util-linux/Documentation
Bjarni Ingi Gislason 37f26093c9 doc: howto-man-page.txt: Use font macros instead of font escapes
Use font macros instead of font escapes (\f[BIPR]).

  The escape '\c' ("connect to next input text")
is used to join the output of two macros without a space character.
This is similar to the '\' escape at the end of a line.

  Font escapes make the text more difficult to read.

###
  Changes based on:

  Use a macro to change to the italic font,
instead of \fI [1], if possible.
  The macros have the italic corrections,
but "\c" removes the "\/" part.

  Or

add the italic corrections.
[1] man-pages(7) [Debian package "manpages"]

###

Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a

1) name for an option

2) negative number to be printed.

###

Wrong distance between sentences or protect the indicator.

a) Separate the sentences and subordinate clauses;
each begins on a new line.
See man-pages(7) [package "manpages"] and "info groff".

Or

b) Adjust space between sentences (two spaces),

c) or protect the indicator by adding "\&" after it.

The "indicator" is an "end-of-sentence character" (.!?).

  The amount of space between sentences in the output can then be
controlled with the ".ss" request.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
2019-12-17 12:32:43 +01:00
..
example.files cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
licenses docs: add GPLv3 text 2019-11-08 11:10:54 +01:00
releases docs: add v2.35-ReleaseNotes 2019-12-11 10:52:51 +01:00
00-about-docs.txt docs: trivial documentation fixes and improvements 2012-02-22 11:52:07 +01:00
PAM-configuration.txt docs: add list of expected PAM config files 2012-09-04 17:00:31 +02:00
TODO docs: remove implemented TODO items 2019-10-17 10:54:15 +02:00
blkid.txt docs: fix typos 2018-11-03 20:56:20 +01:00
boilerplate.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
cal.txt cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
col.txt docs: clean up old readme files 2011-08-23 21:34:21 +02:00
deprecated.txt docs: fix typo 2019-03-22 13:27:33 +01:00
getopt.txt docs: trivial documentation fixes and improvements 2012-02-22 11:52:07 +01:00
getopt_changelog.txt cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
howto-build-sys.txt docs: update howto regards to build-system changes 2014-05-27 15:37:26 +02:00
howto-compilation.txt cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
howto-contribute.txt docs: add info about branches; update travis.yml 2018-10-24 13:02:59 +02:00
howto-debug.txt docs: update info about env debug variables 2014-11-03 13:13:54 +01:00
howto-man-page.txt doc: howto-man-page.txt: Use font macros instead of font escapes 2019-12-17 12:32:43 +01:00
howto-pull-request.txt docs: Fix word repetitions 2017-02-13 14:10:12 +01:00
howto-tests.txt cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
howto-usage-function.txt Docs: update howto-usage-function.txt 2017-07-31 13:48:04 +02:00
hwclock.txt cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
modems-with-agetty.txt cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
mount.txt cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
parse-date.txt misc: fix typos using codespell 2018-02-16 11:12:52 +01:00
pg.txt docs: clean up old readme files 2011-08-23 21:34:21 +02:00
poeigl.txt cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
release-schedule.txt docs: move source-code-management.txt to README 2017-05-31 11:36:47 -04:00
rfkill.readme rfkill: move files to appropriate locations 2017-08-30 20:32:48 +01:00