From MAILER-DAEMON Sat Jun 16 05:00:42 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fU74c-0006bG-PV
	for mharc-groff-commit@gnu.org; Sat, 16 Jun 2018 05:00:42 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:41080)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fU74b-0006b7-6r
	for groff-commit@gnu.org; Sat, 16 Jun 2018 05:00:42 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fU74a-0000CP-Fa
	for groff-commit@gnu.org; Sat, 16 Jun 2018 05:00:41 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:49066)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fU74a-0000BU-Bf
	for groff-commit@gnu.org; Sat, 16 Jun 2018 05:00:40 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id D07282043E; Sat, 16 Jun 2018 05:00:39 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: tbl(1): Fix erroneous global option reference.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180616090039.12807.79746@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 82d56c12d4e131ec072ad3525d7f683c6acd2261
Auto-Submitted: auto-generated
Message-Id: <20180616090039.D07282043E@vcs0.savannah.gnu.org>
Date: Sat, 16 Jun 2018 05:00:39 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 16 Jun 2018 09:00:42 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 82d56c12d4e131ec072ad3525d7f683c6acd2261
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 16 04:56:33 2018 -0400

    tbl(1): Fix erroneous global option reference.
   =20
    * src/preproc/tbl/tbl.1.man: Tell readers that the tab character is s=
et
    with tab(c), not tbl(c).  Noted and corrected by Michael Witten.
   =20
    Fixes Savannah #54114.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/preproc/tbl/tbl.1.man | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index 3fdaee6..c52ef4f 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -149,7 +149,7 @@ Cells are separated by a tab character by default.
 .
 That can be changed by the
 .I global option
-.BI tbl( c ) \fR,
+.BI tab( c ) \fR,
 where
 .I c
 is an arbitrary character.


From MAILER-DAEMON Sat Jun 16 06:17:13 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fU8Gf-0005jo-Jn
	for mharc-groff-commit@gnu.org; Sat, 16 Jun 2018 06:17:13 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:50015)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fU8Gd-0005ji-50
	for groff-commit@gnu.org; Sat, 16 Jun 2018 06:17:12 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fU8Gc-0000ku-6B
	for groff-commit@gnu.org; Sat, 16 Jun 2018 06:17:11 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:50051)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fU8Gc-0000jM-1t
	for groff-commit@gnu.org; Sat, 16 Jun 2018 06:17:10 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id C80902043E; Sat, 16 Jun 2018 06:17:09 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: tbl(1): Make minor style fixes.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180616101709.8094.6648@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 1296163af0f4e5a797f3d5c5857e8b7387009e06
Auto-Submitted: auto-generated
Message-Id: <20180616101709.C80902043E@vcs0.savannah.gnu.org>
Date: Sat, 16 Jun 2018 06:17:09 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 16 Jun 2018 10:17:12 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 1296163af0f4e5a797f3d5c5857e8b7387009e06
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 16 05:58:30 2018 -0400

    tbl(1): Make minor style fixes.
   =20
    * src/preproc/tbl/tbl.1.man:
      + Use singular form for possibly-repeated file argument.
      + Replace the lone use (in this page) of a font-change escape with =
an
        input line connection escape to solve the three-face problem (sor=
ry,
        Ingo).
      + Use possessive form "macro packages'" where needed.
      + Fix comma splice with an em-dash.
      + Add backslash to botched character escape.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/preproc/tbl/tbl.1.man | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index c52ef4f..ace8fd5 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -36,7 +36,7 @@
 .
 .SY @g@tbl
 .OP \-Cv
-.RI [ files\~ .\|.\|.]
+.RI [ file\~ .\|.\|.]
 .YS
 .
 .
@@ -149,7 +149,8 @@ Cells are separated by a tab character by default.
 .
 That can be changed by the
 .I global option
-.BI tab( c ) \fR,
+.BI tab( c )\c
+,
 where
 .I c
 is an arbitrary character.
@@ -333,8 +334,8 @@ Normally
 .B tbl
 attempts to prevent undesirable breaks in boxed tables by using diversio=
ns.
 .
-This can sometimes interact badly with macro packages own use of
-diversions, when footnotes, for example, are used.
+This can sometimes interact badly with macro packages' own use of
+diversions\[em]when footnotes, for example, are used.
 .
 .TP
 .B nospaces
@@ -948,7 +949,7 @@ after the table).
 .
 .
 .LP
-If either \[oq]w\[cq] or \[oq]x[cq] specifiers are not given for
+If either \[oq]w\[cq] or \[oq]x\[cq] specifiers are not given for
 .I all
 columns of a text block span, the default length of the text block (to
 be more precise, the line length used to process the text block


From MAILER-DAEMON Sun Jun 17 09:04:45 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUXML-00018c-8u
	for mharc-groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:45 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51267)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMI-00017w-PY
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:43 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMH-00048o-Qf
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:42 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:36794)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMH-00048d-Nc
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:41 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 9353D209B8; Sun, 17 Jun 2018 09:04:41 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 02/06: man pages: Add commas after "i.e." and "e.g.".
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180617130440.25881.82705@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 977b946f372b6dc2ead1455f911fec911d15459e
Auto-Submitted: auto-generated
Message-Id: <20180617130441.9353D209B8@vcs0.savannah.gnu.org>
Date: Sun, 17 Jun 2018 09:04:41 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 17 Jun 2018 13:04:43 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 977b946f372b6dc2ead1455f911fec911d15459e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sun Jun 17 08:29:22 2018 -0400

    man pages: Add commas after "i.e." and "e.g.".
   =20
    This is an English style fix that happens to robustify the pages agai=
nst
    groff's end-of-sentence detection in the event of sloppy whitespace.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 contrib/glilypond/glilypond.1.man | 2 +-
 man/groff.7.man                   | 2 +-
 man/groff_tmac.5.man              | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/contrib/glilypond/glilypond.1.man b/contrib/glilypond/glilyp=
ond.1.man
index 40e5c26..d9f1455 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -94,7 +94,7 @@ devices.
 .
 .
 .P
-I.e. the following
+I.e., the following
 .B groff
 devices work,
 .BR \-Tps ,
diff --git a/man/groff.7.man b/man/groff.7.man
index b34ccf9..2667b45 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4418,7 +4418,7 @@ to
 .SS Underlining without macro definitions
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-If one does not want to use macro definitions, e.g. when
+If one does not want to use macro definitions, e.g., when
 .B doclifter
 gets lost, use the following:
 .
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index c7ca133..0390000 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -398,7 +398,7 @@ orientation:
 .B pdfpic
 A single macro is provided in this file,
 .BR PSPIC ,
-to include a PDF graphic in a document, i.e. under the output device
+to include a PDF graphic in a document, i.e., under the output device
 .BR \-Tpdf .
 .
 For all other devices,


From MAILER-DAEMON Sun Jun 17 09:04:45 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUXML-00018n-Dy
	for mharc-groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:45 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51273)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMJ-00017y-3t
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:43 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMI-00049I-9t
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:43 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:36800)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMI-00049C-7b
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:42 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 22154208E4; Sun, 17 Jun 2018 09:04:42 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 05/06: groff_filenames(5): Fix botched character escape.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180617130440.25881.82705@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: b0eb252a87ef39ba7d01aaf4e701b16bb7e43669
Auto-Submitted: auto-generated
Message-Id: <20180617130442.22154208E4@vcs0.savannah.gnu.org>
Date: Sun, 17 Jun 2018 09:04:42 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 17 Jun 2018 13:04:44 -0000

gbranden pushed a commit to branch master
in repository groff.

commit b0eb252a87ef39ba7d01aaf4e701b16bb7e43669
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sun Jun 17 08:46:34 2018 -0400

    groff_filenames(5): Fix botched character escape.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 contrib/groff_filenames/groff_filenames.5.man | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/groff_filenames/groff_filenames.5.man b/contrib/grof=
f_filenames/groff_filenames.5.man
index dc10aed..6792a2b 100644
--- a/contrib/groff_filenames/groff_filenames.5.man
+++ b/contrib/groff_filenames/groff_filenames.5.man
@@ -191,7 +191,7 @@ but there are still documents in this format.
 .TQ
 .IB <name> .o
 .I Deprecated
-man page sections, which stood for \[lq]local[rq], \[lq]new\[rq], and
+man page sections, which stood for \[lq]local\[rq], \[lq]new\[rq], and
 \[lq]old\[rq], respectively.
 .
 .


From MAILER-DAEMON Sun Jun 17 09:04:45 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUXML-000192-Hl
	for mharc-groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:45 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51277)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMJ-000180-5X
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:44 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMI-00049Q-Ec
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:43 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:36802)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMI-00049M-CJ
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:42 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 46309208E4; Sun, 17 Jun 2018 09:04:42 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 06/06: groff_me(7): Use @MACRODIR@ to locate files.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180617130440.25881.82705@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 54eb57fb25a0482ee1e3f647a2a26afb15abb02d
Auto-Submitted: auto-generated
Message-Id: <20180617130442.46309208E4@vcs0.savannah.gnu.org>
Date: Sun, 17 Jun 2018 09:04:42 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 17 Jun 2018 13:04:44 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 54eb57fb25a0482ee1e3f647a2a26afb15abb02d
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sun Jun 17 08:55:50 2018 -0400

    groff_me(7): Use @MACRODIR@ to locate files.
   =20
    The page had been ignoring the ./configure --prefix setting and thank=
s
    to Bertrand's recent improvements, had git version jerky in its teeth=
.
   =20
    Before:
    -       /usr/share/groff/1.22.4.rc2.40=E2=80=904d30=E2=80=90dirty/tma=
c/e.tmac
    After:
    +       /usr/local/share/groff/1.22.4/tmac/e.tmac
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 tmac/groff_me.7.man | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tmac/groff_me.7.man b/tmac/groff_me.7.man
index 2b6c00f..c235e74 100644
--- a/tmac/groff_me.7.man
+++ b/tmac/groff_me.7.man
@@ -416,11 +416,11 @@ T}
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.I /usr/share/groff/@VERSION@/tmac/me.tmac
+.I @MACRODIR@/me.tmac
 (a wrapper file for
 .IR e.tmac )
 .br
-.I /usr/share/groff/@VERSION@/tmac/e.tmac
+.I @MACRODIR@/e.tmac
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D


From MAILER-DAEMON Sun Jun 17 09:04:45 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUXML-00019J-Lo
	for mharc-groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:45 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51278)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMJ-000181-5t
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:44 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMI-000498-6p
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:43 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:36798)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMI-000492-45
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:42 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 0031F208E4; Sun, 17 Jun 2018 09:04:41 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 04/06: man pages: Add "\&" to line-ending abbreviations.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180617130440.25881.82705@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 2949db3fcd0b6d6175b1f141de2788b52d0cd162
Auto-Submitted: auto-generated
Message-Id: <20180617130442.0031F208E4@vcs0.savannah.gnu.org>
Date: Sun, 17 Jun 2018 09:04:41 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 17 Jun 2018 13:04:44 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 2949db3fcd0b6d6175b1f141de2788b52d0cd162
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sun Jun 17 08:44:10 2018 -0400

    man pages: Add "\&" to line-ending abbreviations.
   =20
    This is a style fix to correct undesired end-of-sentence detection in
    cases where text reflow put an abbreviation at the end of a line.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 contrib/gpinyin/gpinyin.1.man                 | 2 +-
 contrib/groff_filenames/groff_filenames.5.man | 2 +-
 contrib/mom/groff_mom.7.man                   | 2 +-
 src/devices/gropdf/gropdf.1.man               | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/contrib/gpinyin/gpinyin.1.man b/contrib/gpinyin/gpinyin.1.ma=
n
index 668d07f..84aa80d 100644
--- a/contrib/gpinyin/gpinyin.1.man
+++ b/contrib/gpinyin/gpinyin.1.man
@@ -188,7 +188,7 @@ each syllable consists of 1 to 6 European-like letter=
s, the normal
 ASCII characters in upper and lower case, the only unusual characters
 are the
 .BR "U dieresis " ( umlaut )
-in both cases, i.e.
+in both cases, i.e.\&
 .BR [a\(enzA\(enZ=EF=BF=BD=EF=BF=BD] .
 .
 .
diff --git a/contrib/groff_filenames/groff_filenames.5.man b/contrib/grof=
f_filenames/groff_filenames.5.man
index e9e8d3a..dc10aed 100644
--- a/contrib/groff_filenames/groff_filenames.5.man
+++ b/contrib/groff_filenames/groff_filenames.5.man
@@ -205,7 +205,7 @@ extension in
 .BI . <section>[<group>]
 is optional, but it can be any string of word characters.
 .
-Usually programmers use a group name that is already used, e.g.
+Usually programmers use a group name that is already used, e.g.\&
 .B x
 for
 X Window System
diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index 7c5c3fe..d1f6a13 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -1005,7 +1005,7 @@ and ends after
 .IR men .
 .
 .I Inline escapes
-(e.g.
+(e.g.\&
 .I font
 or
 .I point size
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.=
1.man
index 5a30db8..86a4145 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -726,7 +726,7 @@ can be introduced using the macro
 .B "\[rs]X'ps: exec %%%%BEGINONCE"
 Any text following this command (up to %%%%ENDONCE) is shown only once,
 the next %%%%PAUSE will remove it.
-If producing a non presentation pdf, i.e.
+If producing a non presentation pdf, i.e.\&
 ignoring the pauses, see GROPDF_NOSLIDE below, this text is ignored.
 .LP
 .TP


From MAILER-DAEMON Sun Jun 17 09:04:47 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUXMN-0001Af-06
	for mharc-groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:47 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51271)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMI-00017x-S5
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:44 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMH-00048j-QX
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:42 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:36792)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMH-00048G-MW
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:41 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 71B39208E4; Sun, 17 Jun 2018 09:04:41 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/06: gropdf(1): Break input lines at sentence endings.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180617130440.25881.82705@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 4d301dcb19c5ada95a133b9336f2f4abbab063fd
Auto-Submitted: auto-generated
Message-Id: <20180617130441.71B39208E4@vcs0.savannah.gnu.org>
Date: Sun, 17 Jun 2018 09:04:41 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 17 Jun 2018 13:04:44 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 4d301dcb19c5ada95a133b9336f2f4abbab063fd
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sun Jun 17 08:07:57 2018 -0400

    gropdf(1): Break input lines at sentence endings.
   =20
    This applies inter-sentence spacing to the output formats.
   =20
    I did not reflow the input text or break long input lines despite gre=
at
    temptation.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/devices/gropdf/gropdf.1.man | 33 ++++++++++++++++++++++-----------
 1 file changed, 22 insertions(+), 11 deletions(-)

diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.=
1.man
index 2a8c7f3..5a30db8 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -707,7 +707,8 @@ BLOCKS
 BLOCKE
 .
 .LP
-Which allows you to create presentation type PDFs. Many of the other
+Which allows you to create presentation type PDFs.
+Many of the other
 commands are already available in other macro packages.
 .LP
 These commands are implemented with
@@ -717,18 +718,21 @@ X commands:-
 .TP
 .BI "\[rs]X'ps: exec %%%%PAUSE"
 The section before this is treated as a block and is introduced using th=
e
-current BLOCK transition setting (see \[oq]pdf: transition\[cq] below). =
This command
+current BLOCK transition setting (see \[oq]pdf: transition\[cq] below).
+This command
 can be introduced using the macro
 .BR .pdfpause .
 .TP
 .B "\[rs]X'ps: exec %%%%BEGINONCE"
 Any text following this command (up to %%%%ENDONCE) is shown only once,
-the next %%%%PAUSE will remove it. If producing a non presentation pdf, =
i.e.
+the next %%%%PAUSE will remove it.
+If producing a non presentation pdf, i.e.
 ignoring the pauses, see GROPDF_NOSLIDE below, this text is ignored.
 .LP
 .TP
 .B "\[rs]X'ps: exec %%%%ENDONCE"
-This terminates the block defined by %%%%BEGINONCE. This pair of command=
s
+This terminates the block defined by %%%%BEGINONCE.
+This pair of commands
 is what implements the .BLOCKS Once/.BLOCKE commands in present.tmac.
 .LP
 The
@@ -871,7 +875,8 @@ These macros must only be used within page traps.)
 where
 .IP
 .I feature
-can be either SLIDE or BLOCK. When it is SLIDE the transition is used
+can be either SLIDE or BLOCK.
+When it is SLIDE the transition is used
 when a new slide is introduced to the screen, if BLOCK then this transit=
ion
 is used for the individual blocks which make up the slide.
 .br
@@ -880,7 +885,8 @@ is the transition type between slides:-
 .RS
 .IP
 .B Split
-- Two lines sweep across the screen, revealing the new page. The lines
+- Two lines sweep across the screen, revealing the new page.
+The lines
 may be either horizontal or vertical and may move inward from the
 edges of the page or outward from the center, as specified by the
 .I dimension
@@ -890,10 +896,12 @@ entries, respectively.
 .br
 .B Blinds
 - Multiple lines, evenly spaced across the screen, synchronously
-sweep in the same direction to reveal the new page. The lines may be
+sweep in the same direction to reveal the new page.
+The lines may be
 either horizontal or vertical, as specified by the
 .I dimension
- entry. Horizontal
+ entry.
+Horizontal
 lines move downward; vertical lines move to the right.
 .br
 .B Box
@@ -1022,13 +1030,15 @@ is not 1.0.
 (Optional; PDF 1.5;
 .B Fly
 transition style only) The starting or ending scale at
-which the changes shall be drawn. If
+which the changes shall be drawn.
+If
 .I motion
 specifies an inward transition, the scale
 of the changes drawn shall progress from
 .I scale
 to 1.0 over the course of the
-transition. If
+transition.
+If
 .I motion
 specifies an outward transition, the scale of the changes drawn
 shall progress from 1.0 to
@@ -1047,7 +1057,8 @@ in is rectangular and opaque.
 .IP
 This command can be used by calling the macro
 .B .pdftransition
-using the parameters described above. Any of the parameters may be
+using the parameters described above.
+Any of the parameters may be
 replaced with a "." which signifies the parameter retains its
 previous value, also any trailing missing parameters are ignored.
 .LP


From MAILER-DAEMON Sun Jun 17 09:04:47 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUXMN-0001Av-4z
	for mharc-groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:47 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51275)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMJ-00017z-4t
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:44 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMI-00048y-0i
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:43 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:36796)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUXMH-00048s-TG
	for groff-commit@gnu.org; Sun, 17 Jun 2018 09:04:41 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id C1E25208E4; Sun, 17 Jun 2018 09:04:41 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 03/06: man pages: Add "\&" after abbreviation periods.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180617130440.25881.82705@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 7e3799362a57db2f5b9ab6c79e7f2a3f2bdcb667
Auto-Submitted: auto-generated
Message-Id: <20180617130441.C1E25208E4@vcs0.savannah.gnu.org>
Date: Sun, 17 Jun 2018 09:04:41 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 17 Jun 2018 13:04:44 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 7e3799362a57db2f5b9ab6c79e7f2a3f2bdcb667
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sun Jun 17 08:34:53 2018 -0400

    man pages: Add "\&" after abbreviation periods.
   =20
    This is a style fix to prevent undesired end-of-sentence detection in
    the event text reflow ends up with an abbreviation at the end of a li=
ne.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 contrib/mom/groff_mom.7.man | 2 +-
 man/groff_char.7.man        | 4 ++--
 man/roff.7.man              | 2 +-
 src/preproc/pic/pic.1.man   | 2 +-
 tmac/groff_me.7.man         | 6 +++---
 5 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index 059e96d..7c5c3fe 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -1848,7 +1848,7 @@ only.
 \fB1.\[rs]0The most important point to be considered is whether the
 answer to the meaning of Life, the Universe, and Everything
 really is 42.  We have no-one's word on the subject except
-Mr. Adams'.
+Mr.\& Adams'.
 .B .HI
 2.\[rs]0If the answer to the meaning of Life, the Universe,
 and Everything is indeed 42, what impact does this have on
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index efb9d93..bae9fec 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -1151,9 +1151,9 @@ _
 \[=3D=3D]	\e[=3D=3D]	equivalence	u2261	equivalent +
 \[ne]	\e[ne]	uni2262	u2261_0338	not equivalent
 \[=3D~]	\e[=3D~]	congruent	u2245	T{
-congruent, approx. equal
+congruent, approx.\& equal
 T}
-\[|=3D]	\e[|=3D]	uni2243	u2243	asymptot. equal to +
+\[|=3D]	\e[|=3D]	uni2243	u2243	asymptot.\& equal to +
 \[ap]	\e[ap]	similar	u223C	similar +
 \[~~]	\e[~~]	approxequal	u2248	almost equal to
 \[~=3D]	\e[~=3D]	approxequal	u2248	almost equal to
diff --git a/man/roff.7.man b/man/roff.7.man
index 480e267..cf142e8 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -1048,7 +1048,7 @@ This is the next sentence in the same paragraph.
 \&.
 .
 This is a longer sentence stretching over several input lines;
-abbreviations like cf\&. are easily identified because the dot is
+abbreviations like cf.\& are easily identified because the dot is
 not followed by a line break.
 \&.
 .
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 286345b..4e443f9 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -569,7 +569,7 @@ as the argument to
 Reset pre-defined variables
 .IR variable1 ,
 .I variable2
-\&.\^.\^. to their default values.
+\&.\^.\^.\& to their default values.
 .
 If no arguments are given, reset all pre-defined variables to their
 default values.
diff --git a/tmac/groff_me.7.man b/tmac/groff_me.7.man
index f971a68..2b6c00f 100644
--- a/tmac/groff_me.7.man
+++ b/tmac/groff_me.7.man
@@ -436,9 +436,9 @@ macro packages limited themselves to a single-letter =
namespace
 etc.).
 .
 It is not known for certain what the \(lqe\(rq in \(lqme\(rq stands for,
-but one can infer a derivation from the first initial of Eric P. Allman
-(then of the University of California), who wrote the original technical
-papers documenting the package.
+but one can infer a derivation from the first initial of Eric P.\&
+Allman (then of the University of California), who wrote the original
+technical papers documenting the package.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D


From MAILER-DAEMON Mon Jun 18 01:42:46 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUmwA-00083b-K1
	for mharc-groff-commit@gnu.org; Mon, 18 Jun 2018 01:42:46 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:34765)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUmw7-00082h-Nn
	for groff-commit@gnu.org; Mon, 18 Jun 2018 01:42:44 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUmw7-0001Eq-1D
	for groff-commit@gnu.org; Mon, 18 Jun 2018 01:42:43 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:44715)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUmw6-0001ET-T4
	for groff-commit@gnu.org; Mon, 18 Jun 2018 01:42:42 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 95EB52053E; Mon, 18 Jun 2018 01:42:42 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 02/02: refer(1): Fix damaged comment line.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180618054241.9334.11956@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: c054248a1edd9e93bd52cec644d0c9a8bdb6631b
Auto-Submitted: auto-generated
Message-Id: <20180618054242.95EB52053E@vcs0.savannah.gnu.org>
Date: Mon, 18 Jun 2018 01:42:42 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 18 Jun 2018 05:42:44 -0000

gbranden pushed a commit to branch master
in repository groff.

commit c054248a1edd9e93bd52cec644d0c9a8bdb6631b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Mon Jun 18 01:36:13 2018 -0400

    refer(1): Fix damaged comment line.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/preproc/refer/refer.1.man | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.ma=
n
index 19d0a4a..cd509d0 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -45,7 +45,7 @@
 .YS
 .
 .
-\" --------------------------------------------------------------------
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .


From MAILER-DAEMON Mon Jun 18 01:42:49 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUmwD-00086P-OK
	for mharc-groff-commit@gnu.org; Mon, 18 Jun 2018 01:42:49 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:34778)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUmw9-00083U-Op
	for groff-commit@gnu.org; Mon, 18 Jun 2018 01:42:48 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUmw7-0001Em-0l
	for groff-commit@gnu.org; Mon, 18 Jun 2018 01:42:45 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:44714)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUmw6-0001ES-Sy
	for groff-commit@gnu.org; Mon, 18 Jun 2018 01:42:42 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 707D4203CB; Mon, 18 Jun 2018 01:42:42 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/02: man pages: Stop using .TP for ersatz tables.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180618054241.9334.11956@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 0013a2e010a26f242925b33f8e66be83ebb23ef1
