groff_font.man: Some corrections and cleanup in the groff_font(5) manual

[Bjarni Ingi Gislason]

GROFF VERSION: groff-current from 3 Dec 2012 (based on version 1.21)

MACHINE: SunFire T5220

OS: SunOS 5.10

COMPILER: None

INPUT FILES: man/groff_font.man

COMMAND LINE: None

DESCRIPTION OF INCORRECT BEHAVIOUR:

  Orthography, typography (and cleanup of formatting commands)

SUGGESTED FIX:

  "\~\c" is removed as it is not needed (any more).

  Arguments are quoted instead of using "\ " to increase readability.


  "\[en] is used instead of "-" to mean "to" (range of values).

  intepreted -> interpreted



--- groff_font.5        2012-12-20 00:14:14.000000000 +0000
+++ groff_font.5.new    2012-12-20 01:23:24.000000000 +0000
@@ -51,9 +51,9 @@ are stored in a directory
 There are two types of file: a
 device description file called
 .B DESC
-and for each font\~\c
+and for each font
 .I F
-a font file called\~\c
+a font file called
 .IR F .
 .
 These are text files;
@@ -77,34 +77,34 @@ This line and everything following in th
 It is allowed for the sake of backwards compatibility.
 .
 .TP
-.BI family\  fam
+.BI "family " fam
 The default font family is
 .IR fam .
 .
 .TP
-.BI fonts\  n\ F1\ F2\ F3\ \|.\|.\|.\|\ Fn
+.BI "fonts " "n F1 F2 F3 \|.\|.\|.\| Fn"
 Fonts
-.IR F1 ,\ \|.\|.\|.,\  Fn
+.IR F1 ", \|.\|.\|., " Fn
 are mounted in the font positions
-.IR m \|+\|1,\ \|.\|.\|.,\  m \|+\| n
+.IR m "\|+\|1, \|.\|.\|., " m \|+\| n
 where
 .I m
 is the number of styles.
 .
 This command may extend over more than one line.
 .
-A font name of\~\c
+A font name of
 .B 0
 causes no font to be mounted on the corresponding font position.
 .
 .TP
-.BI hor\  n
+.BI "hor " n
 The horizontal resolution is
-.IR n \~\c
+.I n
 machine units.
 .
 .TP
-.BI image_generator\  string
+.BI "image_generator "  string
 Needed for
 .B \%grohtml
 only.
@@ -117,7 +117,7 @@ Under GNU/Linux this is usually
 but under other systems (notably cygwin) it might be set to another name.
 .
 .TP
-.BI paperlength\  n
+.BI "paperlength " n
 The physical vertical dimension of the output medium in machine units.
 .
 This isn't used by
@@ -131,12 +131,13 @@ Use
 instead.
 .
 .TP
-.BI papersize\  string
+.BI "papersize " string
 Select a paper size.
 .
 Valid values for
 .I string
-are the ISO paper types A0-A7, B0-B7, C0-C7, D0-D7, DL, and the US paper
+are the ISO paper types A0\[en]A7, B0\[en]B7, C0\[en]C7, D0\[en]D7,
+DL, and the US paper
 types letter, legal, tabloid, ledger, statement, executive, com10, and
 monarch.
 .
@@ -178,7 +179,7 @@ More than one argument can be specified;
 scans from left to right and uses the first valid paper specification.
 .
 .TP
-.BI paperwidth\  n
+.BI "paperwidth " n
 The physical horizontal dimension of the output medium in machine units.
 .
 Deprecated.
@@ -196,23 +197,23 @@ itself but by output devices.
 Make troff tell the driver the source file name being processed.
 .
 This is achieved by another tcommand:
-.BR F \~\c
+.B F
 .IR filename .
 .
 .TP
-.BI postpro\  program
+.BI "postpro " program
 Use
 .I program
 as the postprocessor.
 .
 .TP
-.BI prepro\  program
+.BI "prepro " program
 Call
 .I program
 as a preprocessor.
 .
 .TP
-.BI print\  program
+.BI "print "  program
 Use
 .I program
 as the spooler program for printing.
@@ -226,16 +227,16 @@ options of
 are ignored.
 .
 .TP
