groff-commit
[Top][All Lists]
Advanced

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

[groff] 04/31: [docs]: Fix content nits.


From: G. Branden Robinson
Subject: [groff] 04/31: [docs]: Fix content nits.
Date: Sun, 25 Jul 2021 02:39:43 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 220e5a10690ceac718c5d853fe6711a7219b3c62
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Jul 22 01:54:50 2021 +1000

    [docs]: Fix content nits.
    
    Use declarative sentence when describing the device description file's
    `papersize` directive, to better parallel other entries.  Stop using
    "physical" to characterize the output medium; it's unnecessary and
    invites confusion over whether a "physical" medium is actual paper or
    what a PDF viewing application or web browser renders.  Tighten wording.
---
 doc/groff.texi       | 14 +++++++-------
 man/groff_font.5.man |  6 +++---
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 357ff49..7471d12 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -17777,8 +17777,8 @@ however, override previous values.  Empty lines are 
ignored.
 @kindex charset
 This line and everything following it in the file are ignored.  It is
 recognized for compatibility with other @code{troff} implementations.
-In GNU @code{troff}, character set repertoire is defined on a
-per-font-description basis.
+In GNU @code{troff}, character set repertoire is described on a
+per-font basis.
 
 @item family @var{fam}
 @kindex family
@@ -17810,12 +17810,12 @@ this directive.
 
 @item paperlength @var{n}
 @kindex paperlength
-The vertical dimension of the physical output medium is
-@var{n}@tie{}basic units.  Deprecated: use @code{papersize} instead.
+The vertical dimension of the output medium is @var{n}@tie{}basic units.
+Deprecated: use @code{papersize} instead.
 
 @item papersize @var{format-or-dimension-pair-or-file-name} @r{@dots{}}
 @kindex papersize
-Set the dimensions of the physical output medium according to the
+The dimensions of the output medium are as according to the
 argument, which is either a standard paper format, a pair of dimensions,
 or the name of a plain text file containing either of the foregoing.
 
@@ -17844,8 +17844,8 @@ left to right and uses the first valid paper 
specification.
 
 @item paperwidth @var{n}
 @kindex paperwidth
-The horizontal dimension of the physical output medium is
-@var{n}@tie{}basic units.  Deprecated: use @code{papersize} instead.
+The horizontal dimension of the output medium is @var{n}@tie{}basic
+units.  Deprecated: use @code{papersize} instead.
 
 @item pass_filenames
 @kindex pass_filenames
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 9156da5..6706fcb 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -122,9 +122,9 @@ It is recognized for compatibility with other
 .I troff \" generic
 implementations.
 .
-In
-.IR \%@g@troff ,
-character set repertoire is defined on a per-font-description basis.
+In GNU
+.IR troff , \" GNU
+character set repertoire is described on a per-font basis.
 .
 .
 .TP



reply via email to

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