Auto-Submitted: auto-generated
Message-Id: <20180618054242.707D4203CB@vcs0.savannah.gnu.org>
Date: Mon, 18 Jun 2018 01:42:41 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 18 Jun 2018 05:42:48 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 0013a2e010a26f242925b33f8e66be83ebb23ef1
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Mon Jun 18 01:30:23 2018 -0400

    man pages: Stop using .TP for ersatz tables.
   =20
    Remove gratuitous calculated indent setting and page-local macro ("Tp=
")
    often used to facilitate it.  The pages that use this trick do it as =
a
    way to simulate a 2-column table.
   =20
    This is a generalization of the fix to Savannah #53797, in which Bjar=
ni
    Ingli Gislason noted one instance in refer(1).
   =20
    Impact on nroff output with 80 columns:
   =20
    man/groff_font.5:
    * All 3 items in the list of additional font file commands are
      consistently rendered with a hanging tag (before, none were).
   =20
    src/preproc/eqn/eqn.1:
    * Use a 2-column tbl(1) table to describe component types.  (Looks go=
od
      in -Tpdf as well.)  I also recast some wording that confused me, af=
ter
      consulting src/preproc/eqn/text.cpp to check my understanding.
   =20
    src/preproc/refer/refer.1:
    * All items in the list of refer commends now have a hanging tag (som=
e
      did before, but the overall indent was much farther to the right).
    * File paragraphs in the FILES section now have mixed hangs.
   =20
    src/roff/troff/troff.1:
    * Flag paragraphs in the OPTIONS section how have mixed hangs.
   =20
    src/utils/indxbib/indxbib.1:
    src/utils/lkbib/lkbib.1:
    src/utils/lookbib/lookbib.1:
    * File paragraphs in the FILES section now have mixed hangs.
   =20
    man/groff_font.5:
    src/devices/gropdf/gropdf.1:
    src/devices/grops/grops.1:
    src/preproc/grn/grn.1:
    src/preproc/pic/pic.1:
    src/utils/tfmtodit/tfmtodit.1:
    * No visible impact.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 man/groff_font.5.man              | 13 +------
 src/devices/grodvi/grodvi.1.man   |  9 +----
 src/devices/gropdf/gropdf.1.man   |  9 +----
 src/devices/grops/grops.1.man     |  9 +----
 src/preproc/eqn/eqn.1.man         | 75 ++++++++++++---------------------=
------
 src/preproc/grn/grn.1.man         | 13 +------
 src/preproc/pic/pic.1.man         |  9 +----
 src/preproc/refer/refer.1.man     | 16 ++-------
 src/roff/troff/troff.1.man        |  2 +-
 src/utils/afmtodit/afmtodit.1.man | 12 +------
 src/utils/indxbib/indxbib.1.man   |  2 +-
 src/utils/lkbib/lkbib.1.man       | 15 ++------
 src/utils/lookbib/lookbib.1.man   |  2 +-
 src/utils/tfmtodit/tfmtodit.1.man |  8 +----
 14 files changed, 39 insertions(+), 155 deletions(-)

diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index f4801ed..207ead4 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -22,22 +22,11 @@ groff_font \- format of groff device and font descrip=
tion files
 .\" <http://www.gnu.org/licenses/gpl-2.0.html>.
 .
 .
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.\" Macro definitions
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
 .do nr groff_font_C \n[.C]
 .cp 0
 .
 .
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.  ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.  el .TP "\\$1"
-..
-.
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -673,7 +662,7 @@ Most entries in kernpairs section have a negative val=
ue for\~\c
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'@FONTDIR@/devname/DESC'u+3n
+.TP
 .BI @FONTDIR@/dev name /DESC
 Device description file for device
 .IR name .
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.=
1.man
index cbfef20..b0aed5e 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -29,13 +29,6 @@ grodvi \- convert groff output to TeX DVI format
 .ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
 .el .ds tx TeX
 .
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.  ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.  el .TP "\\$1"
-..
-.
 .de FT
 .  if '\\*(.T'dvi' .ft \\$1
 ..
@@ -140,7 +133,7 @@ can be created from tfm files using
 The font description file should contain the following
 additional commands:
 .
-.Tp \w'\fBinternalname'u+2n
+.TP
 .BI internalname\   name
 The name of the tfm file (without the
 .B .tfm
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.=
1.man
index 86a4145..8b8f00e 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -28,13 +28,6 @@ gropdf \- PDF driver for groff
 .\" instead of in the original English.
 .
 .
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.  ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.  el .TP "\\$1"
-..
-.
 .de FT
 .  if '\\*(.T'ps' .ft \\$1
 .  if '\\*(.T'pdf' .ft \\$1
@@ -1273,7 +1266,7 @@ creation timestamp in place of the current time.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'\fB@FONTDIR@/devpdf/download'u+2n
+.TP
 .B @FONTDIR@/devpdf/DESC
 Device description file.
 .
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.ma=
n
index 47f5da1..47ae546 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -28,13 +28,6 @@ grops \- PostScript driver for groff
 .\" instead of in the original English.
 .
 .
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.  ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.  el .TP "\\$1"
-..
-.
 .de FT
 .  if '\\*(.T'ps' .ft \\$1
 .  if '\\*(.T'pdf' .ft \\$1
@@ -1434,7 +1427,7 @@ creation timestamp in place of the current time.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'\fB@FONTDIR@/devps/download'u+2n
+.TP
 .B @FONTDIR@/devps/DESC
 Device description file.
 .
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 22e66fe..707999b 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -1,3 +1,4 @@
+'\" t
 .TH @G@EQN @MAN1EXT@ "@MDATE@" "groff @VERSION@"
 .SH NAME
 @g@eqn \- format equations for troff or MathML
@@ -34,14 +35,6 @@
 .  ds tx TeX
 .
 .
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.  ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.  el .TP "\\$1"
-..
-.
-.
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -310,49 +303,29 @@ If delimiters haven't been specified, the call has =
no effect.
 gives each component of an equation a type, and adjusts the spacing
 between components using that type.
 .
-Possible types are:
+Possible types are described in the table below.
 .
-.RS
-.TP \w'punctuation'u+2n
-ordinary
-an ordinary character such as \[oq]1\[cq] or
-.RI \[oq] x \[cq];
 .
-.TP
-operator
+.TS
+lB l.
+ordinary	T{
+an ordinary character such as \[oq]1\[cq] or
+.RI \[oq] x \[cq]
+T}
+operator	T{
 a large operator such as
 .ds Su \[oq]\s+5\(*S\s0\[cq]
 .if \n(.g .if !c\(*S .ds Su the summation operator
-\*(Su;
-.
-.TP
-binary
-a binary operator such as \[oq]\[pl]\[cq];
-.
-.TP
-relation
-a relation such as \[oq]=3D\[cq];
-.
-.TP
-opening
-a opening bracket such as \[oq](\[cq];
-.
-.TP
-closing
-a closing bracket such as \[oq])\[cq];
-.
-.TP
-punctuation
-a punctuation character such as \[oq],\[cq];
-.
-.TP
-inner
-a subformula contained within brackets;
-.
-.TP
-suppress spacing
-that suppresses automatic spacing adjustment.
-.RE
+\*(Su
+T}
+binary	a binary operator such as \[oq]\[pl]\[cq]
+relation	a relation such as \[oq]=3D\[cq]
+opening	a opening bracket such as \[oq](\[cq]
+closing	a closing bracket such as \[oq])\[cq]
+punctuation	a punctuation character such as \[oq],\[cq]
+inner	a subformula contained within brackets
+suppress	a type that suppresses automatic spacing adjustment
+.TE
 .
 .
 .LP
@@ -834,10 +807,7 @@ Values are in units of hundredths of an em unless ot=
herwise stated.
 These descriptions are intended to be expository rather than
 definitive.
 .
-.ie t \
-.  TP \w'\fBdefault_rule_thickness'u+2n
-.el \
-.  TP
+.TP
 .B minimum_size
 .B eqn
 doesn't set anything at a smaller point-size than this.
@@ -1289,7 +1259,7 @@ causes a character to be set in roman type.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'\fB@MACRODIR@/eqnrc'u+2n
+.TP
 .B @MACRODIR@/eqnrc
 Initialization file.
 .
@@ -1402,5 +1372,6 @@ This is allowed by the specification, but inefficie=
nt.
 .
 .\" Local Variables:
 .\" mode: nroff
+.\" tab-width: 12
 .\" End:
-.\" vim: set filetype=3Dgroff:
+.\" vim: set filetype=3Dgroff tabstop=3D12:
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index 73ce2f4..cfca060 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -28,21 +28,10 @@
 .\" instead of in the original English.
 .
 .
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.\" Definitons
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
 .do nr grn_C \n[.C]
 .cp 0
 .
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.  ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.  el .TP "\\$1"
-..
-.
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH SYNOPSIS
@@ -769,7 +758,7 @@ cause problems if displayed on the
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'@FONTDIR@/devname/DESC'u+3n
+.TP
 .BI @FONTDIR@/dev name /DESC
 Device description file for device
 .IR name .
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 4e443f9..7c6c225 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -34,13 +34,6 @@
 .\" Definitions
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.el .TP "\\$1"
-..
-.
 .ie t \{\
 .  ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
 .  ds lx L\h'-0.36m'\v'-0.22v'\s-2A\s0\h'-0.15m'\v'0.22v'\*(tx
@@ -1254,7 +1247,7 @@ package.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'\fB@MACRODIR@/pic.tmac'u+3n
+.TP
 .B
 @MACRODIR@/pic.tmac
 Example definitions of the
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.ma=
n
index 9adb212..19d0a4a 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -26,16 +26,6 @@
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.\" Macro Definitions
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.  ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.  el .TP "\\$1"
-..
-.
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
@@ -844,7 +834,7 @@ is used for an arbitrary string;
 is used for the name of a file.
 .
 .
-.Tp \w'\fBabbreviate-label-ranges'u+2n
+.TP
 .BI abbreviate\*n\  fields\ string1\ string2\ string3\ string4
 Abbreviate the first names of
 .IR fields .
@@ -1717,7 +1707,7 @@ macro.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'\fB@DEFAULT_INDEX@'u+2n
+.TP
 .B @DEFAULT_INDEX@
 Default database.
 .
@@ -1740,7 +1730,7 @@ man page for details where such files are created.
 .SH ENVIRONMENT
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'\fBREFER'u+2n
+.TP
 .B REFER
 If set, overrides the default database.
 .
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 7a54a84..120a490 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -73,7 +73,7 @@ appropriate order and with the appropriate options.
 It is possible to have whitespace between a command-line option and
 its parameter.
 .
-.TP \w'\-dname=3Ds'u+2n
+.TP
 .B \-a
 Generate an
 .SM ASCII
diff --git a/src/utils/afmtodit/afmtodit.1.man b/src/utils/afmtodit/afmto=
dit.1.man
index c7c1b69..7ffce17 100644
--- a/src/utils/afmtodit/afmtodit.1.man
+++ b/src/utils/afmtodit/afmtodit.1.man
@@ -25,16 +25,6 @@ afmtodit \- create font files for use with groff \-Tps=
 and \-Tpdf
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.\" Definitions
-.
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.  ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.  el .TP "\\$1"
-..
-.
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
@@ -342,7 +332,7 @@ Don't use the built-in Adobe Glyph List.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'\fB@FONTDIR@/devps/download'u+2n
+.TP
 .B @FONTDIR@/devps/DESC
 Device description file.
 .
diff --git a/src/utils/indxbib/indxbib.1.man b/src/utils/indxbib/indxbib.=
1.man
index 66aa17f..1dd1052 100644
--- a/src/utils/indxbib/indxbib.1.man
+++ b/src/utils/indxbib/indxbib.1.man
@@ -231,7 +231,7 @@ is 6.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.TP \w'\fBindxbib\fIXXXXXX'u+2n
+.TP
 .IB filename @INDEX_SUFFIX@
 Index.
 .
diff --git a/src/utils/lkbib/lkbib.1.man b/src/utils/lkbib/lkbib.1.man
index 2d87d39..5e3e831 100644
--- a/src/utils/lkbib/lkbib.1.man
+++ b/src/utils/lkbib/lkbib.1.man
@@ -26,17 +26,6 @@ lkbib \- search bibliographic databases
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.\" Definitions
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.  ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.  el .TP "\\$1"
-..
-.
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
@@ -129,7 +118,7 @@ is\~6.
 .SH ENVIRONMENT
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.TP \w'\fBREFER'u+2n
+.TP
 .SB REFER
 Default database.
 .
@@ -138,7 +127,7 @@ Default database.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'\fB@DEFAULT_INDEX@'u+2n
+.TP
 .B @DEFAULT_INDEX@
 Default database to be used if the
 .SB REFER
diff --git a/src/utils/lookbib/lookbib.1.man b/src/utils/lookbib/lookbib.=
1.man
index 41c5200..7e4b232 100644
--- a/src/utils/lookbib/lookbib.1.man
+++ b/src/utils/lookbib/lookbib.1.man
@@ -98,7 +98,7 @@ is\~6.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.TP \w'\fIfilename\fB@INDEX_SUFFIX@'u+2n
+.TP
 .IB filename @INDEX_SUFFIX@
 Index files.
 .
diff --git a/src/utils/tfmtodit/tfmtodit.1.man b/src/utils/tfmtodit/tfmto=
dit.1.man
index e2dd871..c6126c0 100644
--- a/src/utils/tfmtodit/tfmtodit.1.man
+++ b/src/utils/tfmtodit/tfmtodit.1.man
@@ -31,12 +31,6 @@ tfmtodit \- create font files for use with groff \-Tdv=
i
 .
 .ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
 .el .ds tx TeX
-.\" Like TP, but if specified indent is more than half
-.\" the current line-length - indent, use the default indent.
-.de Tp
-.ie \\n(.$=3D0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
-.el .TP "\\$1"
-..
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -223,7 +217,7 @@ commands giving additional font metric information.
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.Tp \w'\fB@FONTDIR@/devdvi/DESC'u+2n
+.TP
 .B @FONTDIR@/devdvi/DESC
 Device description file.
 .


From MAILER-DAEMON Mon Jun 18 03:20:54 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUoT8-0003iT-CC
	for mharc-groff-commit@gnu.org; Mon, 18 Jun 2018 03:20:54 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:47698)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUoT5-0003iB-W3
	for groff-commit@gnu.org; Mon, 18 Jun 2018 03:20:52 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUoT4-0000xP-SU
	for groff-commit@gnu.org; Mon, 18 Jun 2018 03:20:51 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:45942)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUoT4-0000xI-PD
	for groff-commit@gnu.org; Mon, 18 Jun 2018 03:20:50 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 98F9120890; Mon, 18 Jun 2018 03:20:50 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 02/02: groff_man(7): Update discussion of \c and \f.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180618072049.23442.24092@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 39be7446fd2ccb3c32dc89ebbb35b037d259d3fa
Auto-Submitted: auto-generated
Message-Id: <20180618072050.98F9120890@vcs0.savannah.gnu.org>
Date: Mon, 18 Jun 2018 03:20:50 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 18 Jun 2018 07:20:53 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 39be7446fd2ccb3c32dc89ebbb35b037d259d3fa
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Mon Jun 18 03:14:15 2018 -0400

    groff_man(7): Update discussion of \c and \f.
   =20
    Share the lesson learned from Savannah #53795.
   =20
    Document interaction of .BI and .RI macros with italic corrections an=
d
    use of \c escape in final (if even-numbered) macro arguments.
   =20
    Slightly clarify which argument is meant when discussing .TP; it's no=
t
    the optional one on the same line, but the one on the next line.
   =20
    Recast software package names in a more prosaic way, instead of
    a tar-file-ish one.
   =20
    Get rid of a stray .sp request.
   =20
    Admit that anyone who wants italic corrections is going to have to gi=
ve
    up some portability (presumably).
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 tmac/groff_man.7.man | 54 ++++++++++++++++++++++++++++++++++++++++++++++=
------
 1 file changed, 48 insertions(+), 6 deletions(-)

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index de9db81..8329120 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -1385,16 +1385,46 @@ in a single word, for example:
 .RE
 .
 .IP
+Note that when using this trick with the
+.B .BI
+or
+.B .RI
+macros, you will need to manually add an italic correction escape
+.B \e/
+before the
+.B \ec
+due to way macros expand their arguments.
+.
+.
+.RS
+.IP
+.EX
+Files processed with
+\&.B groff \e\-mom
+(or
+\&.BI "\e\-m " mom\e/\ec
+) produce PostScript output by default.
+.EE
+.RE
+.
+.
+.IP
 Alternatively, and perhaps with better portability, the
 .B \ef
 font escape sequence can be used; see below.
-.sp
+.
 Attempting to use
 .B \ec
-to include the output from more than one macro line into the head of a
+to include the output from more than one macro line into the next-line
+argument of a
 .B .TP
-macro will misrender with groff-1.22.3, mandoc-1.14.1, older versions of
-these programs, and perhaps with some other formatters.
+macro will misrender with
+.I groff
+1.22.3,
+.I mandoc
+1.14.1,
+older versions of these programs,
+and perhaps with some other formatters.
 .
 .TP
 .B \ee
@@ -1429,9 +1459,21 @@ It can also be used if three different fonts are n=
eeded in a
 single word.
 It may be more portable than
 .BR \ec .
+.
+It is up to you to account for italic corrections with
+.B \e/
+and
+.BR \e, ,
+which are themselves
+.I groff
+extensions,
+if desired and if supported by your implementation.
+.
+.
 .IP
-As long as only two fonts are needed, using font alternation
-macros like
+As long as at most two fonts are needed in any one whitespace-delimited
+word,
+using font alternation macros like
 .B .BR
 usually results in more readable source code.
 .


From MAILER-DAEMON Mon Jun 18 03:20:54 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUoT8-0003iX-FL
	for mharc-groff-commit@gnu.org; Mon, 18 Jun 2018 03:20:54 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:47700)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUoT6-0003iC-0k
	for groff-commit@gnu.org; Mon, 18 Jun 2018 03:20:53 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUoT4-0000xW-Tx
	for groff-commit@gnu.org; Mon, 18 Jun 2018 03:20:52 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:45940)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUoT4-0000xG-P3
	for groff-commit@gnu.org; Mon, 18 Jun 2018 03:20:50 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 733D120545; Mon, 18 Jun 2018 03:20:50 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/02: man pages: Add italic correction before '\c'.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
In-Reply-To: groff@gnu.org
References: <20180618072049.23442.24092@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 7823c1ca9e095f0e9bb1b6e07d979aae7695514c
Auto-Submitted: auto-generated
Message-Id: <20180618072050.733D120545@vcs0.savannah.gnu.org>
Date: Mon, 18 Jun 2018 03:20:50 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 18 Jun 2018 07:20:53 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 7823c1ca9e095f0e9bb1b6e07d979aae7695514c
Author: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Date:   Mon Apr 30 21:30:32 2018 +0000

    man pages: Add italic correction before '\c'.
   =20
    The italic correction '\/' in the macros 'I', '[BR]I', and 'I[BR]' is
    ignored if it is applied after a '\c' escape in an argument.
   =20
    Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
   =20
    "\c works on the output level. Anything after this escape on the same
    line is ignored except \R, which works as usual." (_The GNU Troff
    Manual_, section 5.14, "Line Control")
   =20
    Manually restore the italic correction where applicable.
   =20
    And even where it's not; the next thing output after the italic
    correction in the chem.1 and groff_man.1 cases is a space, which does
    not receive an italic correction.  But it's harmless, seems better to
    have it for pedagogical (or cargo-cult) reasons, and is more robust
    against future changes that may put a glyph where the space had been.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 contrib/chem/chem.1.man     |  4 ++--
 contrib/mom/groff_mom.7.man |  2 +-
 man/groff_font.5.man        | 10 +++++-----
 src/roff/groff/groff.1.man  |  2 +-
 tmac/groff_man.7.man        |  2 +-
 tmac/groff_me.7.man         |  2 +-
 6 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/contrib/chem/chem.1.man b/contrib/chem/chem.1.man
index d6242df..28e4290 100644
--- a/contrib/chem/chem.1.man
+++ b/contrib/chem/chem.1.man
@@ -443,8 +443,8 @@ puts a circle into any kind of ring.
 .RB [ \%aromatic ]
 .RB [ put\ Mol\ at\ \fIn\/\fP ]
 .RB [ \%double\ \c
-.IR i , j\ \c
-.IR k , l\ \c
+.IR i , j\ \/\c
+.IR k , l\ \/\c
 \*(EL
 .RI [ picstuff ]
 .YS
diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index d1f6a13..e2fd49d 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -160,7 +160,7 @@ images.
 Files processed with
 .B groff \-mom
 (or
-.BI "\-m " mom\c
+.BI "\-m " mom\/\c
 ) produce
 .I PostScript
 output by default.
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 207ead4..e239826 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -37,7 +37,7 @@ font format.
 The font files for device
 .I name
 are stored in a directory
-.BI dev name\c
+.BI dev name\/\c
 \&.
 .
 There are two types of file: a device description file called
@@ -568,12 +568,12 @@ field has the form (in one line; it is broken here =
for the sake of
 readability):
 .
 .IP
-.I width\c
-.RI [\fB, height\c
-.RI [\fB, depth\c
+.I width\/\c
+.RI [\fB, height\/\c
+.RI [\fB, depth\/\c
 .RI [\fB, italic-correction
 .br
-.RI [\fB, left-italic-correction\c
+.RI [\fB, left-italic-correction\/\c
 .RI [\fB, subscript-correction ]]]]]
 .
 .LP
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index b965ffb..948f956 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -706,7 +706,7 @@ Process standard input after the specified input file=
s.
 Include macro file
 .IB name .tmac
 (or
-.BI tmac. name\c
+.BI tmac. name\/\c
 ); see also
 .BR \%groff_tmac (@MAN5EXT@).
 .
diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 80b4fbb..de9db81 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -851,7 +851,7 @@ running text.
 .
 .
 .TP
-.BI .OP " option-name"\c
+.BI .OP " option-name"\/\c
 .RI " [" option-argument ]
 Indicate an optional command parameter called
 .IR option-name .
diff --git a/tmac/groff_me.7.man b/tmac/groff_me.7.man
index c235e74..e5e7fad 100644
--- a/tmac/groff_me.7.man
+++ b/tmac/groff_me.7.man
@@ -107,7 +107,7 @@ string arguments with uppercase.
 An optional macro argument such as
 .I x
 appears in brackets,
-.BI [ x \c
+.BI [ x \/\c
 .BR ] .
 .
 Note that arguments to macros generally must be quoted if they contain


From MAILER-DAEMON Mon Jun 18 04:02:26 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fUp7K-0000dk-5z
	for mharc-groff-commit@gnu.org; Mon, 18 Jun 2018 04:02:26 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54503)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUp7E-0000dc-RF
	for groff-commit@gnu.org; Mon, 18 Jun 2018 04:02:25 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUp7B-000185-3H
	for groff-commit@gnu.org; Mon, 18 Jun 2018 04:02:20 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:46470)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fUp7A-000181-Vb
	for groff-commit@gnu.org; Mon, 18 Jun 2018 04:02:17 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 6EBF9203CB; Mon, 18 Jun 2018 04:02:16 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: groff(7): Expand explanation of \c.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180618080215.14594.70548@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: e5c1ab4b8e601cc1e220701cf79ed3b52d38202e
Auto-Submitted: auto-generated
Message-Id: <20180618080216.6EBF9203CB@vcs0.savannah.gnu.org>
Date: Mon, 18 Jun 2018 04:02:16 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 18 Jun 2018 08:02:25 -0000

gbranden pushed a commit to branch master
in repository groff.

commit e5c1ab4b8e601cc1e220701cf79ed3b52d38202e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Mon Jun 18 04:00:51 2018 -0400

    groff(7): Expand explanation of \c.
   =20
    Borrow and adapt language from groff.texi's "Line Control" section.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 man/groff.7.man | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index 2667b45..facc170 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2991,7 +2991,16 @@ to\~0 otherwise.
 .
 .TP
 .ESC c
-Interrupt text processing.
+Continue output line at next input line.
+Anything after this escape on the same line is ignored except
+.ESC R
+(which works as usual).
+Anything before
+.ESC c
+on the same line is appended to the current partial output line.
+The next non-command line after a line interrupted with
+.ESC c
+counts as a new input line.
 .
 .TP
 .ESCq C glyph


From MAILER-DAEMON Tue Jun 19 07:11:34 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fVEXu-0003TC-1r
	for mharc-groff-commit@gnu.org; Tue, 19 Jun 2018 07:11:34 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56370)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1fVEXs-0003T5-Dr
	for groff-commit@gnu.org; Tue, 19 Jun 2018 07:11:33 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1fVEXr-0005Tm-76
	for groff-commit@gnu.org; Tue, 19 Jun 2018 07:11:32 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:47330)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1fVEXr-0005Te-3R
	for groff-commit@gnu.org; Tue, 19 Jun 2018 07:11:31 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 126928)
	id E3D47201B3; Tue, 19 Jun 2018 07:11:30 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: Add gropdf new features to NEWS file.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: Deri James <deri@chuzzlewit.myzen.co.uk>
In-Reply-To: groff@gnu.org
References: <20180619111130.1307.81907@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: a3c62d4396f7ac468d41185e03c0d6cbd20fb3db
Auto-Submitted: auto-generated
Message-Id: <20180619111130.E3D47201B3@vcs0.savannah.gnu.org>
Date: Tue, 19 Jun 2018 07:11:30 -0400 (EDT)
From: deri@chuzzlewit.myzen.co.uk (Deri James)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 19 Jun 2018 11:11:33 -0000

deri pushed a commit to branch master
in repository groff.

commit a3c62d4396f7ac468d41185e03c0d6cbd20fb3db
Author: Deri James <deri@chuzzlewit.myzen.co.uk>
Date:   Tue Jun 19 12:10:09 2018 +0100

    Add gropdf new features to NEWS file.
   =20
    * NEWS: new features.
---
 ChangeLog |  8 +++++++-
 NEWS      | 15 +++++++++++++++
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index 7903040..fa85365 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2018-06-19  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Add gropdf new features to NEWS file.
+
+	* NEWS: new features.
+
 2018-05-29  Werner LEMBERG  <wl@gnu.org>
=20
 	[dvi] Fix glyph map for `cmitt10'.
@@ -96,7 +102,7 @@
=20
 2018-04-24  Deri James  <deri@chuzzlewit.myzen.co.uk>
=20
-	Restrict scaling factors to 3dp and better handle CR/LF in imoport.
+	Restrict scaling factors to 3dp and better handle CR/LF in import.
=20
 	* src/devices/gropdf/gropdf.pl: Restrict scaling factors to 3dp
 	rounded. If pdf imported with pdfpic uses CR/LF line termination
diff --git a/NEWS b/NEWS
index 9cd1750..71af08a 100644
--- a/NEWS
+++ b/NEWS
@@ -46,6 +46,20 @@ o PDFPIC has now been corrected, so the behaviour is t=
he same whether you
   postscript driver, only if you used it with the pdf driver.
=20
=20
+Gropdf
+------
+
+  o Type 1 font loading fixed to handle newer ghostscript versions.
+
+  o Handling of glyphs above position 255 improved to allow many more gl=
yphs
+    to be used.
+
+  o New macros .pdftransition and .pdfpause introduced to allow creation=
 of
+    presentation slides. Partially backward compatible with present.tmac=
,
+    specifically the PAUSE, BLOCKS and BLOCKE commands. Supports all the
+    transition types introduced in PDF v1.5. (See gropdf man page)
+
+
 Miscellaneous
 -------------
=20
@@ -66,6 +80,7 @@ o eqn2graph no longer supports the "-unsafe" option.  I=
t did nothing.
 o groffer now supports the output of XHTML.  Use the "--xhtml" or
   "--mode=3Dxhtml" command-line options to generate it.
=20
+
 VERSION 1.22.3
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20


From MAILER-DAEMON Tue Jun 19 18:45:47 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fVPNj-0003ga-3G
	for mharc-groff-commit@gnu.org; Tue, 19 Jun 2018 18:45:47 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:39773)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bertrand.garrigues@laposte.net>) id 1fVPNg-0003fH-JS
	for groff-commit@gnu.org; Tue, 19 Jun 2018 18:45:45 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bertrand.garrigues@laposte.net>) id 1fVPNf-0003Vn-P8
	for groff-commit@gnu.org; Tue, 19 Jun 2018 18:45:44 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:56793)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bertrand.garrigues@laposte.net>) id 1fVPNf-0003VX-KS
	for groff-commit@gnu.org; Tue, 19 Jun 2018 18:45:43 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 132203)
	id 467702012E; Tue, 19 Jun 2018 18:45:43 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: Typo in 'doc/groff.texi'.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: Bertrand Garrigues <bertrand.garrigues@laposte.net>
In-Reply-To: groff@gnu.org
References: <20180619224542.15080.14002@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 6d86b9a21baf8082f24225746e6ac2796256f584
Auto-Submitted: auto-generated
Message-Id: <20180619224543.467702012E@vcs0.savannah.gnu.org>
Date: Tue, 19 Jun 2018 18:45:42 -0400 (EDT)
From: bertrand.garrigues@laposte.net (Bertrand Garrigues)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 19 Jun 2018 22:45:45 -0000

bgarrigues pushed a commit to branch master
in repository groff.

commit 6d86b9a21baf8082f24225746e6ac2796256f584
Author: Bertrand Garrigues <bertrand.garrigues@laposte.net>
Date:   Wed Jun 20 00:42:39 2018 +0200

    Typo in 'doc/groff.texi'.
   =20
    Reported by Dave Kemper <saint.snit@gmail.com>
---
 doc/groff.texi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 07002b2..f7de636 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -16705,7 +16705,7 @@ called@tie{}@file{@var{f}}.
 @pindex DESC@r{ file format}
=20
 The @file{DESC} file can contain the following types of line.  Except
-for the @code{charset} keyword, which must comes last (if at all), the
+for the @code{charset} keyword, which must come last (if at all), the
 order of the lines is not important.  Later entries in the file,
 however, override previous values.
=20


From MAILER-DAEMON Thu Jun 21 06:31:55 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fVwsd-00010e-Mk
	for mharc-groff-commit@gnu.org; Thu, 21 Jun 2018 06:31:55 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:56033)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fVwsa-0000zp-Jr
	for groff-commit@gnu.org; Thu, 21 Jun 2018 06:31:53 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fVwsZ-0005ft-8J
	for groff-commit@gnu.org; Thu, 21 Jun 2018 06:31:52 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:43171)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fVwsZ-0005fp-4H
	for groff-commit@gnu.org; Thu, 21 Jun 2018 06:31:51 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id E4E2A206C7; Thu, 21 Jun 2018 06:31:49 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: NEWS: Make editorial corrections.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180621103149.27311.51923@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 73cc853c844be7ee1f34bc96ce24a433b96b215a
Auto-Submitted: auto-generated
Message-Id: <20180621103150.E4E2A206C7@vcs0.savannah.gnu.org>
Date: Thu, 21 Jun 2018 06:31:49 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 21 Jun 2018 10:31:53 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 73cc853c844be7ee1f34bc96ce24a433b96b215a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Jun 21 06:28:03 2018 -0400

    NEWS: Make editorial corrections.
   =20
    * Bump copyright range end year.
    * Give "PostScript", "Ghostscript", and "PDF" the letter-casing their
      progenitors prescribe.
    * "PDFPIC has now been corrected" -> "PDFPIC has been corrected"
    * Remove unnecessary comma.
    * "0behavior:-" -> "behaviour:"
    * Remove space between option dash and "rPDFPIC_NOSPACE=3D1".
    * Replace comma with em-dash for break in prose.
    * Add verbs to descriptions of gropdf changes.
    * Hyphenate adjective phrase "backward-compatible".
    * Pull parenthetical cross references inside sentences and do not
      capitalize them as if they were sentences.
    * Make indentation of gropdf news consistent with the other items.
    * Turn a giant noun clause about the new configure option into a
      sentence.
   =20
    Thanks to Ralph Corderoy for the discussion and Bertrand Garrigues fo=
r
    the encouragement to not go on a commit fast. :)
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 NEWS | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/NEWS b/NEWS
index 71af08a..0e9296f 100644
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-    Copyright (C) 1992-2014 Free Software Foundation, Inc.
+    Copyright (C) 1992-2018 Free Software Foundation, Inc.
=20
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
@@ -22,50 +22,50 @@ o The `hy' request has been extended.  Value 16 enabl=
es hyphenation before
 PDFPIC
 ------
=20
-o PDFPIC has now been corrected, so the behaviour is the same whether yo=
u
-  use the postscript or pdf drivers. However, this means that any docume=
nts
-  which were written using the old behaviour will not be rendered correc=
tly
-  if using the pdf driver with the new version.
+o PDFPIC has been corrected so the behaviour is the same whether you use=
 the
+  PostScript or PDF drivers.  However, this means that any documents whi=
ch
+  were written using the old behaviour will not be rendered correctly if
+  using the PDF driver with the new version.
=20
   The change would mean that documents which relied on the previous
   behaviour are likely to have a gap underneath the image which was not
   there before.  If you see this effect there are three ways you can res=
tore
-  the previous 0behaviour:-
+  the previous behaviour:
=20
   Add the line ".nr PDFPIC_NOSPACE 1" to the document before the first c=
all
   to .PDFPIC.
=20
   If it is just a single document which exhibits this behaviour you can =
run
-  groff adding "- rPDFPIC_NOSPACE=3D1" to the command-line.
+  groff adding "-rPDFPIC_NOSPACE=3D1" to the command line.
=20
   If you have many documents which rely on the previous behaviour you ca=
n
   set an environment variable "export GROFF_PDFPIC_NOSPACE=3D1" which wi=
ll
   restore the previous behaviour for all runs.
=20
   Note that this change has no effect it you were using .PDFPIC with the
-  postscript driver, only if you used it with the pdf driver.
+  PostScript driver--only if you used it with the PDF driver.
=20
=20
 Gropdf
 ------
=20
-  o Type 1 font loading fixed to handle newer ghostscript versions.
+o Type 1 font loading is fixed to handle newer Ghostscript versions.
=20
-  o Handling of glyphs above position 255 improved to allow many more gl=
yphs
-    to be used.
+o Handling of glyphs above position 255 is improved to allow many more
+  glyphs to be used.
=20
-  o New macros .pdftransition and .pdfpause introduced to allow creation=
 of
-    presentation slides. Partially backward compatible with present.tmac=
,
-    specifically the PAUSE, BLOCKS and BLOCKE commands. Supports all the
-    transition types introduced in PDF v1.5. (See gropdf man page)
+o New macros .pdftransition and .pdfpause are introduced to allow creati=
on
+  of presentation slides.  Partially backward-compatible with present.tm=
ac,
+  specifically the PAUSE, BLOCKS and BLOCKE commands.  Supports all the
+  transition types introduced in PDF v1.5 (see the gropdf man page).
=20
=20
 Miscellaneous
 -------------
=20
-o New 'configure' option --with-compatibility-wrappers to control how gr=
off
+o A new 'configure' option --with-compatibility-wrappers controls how gr=
off
   compatibility wrappers for vendor-provided non-GNU macro sets are
-  installed (See: ./configure --help).
+  installed (see ./configure --help).
=20
 o eqn2graph, grap2graph, and pic2graph now attempt to adapt to very old
   installed versions of the ImageMagick and GraphicsMagick programs
@@ -150,7 +150,7 @@ o New default values for hyphenation.  The previous v=
alues were too strict,
   suppressing some hyphenation points unnecessarily.
=20
 o The -mom macro package now has full support for eqn, pic, and tbl, as =
well
-  as captioning and labelling of pdf images and preprocessor output.  Li=
sts
+  as captioning and labelling of PDF images and preprocessor output.  Li=
sts
   of Figures, Equations, and Tables can now be autogenerated.  PDF_IMAGE=
 has
   a new FRAME option.
=20


From MAILER-DAEMON Thu Jun 21 08:21:41 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fVyar-000645-IF
	for mharc-groff-commit@gnu.org; Thu, 21 Jun 2018 08:21:41 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:50806)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fVyap-00063v-OI
	for groff-commit@gnu.org; Thu, 21 Jun 2018 08:21:40 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fVyao-0006Rb-Ps
	for groff-commit@gnu.org; Thu, 21 Jun 2018 08:21:39 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:44115)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fVyao-0006RR-M2
	for groff-commit@gnu.org; Thu, 21 Jun 2018 08:21:38 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 95D8E20372; Thu, 21 Jun 2018 08:21:38 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 02/02: groff_man(7): Add NOTES section to aid authors.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180621122137.11016.79@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: db0c2bb27142ddc6286f6224852fadbd2ac7d82a
Auto-Submitted: auto-generated
Message-Id: <20180621122138.95D8E20372@vcs0.savannah.gnu.org>
Date: Thu, 21 Jun 2018 08:21:38 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 21 Jun 2018 12:21:40 -0000

gbranden pushed a commit to branch master
in repository groff.

commit db0c2bb27142ddc6286f6224852fadbd2ac7d82a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Jun 21 08:16:14 2018 -0400

    groff_man(7): Add NOTES section to aid authors.
   =20
    Discuss asymmetry of .RS/.RE arguments and their consequences when
    misunderstood.  This came up recently in the quilt(1) man page and I
    know I've seen it multiple times before.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 tmac/groff_man.7.man | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 2499ba6..5c06e2a 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -1551,6 +1551,45 @@ Local changes and customizations should be put int=
o this file.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SH NOTES
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
+Some tips on troubleshooting your man pages follow.
+
+.TP
+.RB \(bu " .RE" " doesn't reset the indent to the expected level
+.TQ
+\(bu warning: scale indicator invalid in this context
+.TQ
+\(bu warning: number register 'an\-saved\-margin2' not defined
+.TQ
+\(bu warning: number register 'an\-saved\-prevailing\-indent2' not \
+defined
+The
+.B .RS
+macro takes an indentation
+.I amount
+as an argument;
+the
+.B .RE
+macro's argument is an indentation
+.IR level .
+In other words,
+.BR .RE 's
+argument tells it the number of previous
+.B .RS
+calls you want to undo.
+.
+If you desire symmetry in your macro calls,
+simply issue one
+.B .RE
+without an argument
+for each
+.B .RS
+that precedes it.
+.
+.
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH AUTHORS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 The GNU version of the


From MAILER-DAEMON Thu Jun 21 08:21:42 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fVyas-00064a-LX
	for mharc-groff-commit@gnu.org; Thu, 21 Jun 2018 08:21:42 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:50802)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fVyap-00063u-IW
	for groff-commit@gnu.org; Thu, 21 Jun 2018 08:21:41 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fVyao-0006RV-Nj
	for groff-commit@gnu.org; Thu, 21 Jun 2018 08:21:39 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:44113)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fVyao-0006RJ-KL
	for groff-commit@gnu.org; Thu, 21 Jun 2018 08:21:38 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 78D0720349; Thu, 21 Jun 2018 08:21:38 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/02: groff_man(7): Make clarifications.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180621122137.11016.79@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 42ba74da04e9ac7de142afc39ddebdd2fa8fc7f9
Auto-Submitted: auto-generated
Message-Id: <20180621122138.78D0720349@vcs0.savannah.gnu.org>
Date: Thu, 21 Jun 2018 08:21:38 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 21 Jun 2018 12:21:41 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 42ba74da04e9ac7de142afc39ddebdd2fa8fc7f9
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Jun 21 08:13:05 2018 -0400

    groff_man(7): Make clarifications.
   =20
    * .SY/.YS: Turns off and restores hyphenation.
    * Fix clunky language in mixed subjunctive and declarative moods.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 tmac/groff_man.7.man | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 8329120..2499ba6 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -873,12 +873,14 @@ is set with a hanging indentation of the width of
 .I command
 plus a space.
 .
+Hyphenation is turned off.
+.
 .
 .TP
 .B .YS
 End synopsis.
 .
-Restore normal indentation.
+Restores indentation and hyphenation to previous values.
 .
 .
 .PP
@@ -991,8 +993,8 @@ Some man pages use a brace-and-pipe notation such as
 to indicate that one and only one of the \(lq|\(rq-separated items
 within the braces must be input.
 .
-If this braced construct were furthermore surrounded by brackets,
-then the meaning is that at most one of the items would be accepted.
+If this braced construct is furthermore surrounded by square brackets,
+it means that at most one of the items is accepted.
 .
 .
 .IP


From MAILER-DAEMON Fri Jun 22 10:24:27 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fWMzD-0007lj-DN
	for mharc-groff-commit@gnu.org; Fri, 22 Jun 2018 10:24:27 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:42591)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fWMz8-0007jN-Aq
	for groff-commit@gnu.org; Fri, 22 Jun 2018 10:24:26 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fWMz6-0004Qk-1R
	for groff-commit@gnu.org; Fri, 22 Jun 2018 10:24:22 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:59977)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fWMz5-0004Qg-T6
	for groff-commit@gnu.org; Fri, 22 Jun 2018 10:24:19 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id A80FF20548; Fri, 22 Jun 2018 10:24:19 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: gpinyin(1): Make many editorial fixes.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180622142418.19386.73715@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: cbcabe4acecb6bb327762ec8484784c45efc14ef
Auto-Submitted: auto-generated
Message-Id: <20180622142419.A80FF20548@vcs0.savannah.gnu.org>
Date: Fri, 22 Jun 2018 10:24:19 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 22 Jun 2018 14:24:26 -0000

gbranden pushed a commit to branch master
in repository groff.

commit cbcabe4acecb6bb327762ec8484784c45efc14ef
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Fri Jun 22 10:00:00 2018 -0400

    gpinyin(1): Make many editorial fixes.
   =20
    * Improve summary with more keywords.
    * Kill off nearly meaningless phrase "European-like" in favor of
      more informative references to romanization and the Latin alphabet.
    * Put all operation modes in SYNOPSIS section.
    * Remove unnecessary suppression of hyphenation from .SY/.YS regions.
    * Borrow string definition for TeX logo from other groff man pages,
      since TeX is mentioned.
    * Relocate most of the description of the preprocessor to the
      Description section.
    * Relocate the OPTIONS section to follow the main discussion of the
      preprocessor.
    * Fix incorrect escape in examples.
    * Use quotation marks instead of boldface for most literals in runnin=
g
      prose.  Generally, typographers agree that boldface should be used
      sparingly.
    * Recast most of the English prose.
    * Add descriptions of the first four tones.
    * Change description of the fifth tone from "no-tone" to "neutral";
      every resource in English that I have seen uses the latter term.
    * Move discussion of the tones into a table, to eliminate repeated
      syntactically-parallel sentences.
    * Eliminate non-ASCII characters from input.  Update Emacs settings.
    * Comment out dead URL in SEE ALSO section.
    * Put Pinyin-related Web resources first in the SEE ALSO section,
      followed by man page cross references.
    * Follow bibliographic conventions more closely when identifying
      external resources; only work titles belong in italics.  Names of
      articles or pages at specific sites are usually simply quoted.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 contrib/gpinyin/gpinyin.1.man | 366 +++++++++++++++++++-----------------=
------
 1 file changed, 164 insertions(+), 202 deletions(-)

diff --git a/contrib/gpinyin/gpinyin.1.man b/contrib/gpinyin/gpinyin.1.ma=
n
index 84aa80d..b8d821c 100644
--- a/contrib/gpinyin/gpinyin.1.man
+++ b/contrib/gpinyin/gpinyin.1.man
@@ -1,12 +1,11 @@
+'\" t
 .TH GPINYIN @MAN1EXT@ "@MDATE@" "groff @VERSION@"
 .SH NAME
-gpinyin \- Chinese European-like writing within groff
+gpinyin \- use Hanyu Pinyin Chinese in roff
 .
 .SH "SYNOPSIS"
 .\" The .SH was moved to this place in order to appease 'apropos'.
 .
-.\" TODO: This page needs a thorough edit by a native English speaker.
-.
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .\" Legalese
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -24,14 +23,16 @@ gpinyin \- Chinese European-like writing within groff
 .\" <http://www.gnu.org/licenses/gpl-2.0.html>.
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.\" Characters
+.\" Local definitions
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
+.\" Define a string for the TeX logo.
+.ie t .ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
+.el   .ds TeX TeX
+.
+.\" Define a string for an ellipsis.
 .ie t .ds EL \f[S]\N'188'\f[P]\"
 .el .ds EL \&.\|.\|.\&\"
-.\" ie t .char \[Ellipsis] \f[S]\N'188'\f[P]
-.\" el .char \[Ellipsis] \&.\|.\|.\&\
-.\" called with \[Ellipsis]
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -39,257 +40,215 @@ gpinyin \- Chinese European-like writing within gro=
ff
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY gpinyin
-.OP \-
-.OP \-\-
-.OP "\%filespec \*(EL"
+.RI [ input-file
+\*(EL]
 .YS
 .
-.BR "gpinyin \-h" | \-\-help
-.br
-.BR "gpinyin \-v" | \-\-version
+.SY gpinyin
+.B \-h
+.SY gpinyin
+.B \-\-help
+.YS
+.
+.SY gpinyin
+.B \-v
+.SY gpinyin
+.B \-\-version
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-This is a preprocessor for
-.BR \%groff (@MAN1EXT@).
-.
-It allows use of the Chinese European-like language
-.I Pinyin
-into
+.B gpinyin
+is a preprocessor for
+.BR \%groff (@MAN1EXT@)
+that facilitates use of the Hanyu Pinyin
 .BR groff (7)
 files.
 .
+Pinyin is a method for writing the Chinese language with the Latin
+alphabet.
 .
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH "OPTIONS"
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SS "Breaking Options"
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
-An option is
-.IR breaking ,
-when the program just writes the information that was asked for and
-then stops.
-.
-All other arguments will be ignored by that.
-.
-The
-.I breaking
-options are here
-.
-.TP
-.B \-h\~\fR|\fB\~\-\-help
-Print help information with a short explanation of options to standard
-output.
-.
-.
-.TP
-.B \-v\~\fR|\fB\~\-\-version
-Print version information to standard output.
+The Chinese language consists of more than four hundred syllables,
+each with one of five different tones.
 .
-.
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SS "Filespec Options"
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
-So far, there are only
-.I filespec
-and
-.I breaking
-options.
+In Pinyin,
+a syllable is written in the Latin alphabet and a numeric tone indicator
+can be appended to each syllable.
 .
 .
 .P
-.I filespec
-arguments are file names or the minus sign
-.B \-
-for standard input.
+Each
+.I input-file
+is a file name or the hyphen-minus character \[lq]\-\[rq] to indicate
+that standard input should be read.
 .
-As usual, the argument
-.B \-\-
-can be used in order to let all following arguments mean file names,
-even if the names begin with a minus character
-.BR \- .
+As usual,
+the argument \[lq]\-\-\[rq] can be used in order to force interpretation
+of all remaining arguments as file names,
+even if an
+.I input-file
+argument begins with the hyphen-minus character.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH "PINYIN PARTS"
+.SS "Pinyin Sections"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.I Pinyin
-parts in
-.I groff files
-are enclosed by two
+Pinyin sections in
+.I groff
+files are enclosed by two
 .B .pinyin
 requests with different arguments.
 .
 The starting request is
 .RS
 .EX
-\e.pinyin start
+\&.pinyin start
 .EE
 .RE
 or
 .RS
 .EX
-\e.pinyin begin
+\&.pinyin begin
 .EE
 .RE
 and the ending request is
 .RS
 .EX
-\e.pinyin stop
+\&.pinyin stop
 .EE
 .RE
 or
 .RS
 .EX
-\e.pinyin end
+\&.pinyin end
 .EE
 .RE
-.
-.
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH "PINYIN DETAILS"
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
-.I Pinyin
-is used for writing the Chinese language in a European-like
-(romanization) way.
-.
-The Chinese language consists of more than 400 syllables, each with
-one of 5 different tones.
-.
-In
-.IR Pinyin ,
-such toned syllables can be appended to word-like connections.
+\&.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SS "Syllables"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-The Chinese language is based on about 411 defined
-.IR syllables ,
+The spoken Chinese language is based on about 411
+.IR syllables ;
 see
 .UR http://\:en.wikipedia.org/\:wiki/\:Pinyin_table
 .UE .
 .
 .
 .P
-In
-.IR Pinyin ,
-each syllable consists of 1 to 6 European-like letters, the normal
-ASCII characters in upper and lower case, the only unusual characters
-are the
-.BR "U dieresis " ( umlaut )
-in both cases, i.e.\&
-.BR [a\(enzA\(enZ=EF=BF=BD=EF=BF=BD] .
+In Pinyin,
+each syllable consists of one to six letters from the Latin alphabet;
+these letters comprise the fifty-two upper- and lowercase letters from
+the ASCII character set,
+plus the letter \[lq]U\[rq] with dieresis (umlaut) in both cases\[em]in
+other words,
+the members of the set \[lq][a\[en]zA\[en]Z\[:u]\[:U]]\[rq].
 .
 .
 .P
-In the
-.B groff gpinyin
+In
+.I groff
 input,
-all ASCII letters are written as usual.
+all ASCII letters are written as themselves.
 .
-But the
-.BR u / U
-.B dieresis
-can be written as either as
-.B \e[\[aq]u] or
-.B ue
-in lower case or
-.BR \e[\[aq]U] ,
-.BR Ue ,
-.B UE
-in upper case.
+The \[lq]u with dieresis\[rq] can be written as
+\[lq]\e[:u]\[rq]
+in lowercase or
+\[lq]\e[:U]\[rq]
+in uppercase.
+.
+Within
+.B .pinyin
+sections,
+.I gpinyin
+supports the form
+\[lq]ue\[rq]
+for lowercase and the forms
+\[lq]Ue\[rq]
+and
+\[lq]UE\[rq]
+for uppercase.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SS "Tones"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-Each syllable has exactly one of 5 defined
+Each syllable has exactly one of five
 .IR tones .
 .
-The 5th tone is not written at all, but each tone 1 to 4 is written
-as an accent above a defined vowel within the syllable.
+The fifth tone is not explicitly written at all,
+but each of the first through fourth tones is indicated with a diacritic
+above a specific vowel within the syllable.
 .
 .
 .P
-In the source file, these tones are written by adding a number 0 to 5
-after the syllable name.
+In a
+.I gpinyin
+source file,
+these tones are written by adding a numeral in the range 0 to 5 after
+the syllable.
 .
+The tone numbers 1 to 4 are transformed into accents above vowels in the
+output.
 .
-.P
-In each writing, the tone numbers 1 to 4 are transformed into accents
-above vowels.
-.
-.
-.P
-The 1st tone is the horizontal macron
-.BR \e[a\-]
-.B \[a-] ,
-similar to a minus or sub character, but on top of the vowel.
-.
-In each source file, write the 1st tone as
-.IB "syllable" 1\fR.
+The tone numbers 0 and 5 are synonymous.
 .
 .
 .P
-The 2nd tone is the accute accent
-.B \e[aa]
-.BR \[aa] .
+The following table summarizes the tones.
 .
-In each source file, write the 2nd tone as
-.IB "syllable" 2\fR.
+Some output devices will not be able to render every output example.
 .
 .
 .P
-The 3rd tone is the caron sign,
-.BR \e[ah]
-.B \[ah] ,
-which looks a bit like a small
-.B v
-above the vowel.
-.
-In each source file, write the 3rd tone as
-.IB "syllable" 3\fR.
+.if t .ne 8 \" Try to keep the table on one page for printed output.
+.TS
+l l l l l.
+Tone	Description	Diacritic	Example Input	Example Output
+_
+first	flat	\[a-]	ma1	m\[u0061_0304]
+second	rising	\[aa]	ma2	m\[u0061_0301]
+third	falling-rising	\[ah]	ma3	m\[u0061_030C]
+fourth	falling	\[ga]	ma4	m\[u0061_0300]
+fifth	neutral	(none)	ma0	ma
+\^	\^	\^	ma5	\^
+.TE
 .
 .
 .P
-The 4th tone is the grave accent
-.B \e[ga]
-.BR \[ga] .
-.
-In each source file, write the 4th tone as
-.IB "syllable" 4\fR.
+The neutral tone number can be omitted from a word-final syllable,
+but not otherwise.
 .
 .
-.P
-The 5th tone is the no-tone.
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SH OPTIONS
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-The numbers 0 and 5 can be used for the
-.BR ( no-tone ).
+.TP
+.B \-h
+.TQ
+.B \-\-help
+Print usage information and exit.
 .
-The
-.B no-tone
-number can be omitted, when the syllable is the end of some word.
 .
-But within a word of syllables, one of the
-.B no-tone
-numbers 0 or 5 must be written.
+.TP
+.B \-v
+.TQ
+.B \-\-version
+Print version information and exit.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH AUTHORS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
 .B gpinyin
 was written by
 .MT <groff\-bernd.warken\-72@\:web.de>
@@ -301,86 +260,89 @@ Bernd Warken
 .SH "SEE ALSO"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.BR \%groff (@MAN1EXT@),
-.BR \%grog (@MAN1EXT@),
-and
-.BR \%groffer (@MAN1EXT@)
-explain how to view
-.I roff
-documents.
-.
-.
-.P
-.BR \%groff (@MAN7EXT@)
-and
-.BR \%groff_char (@MAN7EXT@)
-are comprehensive references covering the language elements of GNU
-.I roff
-and the available glyph repetoire, respectively.
-.
-.
-.P
-Internet documents related to
-.I pinyin
-are
-.RS
+Useful documents on the World Wide Web related to Pinyin include
+.RS 4n
 .br
 .UR http://\:en.wikipedia.org/\:wiki/\:Pinyin
-.I Wikipedia pinyin
+\[lq]Pinyin\[rq] (Wikipedia)
 .UE ,
 .
 .br
 .UR http://\:en.wikipedia.org/\:wiki/\:Pinyin_table
-.I Pinyin Table
-.UE ,
-.
-.br
-.UR http://\:www.sino.uni\-heidelberg.de/\:course_resources/\:s02/\:\
-py\-vowels.htm
-.I Unicode vowels for Pinyin
+\[lq]Pinyin table\[rq] (Wikipedia)
 .UE ,
 .
+.\" XXX: dead link
+.\".br
+.\".UR http://\:www.sino.uni\-heidelberg.de/\:course_resources/\:s02/\:\
+.\"py\-vowels.htm
+.\".I Unicode vowels for Pinyin
+.\".UE ,
+.\".
 .br
 .UR http://\:www.foolsworkshop.com/\:ptou/\:index.html
-.I pinyin to Unicode
+.I Pinyin to Unicode
 .UE ,
 .
 .br
 .UR http://\:www.mandarintools.com/
-.I Online Chinese Tools
+.I On-line Chinese Tools
 .UE ,
 .
 .br
 .UR http://\:www.pinyin.info/\:index.html
-.I Main pinyin website
+.I Pinyin.info: a guide to the writing of Mandarin Chinese in \
+romanization
 .UE ,
 .
 .br
 .UR http://\:www.pinyin.info/\:rules/\:where.html
-.I Where do the tone marks go?
+\[lq]Where do the tone marks go?\[rq] (Pinyin.info)
 .UE ,
 .
 .br
 .UR http://\:git.savannah.gnu.org/\:gitweb/\:\
 ?p=3Dcjk.git;a=3Dblob_plain;f=3Ddoc/\:pinyin.txt;hb=3DHEAD
-.I Pinyin for TeX 1
+pinyin.txt from the CJK macro package for \*[TeX]
 .UE ,
+.br
+.RS -4n
+and
+.RE
 .
 .br
 .UR http://\:git.savannah.gnu.org/\:gitweb/\:\
 ?p=3Dcjk.git;a=3Dblob_plain;f=3Dtexinput/p\:inyin.sty;hb=3DHEAD
-.I Pinyin for TeX 2
+pinyin.sty from the CJK macro package for \*[TeX]
 .UE .
 .
 .RE
 .
+.P
+.BR \%groff (@MAN1EXT@),
+.BR \%grog (@MAN1EXT@),
+and
+.BR \%groffer (@MAN1EXT@)
+explain how to view
+.I roff
+documents.
+.
+.
+.P
+.BR \%groff (@MAN7EXT@)
+and
+.BR \%groff_char (@MAN7EXT@)
+are comprehensive references covering the language elements of GNU
+.I roff
+and the available glyph repertoire,
+respectively.
+.
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.\" Emacs settings
+.\" Editor settings
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .\" Local Variables:
 .\" mode: nroff
-.\" coding: latin-1
 .\" End:
 .\" vim: set filetype=3Dgroff:


From MAILER-DAEMON Mon Jun 25 21:06:52 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fXcRY-00047q-Ht
	for mharc-groff-commit@gnu.org; Mon, 25 Jun 2018 21:06:52 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51954)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <peter@schaffter.ca>) id 1fXcRW-00047W-Bd
	for groff-commit@gnu.org; Mon, 25 Jun 2018 21:06:51 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <peter@schaffter.ca>) id 1fXcRV-0002Le-8T
	for groff-commit@gnu.org; Mon, 25 Jun 2018 21:06:50 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:37313)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <peter@schaffter.ca>) id 1fXcRV-0002LV-49
	for groff-commit@gnu.org; Mon, 25 Jun 2018 21:06:49 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 71277)
	id D962D2052C; Mon, 25 Jun 2018 21:06:47 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: Fix centering of pic output.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: Peter Schaffter <peter@schaffter.ca>
In-Reply-To: groff@gnu.org
References: <20180626010646.9597.83389@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: d57ab4c989c0a804250e2cb6921e123b18bb2728
Auto-Submitted: auto-generated
Message-Id: <20180626010648.D962D2052C@vcs0.savannah.gnu.org>
Date: Mon, 25 Jun 2018 21:06:46 -0400 (EDT)
From: peter@schaffter.ca (Peter Schaffter)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 01:06:51 -0000

PTPi pushed a commit to branch master
in repository groff.

commit d57ab4c989c0a804250e2cb6921e123b18bb2728
Author: Peter Schaffter <peter@schaffter.ca>
Date:   Mon Jun 25 21:04:51 2018 -0400

    Fix centering of pic output.
---
 contrib/mom/BUGS    |  8 ++++++++
 contrib/mom/om.tmac | 11 +++++++----
 2 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/contrib/mom/BUGS b/contrib/mom/BUGS
index 2e1cc89..956fa0e 100644
--- a/contrib/mom/BUGS
+++ b/contrib/mom/BUGS
@@ -21,6 +21,14 @@ the Subject line or you risk my spam filters nuking yo=
ur message.
=20
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
+Version 2.3
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.PS/.PE not working at start of documents without a preceding .PP.
+---Fixed---
+
+Output of .PS/.PE not centered correctly (the default).
+---Fixed---
+
 Version 2.2-a
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 Omitting postfixed digit from ROMAN/roman args to LIST not
diff --git a/contrib/mom/om.tmac b/contrib/mom/om.tmac
index daea3b5..061dd1f 100644
--- a/contrib/mom/om.tmac
+++ b/contrib/mom/om.tmac
@@ -20,8 +20,8 @@ for more details.
 You should have received a copy of the GNU General Public License
 along with this program. If not, see <http://www.gnu.org/licenses/>.
=20
-Version 2.3
------------
+Version 2.3-a
+-------------
 Antoine de St-Exup=C3=A9ry asserted that elegance in engineering is
 achieved not when there is nothing left to add, but when there is
 nothing left to take away.
@@ -54,7 +54,7 @@ extensions, and float management).
 .if (\n[.x]\n[.y] < 118) \
 .   ab [mom]: You need GNU troff version 1.18 or higher to run this vers=
ion of mom.
 \# Mom version
-.ds version 2.2-a
+.ds version 2.3-a
 .if dVERSION \{\
 .   ab [mom]: Version \*[version]
 .\}
@@ -20921,6 +20921,7 @@ does not fit on page \\n[pgnum]\\*[col-num].
 \# Main macros
 \#
 .MAC PS END
+.    if !\\n[#PP] .nop
 .    br
 .    have-adjust \\$@ \" Adjusting is handled by FLOAT
 .    ds ev-current \\n[.ev]
@@ -21059,7 +21060,9 @@ does not fit on page \\n[pgnum]\\*[col-num].
 .       br
 .       ev
 .    \}
-.    if !\\n[pic*left] .in \\n[ll-pre-pic]u-\\n[pic*div-width]u/2u
+.\"
+.\" .if !\\n[pic*left] .in \\n[ll-pre-pic]u-\\n[pic*div-width]u/2u
+.\"
 .    pic*div
 .    sp
 .    if (\\n[pic*have-label]=3D1):(\\n[pic*autolabel]=3D1):(\\n[pic*capt=
ion-after-label]=3D1) \{\


From MAILER-DAEMON Tue Jun 26 08:25:12 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fXn1z-00047O-W9
	for mharc-groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:12 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44589)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1y-00045Z-4V
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:11 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000ab-TG
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:10 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:43597)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000aW-Pw
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:08 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id B1C4B2048D; Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 07/07: pdfmom(1): Make minor style fixes.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180626122507.28918.2789@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 07fed5897899f8acfd3f33b3d3ae62ce4eff4c78
Auto-Submitted: auto-generated
Message-Id: <20180626122508.B1C4B2048D@vcs0.savannah.gnu.org>
Date: Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 12:25:11 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 07fed5897899f8acfd3f33b3d3ae62ce4eff4c78
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 23 11:12:52 2018 -0400

    pdfmom(1): Make minor style fixes.
   =20
    * Don't capitalize the summary like a sentence.
    * Tweak summary to refer to groff and to mom as a macro "package"
      instead of a "set".
    * Make the synopsis agree with DESCRIPTION.  -Tpdf is the default mod=