-.BI res\  n
+.BI "res " n
 There are
 .I n
 machine units per inch.
 .
 .TP
-.BI sizes\  s1\ s2\ \|.\|.\|.\|\ sn\  0
+.BI "sizes " "s1 s2 \|.\|.\|.\| sn " 0
 This means that the device has fonts at
 .IR s1 ,
-.IR s2 ,\ \|.\|.\|.,\  sn
+.IR s2 ", \|.\|.\|., " sn
 scaled points.
 .
 The list of sizes must be terminated by a
@@ -249,7 +250,7 @@ can also be a range of sizes
 The list can extend over more than one line.
 .
 .TP
-.BI sizescale\  n
+.BI "sizescale " n
 The scale factor for point sizes.
 .
 By default this has a value of 1.
@@ -268,17 +269,17 @@ and
 commands are given in scaled points.
 .
 .TP
-.BI styles\  S1\ S2\ \|.\|.\|.\|\ Sm
+.BI "styles " "S1 S2 \|.\|.\|.\| Sm"
 The first
 .I m
 font positions are associated with styles
-.IR S1 ,\ \|.\|.\|.,\  Sm .
+.IR S1 ", \|.\|.\|., " Sm .
 .
 .TP
 .B tcommand
 This means that the postprocessor can handle the
 .B t
-and\~\c
+and
 .B u
 output commands.
 .
@@ -315,10 +316,10 @@ and
 .BR \-Txhtml .
 .
 .TP
-.BI unitwidth\  n
+.BI "unitwidth " n
 Quantities in the font files are given in machine units
 for fonts whose point size is
-.IR n \~\c
+.I n
 scaled points.
 .
 .TP
@@ -335,9 +336,9 @@ This command indicates that troff should
 special commands.
 .
 .TP
-.BI vert\  n
+.BI "vert " n
 The vertical resolution is
-.IR n \~\c
+.I n
 machine units.
 .
 .LP
@@ -375,10 +376,10 @@ words; the first word in the line is a k
 words give a value for that key.
 .
 .TP
-.BI ligatures\  lig1\ lig2\ \|.\|.\|.\|\ lign\ \fR[ 0 \fR]
+.BI "ligatures " "lig1 lig2 \|.\|.\|.\| lign \fR[" 0 \fR]
 Glyphs
 .IR lig1 ,
-.IR lig2 ,\ \|.\|.\|.,\  lign
+.IR lig2 ", \|.\|.\|., " lign
 are ligatures; possible ligatures are
 .BR ff ,
 .BR fi ,
@@ -388,27 +389,27 @@ and
 .BR ffl .
 .
 For backwards compatibility, the list of ligatures may be terminated
-with a\~\c
-.BR 0.
+with a
+.BR 0 .
 .
 The list of ligatures may not extend over more than one line.
 .
 .TP
-.BI name\  F
-The name of the font is\~\c
+.BI "name " F
+The name of the font is
 .IR F .
 .
 .TP
-.BI slant\  n
+.BI "slant " n
 The glyphs of the font have a slant of
-.IR n \~\c
+.I n
 degrees.
 .
 (Positive means forward.)
 .
 .TP
-.BI spacewidth\  n
-The normal width of a space is\~\c
+.BI "spacewidth "  n
+The normal width of a space is
 .IR n .
 .
 .TP
@@ -529,14 +530,14 @@ escape sequence.
 .
 The code can be any integer.
 .
-If it starts with a\~\c
+If it starts with a
 .B 0
 it is interpreted as octal;
 if it starts with
 .B 0x
 or
 .B 0X
-it is intepreted as hexadecimal.
+it is interpreted as hexadecimal.
 .
 Note, however, that the
 .B \[rs]N
@@ -653,10 +654,10 @@ This means that when glyph
 .I c1
 appears next to glyph
 .I c2
-the space between them should be increased by\~\c
+the space between them should be increased by
 .IR n .
 .
-Most entries in kernpairs section have a negative value for\~\c
+Most entries in kernpairs section have a negative value for
 .IR n .
 .
 .
@@ -669,7 +670,7 @@ Device description file for device
 .
 .TP
 .BI /usr/share/groff/1.20.1/font/dev name / F
-Font file for font\~\c
+Font file for font
 .I F
 of device
 .IR name .