bugGNU roff - Bugs: bug #51695, [PATCH] groff.texi: Some textual...

 
 

bug #51695: [PATCH] groff.texi: Some textual and formatting changes

Submitter:  Bjarni Ingi Gislason <bjarniig>
Submitted:  Tue 08 Aug 2017 10:32:32 PM UTC
   
 
Category:  Core Severity:  2 - Minor
Item Group:  Documentation Status:  Fixed
Privacy:  Public Assigned to:  gbranden
Open/Closed:  Closed Planned Release:  1.22.4
* Mandatory Fields

Add a New Comment Rich Markup
   

Sun 04 Nov 2018 08:03:07 PM UTC, comment #1: 

Fixed in 5d695a5541a2ccc778aad4059b453be848b9459e.

G. Branden Robinson <gbranden>
Group administrator
Tue 08 Aug 2017 10:32:32 PM UTC, original submission:  


From 36f777785b3b089d1b3ef66b6be5f88904c3bc82 Mon Sep 17 00:00:00 2001
From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Date: Tue, 8 Aug 2017 22:27:59 +0000
Subject: [PATCH] groff.texi: Some textual and formatting changes

  Use '--' 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.

  Write '6 picas' not '6 Picas' at the beginning of a sentence.

  Use a non-break 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'.

  Correct the writing 'C' to 'c' for "centimeter"

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 doc/groff.texi | 52 ++++++++++++++++++++++++++--------------------------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 9a6943cc..6d1635d9 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 @option{-dpaper=@var{size}}.  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
-@code{a7}-@code{d7}.  An appended @samp{l} (ell) character denotes
+@code{a7}--@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 [@code{man}]
 @cindex @code{man} macros, how to set fonts

-The standard font is roman; the default text size is 10@tie{}point.  If
+The standard font is roman; the default text size is 10@tie{}points.  If
 command line option @option{-rS=@var{n}} is given, use @var{n}@dmn{pt}
 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 40-60@tie{}characters, to allow space for
+Try to keep lines less than 40--60@tie{}characters, 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 to@tie{}2.54@dmn{cm}.
+inch is defined to be 2.54@tie{}cm (worldwide since 1964).

 @item c
 @cindex centimeter unit (@code{c})
 @cindex @code{c} unit
 @cindex unit, @code{c}
-Centimeters.  One centimeter is equal to@tie{}0.3937@dmn{in}.
+Centimeters.  One centimeter is about 0.3937@tie{}in.

 @item p
 @cindex point unit (@code{p})
@@ -5078,7 +5078,7 @@ It is 72@tie{}points to an inch.
 @cindex pica unit (@code{P})
 @cindex @code{P} unit
 @cindex unit, @code{P}
-Pica.  Another typesetting measurement.  6@tie{}Picas to an inch (and
+Pica.  Another typesetting measurement.  6@tie{}picas to an inch (and
 12@tie{}points to a pica).

 @item s
@@ -5190,7 +5190,7 @@ Arithmetic: @samp{+} (addition), @samp{-} (subtraction), @samp{/}
 (division), @samp{*} (multiplication), @samp{%} (modulo).

 @code{gtroff} only provides integer arithmetic.  The internal type used
-for computing results is @samp{int}, which is usually a 32@dmn{bit}
+for computing results is @samp{int}, which is usually a 32@tie{}bit
 signed integer.

 @item
@@ -5386,13 +5386,13 @@ Backspace (@acronym{ASCII}@tie{}@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}, @code{0x0D}-@code{0x1F},
-@code{0x80}-@code{0x9F}.
+details): @code{0x00}, @code{0x0B}, @code{0x0D}--@code{0x1F},
+@code{0x80}--@code{0x9F}.

 And here are the invalid input characters if @code{groff} runs on an
 @acronym{EBCDIC} host: @code{0x00}, @code{0x08}, @code{0x09},
-@code{0x0B}, @code{0x0D}-@code{0x14}, @code{0x17}-@code{0x1F},
-@code{0x30}-@code{0x3F}.
+@code{0x0B}, @code{0x0D}--@code{0x14}, @code{0x17}--@code{0x1F},
+@code{0x30}--@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
-@code{^^@var{xx}} (@var{x} is 0-9 or a-f) and @code{^^@var{x}}
-(character code of @var{x} in the range 0-127) are recognized; other use
+@code{^^@var{xx}} (@var{x} is 0--9 or a--f) and @code{^^@var{x}}
+(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
-@samp{a}-@samp{z} (mapped to themselves) and to the letters
-@samp{A}-@samp{Z} (mapped to @samp{a}-@samp{z}); all other hyphenation
+@samp{a}--@samp{z} (mapped to themselves) and to the letters
+@samp{A}--@samp{Z} (mapped to @samp{a}--@samp{z}); 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 10@dmn{cm} from the paper edge at the bottom.
+line will be at 10@tie{}cm 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 and@tie{}4 (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 @code{A0}-@code{A7}, @code{B0}-@code{B7}, @code{C0}-@code{C7},
-@code{D0}-@code{D7}, @code{DL}, and the US paper types @code{letter},
+types @code{A0}--@code{A7}, @code{B0}--@code{B7}, @code{C0}--@code{C7},
+@code{D0}--@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
 @code{@var{length},@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 @var{n}@tie{}machine 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 by@tie{}0
 (this is digit zero).  Each @var{si} can also be a range of sizes
-@var{m}-@var{n}.  The list can extend over more than one line.
+@var{m}--@var{n}.  The list can extend over more than one line.

 @item sizescale @var{n}
 @kindex sizescale
--
2.13.2


Bjarni Ingi Gislason <bjarniig>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by gbranden (Updated the item)
  • -email is unavailable- added by bgarrigues (Updated the item)
  • -email is unavailable- added by bjarniig (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

    Follow 8 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2018-11-04 gbranden CategoryNone Core
        Open/ClosedOpen Closed
        Planned ReleaseNone 1.22.4
    2017-11-01 gbranden StatusIn Progress Fixed
    2017-11-01 gbranden StatusNone In Progress
        Assigned toNone gbranden
    2017-09-01 bgarrigues Item GroupNone Documentation
    2017-08-30 bgarrigues Severity3 - Normal 2 - Minor

    Back to the top

    Powered by Savane 3.13-4448.
    Corresponding source code