e,
      so list it first.  It also does not accept pdfroff options.
    * Document existence and purpose of -v option.
    * Recast "stdout" to "the standard output".
    * Consistently put 2 empty requests between paragraphs.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/devices/gropdf/pdfmom.1.man | 37 ++++++++++++++++++++++++++++-------=
--
 1 file changed, 28 insertions(+), 9 deletions(-)

diff --git a/src/devices/gropdf/pdfmom.1.man b/src/devices/gropdf/pdfmom.=
1.man
index 9df4ca8..16818f8 100644
--- a/src/devices/gropdf/pdfmom.1.man
+++ b/src/devices/gropdf/pdfmom.1.man
@@ -1,6 +1,6 @@
 .TH PDFMOM @MAN1EXT@ "@MDATE@" "groff @VERSION@"
 .SH NAME
-pdfmom \- Produce PDF documents using the mom macro set
+pdfmom \- produce PDF documents using the mom macro package for groff
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -30,15 +30,22 @@ pdfmom \- Produce PDF documents using the mom macro s=
et
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY pdfmom
-.OP \-Tps "\fR[pdfroff options]"
-[groff options]
-.I files .\|.\|.
+.OP \-Tpdf
+.RI [ groff-options ]
+.I file
+\&.\|.\|.\&
 .YS
 .
 .SY pdfmom
