groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 01/03: groff.texi: Make minor format and style fixes.


From: G. Branden Robinson
Subject: [groff] 01/03: groff.texi: Make minor format and style fixes.
Date: Wed, 1 Nov 2017 04:09:39 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 5d695a5541a2ccc778aad4059b453be848b9459e
Author: G. Branden Robinson <address@hidden>
Date:   Wed Nov 1 03:35:57 2017 -0400

    groff.texi: Make minor format and style fixes.
    
    * Use '--' (TeX en-dash) for ranges instead of '-'.
    * Say '10 points' not '10 point' if not used as an adjective.
    * Specify the relationship between an inch and a centimeter better.
    * Don't capitalize the name of the unit "pica".
    * Use a non-breaking space (@tie{}) between a number and an unit
      (external to the roff language).  '@dmn{...}' is a small space and is
      turned into no space in other formats.
    * Correct an example where the word 'hyphen' and a '-' is used instead of
      'en-dash' and '\(en'.
    * The roff scaling indicator for centimeters is 'c', not 'C'.
    
    Signed-off-by: Bjarni Ingi Gislason <address@hidden>
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 doc/groff.texi | 50 +++++++++++++++++++++++++-------------------------
 1 file changed, 25 insertions(+), 25 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index fe03fb8..47a15e6 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -26,7 +26,7 @@
 @copying
 This manual documents GNU @code{troff} version 1.22.3.
 
-Copyright @copyright{} 1994-2014 Free Software Foundation, Inc.
+Copyright @copyright{} 1994--2014 Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -1622,7 +1622,7 @@ is command-line option @address@hidden  This defines 
string
 the start-up file @file{troffrc} by default).  Possible values for
 @var{size} are the same as the predefined values for the
 @code{papersize} keyword (but only in lowercase) except
address@hidden@code{d7}.  An appended @samp{l} (ell) character denotes
address@hidden@code{d7}.  An appended @samp{l} (ell) character denotes
 landscape orientation.
 
 For example, use the following for PS output on A4 paper in landscape
