[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
groff_font.man: Some corrections and cleanup in the groff_font(5) manual
From: |
Bjarni Ingi Gislason |
Subject: |
groff_font.man: Some corrections and cleanup in the groff_font(5) manual |
Date: |
Thu, 20 Dec 2012 20:35:28 +0000 |
User-agent: |
Mutt/1.5.20 (2009-06-14) |
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 .
- groff_font.man: Some corrections and cleanup in the groff_font(5) manual,
Bjarni Ingi Gislason <=