groff-commit
[Top][All Lists]
Advanced

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

[groff] 24/32: groff_diff(7): Revise concluding sections.


From: G. Branden Robinson
Subject: [groff] 24/32: groff_diff(7): Revise concluding sections.
Date: Sun, 18 Jun 2023 00:31:13 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit aa9f46e06ea7d8beb4833d9dc67303d98e2fa2eb
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Jun 17 19:39:58 2023 -0500

    groff_diff(7): Revise concluding sections.
    
    Content:
    * Rename subsection "Intermediate output format" to "Formatter output
      incompatibilities".
    * Add self to list of this document's authors.
    
    Style:
    * Recast.
    
    Markup:
    * Annotate a research item.
    * Use `P` instead of `PP` macro.
    * Apply poor man's keep to beautify dead-tree pagination.
---
 man/groff_diff.7.man | 28 ++++++++++++++++++----------
 1 file changed, 18 insertions(+), 10 deletions(-)

diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 6f03ee695..bd6ee2af6 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6068,7 +6068,7 @@ will not.
 .
 .
 .\" ====================================================================
-.SS "Intermediate output format"
+.SS "Formatter output incompatibilities"
 .\" ====================================================================
 .
 Its extensions notwithstanding,
@@ -6077,30 +6077,36 @@ the
 intermediate output format has some incompatibilities
 with that of AT&T
 .IR troff , \" AT&T
-but full compatibility is sought;
+but better compatibility is sought;
 problem reports and patches are welcome.
 .
 The following incompatibilities are known.
 .
 .
-.IP \[bu]
-The positioning after drawing polygons conflicts with the AT&T
+.IP \[bu] 2n
+The drawing position after rendering polygons is inconsistent with AT&T
 .I troff \" AT&T
 practice.
 .
+Other implementations have diverged on this point as well.
+.
 .
 .IP \[bu]
-The intermediate output cannot be rescaled to other devices as AT&T
+The output cannot be easily rescaled to other devices as AT&T
 .IR troff 's \" AT&T
 could.
+.\" XXX: Why?  What's the problem?  sizescale?  That could be written
+.\" into the output as a comment or x command.  --GBR
 .
 .
 .\" ====================================================================
 .SH Authors
 .\" ====================================================================
 .
-This document was written by James Clark and modified by Werner Lemberg
-and Bernd Warken.
+This document was written by James Clark,
+Werner Lemberg,
+Bernd Warken,
+and G.\& Branden Robinson.
 .
 .
 .\" ====================================================================
@@ -6116,7 +6122,9 @@ manual.
 You can browse it interactively with \[lq]info groff\[rq].
 .
 .
-.PP
+.br
+.ne 4v
+.P
 \[lq]Troff User's Manual\[rq]
 by Joseph F.\& Ossanna,
 1976
@@ -6133,7 +6141,7 @@ documentation as AT&T
 .IR troff . \" AT&T
 .
 .
-.PP
+.P
 \[lq]A Typesetter-independent TROFF\[rq]
 by Brian W.\& Kernighan,
 1982,
@@ -6143,7 +6151,7 @@ device and font description file formats
 and device-independent output format.
 .
 .
-.PP
+.P
 .MR groff @MAN1EXT@ ,
 .MR groff @MAN7EXT@ ,
 .MR roff @MAN7EXT@



reply via email to

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