-.OP \-Tpdf
-[groff options]
-.I files .\|.\|.
+.B \-Tps
+.RI [ pdfroff-options ]
+.RI [ groff-options ]
+.I file
+\&.\|.\|.\&
+.YS
+.
+.SY pdfmom
+.B \-v
 .YS
 .
 .
@@ -55,8 +62,9 @@ formatted with the mom macros.
 .
 .P
 .B pdfmom
-prints to stdout, so output must be redirected to a destination
-file.  The size of the final PDF can be reduced by piping the output
+prints to the standard output,
+so output must usually be redirected to a destination file.
+The size of the final PDF can be reduced by piping the output
 through
 .BR ps2pdf .
 .
@@ -97,6 +105,7 @@ calls
 .BR pdfroff ,
 the
 .
+.
 .P
 .RS
 .B \-mpdfmark \-mom \-\-no-toc
@@ -123,6 +132,14 @@ macros is discussed in full in the PDF manual,
 .IR "Producing PDFs with groff and mom" .
 .
 .
+.P
+If called with the
+.B \-v
+option,
+.B pdfmom
+simply prints its version information and exits.
+.
+.
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH BUGS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -130,12 +147,14 @@ macros is discussed in full in the PDF manual,
 .B pdfmom
 sometimes issues warnings of the type
 .
+.
 .P
 .RS 2
 \&.\|.\|.:
 .B can't transparently output node at top level
 .RE
 .
+.
 .P
 This is more of an annoyance than a bug, and may safely be ignored.
 .


From MAILER-DAEMON Tue Jun 26 08:25:12 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fXn20-00047c-6T
	for mharc-groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:12 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44555)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1x-00044e-71
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:10 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000Ze-6m
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:09 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:43587)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000ZO-2i
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:08 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id EDD1B2071F; Tue, 26 Jun 2018 08:25:07 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 02/07: grolbp(1): Sort options in alphabetical order.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180626122507.28918.2789@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: be181d7de36678ad24b50f484c7c4f3e40c29dca
Auto-Submitted: auto-generated
Message-Id: <20180626122507.EDD1B2071F@vcs0.savannah.gnu.org>
Date: Tue, 26 Jun 2018 08:25:07 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 12:25:10 -0000

gbranden pushed a commit to branch master
in repository groff.

commit be181d7de36678ad24b50f484c7c4f3e40c29dca
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 23 07:44:03 2018 -0400

    grolbp(1): Sort options in alphabetical order.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/devices/grolbp/grolbp.1.man | 60 ++++++++++++++++++++---------------=
------
 1 file changed, 30 insertions(+), 30 deletions(-)

diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.=
1.man
index 618c957..df0f84f 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -118,20 +118,29 @@ copies of each page.
 .
 .
 .TP
-.B \-l
+.BI \-F " font-directory"
 .TQ
-.B \-\-landscape
-Print the document with a landscape orientation.
+.BI \-\-fontdir=3D font-directory
+Prepend directory
+.IB font-directory /dev name
+to the search path for font and device description files;
+.I name
+is the name of the device, usually
+.BR lbp .
 .
 .
 .TP
-.BI \-p " paper-size"
+.B \-h
 .TQ
-.BI \-\-papersize=3D paper-size
-Set the paper size to
-.IR paper-size ,
-which must be a valid paper size description as indicated in the section
-.BR "PAPER SIZES" .
+.B \-\-help
+Print a short help text.
+.
+.
+.TP
+.B \-l
+.TQ
+.B \-\-landscape
+Print the document with a landscape orientation.
 .
 .
 .TP
@@ -144,14 +153,13 @@ orientation, which must be \(oqportrait\(cq or \(oq=
landscape\(cq.
 .
 .
 .TP
-.BI \-w " width"
+.BI \-p " paper-size"
 .TQ
-.BI \-\-linewidth=3D width
-Set the default line thickness to
-.I width
-thousandths of an em.
-.
-If this option isn't specified, the line thickness defaults to 0.04\~em.
+.BI \-\-papersize=3D paper-size
+Set the paper size to
+.IR paper-size ,
+which must be a valid paper size description as indicated in the section
+.BR "PAPER SIZES" .
 .
 .
 .TP
@@ -162,22 +170,14 @@ Print the version number.
 .
 .
 .TP
-.BI \-F " font-directory"
+.BI \-w " width"
 .TQ
-.BI \-\-fontdir=3D font-directory
-Prepend directory
-.IB font-directory /dev name
-to the search path for font and device description files;
-.I name
-is the name of the device, usually
-.BR lbp .
-.
+.BI \-\-linewidth=3D width
+Set the default line thickness to
+.I width
+thousandths of an em.
 .
-.TP
-.B \-h
-.TQ
-.B \-\-help
-Print a short help text.
+If this option isn't specified, the line thickness defaults to 0.04\~em.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D


From MAILER-DAEMON Tue Jun 26 08:25:12 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fXn20-00047y-Ek
	for mharc-groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:12 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44571)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1x-000454-K4
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:10 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000Zr-AU
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:09 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:43589)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000Zm-6r
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:08 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 202022048D; Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 03/07: grolj4(1): Make editorial fixes.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180626122507.28918.2789@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: e39250e936eb44b0e4872d6b91825ec4897d6dbc
Auto-Submitted: auto-generated
Message-Id: <20180626122508.202022048D@vcs0.savannah.gnu.org>
Date: Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 12:25:11 -0000

gbranden pushed a commit to branch master
in repository groff.

commit e39250e936eb44b0e4872d6b91825ec4897d6dbc
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 23 08:22:19 2018 -0400

    grolj4(1): Make editorial fixes.
   =20
    * Use HP's preferred casing for "LaserJet".
    * Document all operation modes in synopsis.
    * Parallelize option argument names between synopsis and later
      discussion.
    * Consistently put 2 empty requests between paragraphs, even when the
      paragraph is tagged.
    * Add whitespace between short option letter and argument in OPTIONS
      section, for readability.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/devices/grolj4/grolj4.1.man | 62 +++++++++++++++++++++++++++++------=
------
 1 file changed, 44 insertions(+), 18 deletions(-)

diff --git a/src/devices/grolj4/grolj4.1.man b/src/devices/grolj4/grolj4.=
1.man
index cdd6bb8..1478d64 100644
--- a/src/devices/grolj4/grolj4.1.man
+++ b/src/devices/grolj4/grolj4.1.man
@@ -1,6 +1,6 @@
 .TH GROLJ4 @MAN1EXT@ "@MDATE@" "groff @VERSION@"
 .SH NAME
-grolj4 \- groff driver for HP Laserjet 4 family
+grolj4 \- groff driver for HP LaserJet 4 family
 .
 .
 .\" license
@@ -28,13 +28,25 @@ grolj4 \- groff driver for HP Laserjet 4 family
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY grolj4
-.OP \-lv
-.OP \-d \fR[\fPn\fR]\fP
-.OP \-c n
-.OP \-p paper_size
-.OP \-w n
-.OP \-F dir
-.RI "[\ " files\|.\|.\|. "\ ]"
+.OP \-l
+.OP \-c num-copies
+.RB [ \-d
+.RI [ n ]]
+.OP \-F font-directory
+.OP \-p paper-size
+.OP \-w line-width
+.RI [ file
+\&.\|.\|.\&]
+.YS
+.
+.SY grolj4
+.B \-\-help
+.YS
+.
+.SY grolj4
+.B \-v
+.SY grolj4
+.B \-\-version
 .YS
 .
 .
@@ -45,7 +57,7 @@ grolj4 \- groff driver for HP Laserjet 4 family
 .B grolj4
 is a driver for
 .B groff
-that produces output in PCL5 format suitable for an HP Laserjet 4
+that produces output in PCL5 format suitable for an HP LaserJet 4
 printer.
 .
 .
@@ -73,47 +85,57 @@ commands.
 It is possible to have whitespace between a command-line option and its
 parameter.
 .
+.
 .TP
-.BI \-c n
+.BI \-c " num-copies"
 Print
-.I n
+.I num-copies
 copies of each page.
 .
+.
 .TP
 .B \-l
 Print the document with a landscape orientation.
 .
+.
 .TP
-.BI "\-d [" n ]
+.B \-d\c
+.RI " [" n ]
 Use duplex mode
 .IR n :
 1\ is long-side binding; 2\ is short-side binding;
 default is\ 1.
 .
+.
 .TP
-.BI \-p size
+.BI \-p " paper-size"
 Set the paper size to
-.IR size ,
+.IR paper-size ,
 which must be one of
 letter, legal, executive, a4, com10, monarch, c5, b5, dl.
 .
+.
 .TP
 .B \-v
+.TQ
+.B \-\-version
 Print the version number.
 .
+.
 .TP
-.BI \-w n
+.BI \-w " line-width"
 Set the default line thickness to
-.I n
+.I line-width
 thousandths of an em.
 .
 If this option isn't specified, the line thickness defaults to
 0.04\~em.
 .
+.
 .TP
-.BI \-F dir
+.BI \-F " font-directory"
 Prepend directory
-.IB dir /dev name
+.IB font-directory /dev name
 to the search path for font and device description files;
 .I name
 is the name of the device, usually
@@ -124,22 +146,26 @@ is the name of the device, usually
 The following four commands are available additionally in the
 font description files:
 .
+.
 .TP
 .BI pclweight \ N
 The integer value
 .I N
 must be in the range \-7 to +7; default is\~0.
 .
+.
 .TP
 .BI pclstyle \ N
 The integer value
 .I N
 must be in the range 0 to 32767; default is\~0.
 .
+.
 .TP
 .BI pclproportional \ N
 A boolean flag which can be either 0 or\~1; default is\~0.
 .
+.
 .TP
 .BI pcltypeface \ N
 The integer value


From MAILER-DAEMON Tue Jun 26 08:25:12 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fXn20-00048I-NX
	for mharc-groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:12 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44564)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1x-00044m-BK
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:11 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000a0-FY
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:09 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:43591)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000Zv-Ay
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:08 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 441B42048D; Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 04/07: lj4_font(5): Drop section from cross references.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180626122507.28918.2789@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 82776a8a8c6dd997766ab80e8de4f2b3895cafc5
Auto-Submitted: auto-generated
Message-Id: <20180626122508.441B42048D@vcs0.savannah.gnu.org>
Date: Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 12:25:11 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 82776a8a8c6dd997766ab80e8de4f2b3895cafc5
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 23 10:14:59 2018 -0400

    lj4_font(5): Drop section from cross references.
   =20
    ...after the first occurrence, if outside the SEE ALSO section.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/devices/grolj4/lj4_font.5.man | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/devices/grolj4/lj4_font.5.man b/src/devices/grolj4/lj4_f=
ont.5.man
index 4b217eb..e8383da 100644
--- a/src/devices/grolj4/lj4_font.5.man
+++ b/src/devices/grolj4/lj4_font.5.man
@@ -84,7 +84,7 @@ searches a list of symbol sets,
 and selects the first set that contains the glyph.
 .
 The printing code generated by
-.BR hpftodit (@MAN1EXT@)
+.B hpftodit
 is an integer that encodes a numerical value for the symbol set in the
 high byte(s),
 and the index in the low byte.
@@ -108,7 +108,7 @@ sufficient to enable printing of more than 600 glyphs=
.
 .
 .LP
 The metrics generated by
-.BR hpftodit (@MAN1EXT@)
+.B hpftodit
 assume that the DESC file contains values of 1200 for
 .I res
 and 6350 for


From MAILER-DAEMON Tue Jun 26 08:25:13 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fXn20-00048a-SX
	for mharc-groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:12 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44582)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1x-00045F-Pu
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:11 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000aE-Im
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:09 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:43593)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000a4-Fw
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:08 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 670982048D; Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 05/07: gropdf(1): Sort options in alphabetical order.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180626122507.28918.2789@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 3d7071cafb5b2550fbf9175f29f67cd11dc699f7
Auto-Submitted: auto-generated
Message-Id: <20180626122508.670982048D@vcs0.savannah.gnu.org>
Date: Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 12:25:11 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 3d7071cafb5b2550fbf9175f29f67cd11dc699f7
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 23 10:35:32 2018 -0400

    gropdf(1): Sort options in alphabetical order.
   =20
    Also relocate the mention of optional whitespace from SYNOPSIS to
    OPTIONS and tighten the wording.
   =20
    Put two empty requests between tagged paragraphs.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/devices/gropdf/gropdf.1.man | 59 ++++++++++++++++++++++-------------=
------
 1 file changed, 32 insertions(+), 27 deletions(-)

diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.=
1.man
index 8b8f00e..f5c9621 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -50,11 +50,6 @@ gropdf \- PDF driver for groff
 .YS
 .
 .
-.LP
-It is possible to have whitespace between a command-line option and its
-parameter.
-.
-.
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -106,12 +101,24 @@ below for a guide how to install fonts for
 .SH OPTIONS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
+.LP
+Whitespace is optional between a command-line option and its parameter.
+.
+.
 .TP
 .B \-d
 Include debug information as comments within the PDF.
 .
 Also produces an uncompressed PDF.
 .
+.
+.TP
+.B \-e
+Forces
+.B gropdf
+to embed ALL fonts (even the 14 base PDF fonts).
+.
+.
 .TP
 .BI \-F dir
 Prepend directory
@@ -159,28 +166,6 @@ See
 .B groff_font (@MAN5EXT@)
 for details.
 .
-.\" .TP
-.\" .BI \-w n
-.\" Lines should be drawn using a thickness of
-.\" .IR n \~\c
-.\" thousandths of an em.
-.\" .
-.\" If this option is not given, the line thickness defaults to 0.04\~em=
.
-.\" .
-.
-.TP
-.B \-v
-Print the version number.
-.
-.TP
-.BI \-y foundry
-Set the foundry to use for selecting fonts of the same name.
-.
-.TP
-.B \-e
-Forces
-.B gropdf
-to embed ALL fonts (even the 14 base PDF fonts).
 .
 .TP
 .B \-s
@@ -191,6 +176,7 @@ Ghostscript's
 .B ps2pdf
 complains about this line if it is included, but works anyway.
 .
+.
 .TP
 .B \-u
 .TQ
@@ -206,6 +192,25 @@ You can include your own CMap by specifying a
 or have no CMap at all by omitting the argument.
 .
 .
+.TP
+.B \-v
+Print the version number.
+.
+.
+.\" .TP
+.\" .BI \-w n
+.\" Lines should be drawn using a thickness of
+.\" .IR n \~\c
+.\" thousandths of an em.
+.\" .
+.\" If this option is not given, the line thickness defaults to 0.04\~em=
.
+.\" .
+.\" .
+.TP
+.BI \-y foundry
+Set the foundry to use for selecting fonts of the same name.
+.
+.
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH USAGE
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D


From MAILER-DAEMON Tue Jun 26 08:25:14 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fXn22-0004A3-6F
	for mharc-groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:14 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44591)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1y-00045n-Bv
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:11 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000aQ-O4
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:10 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:43595)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000aL-Kn
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:08 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 8BC4D2048D; Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 06/07: gropdf(1): Make minor style fixes.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180626122507.28918.2789@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: e74507a22cb942531ea34a997251c0a7fa6ff68f
Auto-Submitted: auto-generated
Message-Id: <20180626122508.8BC4D2048D@vcs0.savannah.gnu.org>
Date: Tue, 26 Jun 2018 08:25:08 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 12:25:11 -0000

gbranden pushed a commit to branch master
in repository groff.

commit e74507a22cb942531ea34a997251c0a7fa6ff68f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 23 10:41:41 2018 -0400

    gropdf(1): Make minor style fixes.
   =20
    * Use italics instead of full-caps for emphasis.
    * Set option arguments with preceding whitespace.
    * Describe the -l option as "orient"ing the document in landscape for=
mat
      rather than "print"ing, since (1) actually printing out a PDF is no=
t
      groff's bailiwick, and (2) we use "print" to mean "write a message =
to
      the terminal" in the description of the -v option.
    * Fix macro call to render man page cross reference correctly.
    * Rename -u's option argument to "cmapfile" to agree with synopsis.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/devices/gropdf/gropdf.1.man | 27 +++++++++++++++------------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.=
1.man
index f5c9621..3852cdf 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -116,11 +116,13 @@ Also produces an uncompressed PDF.
 .B \-e
 Forces
 .B gropdf
-to embed ALL fonts (even the 14 base PDF fonts).
+to embed
+.I all
+fonts (even the 14 base PDF fonts).
 .
 .
 .TP
-.BI \-F dir
+.BI \-F " dir"
 Prepend directory
 .IB dir /dev name
 to the search path for font, and device description files;
@@ -129,7 +131,7 @@ is the name of the device, usually
 .BR pdf .
 .
 .TP
-.BI \-I dir
+.BI \-I " dir"
 This option may be used to add a directory to the search path for
 files named in
 .B \[rs]X'pdf: pdfpic'
@@ -145,10 +147,10 @@ No directory search is performed for files with an =
absolute file name.
 .
 .TP
 .B \-l
-Print the document in landscape format.
+Orient the document in landscape format.
 .
 .TP
-.BI \-p paper-size
+.BI \-p " paper-size"
 Set physical dimension of output medium.
 .
 This overrides the
@@ -163,7 +165,7 @@ file; it accepts the same arguments as the
 command.
 .
 See
-.B groff_font (@MAN5EXT@)
+.BR groff_font (@MAN5EXT@)
 for details.
 .
 .
@@ -178,9 +180,8 @@ complains about this line if it is included, but work=
s anyway.
 .
 .
 .TP
-.B \-u
-.TQ
-.BI \-u cmapfilename
+.B \-u\c
+.RI " [" cmapfile ]
 .B Gropdf
 normally includes a ToUnicode CMap with any font created using
 .B text.enc
@@ -188,13 +189,15 @@ as the encoding file,
 this makes it easier to search for words which contain ligatures.
 .
 You can include your own CMap by specifying a
-.I cmapfilename
+.I cmapfile
 or have no CMap at all by omitting the argument.
 .
 .
 .TP
 .B \-v
-Print the version number.
+.TQ
+.B \-\-version
+Print the version number and exit.
 .
 .
 .\" .TP
@@ -207,7 +210,7 @@ Print the version number.
 .\" .
 .\" .
 .TP
-.BI \-y foundry
+.BI \-y " foundry"
 Set the foundry to use for selecting fonts of the same name.
 .
 .


From MAILER-DAEMON Tue Jun 26 08:25:15 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fXn23-0004Ax-2o
	for mharc-groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:15 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44576)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1x-00045A-Mw
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:11 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000Zc-6O
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:09 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:43585)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXn1w-0000ZN-2c
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:25:08 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id D62F32048D; Tue, 26 Jun 2018 08:25:07 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/07: grolbp(1): Make editorial fixes.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180626122507.28918.2789@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 82f9e0f618cf4639afd6eb27e4091ba0a7c5cd47
Auto-Submitted: auto-generated
Message-Id: <20180626122507.D62F32048D@vcs0.savannah.gnu.org>
Date: Tue, 26 Jun 2018 08:25:07 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 12:25:11 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 82f9e0f618cf4639afd6eb27e4091ba0a7c5cd47
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 23 07:25:19 2018 -0400

    grolbp(1): Make editorial fixes.
   =20
    * Get rid of period at end of summary.  (I can't imagine an argument =
for
      it; the summary is not even a sentence.)
    * Document all operation modes in synopsis.
    * Parallelize option argument names between synopsis and later
      discussion.
    * Break lines at 72 columns.
    * Add manual section to grolj4 cross reference.
    * Consistently put 2 empty requests between paragraphs, even when the
      paragraph is tagged.
    * ...and before new sections, for internal consistency.
    * Add whitespace between short option letter and argument in OPTIONS
      section, for readability.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 src/devices/grolbp/grolbp.1.man | 118 +++++++++++++++++++++++++---------=
------
 1 file changed, 75 insertions(+), 43 deletions(-)

diff --git a/src/devices/grolbp/grolbp.1.man b/src/devices/grolbp/grolbp.=
1.man
index f4b3841..618c957 100644
--- a/src/devices/grolbp/grolbp.1.man
+++ b/src/devices/grolbp/grolbp.1.man
@@ -3,7 +3,7 @@
 .TH GROLBP @MAN1EXT@ "@MDATE@" "groff @VERSION@"
 .SH NAME
 grolbp \- groff driver for Canon CAPSL printers (LBP-4 and LBP-8 \
-series laser printers).
+series laser printers)
 .\" Modified by Francisco Andr=EF=BF=BDs Verd=EF=BF=BD <pandres@dragonet=
