[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@
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 24/32: groff_diff(7): Revise concluding sections.,
G. Branden Robinson <=