@@ -2495,7 +2495,7 @@ Finally, the macros @code{SH}, @code{SS}, @code{LP} 
(@code{PP},
 @cindex font selection address@hidden
 @cindex @code{man} macros, how to set fonts
 
-The standard font is roman; the default text size is address@hidden  If
+The standard font is roman; the default text size is address@hidden  If
 command-line option @address@hidden is given, use @address@hidden
 as the default text size.
 
@@ -4923,7 +4923,7 @@ in other logical places.  Keep separate phrases on lines 
by themselves,
 as entire phrases are often added or deleted when editing.
 
 @item
-Try to keep lines less than address@hidden, to allow space for
+Try to keep lines less than address@hidden, to allow space for
 inserting more text.
 
 @item
@@ -5059,13 +5059,13 @@ current settings (e.g.@: type size) of @code{gtroff}.
 @cindex unit, @code{i}
 Inches.  An antiquated measurement unit still in use in certain
 backwards countries with incredibly low-cost computer equipment.  One
-inch is equal address@hidden@dmn{cm}.
+inch is defined to be address@hidden (worldwide since 1964).
 
 @item c
 @cindex centimeter unit (@code{c})
 @cindex @code{c} unit
 @cindex unit, @code{c}
-Centimeters.  One centimeter is equal address@hidden@dmn{in}.
+Centimeters.  One centimeter is about address@hidden
 
 @item p
 @cindex point unit (@code{p})
@@ -5078,7 +5078,7 @@ It is address@hidden to an inch.
 @cindex pica unit (@code{P})
 @cindex @code{P} unit
 @cindex unit, @code{P}
-Pica.  Another typesetting measurement.  address@hidden to an inch (and
+Pica.  Another typesetting measurement.  address@hidden to an inch (and
 address@hidden to a pica).
 
 @item s
@@ -5386,13 +5386,13 @@ Backspace (@address@hidden@code{0x08} or
 The following input characters are invalid and are ignored if
 @code{groff} runs on a machine based on @acronym{ASCII}, causing a
 warning message of type @samp{input} (see @ref{Debugging}, for more
-details): @code{0x00}, @code{0x0B}, @address@hidden,
address@hidden@code{0x9F}.
+details): @code{0x00}, @code{0x0B}, @address@hidden,
address@hidden@code{0x9F}.
 
 And here are the invalid input characters if @code{groff} runs on an
 @acronym{EBCDIC} host: @code{0x00}, @code{0x08}, @code{0x09},
address@hidden, @address@hidden, @address@hidden,
address@hidden@code{0x3F}.
address@hidden, @address@hidden, @address@hidden,
address@hidden@code{0x3F}.
 
 Currently, some of these reserved codepoints are used internally, thus
 making it non-trivial to extend @code{gtroff} to cover Unicode or other
@@ -6533,19 +6533,19 @@ Initialized at start-up of @code{gtroff}.
 @cindex day of the week register (@code{dw})
 @cindex date, day of the week register (@code{dw})
 @vindex dw
-Day of the week (1-7).
+Day of the week (1--7).
 
 @item \n[dy]
 @cindex day of the month register (@code{dy})
 @cindex date, day of the month register (@code{dy})
 @vindex dy
-Day of the month (1-31).
+Day of the month (1--31).
 
 @item \n[mo]
 @cindex month of the year register (@code{mo})
 @cindex date, month of the year register (@code{mo})
 @vindex mo
-Current month (1-12).
+Current month (1--12).
 
 @item \n[year]
 @cindex date, year register (@code{year}, @code{yr})
@@ -7165,8 +7165,8 @@ preceded by a backslash.
 No support for `digraphs' like @code{\$}.
 
 @item
address@hidden@var{xx}} (@var{x} is 0-9 or a-f) and @address@hidden
-(character code of @var{x} in the range 0-127) are recognized; other use
address@hidden@var{xx}} (@var{x} is 0--9 or a--f) and @address@hidden
+(character code of @var{x} in the range 0--127) are recognized; other use
 of @code{^} causes an error.
 
 @item
@@ -7233,8 +7233,8 @@ character (not a special character) other than a digit or 
a space.
 
 To make hyphenation work, hyphenation codes must be set up.  At
 start-up, groff only assigns hyphenation codes to the letters
address@hidden@samp{z} (mapped to themselves) and to the letters
address@hidden@samp{Z} (mapped to @address@hidden); all other hyphenation
address@hidden@samp{z} (mapped to themselves) and to the letters
address@hidden@samp{Z} (mapped to @address@hidden); all other hyphenation
 codes are set to zero.  Normally, hyphenation patterns contain only
 lowercase letters, which should be applied regardless of case.  In
 other words, the words `FOO' and `Foo' should be hyphenated exactly the
@@ -7381,7 +7381,7 @@ of the page:
 
 @noindent
 A call to @samp{.y-from-bot-up 10c} means that the bottom of the next
-line will be at address@hidden from the paper edge at the bottom.
+line will be at address@hidden from the paper edge at the bottom.
 
 If a vertical trap is sprung during execution of @code{sp}, the amount
 of vertical space after the trap is discarded.  For example, this
@@ -9661,10 +9661,10 @@ property).
 Ignore hyphenation code values of the surrounding characters.  Use this
 in combination with values 2 address@hidden (initially no characters have
 this property).  For example, if you need an automatic break point after
-the hyphen in number ranges like `3000-5000', insert
+the en-dash in number ranges like `3000--5000', insert
 
 @Example
-.cflags 68 -
+.cflags 68 \(en
 @endExample
 
 @noindent
@@ -16686,8 +16686,8 @@ Deprecated.  Use @code{papersize} instead.
 @item papersize @var{string} @dots{}
 @kindex papersize
 Select a paper size.  Valid values for @var{string} are the ISO paper
-types @address@hidden, @address@hidden, @address@hidden,
address@hidden@code{D7}, @code{DL}, and the US paper types @code{letter},
+types @address@hidden, @address@hidden, @address@hidden,
address@hidden@code{D7}, @code{DL}, and the US paper types @code{letter},
 @code{legal}, @code{tabloid}, @code{ledger}, @code{statement},
 @code{executive}, @code{com10}, and @code{monarch}.  Case is not
 significant for @var{string} if it holds predefined paper types.
@@ -16697,7 +16697,7 @@ the first line and tests for the above paper sizes.  
Finally,
 @var{string} can be a custom paper size in the format
 @address@hidden,@var{width}} (no spaces before and after the comma).
 Both @var{length} and @var{width} must have a unit appended; valid
-values are @samp{i} for inches, @samp{C} for centimeters, @samp{p} for
+values are @samp{i} for inches, @samp{c} for centimeters, @samp{p} for
 points, and @samp{P} for picas.  Example: @code{12c,235p}.  An argument
 that starts with a digit is always treated as a custom paper format.
 @code{papersize} sets both the vertical and horizontal dimension of the
@@ -16752,7 +16752,7 @@ There are @address@hidden units per inch.
 This means that the device has fonts at @var{s1}, @var{s2}, @dots{}
 @var{sn} scaled points.  The list of sizes must be terminated address@hidden
 (this is digit zero).  Each @var{si} can also be a range of sizes
address@hidden@var{n}.  The list can extend over more than one line.
address@hidden@var{n}.  The list can extend over more than one line.
 
 @item sizescale @var{n}
 @kindex sizescale



reply via email to

[Prev in Thread] Current Thread [Next in Thread]