.es> for the
 .\" grolbp program.
 .
@@ -34,22 +34,41 @@ series laser printers).
 .
 .SY grolbp
 .OP \-l
-.OP \-\-landscape
-.OP \-v
-.OP \-\-version
-.OP \-c n
-.OP \-\-copies=3D numcopies
-.OP \-p paper_size
-.OP \-\-papersize=3D paper_size
+.OP \-c num-copies
+.OP \-F font-directory
 .OP \-o orientation
-.OP \-\-orientation=3D orientation
+.OP \-p paper-size
 .OP \-w width
-.OP \-\-linewidth=3D width
-.OP \-F dir
-.OP \-\-fontdir=3D dir
-.OP \-h
-.OP \-\-help
-.RI "[\ " files\|.\|.\|. "\ ]"
+.RI [ file
+\&.\|.\|.\&]
+.SY grolbp
+[\c
+.BI \-\-copies=3D num-copies\c
+] [\c
+.BI \-\-fontdir=3D font-directory\c
+] [\c
+.BI \-\-landscape\c
+] [\c
+.BI \-\-linewidth=3D width\c
+] [\c
+.BI \-\-orientation=3D orientation\c
+] [\c
+.BI \-\-papersize=3D paper-size\c
+]
+.RI [ file
+\&.\|.\|.\&]
+.YS
+.
+.SY grolbp
+.B \-h
+.SY grolbp
+.B \-\-help
+.YS
+.
+.SY grolbp
+.B \-v
+.SY grolbp
+.B \-\-version
 .YS
 .
 .
@@ -60,18 +79,22 @@ series laser printers).
 .B grolbp
 is a driver for
 .B groff
-that produces output in CAPSL and VDM format suitable for Canon LBP\-4 a=
nd
-LBP\-8 printers.
+that produces output in CAPSL and VDM format suitable for Canon LBP-4
+and LBP-8 printers.
 .
 .
 .LP
-For compatibility with grolj4 there is an additional drawing command
-available:
+For compatibility with
+.BR grolj4 (@MAN1EXT@)
+there is an additional drawing command available:
 .
 .TP
 .BI \eD'R\  dh\ dv '
-Draw a rule (i.e.\ a solid black rectangle), with one corner at the curr=
ent
-position, and the diagonally opposite corner at the current position
+Draw a rule
+(i.e., a solid black rectangle),
+with one corner at the current position,
+and the diagonally opposite corner at the current
+position
 .RI +( dh , dv ).
 .
 .
@@ -80,42 +103,48 @@ position, and the diagonally opposite corner at the =
current position
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 Note that there can be whitespace between a one-letter option and its
-argument; on the other hand, there must be whitespace and/or an equal si=
gn
+argument;
+on the other hand, there must be whitespace and/or an equal sign
 (\(oq=3D\(cq) between a long-name option and its argument.
 .
+.
 .TP
-.BI \-c numcopies
+.BI \-c " num-copies"
 .TQ
-.BI \-\-copies=3D numcopies
+.BI \-\-copies=3D num-copies
 Print
-.I numcopies
+.I num-copies
 copies of each page.
 .
+.
 .TP
 .B \-l
 .TQ
 .B \-\-landscape
 Print the document with a landscape orientation.
 .
+.
 .TP
-.BI \-p paper_size
+.BI \-p " paper-size"
 .TQ
-.BI \-\-papersize=3D paper_size
+.BI \-\-papersize=3D paper-size
 Set the paper size to
-.IR paper_size ,
+.IR paper-size ,
 which must be a valid paper size description as indicated in the section
 .BR "PAPER SIZES" .
 .
+.
 .TP
-.BI \-o orientation
+.BI \-o " orientation"
 .TQ
 .BI \-\-orientation=3D orientation
 Print the document with
 .I orientation
 orientation, which must be \(oqportrait\(cq or \(oqlandscape\(cq.
 .
+.
 .TP
-.BI \-w width
+.BI \-w " width"
 .TQ
 .BI \-\-linewidth=3D width
 Set the default line thickness to
@@ -124,23 +153,26 @@ thousandths of an em.
 .
 If this option isn't specified, the line thickness defaults to 0.04\~em.
 .
+.
 .TP
 .B \-v
 .TQ
 .B \-\-version
 Print the version number.
 .
+.
 .TP
-.BI \-F dir
+.BI \-F " font-directory"
 .TQ
-.BI \-\-fontdir=3D dir
+.BI \-\-fontdir=3D font-directory
 Prepend directory
-.IB dir /dev name
+.IB font-directory /dev name
 to the search path for font and device description files;
 .I name
 is the name of the device, usually
 .BR lbp .
 .
+.
 .TP
 .B \-h
 .TQ
@@ -152,17 +184,17 @@ Print a short help text.
 .SH TYPEFACES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-The driver supports the Dutch, Swiss and Swiss-Narrow scalable typefaces=
,
-each one in the Regular, Bold, Italic and Bold-Italic styles.
+The driver supports the Dutch, Swiss and Swiss-Narrow scalable
+typefaces, each one in the Regular, Bold, Italic and Bold-Italic styles.
 .
-Additionally, the Courier and Elite monospaced typefaces at the sizes 8 =
and
-12 points (for Courier) resp.\& 8 and 10 points (for Elite) are supporte=
d,
-each one in the Regular, Bold and Italic styles.
+Additionally, the Courier and Elite monospaced typefaces at the sizes 8
+and 12 points (for Courier) resp.\& 8 and 10 points (for Elite) are
+supported, each one in the Regular, Bold and Italic styles.
 .
 .
 .PP
-The following chart summarizes the font names you can use to access thes=
e
-fonts:
+The following chart summarizes the font names you can use to access
+these fonts:
 .
 .
 .PP
@@ -329,9 +361,9 @@ font description file is
 .IP
 Note that you may need to modify
 .B grolbp
-to add support for new bitmapped fonts, since the available font names a=
nd
-font sizes of bitmapped fonts (as documented above) are hard-coded into =
the
-program.
+to add support for new bitmapped fonts, since the available font names
+and font sizes of bitmapped fonts (as documented above) are hard-coded
+into the program.
 .
 .IP \(bu
 For scalable fonts,


From MAILER-DAEMON Tue Jun 26 08:59:23 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fXnZ5-0004fF-NX
	for mharc-groff-commit@gnu.org; Tue, 26 Jun 2018 08:59:23 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:52509)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXnZ3-0004dn-OT
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:59:22 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXnZ3-0007JO-58
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:59:21 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:43979)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fXnZ3-0007JG-2A
	for groff-commit@gnu.org; Tue, 26 Jun 2018 08:59:21 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id D21F32048D; Tue, 26 Jun 2018 08:59:20 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: groff_mom(7): Fix typo.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180626125920.11599.77423@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: d8746c8c518edfa3f2746fbb067d93b60a407ab4
Auto-Submitted: auto-generated
Message-Id: <20180626125920.D21F32048D@vcs0.savannah.gnu.org>
Date: Tue, 26 Jun 2018 08:59:20 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 12:59:22 -0000

gbranden pushed a commit to branch master
in repository groff.

commit d8746c8c518edfa3f2746fbb067d93b60a407ab4
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sat Jun 23 05:30:43 2018 -0400

    groff_mom(7): Fix typo.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 contrib/mom/groff_mom.7.man | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index e2fd49d..96d8a5c 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -3353,7 +3353,7 @@ PDF support was provided by
 Deri James
 .ME .
 .
-The alphabetical documentation of macros and escape seqauences in this
+The alphabetical documentation of macros and escape sequences in this
 man page were written by the
 .I mom
 team.


From MAILER-DAEMON Thu Jun 28 20:03:04 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fYgsS-0001wX-4N
	for mharc-groff-commit@gnu.org; Thu, 28 Jun 2018 20:03:04 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:38453)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYgsM-0001uJ-Ij
	for groff-commit@gnu.org; Thu, 28 Jun 2018 20:03:02 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYgsI-0000ca-AV
	for groff-commit@gnu.org; Thu, 28 Jun 2018 20:02:58 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:34482)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYgsI-0000cK-5F
	for groff-commit@gnu.org; Thu, 28 Jun 2018 20:02:54 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id BB3D3206CC; Thu, 28 Jun 2018 20:02:53 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/01: **/*.man: Rationalize synopses.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180629000252.5223.78418@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 4ab68de177fbcf705e60938afd519a9374ffa05a
Auto-Submitted: auto-generated
Message-Id: <20180629000253.BB3D3206CC@vcs0.savannah.gnu.org>
Date: Thu, 28 Jun 2018 20:02:52 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 29 Jun 2018 00:03:02 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 4ab68de177fbcf705e60938afd519a9374ffa05a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Jun 28 13:04:35 2018 -0400

    **/*.man: Rationalize synopses.
   =20
    Make command synopses consistent with each other, with existing man
    pages in the tree, and with the parameters each command actually
    accepts.
   =20
    contrib/mm/groff_mm.7.man:
    contrib/mm/groff_mmse.7.man:
    contrib/mm/mmroff.1.man:
    src/devices/grodvi/grodvi.1.man:
    src/devices/grotty/grotty.1.man:
    src/devices/xditview/gxditview.1.man:
    src/preproc/grn/grn.1.man:
    src/preproc/pic/pic.1.man:
    src/utils/addftinfo/addftinfo.1.man:
    src/utils/lkbib/lkbib.1.man:
    src/utils/lookbib/lookbib.1.man:
    src/utils/pfbtops/pfbtops.1.man:
    src/utils/xtotroff/xtotroff.1.man:
    * Use .SY/.YS macro pairs to structure synopses.
   =20
    contrib/chem/chem.1.man:
    contrib/eqn2graph/eqn2graph.1.man:
    contrib/gperl/gperl.1.man:
    contrib/grap2graph/grap2graph.1.man:
    contrib/groffer/groffer.1.man:
    contrib/groffer/roff2.1.man:
    contrib/pdfmark/pdfroff.1.man:
    contrib/pic2graph/pic2graph.1.man:
    src/preproc/preconv/preconv.1.man:
    src/roff/groff/groff.1.man:
    src/roff/grog/grog.1.man:
    src/roff/nroff/nroff.1.man:
    * Use multiple adjacent synopsis lines (analogous to .TP and .TQ)
      instead of a roman alternation symbol ("|") for synonymous options =
in
      alternative-operation mode scenarios like printing usage or version
      information.
   =20
    contrib/eqn2graph/eqn2graph.1.man:
    contrib/gdiffmk/gdiffmk.1.man:
    contrib/gperl/gperl.1.man:
    contrib/grap2graph/grap2graph.1.man:
    contrib/pdfmark/pdfroff.1.man:
    contrib/pic2graph/pic2graph.1.man:
    src/preproc/pic/pic.1.man:
    src/preproc/refer/refer.1.man:
    src/roff/groff/groff.1.man:
    src/roff/grog/grog.1.man:
    src/roff/nroff/nroff.1.man:
    src/utils/addftinfo/addftinfo.1.man:
    src/utils/afmtodit/afmtodit.1.man:
    src/utils/hpftodit/hpftodit.1.man:
    src/utils/indxbib/indxbib.1.man:
    src/utils/lkbib/lkbib.1.man:
    src/utils/lookbib/lookbib.1.man:
    src/utils/pfbtops/pfbtops.1.man:
    src/utils/tfmtodit/tfmtodit.1.man:
    src/utils/xtotroff/xtotroff.1.man:
    * Use multiple .SY/.YS blocks where necessary to distinguish alternat=
ive
      modes of operation.  (E.g., --help and --version don't do the same
      thing, let alone whatever the tool itself does.)
   =20
    contrib/chem/chem.1.man:
    contrib/gdiffmk/gdiffmk.1.man:
    contrib/gperl/gperl.1.man:
    contrib/groffer/groffer.1.man:
    contrib/groffer/roff2.1.man:
    contrib/pdfmark/pdfroff.1.man:
    src/roff/grog/grog.1.man:
    src/roff/nroff/nroff.1.man:
    * Use font macros instead of .OP for optional operands (as opposed to
      flags with only 0, or only 1, argument).  This also prevents ellips=
es
      from being set in italics, which is incorrect.
   =20
    src/preproc/refer/refer.1.man:
    * Use font macros instead of .OP for option arguments that have
      character-literal sequences in them.
   =20
    contrib/chem/chem.1.man:
    contrib/eqn2graph/eqn2graph.1.man:
    contrib/gdiffmk/gdiffmk.1.man:
    contrib/glilypond/glilypond.1.man:
    contrib/gperl/gperl.1.man:
    contrib/grap2graph/grap2graph.1.man:
    contrib/groffer/groffer.1.man:
    contrib/groffer/roff2.1.man:
    contrib/pic2graph/pic2graph.1.man:
    src/devices/grohtml/grohtml.1.man:
    src/devices/xditview/gxditview.1.man:
    src/preproc/refer/refer.1.man:
    src/roff/grog/grog.1.man:
    src/utils/xtotroff/xtotroff.1.man:
    * Remove use of \% to suppress hyphenation inside a .SY/.YS block, si=
nce
      .SY already takes care of that for us.
   =20
    contrib/gdiffmk/gdiffmk.1.man:
    * Tweak markup of contextual options (-B and -M are only meaningful i=
f
      -D is given) to get the roman option bracket delimiters to "hug" th=
eir
      contents.
   =20
    contrib/glilypond/glilypond.1.man:
    * Offer synopsis that doesn't just hand-wave away all the work with
      "[options]".  Bernd did not make this easy.  groffer is an even mor=
e
      daunting example, and has such an efflorescent option interface tha=
t I
      despaired of documenting it.  Preferable in my opinion would be jus=
t
      to put the command's interface itself on a severe diet and document
      the result.
   =20
    src/devices/xditview/gxditview.1.man:
    * Offer synopsis that doesn't just hand-wave away all the work with
      "[-toolkitoptin ...]" and "[-option ...]".
   =20
    src/utils/addftinfo/addftinfo.1.man:
    * Offer synopsis that doesn't just hand-wave away all the work with
      "[param-option value]".
   =20
    contrib/mom/groff_mom.7.man:
    * Use the Ellipsis string since the page already has one defined.
   =20
    contrib/mm/groff_mm.7.man:
    contrib/mom/groff_mom.7.man:
    src/devices/grohtml/grohtml.1.man:
    src/devices/gropdf/gropdf.1.man:
    src/devices/grops/grops.1.man:
    src/devices/grotty/grotty.1.man:
    src/preproc/eqn/eqn.1.man:
    src/preproc/preconv/preconv.1.man:
    src/preproc/soelim/soelim.1.man:
    src/preproc/tbl/tbl.1.man:
    * Use the singular, not the plural, for a parameter followed by an
      ellipsis.
   =20
    contrib/pdfmark/pdfroff.1.man:
    * Mark pdfroff's file ... operands as optional, not mandatory, since
      pdfroff attempts to read from standard input even if not given -i.
      This may be a bug?
   =20
    contrib/pic2graph/pic2graph.1.man:
    * Fix spelling of "delimiters"; the relevant root is "limit", not
      "meter".  A "delimeter" might be something that tells me how far I'=
d
      have to walk for a hoagie.
   =20
    src/devices/grodvi/grodvi.1.man:
    src/devices/grohtml/grohtml.1.man:
    src/preproc/refer/refer.1.man:
    src/utils/addftinfo/addftinfo.1.man:
    src/utils/hpftodit/hpftodit.1.man:
    src/utils/indxbib/indxbib.1.man:
    src/utils/lkbib/lkbib.1.man:
    src/utils/lookbib/lookbib.1.man:
    src/utils/pfbtops/pfbtops.1.man:
    src/utils/tfmtodit/tfmtodit.1.man:
    src/utils/xtotroff/xtotroff.1.man:
    * Document --help and --version options.
   =20
    src/devices/gropdf/gropdf.1.man:
    * Document --version option.
   =20
    src/devices/grohtml/grohtml.1.man:
    * Document -V ("validator button") option in synopsis.
   =20
    src/utils/addftinfo/addftinfo.1.man:
    * Document -v option.
   =20
    src/devices/gropdf/gropdf.1.man:
    * Respell "papersize" option argument as "paper-size" to agree with
      Options section.
   =20
    src/preproc/pic/pic.1.man:
    src/preproc/refer/refer.1.man:
    * Respell "filename" operand as simply "file".  This is consistent wi=
th
      the bulk of other groff man pages and requires no changes to the re=
st
      of the page (which is why I did not make similar alignments elsewhe=
re
      for this commit).
   =20
    src/roff/groff/groff.1.man:
    src/roff/troff/troff.1.man:
    * Use a line break instead of an adjustable, breakable space escape
      ("\~").  We accept breaks between ellipses and their predecessors
      everywhere else.
   =20
    src/roff/grog/grog.1.man:
    * Simplify reference to groff options in synopsis.  groff(1) uses GNU
      getopt so it is not necessary to group all options that don't take
      arguments before those that do, which is what the synopsis was
      implying.
   =20
    src/roff/nroff/nroff.1.man:
    * Note that -w ("enable warning") and -W ("inhibit warning") take an
      argument.
   =20
    src/utils/indxbib/indxbib.1.man:
    * Make optional operand brackets hug their contents, and set ellipsis=
 in
      roman, not italics.
   =20
    src/utils/lkbib/lkbib.1.man:
    src/utils/lookbib/lookbib.1.man:
    * Put space between and ellipsis and its predecessor.
   =20
    src/utils/hpftodit/hpftodit.1.man:
    * Put an empty request between the section header for the synopsis an=
d
      its content (for consistency with every other page).
---
 contrib/chem/chem.1.man              |  8 +++---
 contrib/eqn2graph/eqn2graph.1.man    |  8 ++++--
 contrib/gdiffmk/gdiffmk.1.man        | 34 ++++++++++++------------
 contrib/glilypond/glilypond.1.man    | 50 ++++++++++++++++++++++++++++++=
++++--
 contrib/gperl/gperl.1.man            | 19 +++++++++-----
 contrib/grap2graph/grap2graph.1.man  |  8 ++++--
 contrib/groffer/groffer.1.man        | 26 +++++++++++--------
 contrib/groffer/roff2.1.man          | 14 +++++++---
 contrib/mm/groff_mm.7.man            | 19 ++++++++------
 contrib/mm/groff_mmse.7.man          | 19 ++++++++------
 contrib/mm/mmroff.1.man              |  7 +++--
 contrib/mom/groff_mom.7.man          | 26 ++++++++++++-------
 contrib/pdfmark/pdfroff.1.man        | 23 ++++++++++++-----
 contrib/pic2graph/pic2graph.1.man    | 10 +++++---
 src/devices/grodvi/grodvi.1.man      | 32 ++++++++++++++---------
 src/devices/grohtml/grohtml.1.man    | 28 +++++++++++++-------
 src/devices/gropdf/gropdf.1.man      | 16 ++++++++----
 src/devices/grops/grops.1.man        |  4 +--
 src/devices/grotty/grotty.1.man      | 16 ++++++------
 src/devices/xditview/gxditview.1.man | 19 +++++++++++---
 src/preproc/eqn/eqn.1.man            |  3 ++-
 src/preproc/grn/grn.1.man            | 24 ++++++-----------
 src/preproc/pic/pic.1.man            | 28 ++++++++------------
 src/preproc/preconv/preconv.1.man    |  9 ++++---
 src/preproc/refer/refer.1.man        | 19 +++++++++++---
 src/preproc/soelim/soelim.1.man      |  4 +--
 src/preproc/tbl/tbl.1.man            |  3 ++-
 src/roff/groff/groff.1.man           | 14 +++++++---
 src/roff/grog/grog.1.man             | 21 ++++++++++-----
 src/roff/nroff/nroff.1.man           | 11 +++++---
 src/roff/troff/troff.1.man           |  3 ++-
 src/utils/addftinfo/addftinfo.1.man  | 27 ++++++++++++++-----
 src/utils/afmtodit/afmtodit.1.man    |  6 ++++-
 src/utils/hpftodit/hpftodit.1.man    | 13 +++++++++-
 src/utils/indxbib/indxbib.1.man      | 14 ++++++++--
 src/utils/lkbib/lkbib.1.man          | 30 ++++++++++++----------
 src/utils/lookbib/lookbib.1.man      | 25 ++++++++++--------
 src/utils/pfbtops/pfbtops.1.man      | 19 +++++++++-----
 src/utils/tfmtodit/tfmtodit.1.man    | 12 ++++++++-
 src/utils/xtotroff/xtotroff.1.man    | 24 +++++++++--------
 40 files changed, 458 insertions(+), 237 deletions(-)

diff --git a/contrib/chem/chem.1.man b/contrib/chem/chem.1.man
index 28e4290..9b383f9 100644
--- a/contrib/chem/chem.1.man
+++ b/contrib/chem/chem.1.man
@@ -84,20 +84,20 @@
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY @g@chem
-.OP \fI\%option \*(EL\fP
 .OP \-\-
-.OP \fI\%filespec \*(EL\fP
+.RI [ filespec
+\*(EL]
 .YS
 .
 .SY @g@chem
 .B \-h
-|
+.SY @g@chem
 .B \-\-help
 .YS
 .
 .SY @g@chem
 .B \-v
-|
+.SY @g@chem
 .B \-\-version
 .YS
 .
diff --git a/contrib/eqn2graph/eqn2graph.1.man b/contrib/eqn2graph/eqn2gr=
aph.1.man
index f9bd344..1318467 100644
--- a/contrib/eqn2graph/eqn2graph.1.man
+++ b/contrib/eqn2graph/eqn2graph.1.man
@@ -16,13 +16,17 @@ eqn2graph \- convert an EQN equation into a cropped i=
mage
 .
 .SY eqn2graph
 .OP \-format output-format
-.RI [ \%convert-arguments ]
+.RI [ convert-arguments ]
 .YS
 .
 .SY eqn2graph
 .B \-\-help
+.YS
+.
 .SY eqn2graph
-.RB { \-v | \-\-version }
+.B \-v
+.SY eqn2graph
+.B \-\-version
 .YS
 .
 .
diff --git a/contrib/gdiffmk/gdiffmk.1.man b/contrib/gdiffmk/gdiffmk.1.ma=
n
index 8fa83d6..028e909 100644
--- a/contrib/gdiffmk/gdiffmk.1.man
+++ b/contrib/gdiffmk/gdiffmk.1.man
@@ -32,25 +32,27 @@ gdiffmk \- mark differences between groff/nroff/troff=
 files
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY gdiffmk
-.OP \-a \%addmark
-.OP \-c \%changemark
-.OP \-d \%deletemark
-[\ \c
-.B \-D
-.OP \-B
-.OP \-M "mark1 mark2"
-]
-.OP \-x \%diffcmd
+.OP \-a addmark
+.OP \-c changemark
+.OP \-d deletemark
+.RB [ \-D
+.RB [ \-B ]
+.RB [ \-M
+.IR "mark1 mark2" ]]
+.OP \-x diffcmd
 .OP \-\-
-.OP \-\-help
-.OP \%\-\-version
-.I \%file1
-.I \%file2
-[\ \c
-.IR \%output \ \c
-]
+.I file1
+.I file2
+.RI [ output ]
+.YS
+.
+.SY gdiffmk
+.B \-\-help
 .YS
 .
+.SY gdiffmk
+.B \-\-version
+.YS
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
diff --git a/contrib/glilypond/glilypond.1.man b/contrib/glilypond/glilyp=
ond.1.man
index d9f1455..c98af76 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -44,12 +44,58 @@ glilypond \- integrate lilypond parts into groff
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY glilypond
-.OP options
+.RB [{ \-\-ly2eps | \-\-pdf2eps }]
+.RB [ \-e
+.IR directory ]
+.OP \-k
+.RB [ \-o
+.IR output-file ]
+.RB [ \-p
+.IR filename-prefix ]
+.RB [ \-t
+.IR tdir ]
+.RB [{ \-v | \-V }]
 .OP \-
 .OP \-\-
-.OP "\%filespec \*(EL"
+.RI [ filespec
+\*(EL]
+.SY glilypond
+.RB [{ \-\-ly2eps | \-\-pdf2eps }]
+.RB [ \-\-eps_dir
+.IR directory ]
+.OP \-\-keep_all
+.RB [ \-\-output
+.IR output-file ]
+.RB [ \-\-prefix
+.IR filename-prefix ]
+.RB [ \-\-temp_dir
+.IR tdir ]
+.OP \-\-verbose
+.OP \-
+.OP \-\-
+.RI [ filespec
+\*(EL]
 .YS
 .
+.SY glilypond
+.B \-?
+.SY glilypond
+.B \-h
+.SY glilypond
+.B \-\-help
+.SY glilypond
+.B \-\-usage
+.YS
+.
+.SY glilypond
+.B \-l
+.SY glilypond
+.B \-\-license
+.YS
+.
+.SY glilypond
+.B \-\-version
+.YS
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
diff --git a/contrib/gperl/gperl.1.man b/contrib/gperl/gperl.1.man
index c98ad2d..57e46cc 100644
--- a/contrib/gperl/gperl.1.man
+++ b/contrib/gperl/gperl.1.man
@@ -40,14 +40,21 @@ gperl \- groff preprocessor for Perl parts in roff fi=
les
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY gperl
-.OP \-
-.OP \-\-
-.OP \& "\%filespec \*(EL"
+.RI [ filespec
+\*(EL]
 .YS
 .
-.BR "gperl \-h" | \-\-help
-.br
-.BR "gperl \-v" | \-\-version
+.SY gperl
+.B \-h
+.SY gperl
+.B \-\-help
+.YS
+.
+.SY gperl
+.B \-v
+.SY gperl
+.B \-\-version
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/contrib/grap2graph/grap2graph.1.man b/contrib/grap2graph/gra=
p2graph.1.man
index 36475f6..5740360 100644
--- a/contrib/grap2graph/grap2graph.1.man
+++ b/contrib/grap2graph/grap2graph.1.man
@@ -17,13 +17,17 @@ grap2graph \- convert a GRAP diagram into a cropped i=
mage
 .SY grap2graph
 .OP \-unsafe
 .OP \-format output-format
-.RI [ \%convert-arguments ]
+.RI [ convert-arguments ]
 .YS
 .
 .SY grap2graph
 .B \-\-help
+.YS
+.
 .SY grap2graph
-.RB { \-v | \-\-version }
+.B \-v
+.SY grap2graph
+.B \-\-version
 .YS
 .
 .
diff --git a/contrib/groffer/groffer.1.man b/contrib/groffer/groffer.1.ma=
n
index 5723606..edd66d8 100644
--- a/contrib/groffer/groffer.1.man
+++ b/contrib/groffer/groffer.1.man
@@ -54,25 +54,29 @@ groffer \- display groff files and man\~pages on X an=
d tty
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY groffer
+.RI [ mode-option
+\*(EL]
+.RI [ groff-option
+\*(EL]
+.RI [ man-option
+\*(EL]
+.RI [ X-option
+\*(EL]
 .OP \-\-
-.OP \%filespec \*(EL
+.RI [ filespec
+\*(EL]
 .YS
 .
 .SY groffer
-.OP mode-option \*(EL
-.OP groff-options \*(EL
-.OP man-options \*(EL
-.OP X-options \*(EL
-.OP \-\-
-.OP \%filespec \*(EL
-.YS
-.
+.B \-h
 .SY groffer
-.BR \-h " | " \-\-help
+.B \-\-help
 .YS
 .
 .SY groffer
-.BR \-v " | " \-\-version
+.B \-v
+.SY groffer
+.B \-\-version
 .YS
 .
 .
diff --git a/contrib/groffer/roff2.1.man b/contrib/groffer/roff2.1.man
index fd48715..6eb2ebb 100644
--- a/contrib/groffer/roff2.1.man
+++ b/contrib/groffer/roff2.1.man
@@ -40,17 +40,23 @@ roff2@ROFF2MODE@ \- transform roff code into @ROFF2MO=
DE@ mode
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY roff2@ROFF2MODE@
-.OP \& "\%groffer_option \*(EL"
+.RI [ groffer-option
+\*(EL]
 .OP \-\-
-.OP \& "\%filespec \*(EL"
+.RI [ filespec
+\*(EL]
 .YS
 .
 .SY roff2@ROFF2MODE@
-.BR \-h | \-\-help
+.B \-h
+.SY roff2@ROFF2MODE@
+.B \-\-help
 .YS
 .
 .SY roff2@ROFF2MODE@
-.BR \-v | \-\-version
+.B \-v
+.SY roff2@ROFF2MODE@
+.B \-\-version
 .YS
 .
 .P
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 61da970..015ee9c 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -31,14 +31,17 @@ groff_mm \- memorandum macros for GNU roff
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B groff
-.B \-m@TMAC_M_PREFIX@m
-[
-.IR options .\|.\|.\&
-]
-[
-.IR files .\|.\|.\&
-]
+.SY "groff \-m@TMAC_M_PREFIX@m"
+.RI [ option
+\&.\|.\|.\&]
+.RI [ file
+\&.\|.\|.\&]
+.SY "groff \-m m@TMAC_M_PREFIX@m"
+.RI [ option
+\&.\|.\|.\&]
+.RI [ file
+\&.\|.\|.\&]
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/contrib/mm/groff_mmse.7.man b/contrib/mm/groff_mmse.7.man
index 3824a2b..d50a9cc 100644
--- a/contrib/mm/groff_mmse.7.man
+++ b/contrib/mm/groff_mmse.7.man
@@ -39,14 +39,17 @@ the original English.
 .SH SYNTAX
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B groff
-.B \-m@TMAC_M_PREFIX@mse
-[
-.IR flaggor .\|.\|.\&
-]
-[
-.IR filer .\|.\|.\&
-]
+.SY "groff \-m@TMAC_M_PREFIX@mse"
+.RI [ flaggor
+\&.\|.\|.\&]
+.RI [ filer
+\&.\|.\|.\&]
+.SY "groff \-m m@TMAC_M_PREFIX@mse"
+.RI [ flaggor
+\&.\|.\|.\&]
+.RI [ filer
+\&.\|.\|.\&]
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/contrib/mm/mmroff.1.man b/contrib/mm/mmroff.1.man
index db2c94e..be9c515 100644
--- a/contrib/mm/mmroff.1.man
+++ b/contrib/mm/mmroff.1.man
@@ -29,11 +29,10 @@ mmroff \- cross-reference preprocessor for GNU roff m=
m macro package
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B mmroff
-[
-.B \-x
-]
+.SY mmroff
+.OP \-x
 .I groff-arguments
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index 96d8a5c..7e7464c 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -68,19 +68,27 @@ groff_mom \- groff \[lq]mom\[rq] macros; \[lq]mom\[rq=
] is a \[lq]roff\[rq] langu
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY pdfmom
-.OP \-Tps "\fR[pdfroff options]"
-[groff options]
-.I files \*[Ellipsis]
+.RB [ \-Tps
+.RI [ pdfroff-option
+\*[Ellipsis]]]
+.RI [ groff-option
+\*[Ellipsis]]
+.I file
+\*[Ellipsis]
 .YS
 .
 .SY groff
-.OP \-mom
-.I files \*[Ellipsis]
-.YS
-.
+.B \-mom
+.RI [ option
+\*[Ellipsis]]
+.I file
+\*[Ellipsis]
 .SY groff
-.OP "\-m mom"
-.I files .\|.\|.
+.B "\-m mom"
+.RI [ option
+\*[Ellipsis]]
+.I file
+\*[Ellipsis]
 .YS
 .
 .
diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.ma=
n
index 0a0a7c2..88a5a0c 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -70,25 +70,34 @@ pdfroff \- create PDF documents using groff
 .OP \-\-emit\-ps
 .OP \-\-no\-toc\-relocation
 .OP \-\-no-kill\-null\-pages
-.OP \-\-stylesheet=3D\fIname\fP
+.RB [ \-\-stylesheet=3D\c
+.IR name ]
 .OP \-\-no\-pdf\-output
-.OP \-\-pdf\-output=3D\fIname\fP
+.RB [ \-\-pdf\-output=3D\c
+.IR name ]
 .OP \-\-no\-reference\-dictionary
-.OP \-\-reference\-dictionary=3D\fIname\fP
+.RB [ \-\-reference\-dictionary=3D\c
+.IR  name ]
 .OP \-\-report\-progress
 .OP \-\-keep\-temporary\-files
-.I file .\|.\|.
+.RI [ file
+\&.\|.\|.\&]
+.YS
 .
 .SY pdfroff
 .B \-h
-|
+.SY pdfroff
 .B \-\-help
+.YS
 .
 .SY pdfroff
 .B \-v
-|
+.RI [ groff-option
+\&.\|.\|.\&]
+.SY pdfroff
 .B \-\-version
-.RI [ option\ .\|.\|. ]
+.RI [ groff-option
+\&.\|.\|.\&]
 .YS
 .
 .
diff --git a/contrib/pic2graph/pic2graph.1.man b/contrib/pic2graph/pic2gr=
aph.1.man
index 00e5dee..a810e20 100644
--- a/contrib/pic2graph/pic2graph.1.man
+++ b/contrib/pic2graph/pic2graph.1.man
@@ -17,14 +17,18 @@ pic2graph \- convert a PIC diagram into a cropped ima=
ge
 .SY pic2graph
 .OP \-unsafe
 .OP \-format output-format
-.OP \-eqn delimeters
-.RI [ \%convert-arguments ]
+.OP \-eqn delimiters
+.RI [ convert-arguments ]
 .YS
 .
 .SY pic2graph
 .B \-\-help
+.YS
+.
 .SY pic2graph
-.RB { \-v | \-\-version }
+.B \-v
+.SY pic2graph
+.B \-\-version
 .YS
 .
 .
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.=
1.man
index b0aed5e..720aec2 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -38,18 +38,26 @@ grodvi \- convert groff output to TeX DVI format
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B grodvi
-[
-.B \-dlv
-] [
-.BI \-F dir
-] [
-.BI \-p papersize
-] [
-.BI \-w n
-] [
-.IR files \|.\|.\|.\&
-]
+.SY grodvi
+.OP \-dl
+.OP \-F dir
+.OP \-p papersize
+.OP \-w n
+.RI [ file
+\&.\|.\|.\&]
+.YS
+.
+.SY grodvi
+.B \-\-help
+.SY
+.
+.SY grodvi
+.B \-v
+.SY grodvi
+.B \-\-version
+.YS
+.
+.
 .PP
 It is possible to have whitespace between a command-line option and its
 parameter.
diff --git a/src/devices/grohtml/grohtml.1.man b/src/devices/grohtml/groh=
tml.1.man
index 93a97dc..6f9e386 100644
--- a/src/devices/grohtml/grohtml.1.man
+++ b/src/devices/grohtml/grohtml.1.man
@@ -28,21 +28,31 @@ grohtml \- HTML driver for groff
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY grohtml
-.OP \-bhlnprv
-.OP \-a \%aa-text-bits
+.OP \-bhlnprVy
+.OP \-a aa-text-bits
 .OP \-D dir
 .OP \-F dir
-.OP \-g \%aa-graphic-bits
-.OP \-i \%resolution
-.OP \-I \%image-stem
-.OP \-j \%filename
-.OP \-o \%image-vertical-offset
+.OP \-g aa-graphic-bits
+.OP \-i resolution
+.OP \-I image-stem
+.OP \-j filename
+.OP \-o image-vertical-offset
 .OP \-s size
 .OP \-S level
-.OP \-x \%html-dialect
-.RI "[\ " files\|.\|.\|. "\ ]"
+.OP \-x html-dialect
+.RI [ file
+\&.\|.\|.\&]
 .YS
 .
+.SY grohtml
+.B \-\-help
+.YS
+.
+.SY grohtml
+.B \-v
+.SY grohtml
+.B \-\-version
+.YS
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.=
1.man
index 3852cdf..73a7446 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -38,17 +38,23 @@ gropdf \- PDF driver for groff
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY gropdf
-.OP \-delvs
+.OP \-dels
 .OP \-F dir
 .OP \-I dir
-.OP \-p papersize
+.OP \-p paper-size
 \#.OP \-w n
+.RB [ \-u
+.RI [ cmapfile ]]
 .OP \-y foundry
-.OP \-u [cmapfile]
-.RI [ files
-.IR .\|.\|. ]
+.RI [ file
+\&.\|.\|.\&]
 .YS
 .
+.SY gropdf
+.B \-v
+.SY gropdf
+.B \-\-version
+.YS
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.ma=
n
index 47ae546..22a5d97 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -46,8 +46,8 @@ grops \- PostScript driver for groff
 .OP \-p papersize
 .OP \-P prologue
 .OP \-w n
-.RI [ files
-.IR .\|.\|. ]
+.RI [ file
+\&.\|.\|.\&]
 .YS
 .
 .
diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.=
1.man
index bba6140..902a0a6 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -32,14 +32,14 @@ grotty \- groff driver for typewriter-like devices
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B grotty
-[
-.B \-bBcdfhioruUv
-] [
-.BI \-F dir
-] [
-.IR files \|.\|.\|.\&
-]
+.SY grotty
+.OP \-bBcdfhioruUv
+.OP \-F dir
+.RI [ file
+\&.\|.\|.\&]
+.YS
+.
+.
 .PP
 It is possible to have whitespace between the
 .B \-F
diff --git a/src/devices/xditview/gxditview.1.man b/src/devices/xditview/=
gxditview.1.man
index a9e6bde..2f02c2c 100644
--- a/src/devices/xditview/gxditview.1.man
+++ b/src/devices/xditview/gxditview.1.man
@@ -33,10 +33,21 @@ gxditview \- display groff intermediate output files
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B \%gxditview
-.RI [\fB\- toolkitoption\  .\|.\|.\|]
-.RI [\fB\- option\  .\|.\|.\|]
-.RI [ filename ]
+.SY gxditview
+.RI [ X-toolkit-option \&.\|.\|.\&]
+.OP \-backingStore backing-store-type
+.OP \-filename string
+.OP \-page n
+.OP \-printCommand string
+.OP \-resolution res
+.RI [ file ]
+.YS
+.
+.SY gxditview
+.B \-help
+.SY gxditview
+.B \-\-help
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 707999b..ef428cf 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -48,7 +48,8 @@
 .OP \-s n
 .OP \-p n
 .OP \-m n
-.RI [ files\|.\|.\|. ]
+.RI [ file
+\&.\|.\|.\&]
 .YS
 .
 .
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index cfca060..dfa5293 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -37,22 +37,14 @@
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.BR @g@grn
-[
-.B \-Cv
-]
-[
-.BI \-T dev
-]
-[
-.BI \-M dir
-]
-[
-.BI \-F dir
-]
-[
-.IR file\.\.\.\&
-]
+.SY @g@grn
+.OP \-Cv
+.OP \-T dev
+.OP \-M dir
+.OP \-F dir
+.RI [ file
+\&.\|.\|.\&]
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 7c6c225..86ad8a4 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -55,24 +55,18 @@
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B @g@pic
-[
-.B \-nvCSU
-]
-[
-.I filename
-\&.\|.\|.\&
-]
-.br
-.B @g@pic
+.SY @g@pic
+.OP \-nvCSU
+.RI [ file
+\&.\|.\|.\&]
+.YS
+.
+.SY @g@pic
 .B \-t
-[
-.B \-cvzCSU
-]
-[
-.I filename
-\&.\|.\|.\&
-]
+.OP \-cvzCSU
+.RI [ file
+\&.\|.\|.\&]
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/src/preproc/preconv/preconv.1.man b/src/preproc/preconv/prec=
onv.1.man
index 44273d8..411867d 100644
--- a/src/preproc/preconv/preconv.1.man
+++ b/src/preproc/preconv/preconv.1.man
@@ -35,17 +35,18 @@ preconv \- convert encoding of input files to somethi=
ng GNU troff understands
 .SY preconv
 .OP \-dr
 .OP \-e encoding
-.RI [ files
-.IR .\|.\|. ]
+.RI [ file
+\&.\|.\|.\&]
 .
 .SY preconv
 .B \-h
-|
+.SY preconv
 .B \-\-help
+.YS
 .
 .SY preconv
 .B \-v
-|
+.SY preconv
 .B \-\-version
 .YS
 .
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.ma=
n
index cd509d0..8dd45d4 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -30,18 +30,29 @@
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY @g@refer
-.OP \-benvCPRS
+.OP \-benCPRS
 .OP \-a n
 .OP \-c fields
 .OP \-f n
 .OP \-i fields
 .OP \-k field
 .OP \-l m,n
-.OP \-p \%filename
+.OP \-p filename
 .OP \-s fields
 .OP \-t n
-.OP \-B field.macro
-.RI [\  \%filename \|.\|.\|.\ ]
+.BI "\-B " field . macro
+.RI [ file
+\&.\|.\|.\&]
+.YS
+.
+.SY @g@refer
+.B \-\-help
+.YS
+.
+.SY @g@refer
+.B \-v
+.SY @g@refer
+.B \-\-version
 .YS
 .
 .
diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.=
1.man
index e3a69d3..c17e258 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -37,8 +37,8 @@
 .SY @g@soelim
 .OP \-Crtv
 .OP \-I dir
-.RI [ files
-.IR \|.\|.\|. ]
+.RI [ file
+\&.\|.\|.\&]
 .YS
 .
 .
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index ace8fd5..48b9e9d 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -36,7 +36,8 @@
 .
 .SY @g@tbl
 .OP \-Cv
-.RI [ file\~ .\|.\|.]
+.RI [ file
+\&.\|.\|.\&]
 .YS
 .
 .
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 948f956..ae1bcdc 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -72,18 +72,24 @@ groff \- front-end for the groff document formatting =
system
 .OP \-T dev
 .OP \-w name
 .OP \-W name
-.RI [ file\~ .\|.\|.]
+.RI [ file
+\&.\|.\|.\&]
+.YS
 .
 .SY groff
 .B \-h
-|
+.SY groff
 .B \-\-help
+.YS
 .
 .SY groff
 .B \-v
-|
+.RI [ option
+\&.\|.\|.\&]
+.SY groff
 .B \-\-version
-.RI [ option\~ .\|.\|.]
+.RI [ option
+\&.\|.\|.\&]
 .YS
 .
 .
diff --git a/src/roff/grog/grog.1.man b/src/roff/grog/grog.1.man
index 7b5565b..7e4638a 100644
--- a/src/roff/grog/grog.1.man
+++ b/src/roff/grog/grog.1.man
@@ -49,15 +49,24 @@ grog \- guess options for a following groff command
 .OP \-\-run
 .OP \-\-warnings
 .OP \-\-ligatures
-.OP "\%groff\-option no arg"
-.OP "\%groff\-option with arg \*(EL"
+.RI [ groff-option
+\*(EL]
 .OP \-\-
-.OP "\%filespec \*(EL"
+.RI [ filespec
+\*(EL]
 .YS
 .
-.BR "grog \-h " | " \-\-help"
-.br
-.BR "grog \-v " | " \-\-version"
+.SY grog
+.B \-h
+.SY grog
+.B \-\-help
+.YS
+.
+.SY grog
+.B \-v
+.SY grog
+.B \-\-version
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/src/roff/nroff/nroff.1.man b/src/roff/nroff/nroff.1.man
index e070906..1161d2c 100644
--- a/src/roff/nroff/nroff.1.man
+++ b/src/roff/nroff/nroff.1.man
@@ -38,7 +38,7 @@
 ..
=20
 .SY @g@nroff
-.OP \-CchipStUvwW
+.OP \-CchipStUv
 .OP \-d cs
 .OP \-M dir
 .OP \-m name
@@ -46,14 +46,19 @@
 .OP \-o list
 .OP \-r cn
 .OP \-T name
-.RI [ file\~ .\|.\|.]
+.OP \-W warning
+.OP \-w warning
+.RI [ file
+\&.\|.\|.\&]
+.YS
 .
 .SY @g@nroff
 .B \-\-help
+.YS
 .
 .SY @g@nroff
 .B \-v
-|
+.SY @g@nroff
 .B \-\-version
 .YS
 .
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 120a490..7cf2080 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -43,7 +43,8 @@
 .OP \-T name
 .OP \-w name
 .OP \-W name
-.RI [ file\~ .\|.\|.]
+.RI [ file
+\&.\|.\|.\&]
 .YS
 .
 .
diff --git a/src/utils/addftinfo/addftinfo.1.man b/src/utils/addftinfo/ad=
dftinfo.1.man
index 60d7b1c..07c4312 100644
--- a/src/utils/addftinfo/addftinfo.1.man
+++ b/src/utils/addftinfo/addftinfo.1.man
@@ -39,16 +39,29 @@ addftinfo \- add information to troff font files for =
use with groff
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B addftinfo
-[
-.B \-v
-]
-[
-.IR "param-option value" \*(EL
-]
+.SY addftinfo
+.OP \-asc\-height n
+.OP \-body\-depth n
+.OP \-body\-height n
+.OP \-cap\-height n
+.OP \-comma\-depth n
+.OP \-desc\-depth n
+.OP \-fig\-height n
+.OP \-x\-height n
 .I res
 .I unitwidth
 .I font
+.YS
+.
+.SY addftinfo
+.B \-\-help
+.YS
+.
+.SY addftinfo
+.B \-v
+.SY addftinfo
+.B \-\-version
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/src/utils/afmtodit/afmtodit.1.man b/src/utils/afmtodit/afmto=
dit.1.man
index 7ffce17..f1371cd 100644
--- a/src/utils/afmtodit/afmtodit.1.man
+++ b/src/utils/afmtodit/afmtodit.1.man
@@ -29,7 +29,7 @@ afmtodit \- create font files for use with groff \-Tps =
and \-Tpdf
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY afmtodit
-.OP \-ckmnsvx
+.OP \-ckmnsx
 .OP \-a n
 .OP \-d desc_file
 .OP \-e enc_file
@@ -41,6 +41,10 @@ afmtodit \- create font files for use with groff \-Tps=
 and \-Tpdf
 .I font
 .YS
 .
+.SY afmtodit
+.B \-v
+.YS
+.
 .
 .LP
 The whitespace between a command-line option and its argument is optiona=
l.
diff --git a/src/utils/hpftodit/hpftodit.1.man b/src/utils/hpftodit/hpfto=
dit.1.man
index 63dfefc..a0a4c53 100644
--- a/src/utils/hpftodit/hpftodit.1.man
+++ b/src/utils/hpftodit/hpftodit.1.man
@@ -33,8 +33,9 @@ hpftodit \- create font description files for use with =
groff \-Tlj4
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
 .SY hpftodit
-.OP \-aqsv
+.OP \-aqs
 .OP \-i n
 .I tfm-file
 .I map-file
@@ -47,6 +48,16 @@ hpftodit \- create font description files for use with=
 groff \-Tlj4
 .RI [ map-file ]
 .YS
 .
+.SY hpftodit
+.B \-\-help
+.YS
+.
+.SY hpftodit
+.B \-v
+.SY hpftodit
+.B \-\-version
+.YS
+.
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
diff --git a/src/utils/indxbib/indxbib.1.man b/src/utils/indxbib/indxbib.=
1.man
index 1dd1052..8a63fa5 100644
--- a/src/utils/indxbib/indxbib.1.man
+++ b/src/utils/indxbib/indxbib.1.man
@@ -26,7 +26,7 @@
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY @g@indxbib
-.OP \-vw
+.OP \-w
 .OP \-c file
 .OP \-d dir
 .OP \-f file
@@ -37,9 +37,19 @@
 .OP \-n n
 .OP \-o file
 .OP \-t n
-.RI [\  filename \|.\|.\|.\ ]
+.RI [ filename
+\&.\|.\|.\&]
 .YS
 .
+.SY @g@indxbib
+.B \-\-help
+.YS
+.
+.SY @g@indxbib
+.B \-v
+.SY @g@indxbib
+.B \-\-version
+.YS
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
diff --git a/src/utils/lkbib/lkbib.1.man b/src/utils/lkbib/lkbib.1.man
index 5e3e831..9426949 100644
--- a/src/utils/lkbib/lkbib.1.man
+++ b/src/utils/lkbib/lkbib.1.man
@@ -29,20 +29,24 @@ lkbib \- search bibliographic databases
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B lkbib
-[
+.SY lkbib
+.OP \-n
+.OP \-i fields
+.OP \-p filename
+.OP \-t n
+.I key
+\&.\|.\|.\&
+.YS
+.
+.SY lkbib
+.B \-\-help
+.YS
+.
+.SY lkbib
 .B \-v
-]
-[
-.BI \-i fields
-]
-[
-.BI \-p filename
-]
-[
-.BI \-t n
-]
-.IR key \|.\|.\|.
+.SY lkbib
+.B \-\-version
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/src/utils/lookbib/lookbib.1.man b/src/utils/lookbib/lookbib.=
1.man
index 7e4b232..3baaa85 100644
--- a/src/utils/lookbib/lookbib.1.man
+++ b/src/utils/lookbib/lookbib.1.man
@@ -29,17 +29,22 @@
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B @g@lookbib
-[
+.SY @g@lookbib
+.OP \-i string
+.OP \-t n
+.I filename
+\&.\|.\|.\&
+.YS
+.
+.SY @g@lookbib
+.B \-\-help
+.YS
+.
+.SY @g@lookbib
 .B \-v
-]
-[
-.BI \-i string
-]
-[
-.BI \-t n
-]
-.IR filename \|.\|.\|.
+.SY @g@lookbib
+.B \-\-version
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
diff --git a/src/utils/pfbtops/pfbtops.1.man b/src/utils/pfbtops/pfbtops.=
1.man
index 278aada..0da731d 100644
--- a/src/utils/pfbtops/pfbtops.1.man
+++ b/src/utils/pfbtops/pfbtops.1.man
@@ -29,14 +29,19 @@ pfbtops \- translate a PostScript font in .pfb format=
 to ASCII
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B pfbtops
-[
-.B \-v
-]
-[
-.I pfb_file
-]
+.SY pfbtops
+.RI [ pfb_file ]
+.YS
 .
+.SY pfbtops
+.B \-\-help
+.YS
+.
+.SY pfbtops
+.B \-v
+.SY pfbtops
+.B \-\-version
+.YS
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
diff --git a/src/utils/tfmtodit/tfmtodit.1.man b/src/utils/tfmtodit/tfmto=
dit.1.man
index c6126c0..634545d 100644
--- a/src/utils/tfmtodit/tfmtodit.1.man
+++ b/src/utils/tfmtodit/tfmtodit.1.man
@@ -38,7 +38,7 @@ tfmtodit \- create font files for use with groff \-Tdvi
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .SY tfmtodit
-.OP \-sv
+.OP \-s
 .OP \-g gf_file
 .OP \-k skewchar
 .I tfm_file
@@ -46,6 +46,16 @@ tfmtodit \- create font files for use with groff \-Tdv=
i
 .I font
 .YS
 .
+.SY tfmtodit
+.B \-\-help
+.YS
+.
+.SY tfmtodit
+.B \-v
+.SY tfmtodit
+.B \-\-version
+.YS
+.
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH DESCRIPTION
diff --git a/src/utils/xtotroff/xtotroff.1.man b/src/utils/xtotroff/xtotr=
off.1.man
index d87d9af..42b77e6 100644
--- a/src/utils/xtotroff/xtotroff.1.man
+++ b/src/utils/xtotroff/xtotroff.1.man
@@ -29,17 +29,21 @@ xtotroff \- convert X font metrics into GNU troff fon=
t metrics
 .SH SYNOPSIS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-.B xtotroff
-[
-.BI \-r \%resolution
-]
-[
-.BI \-s \%point-size
-]
-[
-.B \-v
-]
+.SY xtotroff
+.OP \-r resolution
+.OP \-s point-size
 .I FontMap
+.YS
+.
+.SY xtotroff
+.B \-\-help
+.YS
+.
+.SY xtotroff
+.B \-v
+.SY xtotroff
+.B \-\-version
+.YS
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D


From MAILER-DAEMON Fri Jun 29 14:41:37 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fYyKv-0003Zu-R8
	for mharc-groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:37 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59939)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKt-0003Ze-D3
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:36 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-000871-9x
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:35 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:47295)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-00086h-6V
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:34 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id E84462053C; Fri, 29 Jun 2018 14:41:33 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 02/05: groff_man(7): Demote some sections to subsections.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180629184133.4844.8728@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 79548f0073c448594e8f3181ba65ba4da4407afd
Auto-Submitted: auto-generated
Message-Id: <20180629184133.E84462053C@vcs0.savannah.gnu.org>
Date: Fri, 29 Jun 2018 14:41:33 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 29 Jun 2018 18:41:36 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 79548f0073c448594e8f3181ba65ba4da4407afd
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Jun 28 20:59:14 2018 -0400

    groff_man(7): Demote some sections to subsections.
   =20
    * Use sentence-case instead of title-case.  Our man pages, when they =
use
      subsections at all, split on this convention.  Sentence-case is wha=
t
      man-pages(7) recommends, and is consistent with our pages grops(1),
      gropdf(1), tbl(1), refer(1), groff_hdtbl(1), groff_mm(7),
      groff_diff(7), groff_font(7), and groff_ms(7).
   =20
    * Shorten "Portability of troff requests" subsection title to just
      "Portability", since we added a huge section on escapes a while bac=
k.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 tmac/groff_man.7.man | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 01810f8..4e43a37 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -66,7 +66,7 @@ package.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH USAGE
+.SS Usage
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 This section describes the available macros for manual pages.
@@ -461,7 +461,7 @@ also cause a break but no insertion of vertical space=
.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH "MACROS TO SET FONTS"
+.SS "Macros to set fonts"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 The standard font is Roman; the default text size is 10\~point.
@@ -560,7 +560,7 @@ appear in a font that is one point size smaller than =
the default font.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH "MACROS TO DESCRIBE HYPERLINKS AND EMAIL ADDRESSES"
+.SS "Macros to describe hyperlinks and email addresses"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 The following macros are not defined on legacy Unix systems
@@ -668,7 +668,7 @@ omitted.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH "MACROS TO DESCRIBE COMMAND SYNOPSES"
+.SS "Macros to describe command synopses"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 The following macros are not defined on legacy Unix systems
@@ -853,7 +853,7 @@ regarding the narrow-space escape sequence \(lq\e|\(r=
q.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH "MISCELLANEOUS"
+.SS Miscellaneous
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 The default indentation is 7.2n in troff mode and 7n in nroff mode
@@ -1025,7 +1025,7 @@ preprocessor(s).
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH "PORTABILITY AND TROFF REQUESTS"
+.SS Portability
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 Since the


From MAILER-DAEMON Fri Jun 29 14:41:39 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fYyKw-0003aa-Ua
	for mharc-groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:38 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59951)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKt-0003Zg-Vg
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:37 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-00087r-JW
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:36 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:47304)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-00087c-Fv
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:34 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 5A5A82053C; Fri, 29 Jun 2018 14:41:34 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 05/05: groff_man(7): Flesh out new subsections.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180629184133.4844.8728@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 1eb2f1b33833f09bf57aa33845bed1acbff86c8f
Auto-Submitted: auto-generated
Message-Id: <20180629184134.5A5A82053C@vcs0.savannah.gnu.org>
Date: Fri, 29 Jun 2018 14:41:34 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 29 Jun 2018 18:41:37 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 1eb2f1b33833f09bf57aa33845bed1acbff86c8f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Fri Jun 29 14:28:48 2018 -0400

    groff_man(7): Flesh out new subsections.
   =20
    Also:
    * Recast introduction.
    * Add introductory paragraphs to new subsections.
    * Split "Miscellaneous" subsection into:
      + Horizontal and vertical spacing
      + String registers
      + Interaction with preprocessors
    * Relocate material about which requests cause breaks and vertical
      spacing to new "Horizontal and vertical spacing" subsection.
    * Add information about indentation of .SH and .SS headings.
    * Exhort people not to try to fake up tables and multi-column output
      with macro calls; steer them to tbl(1).
    * Recast some of the preprocessor discussion.
    * Use a straight apostrophe glyph for formatter hint comment example;
      this was rendering as non-ASCII character on the PDF output device.
    * Bump copyright year range end to 2018 since there's new stuff here.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 tmac/groff_man.7.man | 223 ++++++++++++++++++++++++++++++++++++++++-----=
------
 1 file changed, 177 insertions(+), 46 deletions(-)

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 23cc218..143b9d7 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -13,7 +13,7 @@ groff_man \- GNU roff macro package for formatting man =
pages
 .\" Legal Terms
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .\"
-.\" Copyright (C) 1999-2017 Free Software Foundation, Inc.
+.\" Copyright (C) 1999-2018 Free Software Foundation, Inc.
 .\"
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
@@ -56,14 +56,15 @@ groff_man \- GNU roff macro package for formatting ma=
n pages
 .
 The
 .B man
-macros used to generate
-.I man\~pages
-with
+macro package for
 .I groff
-were written by James Clark.
+is used to produce manual pages
+.RI (\(lq man\~pages \(rq)
+like the one you are reading.
 .
-This document provides a brief summary of the use of each macro in that
-package.
+GNU
+.IR roff 's
+implementation was written by James Clark.
 .
 .
 .PP
@@ -139,6 +140,43 @@ package.
 .SS "Document structure macros"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
+The highest level of organization of a man page is determined by this
+group of macros.
+.
+.B .TH
+(title heading) identifies the document as a man page and defines
+fundamental information enabling its indexing by
+.BR mandb (8).
+.
+Sections
+.RB ( .SH ),
+one of which is mandatory and many of which are standardized,
+facilitate quick location of relevant information by the reader and aid
+the man page writer to comprehensively discuss all essential aspects of
+the topic.
+.
+Subsections
+.RB ( .SS )
+are optional and permit sections that grow long to develop in a
+controlled way.
+.
+Many technical discussions require examples;
+lengthy ones,
+especially those reflecting multiple lines of input to or output from
+the system,
+are usefully bracketed by
+.B .EX
+and
+.BR .EE .
+.
+When none of the foregoing meets a structural demand,
+a section of the discussion can be manually indented within
+.B .RS
+and
+.B .RE
+macros.
+.
+.
 .TP
 .BI .TH " title section \fR[\fPextra1\fR]\fP \fR[\fPextra2\fR]\fP \fR[\f=
Pextra3\fR]"
 Set the title of the
@@ -294,34 +332,31 @@ yet) has number\~1, and each call to
 increases the level by\~1.
 .
 .
-.PP
-To summarize, the following macros cause a line break with the
-insertion of vertical space (which amount can be changed with the
-.B PD
-macro):
-.BR SH ,
-.BR SS ,
-.BR TP ,
-.BR TQ ,
-.B LP
-.RB ( PP ,
-.BR P ),
-.BR IP ,
-and
-.BR HP .
-The macros
-.BR RS ,
-.BR RE ,
-.BR EX ,
-and
-.B EE
-also cause a break but no insertion of vertical space.
-.
-.
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SS "Paragraph macros"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
+A typical paragraph
+.RB ( .PP )
+is set left at the prevailing indent.
+.
+In man pages and other technical literature,
+definition lists are frequently encountered;
+these can be set as \(lqtagged paragraphs\(rq
+.RB ( .TP
+and
+.BR .TQ ),
+which have one or more leading tags followed by a paragraph that has an
+additional left indent.
+.
+The \(lqindented paragraph\(rq
+.RB ( .IP )
+macro is useful to continue the indented content of a narrative started
+with
+.BR .TP ,
+or to set up an itemized or ordered list.
+.
+.
 .TP
 .B .LP
 .TQ
@@ -869,16 +904,81 @@ The text must be on the same line as the macro call=
.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SS Miscellaneous
+.SS "Horizontal and vertical spacing"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-The default indentation is 7.2n in troff mode and 7n in nroff mode
+The default indentation,
+exhibited by ordinary
+.B .PP
+paragraphs not within an
+.BR .RS / .RE
+relative indent,
+is 7.2n in
+.I troff
+mode and 7n in
+.I nroff
+mode,
 except for
 .BR grohtml ,
 which ignores indentation.
 .
+Section headings
+.RB ( .SH )
+are set flush with the left margin,
+and subsection headings
+.RB ( .SS )
+are indented 3n.
+.
 .
 .PP
+Resist the temptation to mock up tabular or multi-column output with
+ASCII tab characters or the indentation arguments to
+.BR .IP ,
+.BR .TP ,
+.BR .RS ,
+or the deprecated
+.BR .HP ;
+the result may not render comprehensibly on an output device you fail to
+check,
+or which is developed in the future.
+.
+The table preprocessor
+.BR tbl (1)
+can likely meet your needs.
+.
+.
+.PP
+The following macros cause a line break with the
+insertion of vertical space:
+.BR SH ,
+.BR SS ,
+.BR TP ,
+.BR TQ ,
+.B LP
+.RB ( PP ,
+.BR P ),
+.BR IP ,
+and the deprecated
+.BR HP .
+.
+(The deprecated macro
+.B .PD
+can change this vertical spacing,
+but its use is discouraged.)
+.
+The macros
+.BR RS ,
+.BR RE ,
+.BR EX ,
+and
+.B EE
+also cause a break but no insertion of vertical space.
+.
+.
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SS "String registers"
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
 The following strings are defined:
 .
 .
@@ -913,38 +1013,66 @@ The default is \[oq]B\[cq].
 The \[oq]trademark\[cq] sign.
 .
 .
-.PP
-If a preprocessor like
-.B @g@tbl
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SS "Interaction with preprocessors"
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
+When a preprocessor like
+.I @g@tbl
 or
-.B @g@eqn
-is needed, it has become common to make the first line of the
-.I \%man\~page
-look like this:
+.I @g@eqn
+is needed,
+a hint can be given to the man page formatter by making the first line
+of a man page look like this:
 .
 .
 .PP
 .RS
-.BI '\e"\  word
+.BI \(aq\e"\  word
 .RE
 .
 .
 .PP
-Note the single space character after the double quote.
+Note that the line starts with an apostrophe (\(aq),
+not a dot,
+and that a single space character follows the double quote.
+The
 .I word
-consists of letters for the needed preprocessors: \[oq]e\[cq] for
+consists of one letter for each needed preprocessor:
+\[oq]e\[cq] for
 .BR @g@eqn ,
 \[oq]r\[cq] for
 .BR @g@refer ,
-and \[oq]t\[cq] for
+and
+\[oq]t\[cq] for
 .BR @g@tbl .
 .
 Modern implementations of the
-.B man
-program read this first line and automatically call the right
+.I man
+program interpret this first line and automatically call the right
 preprocessor(s).
 .
 .
+.PP
+The usual
+.I tbl
+and
+.I eqn
+macros for table and equation inclusion,
+.BR .TS ,
+.BR .T& ,
+.BR .TE ,
+.BR .EQ ,
+and
+.BR .EN ,
+may be used freely.
+.
+Note that
+.I nroff
+output devices are extremely limited in presentation of mathematical
+equations.
+.
+.
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SS Portability
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
@@ -1253,6 +1381,9 @@ not listed above are better avoided in manual pages=
.
 .SS "Deprecated features"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
+Use of the following is discouraged.
+.
+.
 .TP
 .BI .AT " \fR[\fPsystem \fR[\fPrelease\fR]]\fP"
 Alter the footer for use with \f[CR]AT&T\f[]


From MAILER-DAEMON Fri Jun 29 14:41:39 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fYyKx-0003ah-1z
	for mharc-groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:39 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59948)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKt-0003Zf-RY
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:37 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-00087M-Bm
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:35 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:47293)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-00086f-6Z
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:34 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id CCB8C2053B; Fri, 29 Jun 2018 14:41:33 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 01/05: groff_man(7): Relocate the Options section.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180629184133.4844.8728@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 5cde3214d2fe301f41d9b27026d75ea47d656705
Auto-Submitted: auto-generated
Message-Id: <20180629184133.CCB8C2053B@vcs0.savannah.gnu.org>
Date: Fri, 29 Jun 2018 14:41:33 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 29 Jun 2018 18:41:37 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 5cde3214d2fe301f41d9b27026d75ea47d656705
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Jun 28 20:46:47 2018 -0400

    groff_man(7): Relocate the Options section.
   =20
    ...to follow all the sections that are really just extensions of the
    Description section, which is really just an introductory paragraph.
   =20
    This commit is to prepare for conversion of those many aforementioned
    sections to subsections, which are not presently used in this page.
   =20
    The objective is to get the information that man page writers need to
    know in front of them sooner rather than later, and particularly befo=
re
    the use of groff options with the macro package, which is a pretty
    esoteric use case.  Most people will feed the package register settin=
gs
    via man(1), perhaps unknowingly, and if at all.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 tmac/groff_man.7.man | 316 +++++++++++++++++++++++++--------------------=
------
 1 file changed, 158 insertions(+), 158 deletions(-)

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 5c06e2a..01810f8 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -66,164 +66,6 @@ package.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SH OPTIONS
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
-The
-.B man
-macros understand the following command-line options (which define
-various registers).
-.
-.
-.TP
-.B \-rcR=3D1
-This option (the default if in nroff mode) creates a single, very
-long page instead of multiple pages.
-.
-Say
-.B \-rcR=3D0
-to disable it.
-.
-.
-.TP
-.B \-rC1
-If more than one manual page is given on the command line, number the
-pages continuously, rather than starting each at\~1.
-.
-.
-.TP
-.B \-rD1
-Double-sided printing.
-.
-Footers for even and odd pages are formatted differently.
-.
-.
-.TP
-.BI \-rFT=3D dist
-Set distance of the footer relative to the bottom of the page if
-negative or relative to the top if positive.
-.
-The default is \-0.5i.
-.
-.
-.TP
-.BI \-rHY=3D flags
-Set hyphenation flags.
-.
-Possible values are 1\~to not hyphenate the first and last character
-of a word, 2\~to not hyphenate the last word on a page, 4\~to not
-hyphenate the last two characters of a word, 8\~to not hyphenate the
-first two characters of a word, 16\~to enable hyphenation before the
-last character of a word, and 32 to enable hyphenation after the
-first character of a word.
-.
-These values are additive; the default is\~6.  Using values 4 and\~16
-can't be used together since they contradict each other; the same
-holds for values 8 and\~32.
-.
-.
-.TP
-.BI \-rIN=3D width
-Set body text indentation to
-.IR width .
-.
-The default is 7n for
-.IR nroff ,
-7.2n for
-.IR troff .
-.
-For
-.IR nroff ,
-this value should always be an integer multiple of unit \[oq]n\[cq] to
-get consistent indentation.
-.
-.
-.TP
-.BI \-rLL=3D line-length
-Set line length.
-.
-If this option is not given, the line length is set to respect any
-value set by a prior \[oq].ll\[cq] request (which
-.I must
-be in effect when the \[oq].TH\[cq] macro is invoked),
-if this differs from the built\-in default for the formatter;
-otherwise it defaults to 78n in
-.I nroff
-mode and 6.5i in
-.I troff
-mode.
-.
-.
-.IP
-Note that the use of a \[oq].ll\[cq] request to initialize the line
-length is supported for backward compatibility with some versions of
-the
-.B man
-program;
-direct initialization of the \[oq]LL\[cq] register should
-.I always
-be preferred to the use of such a request.
-.
-In particular, note that a \[oq].ll\ 65n\[cq] request does
-.I not
-preserve the normal
-.I nroff
-default line length,
-(the
-.B man
-default initialization to 78n prevails), whereas, the
-\[oq]\-rLL=3D65n\[cq] option, or an equivalent \[oq].nr\ LL\ 65n\[cq]
-request preceding the use of the \[oq]TH\[cq] macro,
-.I does
-set a line length of 65n.
-.
-.
-.TP
-.BI \-rLT=3D title-length
-Set title length.
-.
-If this option is not given, the title length defaults to the line
-length.
-.
-.
-.TP
-.BI \-rP nnn
-Enumeration of pages start with
-.I nnn
-rather than with\~1.
-.
-.
-.TP
-.BI \-rS xx
-Base document font size is
-.I xx
-points
-.RI ( xx
-can be 10, 11, or\~12) rather than 10\~points.
-.
-.
-.TP
-.BI \-rSN=3D width
-Set sub-subheading indentation to
-.IR width .
-The default is 3n.
-.
-.
-.TP
-.BI \-rX nnn
-After page\~\c
-.IR nnn ,
-number pages as
-.IR nnn a,
-.IR nnn b,
-.IR nnn c,
-etc.
-.
-For example, the option \[oq]\-rX2\[cq] produces the following page
-numbers: 1, 2, 2a, 2b, 2c, etc.
-.
-.
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH USAGE
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
@@ -1486,6 +1328,164 @@ not listed above are better avoided in manual pag=
es.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SH OPTIONS
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
+The
+.B man
+macros understand the following command-line options (which define
+various registers).
+.
+.
+.TP
+.B \-rcR=3D1
+This option (the default if in nroff mode) creates a single, very
+long page instead of multiple pages.
+.
+Say
+.B \-rcR=3D0
+to disable it.
+.
+.
+.TP
+.B \-rC1
+If more than one manual page is given on the command line, number the
+pages continuously, rather than starting each at\~1.
+.
+.
+.TP
+.B \-rD1
+Double-sided printing.
+.
+Footers for even and odd pages are formatted differently.
+.
+.
+.TP
+.BI \-rFT=3D dist
+Set distance of the footer relative to the bottom of the page if
+negative or relative to the top if positive.
+.
+The default is \-0.5i.
+.
+.
+.TP
+.BI \-rHY=3D flags
+Set hyphenation flags.
+.
+Possible values are 1\~to not hyphenate the first and last character
+of a word, 2\~to not hyphenate the last word on a page, 4\~to not
+hyphenate the last two characters of a word, 8\~to not hyphenate the
+first two characters of a word, 16\~to enable hyphenation before the
+last character of a word, and 32 to enable hyphenation after the
+first character of a word.
+.
+These values are additive; the default is\~6.  Using values 4 and\~16
+can't be used together since they contradict each other; the same
+holds for values 8 and\~32.
+.
+.
+.TP
+.BI \-rIN=3D width
+Set body text indentation to
+.IR width .
+.
+The default is 7n for
+.IR nroff ,
+7.2n for
+.IR troff .
+.
+For
+.IR nroff ,
+this value should always be an integer multiple of unit \[oq]n\[cq] to
+get consistent indentation.
+.
+.
+.TP
+.BI \-rLL=3D line-length
+Set line length.
+.
+If this option is not given, the line length is set to respect any
+value set by a prior \[oq].ll\[cq] request (which
+.I must
+be in effect when the \[oq].TH\[cq] macro is invoked),
+if this differs from the built\-in default for the formatter;
+otherwise it defaults to 78n in
+.I nroff
+mode and 6.5i in
+.I troff
+mode.
+.
+.
+.IP
+Note that the use of a \[oq].ll\[cq] request to initialize the line
+length is supported for backward compatibility with some versions of
+the
+.B man
+program;
+direct initialization of the \[oq]LL\[cq] register should
+.I always
+be preferred to the use of such a request.
+.
+In particular, note that a \[oq].ll\ 65n\[cq] request does
+.I not
+preserve the normal
+.I nroff
+default line length,
+(the
+.B man
+default initialization to 78n prevails), whereas, the
+\[oq]\-rLL=3D65n\[cq] option, or an equivalent \[oq].nr\ LL\ 65n\[cq]
+request preceding the use of the \[oq]TH\[cq] macro,
+.I does
+set a line length of 65n.
+.
+.
+.TP
+.BI \-rLT=3D title-length
+Set title length.
+.
+If this option is not given, the title length defaults to the line
+length.
+.
+.
+.TP
+.BI \-rP nnn
+Enumeration of pages start with
+.I nnn
+rather than with\~1.
+.
+.
+.TP
+.BI \-rS xx
+Base document font size is
+.I xx
+points
+.RI ( xx
+can be 10, 11, or\~12) rather than 10\~points.
+.
+.
+.TP
+.BI \-rSN=3D width
+Set sub-subheading indentation to
+.IR width .
+The default is 3n.
+.
+.
+.TP
+.BI \-rX nnn
+After page\~\c
+.IR nnn ,
+number pages as
+.IR nnn a,
+.IR nnn b,
+.IR nnn c,
+etc.
+.
+For example, the option \[oq]\-rX2\[cq] produces the following page
+numbers: 1, 2, 2a, 2b, 2c, etc.
+.
+.
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH FILES
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .


From MAILER-DAEMON Fri Jun 29 14:41:44 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fYyL2-0003dj-5v
	for mharc-groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:44 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59972)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKw-0003aD-67
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:42 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-00087g-HK
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:38 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:47302)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-00087L-Bl
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:34 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 3BD272053B; Fri, 29 Jun 2018 14:41:34 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 04/05: groff_man(7): Rearrange macro discussion.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180629184133.4844.8728@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 96bacd514effda8cf261b7d77dfd0ce4372b8d91
Auto-Submitted: auto-generated
Message-Id: <20180629184134.3BD272053B@vcs0.savannah.gnu.org>
Date: Fri, 29 Jun 2018 14:41:34 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 29 Jun 2018 18:41:42 -0000

gbranden pushed a commit to branch master
in repository groff.

commit 96bacd514effda8cf261b7d77dfd0ce4372b8d91
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Fri Jun 29 11:02:10 2018 -0400

    groff_man(7): Rearrange macro discussion.
   =20
    Organize macro descriptions into more (sub)sections, adding "document
    structure macros", "font face macros", and "paragraph macros".  Also =
add
    a "deprecated features" subsequent, thus named so we can put more tha=
n
    just macros into it, if necessary.
   =20
    Retitle subsections covering command synopses and email addresses and
    URLs to be shorter and fit in the table on an 80-column TTY.
   =20
    Precede macro discussions with a table alphabetically listing all
    non-deprecated macros and referring the reader to the subsection wher=
e
    they are described.
   =20
    Add paragraph mentioning deprecated macros not mentioned in the table=
.
   =20
    Present macros in each subsection in a more pedagogically useful orde=
r.
    For instance, the very first macro a person writing a man page from
    scratch needs to know about is .TH.  (The previous ordering was not
    strictly alphabetical anyway; we started with .EX, not the
    strictly-first .AT, and not .B, the first non-deprecated macro.)
   =20
    No alterations were made to relocated material for this commit.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 tmac/groff_man.7.man | 1103 +++++++++++++++++++++++++++-----------------=
------
 1 file changed, 587 insertions(+), 516 deletions(-)

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 0fc84ce..23cc218 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -1,3 +1,4 @@
+'\" t
 .TH GROFF_MAN @MAN7EXT@ "@MDATE@" "groff @VERSION@"
 .SH NAME
 groff_man \- GNU roff macro package for formatting man pages
@@ -65,12 +66,67 @@ This document provides a brief summary of the use of =
each macro in that
 package.
 .
 .
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SS Usage
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.PP
+This document presents the macros thematically to aid learners;
+for those needing only a quick reference,
+the following table lists them alphabetically,
+with cross-references to appropriate subsections below.
+.
+.
+.PP
+.TS
+l l l.
+Macro	Meaning	Subsection
+.T&
+lB l l.
+_
+\&.B	Boldface	Font face macros
+\&.BI	Boldface, italic alternating	Font face macros
+\&.BR	Boldface, roman alternating	Font face macros
+\&.EE	Example end	Document structure macros
+\&.EX	Example begin	Document structure macros
+\&.I	Italic	Font face macros
+\&.IB	Italic, boldface alternating	Font face macros
+\&.IP	Indented paragraph	Paragraph macros
+\&.IR	Italic, roman alternating	Font face macros
+\&.LP	(Left) paragraph	Paragraph macros
+\&.ME	Mail-to end	Hyperlink and email macros
+\&.MT	Mail-to start	Hyperlink and email macros
+\&.OP	(Command-line) option	Command synopsis macros
+\&.P	Paragraph	Paragraph macros
+\&.PP	Paragraph	Paragraph macros
+\&.RB	Roman, boldface alternating	Font face macros
+\&.RE	Relative-indent end	Document structure macros
+\&.RI	Roman, italic alternating	Font face macros
+\&.RS	Relative-indent start	Document structure macros
+\&.SB	Small boldface	Font face macros
+\&.SH	Section heading	Document structure macros
+\&.SM	Small	Font face macros
+\&.SS	Subection heading	Document structure macros
+\&.SY	Synopsis start	Command synopsis macros
+\&.TH	Title heading	Document structure macros
+\&.TP	Tagged paragraph	Paragraph macros
+\&.TQ	Tagged paragraph continuation	Paragraph macros
+\&.UE	URL end	Hyperlink and email macros
+\&.UR	URL start	Hyperlink and email macros
+\&.YS	Synopsis end	Command synopsis macros
+.TE
+.
+.
+.PP
+Macros whose use we discourage
+.RB ( .AT ,
+.BR .BT ,
+.BR .DT ,
+.BR .HP ,
+.BR .PD ,
+.BR .PT ,
+and
+.BR .UC )
+are described in subsection \(lqDeprecated features\(rq, below.
 .
-This section describes the available macros for manual pages.
 .
+.PP
 For further customization, put additional macros and requests into the
 file
 .BR man.local ,
@@ -79,6 +135,99 @@ which is loaded immediately after the
 package.
 .
 .
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SS "Document structure macros"
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
+.TP
+.BI .TH " title section \fR[\fPextra1\fR]\fP \fR[\fPextra2\fR]\fP \fR[\f=
Pextra3\fR]"
+Set the title of the
+.I man\~page
+to
+.I title
+and the section to
+.IR section ,
+which must take on a value between 1 and\~8.
+.
+The value
+.I section
+may also have a string appended, e.g.\& \[oq].pm\[cq], to indicate a
+specific subsection of the
+.IR \%man\~pages .
+.
+Both
+.I title
+and
+.I section
+are positioned at the left and right in the header line (with
+.I section
+in parentheses immediately appended to
+.IR title .
+.
+.I extra1
+is positioned in the middle of the footer line.
+.
+.I extra2
+is positioned at the left in the footer line (or at the left on
+even pages and at the right on odd pages if double-sided printing is
+active).
+.
+.I extra3
+is centered in the header line.
+.
+.
+.IP
+For HTML output, headers and footers are completely suppressed.
+.
+.
+.IP
+Additionally, this macro starts a new page; the new line number is\~1
+again (except if the \[oq]\-rC1\[cq] option is given on the command
+line) -- this feature is intended only for formatting multiple
+.IR \%man\~pages ;
+a single
+.I \%man\~page
+should contain exactly one
+.B TH
+macro at the beginning of the file.
+.
+.
+.TP
+.BI .SH " \fR[\fPtext for a heading\fR]\fP"
+Set up an unnumbered section heading sticking out to the left.
+.
+Prints out all the text following
+.B .SH
+up to the end of the line (or the text in the next input line if there
+is no argument to
+.BR .SH )
+in bold face
+(or the font specified by the string
+.BR HF ),
+one size larger than the base document size.
+.
+Additionally, the left margin and the indentation for the following
+text is reset to the default values.
+.
+.
+.TP
+.BI .SS " \fR[\fPtext for a heading\fR]\fP"
+Set up a secondary, unnumbered section heading.
+.
+Prints out all the text following
+.B .SS
+up to the end of the line (or the text in the next input line if there
+is no argument to
+.BR .SS )
+in bold face
+(or the font specified by the string
+.BR HF ),
+at the same size as the base document size.
+.
+Additionally, the left margin and the indentation for the following
+text is reset to the default values.
+.
+.
 .TP
 .B .EX
 .TQ
@@ -110,114 +259,68 @@ installation.
 .
 .
 .TP
-.BI .HP " \fR[\fPnnn\fR]\fP"
-Set up a paragraph with hanging left indentation.
-.
-The indentation is set to
+.BI .RS " \fR[\fPnnn\fR]\fP"
+This macro moves the left margin to the right by the value
 .I nnn
-if that argument is supplied (the default unit is \[oq]n\[cq] if
-omitted), otherwise it is set to the previous indentation value
-specified with
+if specified (default unit is \[oq]n\[cq]); otherwise it is set to the
+previous indentation value specified with
 .BR .TP ,
 .BR .IP ,
 or
 .B .HP
 (or to the default value if none of them have been used yet).
 .
-Font size and face are reset to its default values.
-.
-The following paragraph illustrates the effect of this macro with
-hanging indentation set to\~4 (enclosed by
-.B .RS
-and
-.B .RE
-to set the left margin temporarily to the current indentation):
-.
-.
-.RS
-.HP 4
-This is a paragraph following an invocation of the
-.B HP
-macro.
-.
-As you can see, it produces a paragraph where all lines but the first
-are indented.
-.RE
+The indentation value is then set to the default.
 .
 .
 .IP
-Use of this presentation-level macro is deprecated.
-.
-While it is universally portable to legacy Unix systems, a hanging
-indentation cannot be expressed naturally under HTML, and many
-HTML-based manual viewers simply interpret it as a starter for a
-normal paragraph.
-.
-Thus, any information or distinction you tried to express with the
-indentation may be lost.
+Calls to the
+.B RS
+macro can be nested.
 .
 .
 .TP
-.BI .IP " \fR[\fPdesignator\fR]\fP \fR[\fPnnn\fR]\fP"
-Set up an indented paragraph, using
-.I designator
-as a tag to mark its beginning.
-.
-The indentation is set to
-.I nnn
-if that argument is supplied (the default unit is \[oq]n\[cq] if
-omitted), otherwise it is set to the previous indentation value
-specified with
-.BR .TP ,
-.BR .IP ,
-or
-.B .HP
-(or to the default value if none of them have been used yet).
-.
-Font size and face of the paragraph (but not the designator) are reset
-to its default values.
-.
-.
-.IP
-To start an indented paragraph with a particular indentation but
-without a designator, use \[oq]""\[cq] (two doublequotes) as the
-first argument.
-.
+.BI .RE " \fR[\fPnnn\fR]\fP"
+This macro moves the left margin back to level
+.IR nnn ,
+restoring the previous left margin.
 .
-.IP
-For example, the following paragraphs were all set up with bullets as
-the designator, using \[oq].IP\ \e(bu\ 4\[cq].
+If no argument is given, it moves one level back.
 .
-The whole block has been enclosed with
+The first level (i.e., no call to
 .B .RS
-and
-.B .RE
-to set the left margin temporarily to the current indentation value.
-.
-.
-.RS
-.IP \(bu 4
-.B IP
-is one of the three macros used in the
-.B man
-package to format lists.
-.
-.
-.IP \(bu 4
-.B HP
-is another.
-.
-This macro produces a paragraph with a left hanging indentation.
+yet) has number\~1, and each call to
+.B .RS
+increases the level by\~1.
 .
 .
-.IP \(bu 4
-.B TP
-is another.
+.PP
+To summarize, the following macros cause a line break with the
+insertion of vertical space (which amount can be changed with the
+.B PD
+macro):
+.BR SH ,
+.BR SS ,
+.BR TP ,
+.BR TQ ,
+.B LP
+.RB ( PP ,
+.BR P ),
+.BR IP ,
+and
+.BR HP .
+The macros
+.BR RS ,
+.BR RE ,
+.BR EX ,
+and
+.B EE
+also cause a break but no insertion of vertical space.
 .
-This macro produces an unindented label followed by an indented
-paragraph.
-.RE
 .
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SS "Paragraph macros"
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 .TP
 .B .LP
@@ -240,138 +343,13 @@ default values.
 .
 .
 .TP
-.BI .RE " \fR[\fPnnn\fR]\fP"
-This macro moves the left margin back to level
-.IR nnn ,
-restoring the previous left margin.
-.
-If no argument is given, it moves one level back.
-.
-The first level (i.e., no call to
-.B .RS
-yet) has number\~1, and each call to
-.B .RS
-increases the level by\~1.
-.
+.BI .TP " \fR[\fPnnn\fR]\fP"
+Set up an indented paragraph with label.
 .
-.TP
-.BI .RS " \fR[\fPnnn\fR]\fP"
-This macro moves the left margin to the right by the value
+The indentation is set to
 .I nnn
-if specified (default unit is \[oq]n\[cq]); otherwise it is set to the
-previous indentation value specified with
-.BR .TP ,
-.BR .IP ,
-or
-.B .HP
-(or to the default value if none of them have been used yet).
-.
-The indentation value is then set to the default.
-.
-.
-.IP
-Calls to the
-.B RS
-macro can be nested.
-.
-.
-.TP
-.BI .SH " \fR[\fPtext for a heading\fR]\fP"
-Set up an unnumbered section heading sticking out to the left.
-.
-Prints out all the text following
-.B .SH
-up to the end of the line (or the text in the next input line if there
-is no argument to
-.BR .SH )
-in bold face
-(or the font specified by the string
-.BR HF ),
-one size larger than the base document size.
-.
-Additionally, the left margin and the indentation for the following
-text is reset to the default values.
-.
-.
-.TP
-.BI .SS " \fR[\fPtext for a heading\fR]\fP"
-Set up a secondary, unnumbered section heading.
-.
-Prints out all the text following
-.B .SS
-up to the end of the line (or the text in the next input line if there
-is no argument to
-.BR .SS )
-in bold face
-(or the font specified by the string
-.BR HF ),
-at the same size as the base document size.
-.
-Additionally, the left margin and the indentation for the following
-text is reset to the default values.
-.
-.
-.TP
-.BI .TH " title section \fR[\fPextra1\fR]\fP \fR[\fPextra2\fR]\fP \fR[\f=
Pextra3\fR]"
-Set the title of the
-.I man\~page
-to
-.I title
-and the section to
-.IR section ,
-which must take on a value between 1 and\~8.
-.
-The value
-.I section
-may also have a string appended, e.g.\& \[oq].pm\[cq], to indicate a
-specific subsection of the
-.IR \%man\~pages .
-.
-Both
-.I title
-and
-.I section
-are positioned at the left and right in the header line (with
-.I section
-in parentheses immediately appended to
-.IR title .
-.
-.I extra1
-is positioned in the middle of the footer line.
-.
-.I extra2
-is positioned at the left in the footer line (or at the left on
-even pages and at the right on odd pages if double-sided printing is
-active).
-.
-.I extra3
-is centered in the header line.
-.
-.
-.IP
-For HTML output, headers and footers are completely suppressed.
-.
-.
-.IP
-Additionally, this macro starts a new page; the new line number is\~1
-again (except if the \[oq]\-rC1\[cq] option is given on the command
-line) -- this feature is intended only for formatting multiple
-.IR \%man\~pages ;
-a single
-.I \%man\~page
-should contain exactly one
-.B TH
-macro at the beginning of the file.
-.
-.
-.TP
-.BI .TP " \fR[\fPnnn\fR]\fP"
-Set up an indented paragraph with label.
-.
-The indentation is set to
-.I nnn
-if that argument is supplied (the default unit is \[oq]n\[cq] if omitted=
),
-otherwise it is set to the previous indentation value specified with
+if that argument is supplied (the default unit is \[oq]n\[cq] if omitted=
),
+otherwise it is set to the previous indentation value specified with
 .BR .TP ,
 .BR .IP ,
 or
@@ -432,243 +410,74 @@ To be certain your page will be portable to those =
systems,
 copy its definition from the
 .B \%an-ext.tmac
 file of a
-.BR groff
-installation.
-.
-.
-.PP
-To summarize, the following macros cause a line break with the
-insertion of vertical space (which amount can be changed with the
-.B PD
-macro):
-.BR SH ,
-.BR SS ,
-.BR TP ,
-.BR TQ ,
-.B LP
-.RB ( PP ,
-.BR P ),
-.BR IP ,
-and
-.BR HP .
-The macros
-.BR RS ,
-.BR RE ,
-.BR EX ,
-and
-.B EE
-also cause a break but no insertion of vertical space.
-.
-.
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SS "Macros to set fonts"
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
-The standard font is Roman; the default text size is 10\~point.
-.
-.
-.TP
-.BI .B " \fR[\fPtext\fR]\fP"
-Causes
-.I text
-to appear in bold face.
-.
-If no text is present on the line where the macro is called the text
-of the next input line appears in bold face.
-.
-.
-.TP
-.BI ".BI " text
-Causes text on the same line to appear alternately in bold face and
-italic.
-.
-The text must be on the same line as the macro call.
-.
-Thus
-.
-.
-.RS
-.IP
-\&.BI this "word and" that
-.
-.
-.PP
-would cause \[oq]this\[cq] and \[oq]that\[cq] to appear in bold face,
-while \[oq]word and\[cq] appears in italics.
-.RE
-.
-.
-.TP
-.BI ".BR " text
-Causes text on the same line to appear alternately in bold face and
-roman.
-.
-The text must be on the same line as the macro call.
-.
-.
-.TP
-.BI .I " \fR[\fPtext\fR]\fP"
-Causes
-.I text
-to appear in italic.
-.
-If no text is present on the line where the macro is called the text
-of the next input line appears in italic.
-.
-.
-.TP
-.BI ".IB " text
-Causes text to appear alternately in italic and bold face.
-.
-The text must be on the same line as the macro call.
-.
-.
-.TP
-.BI ".IR " text
-Causes text on the same line to appear alternately in italic and
-roman.
-.
-The text must be on the same line as the macro call.
-.
-.
-.TP
-.BI ".RB " text
-Causes text on the same line to appear alternately in roman and bold
-face.
-.
-The text must be on the same line as the macro call.
-.
-.
-.TP
-.BI ".RI " text
-Causes text on the same line to appear alternately in roman and
-italic.
-.
-The text must be on the same line as the macro call.
-.
-.
-.TP
-.BI .SB " \fR[\fPtext\fR]\fP"
-Causes the text on the same line or the text on the next input line to
-appear in boldface font, one point size smaller than the default font.
-.
-.
-.TP
-.BI .SM " \fR[\fPtext\fR]\fP"
-Causes the text on the same line or the text on the next input line to
-appear in a font that is one point size smaller than the default font.
-.
-.
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SS "Macros to describe hyperlinks and email addresses"
-.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.
-The following macros are not defined on legacy Unix systems
-running classic troff.
-.
-To be certain your page will be portable to those systems, copy
-their definitions from the
-.B \%an-ext.tmac
-file of a
-.BR groff
-installation.
-.
-.
-.PP
-Using these macros helps ensure that you get hyperlinks when your
-manual page is rendered in a browser or other program that is
-Web-enabled.
-.
-.
-.TP
-.BI .MT " address"
-.TQ
-.BI .ME " \fR[\fPpunctuation\fR]\fP"
-Wrap an email address.
-.
-The argument of
-.B .MT
-is the address; text following, until
-.BR .ME ,
-is a name to be associated with the address.
+.BR groff
+installation.
 .
-Any argument to the
-.B ME
-macro is pasted to the end of the link text.
 .
-On a device that is not a browser,
+.TP
+.BI .IP " \fR[\fPdesignator\fR]\fP \fR[\fPnnn\fR]\fP"
+Set up an indented paragraph, using
+.I designator
+as a tag to mark its beginning.
 .
+The indentation is set to
+.I nnn
+if that argument is supplied (the default unit is \[oq]n\[cq] if
+omitted), otherwise it is set to the previous indentation value
+specified with
+.BR .TP ,
+.BR .IP ,
+or
+.B .HP
+(or to the default value if none of them have been used yet).
 .
-.RS
-.IP
-.EX
-contact
-\&.MT fred.foonly@\e:fubar.net
-Fred Foonly
-\&.ME
-for more information
-.EE
-.RE
+Font size and face of the paragraph (but not the designator) are reset
+to its default values.
 .
 .
 .IP
-usually displays like this: \[lq]contact Fred Foonly
-<fred.foonly@\:fubar.net> for more information\[rq].
+To start an indented paragraph with a particular indentation but
+without a designator, use \[oq]""\[cq] (two doublequotes) as the
+first argument.
 .
 .
 .IP
-The use of
-.B \e:
-to insert hyphenless breakpoints is a groff extension and can
-be omitted.
-.
-.
-.TP
-.BI .UR " URL"
-.TQ
-.BI .UE " \fR[\fPpunctuation\fR]\fP"
-Wrap a World Wide Web hyperlink.
+For example, the following paragraphs were all set up with bullets as
+the designator, using \[oq].IP\ \e(bu\ 4\[cq].
 .
-The argument to
-.B .UR
-is the URL; thereafter, lines until
-.B .UE
-are collected and used as the link text.
+The whole block has been enclosed with
+.B .RS
+and
+.B .RE
+to set the left margin temporarily to the current indentation value.
 .
-Any argument to the
-.B UE
-macro is pasted to the end of the text.
 .
-On a device that is not a browser,
+.RS
+.IP \(bu 4
+.B IP
+is one of the three macros used in the
+.B man
+package to format lists.
 .
 .
-.RS
-.IP
-.EX
-this is a link to
-\&.UR http://\e:randomsite.org/\e:fubar
-some random site
-\&.UE ,
-given as an example
-.EE
-.RE
+.IP \(bu 4
+.B HP
+is another.
 .
+This macro produces a paragraph with a left hanging indentation.
 .
-.IP
-usually displays like this: \[lq]this is a link to some random
-site \[la]http://\:randomsite.org/\:fubar\[ra], given as an
-example\[rq].
 .
+.IP \(bu 4
+.B TP
+is another.
 .
-.IP
-The use of
-.B \e:
-to insert hyphenless breakpoints is a groff extension and can be
-omitted.
+This macro produces an unindented label followed by an indented
+paragraph.
+.RE
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SS "Macros to describe command synopses"
+.SS "Command synopsis macros"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
 The following macros are not defined on legacy Unix systems
@@ -693,17 +502,6 @@ running text.
 .
 .
 .TP
-.BI .OP " option-name"\/\c
-.RI " [" option-argument ]
-Indicate an optional command parameter called
-.IR option-name .
-.
-If the option takes an argument, specify
-.I option-argument
-using a noun, abbreviation, or hyphenated noun phrase.
-.
-.
-.TP
 .BI .SY " command"
 Begin synopsis.
 .
@@ -719,6 +517,17 @@ Hyphenation is turned off.
 .
 .
 .TP
+.BI .OP " option-name"\/\c
+.RI " [" option-argument ]
+Indicate an optional command parameter called
+.IR option-name .
+.
+If the option takes an argument, specify
+.I option-argument
+using a noun, abbreviation, or hyphenated noun phrase.
+.
+.
+.TP
 .B .YS
 End synopsis.
 .
@@ -845,7 +654,7 @@ escape sequence \(lq\e&\(rq on both sides of the elli=
psis;
 this is a good practice to avoid surprises in the event the ellipsis
 gets reflowed in your text editor.
 .
-See \(lqPORTABILITY AND TROFF REQUESTS\(rq, below.
+See \(lqPortability\(rq, below.
 .
 The morbidly curious may consult
 .BR groff (7)
@@ -853,108 +662,220 @@ regarding the narrow-space escape sequence \(lq\e=
|\(rq.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
-.SS Miscellaneous
+.SS "Hyperlink and email macros"
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .
-The default indentation is 7.2n in troff mode and 7n in nroff mode
-except for
-.BR grohtml ,
-which ignores indentation.
+The following macros are not defined on legacy Unix systems
+running classic troff.
+.
+To be certain your page will be portable to those systems, copy
+their definitions from the
+.B \%an-ext.tmac
+file of a
+.BR groff
+installation.
+.
+.
+.PP
+Using these macros helps ensure that you get hyperlinks when your
+manual page is rendered in a browser or other program that is
+Web-enabled.
 .
 .
 .TP
-.BI .AT " \fR[\fPsystem \fR[\fPrelease\fR]]\fP"
-Alter the footer for use with \f[CR]AT&T\f[]
-.IR \%man\~pages .
-This command exists only for compatibility; don't use it.
+.BI .MT " address"
+.TQ
+.BI .ME " \fR[\fPpunctuation\fR]\fP"
+Wrap an email address.
 .
-See the
-.I groff
-info manual for more.
+The argument of
+.B .MT
+is the address; text following, until
+.BR .ME ,
+is a name to be associated with the address.
+.
+Any argument to the
+.B ME
+macro is pasted to the end of the link text.
+.
+On a device that is not a browser,
+.
+.
+.RS
+.IP
+.EX
+contact
+\&.MT fred.foonly@\e:fubar.net
+Fred Foonly
+\&.ME
+for more information
+.EE
+.RE
+.
+.
+.IP
+usually displays like this: \[lq]contact Fred Foonly
+<fred.foonly@\:fubar.net> for more information\[rq].
+.
+.
+.IP
+The use of
+.B \e:
+to insert hyphenless breakpoints is a groff extension and can
+be omitted.
+.
+.
+.TP
+.BI .UR " URL"
+.TQ
+.BI .UE " \fR[\fPpunctuation\fR]\fP"
+Wrap a World Wide Web hyperlink.
+.
+The argument to
+.B .UR
+is the URL; thereafter, lines until
+.B .UE
+are collected and used as the link text.
+.
+Any argument to the
+.B UE
+macro is pasted to the end of the text.
+.
+On a device that is not a browser,
+.
+.
+.RS
+.IP
+.EX
+this is a link to
+\&.UR http://\e:randomsite.org/\e:fubar
+some random site
+\&.UE ,
+given as an example
+.EE
+.RE
+.
+.
+.IP
+usually displays like this: \[lq]this is a link to some random
+site \[la]http://\:randomsite.org/\:fubar\[ra], given as an
+example\[rq].
+.
+.
+.IP
+The use of
+.B \e:
+to insert hyphenless breakpoints is a groff extension and can be
+omitted.
+.
+.
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SS "Font face macros"
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
+The standard font is Roman; the default text size is 10\~point.
+.
+.
+.TP
+.BI .B " \fR[\fPtext\fR]\fP"
+Causes
+.I text
+to appear in bold face.
+.
+If no text is present on the line where the macro is called the text
+of the next input line appears in bold face.
+.
+.
+.TP
+.BI .I " \fR[\fPtext\fR]\fP"
+Causes
+.I text
+to appear in italic.
+.
+If no text is present on the line where the macro is called the text
+of the next input line appears in italic.
 .
 .
 .TP
-.B .BT
-Print the footer string.
+.BI .SM " \fR[\fPtext\fR]\fP"
+Causes the text on the same line or the text on the next input line to
+appear in a font that is one point size smaller than the default font.
 .
-Redefine this macro to get control of the footer.
+.
+.TP
+.BI .SB " \fR[\fPtext\fR]\fP"
+Causes the text on the same line or the text on the next input line to
+appear in boldface font, one point size smaller than the default font.
 .
 .
 .TP
-.B .DT
-Set tabs every 0.5\~inches.
+.BI ".BI " text
+Causes text on the same line to appear alternately in bold face and
+italic.
 .
-Since this macro is always called during a
-.B TH
-macro, it makes sense to call it only if the tab positions have been
-changed.
+The text must be on the same line as the macro call.
+.
+Thus
 .
 .
+.RS
 .IP
-Use of this presentation-level macro is deprecated.
-.
-It translates poorly to HTML, under which exact whitespace control
-and tabbing are not readily available.
+\&.BI this "word and" that
 .
-Thus, information or distinctions that you use
-.B .DT
-to express are likely to be lost.
 .
-If you feel tempted to use it, you should probably be composing a
-table using
-.BR @g@tbl (@MAN1EXT@)
-markup instead.
+.PP
+would cause \[oq]this\[cq] and \[oq]that\[cq] to appear in bold face,
+while \[oq]word and\[cq] appears in italics.
+.RE
 .
 .
 .TP
-.BI .PD " \fR[\fPnnn\fR]\fP"
-Adjust the empty space before a new paragraph or section.
+.BI ".BR " text
+Causes text on the same line to appear alternately in bold face and
+roman.
 .
-The optional argument gives the amount of space (default unit is
-\[oq]v\[cq]); without parameter, the value is reset to its default
-value (1\~line in nroff mode, 0.4v\~otherwise).
+The text must be on the same line as the macro call.
 .
-This affects the macros
-.BR SH ,
-.BR SS ,
-.BR TP ,
-.B LP
-(resp.\&
-.B PP
-and
-.BR P ),
-.BR IP ,
-and
-.BR HP .
 .
+.TP
+.BI ".IB " text
+Causes text to appear alternately in italic and bold face.
+.
+The text must be on the same line as the macro call.
 .
-.IP
-Use of this presentation-level macro is deprecated.
 .
-It translates poorly to HTML, under which exact control of
-inter-paragraph spacing is not readily available.
+.TP
+.BI ".IR " text
+Causes text on the same line to appear alternately in italic and
+roman.
 .
-Thus, information or distinctions that you use
-.B .PD
-to express are likely to be lost.
+The text must be on the same line as the macro call.
 .
 .
 .TP
-.B .PT
-Print the header string.
+.BI ".RB " text
+Causes text on the same line to appear alternately in roman and bold
+face.
 .
-Redefine this macro to get control of the header.
+The text must be on the same line as the macro call.
 .
 .
 .TP
-.BI .UC " \fR[\fPversion\fR]\fP"
-Alter the footer for use with \f[CR]BSD\f[]
-.IR man\~pages .
-This command exists only for compatibility; don't use it.
+.BI ".RI " text
+Causes text on the same line to appear alternately in roman and
+italic.
 .
-See the
-.I groff
-info manual for more.
+The text must be on the same line as the macro call.
+.
+.
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SS Miscellaneous
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
+The default indentation is 7.2n in troff mode and 7n in nroff mode
+except for
+.BR grohtml ,
+which ignores indentation.
 .
 .
 .PP
@@ -1062,7 +983,8 @@ Further, it is best to completely avoid those we hav=
e described as
 .RB ( .HP ,
 .BR .PD ,
 and
-.BR .DT ).
+.BR .DT )
+in \(lqDeprecated features\(rq, below.
 .
 .
 .PP
@@ -1328,6 +1250,155 @@ not listed above are better avoided in manual pag=
es.
 .
 .
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.SS "Deprecated features"
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.
+.TP
+.BI .AT " \fR[\fPsystem \fR[\fPrelease\fR]]\fP"
+Alter the footer for use with \f[CR]AT&T\f[]
+.IR \%man\~pages .
+This command exists only for compatibility; don't use it.
+.
+See the
+.I groff
+info manual for more.
+.
+.
+.TP
+.B .BT
+Print the footer string.
+.
+Redefine this macro to get control of the footer.
+.
+.
+.TP
+.B .DT
+Set tabs every 0.5\~inches.
+.
+Since this macro is always called during a
+.B TH
+macro, it makes sense to call it only if the tab positions have been
+changed.
+.
+.
+.IP
+Use of this presentation-level macro is deprecated.
+.
+It translates poorly to HTML, under which exact whitespace control
+and tabbing are not readily available.
+.
+Thus, information or distinctions that you use
+.B .DT
+to express are likely to be lost.
+.
+If you feel tempted to use it, you should probably be composing a
+table using
+.BR @g@tbl (@MAN1EXT@)
+markup instead.
+.
+.
+.TP
+.BI .HP " \fR[\fPnnn\fR]\fP"
+Set up a paragraph with hanging left indentation.
+.
+The indentation is set to
+.I nnn
+if that argument is supplied (the default unit is \[oq]n\[cq] if
+omitted), otherwise it is set to the previous indentation value
+specified with
+.BR .TP ,
+.BR .IP ,
+or
+.B .HP
+(or to the default value if none of them have been used yet).
+.
+Font size and face are reset to its default values.
+.
+The following paragraph illustrates the effect of this macro with
+hanging indentation set to\~4 (enclosed by
+.B .RS
+and
+.B .RE
+to set the left margin temporarily to the current indentation):
+.
+.
+.RS
+.HP 4
+This is a paragraph following an invocation of the
+.B HP
+macro.
+.
+As you can see, it produces a paragraph where all lines but the first
+are indented.
+.RE
+.
+.
+.IP
+Use of this presentation-level macro is deprecated.
+.
+While it is universally portable to legacy Unix systems, a hanging
+indentation cannot be expressed naturally under HTML, and many
+HTML-based manual viewers simply interpret it as a starter for a
+normal paragraph.
+.
+Thus, any information or distinction you tried to express with the
+indentation may be lost.
+.
+.
+.TP
+.BI .PD " \fR[\fPnnn\fR]\fP"
+Adjust the empty space before a new paragraph or section.
+.
+The optional argument gives the amount of space (default unit is
+\[oq]v\[cq]); without parameter, the value is reset to its default
+value (1\~line in nroff mode, 0.4v\~otherwise).
+.
+This affects the macros
+.BR SH ,
+.BR SS ,
+.BR TP ,
+.B LP
+(resp.\&
+.B PP
+and
+.BR P ),
+.BR IP ,
+and
+.BR HP .
+.
+.
+.IP
+Use of this presentation-level macro is deprecated.
+.
+It translates poorly to HTML, under which exact control of
+inter-paragraph spacing is not readily available.
+.
+Thus, information or distinctions that you use
+.B .PD
+to express are likely to be lost.
+.
+.
+.TP
+.B .PT
+Print the header string.
+.
+Redefine this macro to get control of the header.
+.
+.
+.TP
+.BI .UC " \fR[\fPversion\fR]\fP"
+Alter the footer for use with \f[CR]BSD\f[]
+.IR man\~pages .
+This command exists only for compatibility; don't use it.
+.
+See the
+.I groff
+info manual for more.
+.
+.
+.
+.
+.\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .SH OPTIONS
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .


From MAILER-DAEMON Fri Jun 29 14:41:45 2018
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1fYyL3-0003eu-RX
	for mharc-groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:45 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59970)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKw-0003aA-3b
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:44 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-00087D-B6
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:38 -0400
Received: from vcs0.savannah.gnu.org ([208.118.235.201]:47299)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <g.branden.robinson@gmail.com>) id 1fYyKs-00086p-7Q
	for groff-commit@gnu.org; Fri, 29 Jun 2018 14:41:34 -0400
Received: by vcs0.savannah.gnu.org (Postfix, from userid 143018)
	id 16BEF2053F; Fri, 29 Jun 2018 14:41:34 -0400 (EDT)
To: groff-commit@gnu.org
Subject: [groff] 03/05: groff_man(7): Bump copyright year to 2017.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Reply-To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
In-Reply-To: groff@gnu.org
References: <20180629184133.4844.8728@vcs0.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: dfc1b2bad31298c86cf280973868f7bb666dd391
Auto-Submitted: auto-generated
Message-Id: <20180629184134.16BEF2053F@vcs0.savannah.gnu.org>
Date: Fri, 29 Jun 2018 14:41:34 -0400 (EDT)
From: g.branden.robinson@gmail.com (G. Branden Robinson)
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 208.118.235.201
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit/>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Fri, 29 Jun 2018 18:41:44 -0000

gbranden pushed a commit to branch master
in repository groff.

commit dfc1b2bad31298c86cf280973868f7bb666dd391
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Jun 28 21:10:07 2018 -0400

    groff_man(7): Bump copyright year to 2017.
   =20
    Ingo and I added a lot of stuff about character escapes last year.
   =20
    Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
---
 tmac/groff_man.7.man | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 4e43a37..0fc84ce 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -12,7 +12,7 @@ groff_man \- GNU roff macro package for formatting man =
pages
 .\" Legal Terms
 .\" =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 .\"
-.\" Copyright (C) 1999-2014 Free Software Foundation, Inc.
+.\" Copyright (C) 1999-2017 Free Software Foundation, Inc.
 .\"
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are


