[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 02/02: man pages: Comment compatibility-mode switching.
|
From: |
G. Branden Robinson |
|
Subject: |
[groff] 02/02: man pages: Comment compatibility-mode switching. |
|
Date: |
Thu, 14 Dec 2017 03:05:24 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit 518577df68d021335f49e227f8866f4b98e947ca
Author: G. Branden Robinson <address@hidden>
Date: Thu Dec 14 03:04:29 2017 -0500
man pages: Comment compatibility-mode switching.
The '.do' and '.cp' requests (both groffisms) are some of the more
obscure features of groff's own man page corpus. Consequently, they get
cargo-culted around, within and outside groff. Thanks to Werner Lemberg
for the discussion, which revealed (to me) that groff ships with
compatibility mode on by default on Solaris 10 and 11.
Fix bug https://savannah.gnu.org/bugs/?52444.
Signed-off-by: G. Branden Robinson <address@hidden>
---
ChangeLog | 13 +++++++++++++
contrib/chem/chem.1.man | 2 ++
contrib/hdtbl/groff_hdtbl.7.man | 2 ++
contrib/mm/groff_mm.7.man | 2 ++
contrib/mm/groff_mmse.7.man | 2 ++
contrib/mom/groff_mom.7.man | 2 ++
contrib/pdfmark/pdfroff.1.man | 2 ++
man/groff.7.man | 2 ++
man/groff_char.7.man | 2 ++
man/groff_diff.7.man | 2 ++
man/groff_font.5.man | 2 ++
man/groff_out.5.man | 2 ++
man/groff_tmac.5.man | 2 ++
man/roff.7.man | 2 ++
src/devices/grodvi/grodvi.1.man | 2 ++
src/devices/gropdf/gropdf.1.man | 2 ++
src/devices/grops/grops.1.man | 2 ++
src/devices/grotty/grotty.1.man | 2 ++
src/preproc/eqn/eqn.1.man | 2 ++
src/preproc/grn/grn.1.man | 2 ++
src/preproc/pic/pic.1.man | 2 ++
src/preproc/preconv/preconv.1.man | 2 ++
src/preproc/soelim/soelim.1.man | 2 ++
src/preproc/tbl/tbl.1.man | 2 ++
src/roff/groff/groff.1.man | 2 ++
src/utils/hpftodit/hpftodit.1.man | 2 ++
tmac/groff_man.7.man | 2 ++
tmac/groff_ms.7.man | 2 ++
tmac/groff_trace.7.man | 2 ++
tmac/groff_www.7.man | 2 ++
30 files changed, 71 insertions(+)
diff --git a/ChangeLog b/ChangeLog
index 74bc2ad..090e286 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,16 @@
+2017-12-14 G. Branden Robinson <address@hidden>
+
+ man pages: Comment compatibility-mode switching.
+
+ The '.do' and '.cp' requests (both groffisms) are some of the
+ more obscure features of groff's own man page corpus.
+ Consequently, they get cargo-culted around, within and outside
+ groff. Thanks to Werner Lemberg for the discussion, which
+ revealed (to me) that groff ships with compatibility mode on by
+ default on Solaris 10 and 11.
+
+ Fix bug https://savannah.gnu.org/bugs/?52444.
+
2017-11-30 G. Branden Robinson <address@hidden>
* contrib/hdtbl/examples/common.roff:
diff --git a/contrib/chem/chem.1.man b/contrib/chem/chem.1.man
index 2a5b2bd..02f20c6 100644
--- a/contrib/chem/chem.1.man
+++ b/contrib/chem/chem.1.man
@@ -28,6 +28,7 @@
.\" Setup
.\" ====================================================================
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr chem_C \n[.C]
.cp 0
.
@@ -1002,6 +1003,7 @@ is
.UE .
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[chem_C]
.
.
diff --git a/contrib/hdtbl/groff_hdtbl.7.man b/contrib/hdtbl/groff_hdtbl.7.man
index c0f03f8..0f9d436 100644
--- a/contrib/hdtbl/groff_hdtbl.7.man
+++ b/contrib/hdtbl/groff_hdtbl.7.man
@@ -3,6 +3,7 @@
groff_hdtbl \- Heidelberger table macros for GNU roff
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_hdtbl_C \n[.C]
.cp 0
.
@@ -1280,6 +1281,7 @@ describes the traditional
preprocessor for tables.
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_hdtbl_C]
.
.
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 5c58516..40b1757 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -4,6 +4,7 @@
groff_mm \- memorandum macros for GNU roff
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_mm_C \n[.C]
.cp 0
.
@@ -3975,6 +3976,7 @@ of Lund, Sweden.
.BR groff_mmse (@MAN7EXT@)
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_mm_C]
.
.
diff --git a/contrib/mm/groff_mmse.7.man b/contrib/mm/groff_mmse.7.man
index 07970ba..0220b05 100644
--- a/contrib/mm/groff_mmse.7.man
+++ b/contrib/mm/groff_mmse.7.man
@@ -4,6 +4,7 @@
groff_mmse \- svenska \[rq]memorandum\[rq] makro f�r GNU roff
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_mmse_C \n[.C]
.cp 0
.
@@ -161,6 +162,7 @@ J
.br
.BR groff_mm (@MAN7EXT@)
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_mmse_C]
.
.
diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index b0710ff..e615487 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -5,6 +5,7 @@ groff_mom \- groff \[lq]mom\[rq] macros; \[lq]mom\[rq] is a
\[lq]roff\[rq] langu
.\" The .SH was moved to this place in order to appease 'apropos'.
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_mom_C \n[.C]
.cp 0
.
@@ -3391,6 +3392,7 @@ groff-bug mailing list
or directly to the authors.
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_mom_C]
.
.\" ====================================================================
diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.man
index da6a37d..a3fdb1c 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -3,6 +3,7 @@
pdfroff \- create PDF documents using groff
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr pdfroff_C \n[.C]
.cp 0
.
@@ -832,6 +833,7 @@ included in the installed documentation set as
.BR address@hidden@/pdfmark.pdf .
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[pdfroff_C]
.
.
diff --git a/man/groff.7.man b/man/groff.7.man
index 854befc..4968e74 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -31,6 +31,7 @@ groff \- a short reference for the GNU roff language
.\" Setup
.\" ====================================================================
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_7_C \n[.C]
.cp 0
.
@@ -4650,6 +4651,7 @@ This is a collection of internet sites with classical
documentations and other information.
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_7_C]
.
.
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index 728ba73..efb9d93 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -36,6 +36,7 @@ groff_char \- groff glyph names
.\" Setup
.\" ====================================================================
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_char_C \n[.C]
.cp 0
.
@@ -1365,6 +1366,7 @@ The Unicode Standard
.UE
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_char_C]
.
.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index a3b7193..7414e42 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -9,6 +9,7 @@ groff_diff \- differences between GNU troff and classical troff
.\" Installed position: <prefix>/share/man/man7/groff_diff.7
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_diff_C \n[.C]
.cp 0
.
@@ -3964,6 +3965,7 @@ classical troff documentation
.UE .
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_diff_C]
.
.
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index dd76bba..7923191 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -26,6 +26,7 @@ groff_font \- format of groff device and font description
files
.\" Macro definitions
.\" ====================================================================
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_font_C \n[.C]
.cp 0
.
@@ -716,6 +717,7 @@ for graphical mode (default is PDF mode).
.RE
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_font_C]
.
.
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index 4e7e1c0..6658d8f 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -9,6 +9,7 @@ groff_out \- groff intermediate output format
.\" Installed position: <prefix>/share/man/man5/groff_out.5
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_out_C \n[.C]
.cp 0
.
@@ -1999,6 +2000,7 @@ CSTR\~#54
.UE .
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_out_C]
.
.
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 974295e..7a18d32 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -6,6 +6,7 @@ groff_tmac \- macro files in the roff typesetting system
.\" Source file position: <groff_source>/man/groff_tmac.man
.\" Installed position: <prefix>/share/man/man5/groff_tmac.5
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_tmac_C \n[.C]
.cp 0
.
@@ -1313,6 +1314,7 @@ FHS web site
.UE .
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_tmac_C]
.
.
diff --git a/man/roff.7.man b/man/roff.7.man
index 2f5da9d..0226654 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -6,6 +6,7 @@ roff \- concepts and history of roff typesetting
.\" this is the man page roff.7
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr roff_C \n[.C]
.cp 0
.
@@ -1415,6 +1416,7 @@ On other systems, you are on your own, but
might be a good starting point.
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[roff_C]
.
.
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index 8535faa..a6d0741 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -22,6 +22,7 @@ grodvi \- convert groff output to TeX DVI format
.\" instead of in the original English.
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr grodvi_C \n[.C]
.cp 0
.
@@ -460,6 +461,7 @@ and widths of rules be rounded.
.BR groff_tmac (@MAN5EXT@)
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[grodvi_C]
.\" Local Variables:
.\" mode: nroff
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 86d36ca..0ff132e 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -3,6 +3,7 @@
gropdf \- PDF driver for groff
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr gropdf_C \n[.C]
.cp 0
.
@@ -1079,6 +1080,7 @@ automatically loaded by
.\" .BR \%groff_tmac (@MAN5EXT@),
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[gropdf_C]
.
.
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index a9abec0..a20b750 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -3,6 +3,7 @@
grops \- PostScript driver for groff
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr grops_C \n[.C]
.cp 0
.
@@ -1498,6 +1499,7 @@ PostScript Language Document Structuring Conventions
Specification
.UE
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[grops_C]
.
.
diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index 5e7d364..e0b8903 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -23,6 +23,7 @@ grotty \- groff driver for typewriter-like devices
.\" instead of in the original English.
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr grotty_C \n[.C]
.cp 0
.
@@ -534,6 +535,7 @@ character cell, affecting all subsequent operations.
.BR less (1)
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[grotty_C]
.\" Local Variables:
.\" mode: nroff
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 7fe4e8b..754d161 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -3,6 +3,7 @@
@address@hidden \- format equations for troff or MathML
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr eqn_C \n[.C]
.cp 0
.
@@ -1395,6 +1396,7 @@ This is allowed by the specification, but inefficient.
.I The\ \*[tx]book
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[eqn_C]
.
.
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index d0c8f1e..0c016bc 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -32,6 +32,7 @@
.\" Definitons
.\" ====================================================================
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr grn_C \n[.C]
.cp 0
.
@@ -794,6 +795,7 @@ Daniel Senderowicz and Werner Lemberg modified it for
.BR ideal (1)
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[grn_C]
.
.
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 4eb9355..2e92791 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -3,6 +3,7 @@
@address@hidden \- compile pictures for troff or TeX
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr pic_C \n[.C]
.cp 0
.
@@ -1340,6 +1341,7 @@ which interprets 0 as black and 1 as white.
PostScript\*R is a registered trademark of Adobe Systems Incorporation.
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[pic_C]
.
.
diff --git a/src/preproc/preconv/preconv.1.man
b/src/preproc/preconv/preconv.1.man
index 383d4ee..b3c6f8b 100644
--- a/src/preproc/preconv/preconv.1.man
+++ b/src/preproc/preconv/preconv.1.man
@@ -3,6 +3,7 @@
preconv \- convert encoding of input files to something GNU troff understands
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr preconv_C \n[.C]
.cp 0
.
@@ -360,6 +361,7 @@ and
info pages
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[preconv_C]
.
.
diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.1.man
index 214886a..57f3673 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -4,6 +4,7 @@
@address@hidden \- interpret .so requests in groff input
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr soelim_C \n[.C]
.cp 0
.mso pic.tmac
@@ -273,6 +274,7 @@ box invisible width 0.5 height 0.4 "output" "file"
.BR groff (@MAN1EXT@)
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[soelim_C]
.
.
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index 1bc7ece..8bc1d06 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -4,6 +4,7 @@
@address@hidden \- format tables for troff
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr tbl_C \n[.C]
.cp 0
.
@@ -1218,6 +1219,7 @@ but copies can be found with a title search on the World
Wide Web.
.BR @address@hidden (@MAN1EXT@)
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[tbl_C]
.
.
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 176e12e..ca35d75 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -5,6 +5,7 @@ groff \- front-end for the groff document formatting system
.\" groff.man -> groff.1
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_1_c \n[.C]
.cp 0
.
@@ -2018,6 +2019,7 @@ The following utilities are available:
.BR \%xtotroff (@MAN1EXT@).
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_1_c]
.
.
diff --git a/src/utils/hpftodit/hpftodit.1.man
b/src/utils/hpftodit/hpftodit.1.man
index adf1f77..6e14286 100644
--- a/src/utils/hpftodit/hpftodit.1.man
+++ b/src/utils/hpftodit/hpftodit.1.man
@@ -3,6 +3,7 @@
hpftodit \- create font description files for use with groff \-Tlj4
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr hpftodit_c \n[.C]
.cp 0
.
@@ -401,6 +402,7 @@ symbol mapping files
.BR lj4_font (@MAN5EXT@)
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[hpftodit_c]
.
.
diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 626e1cd..15a3141 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -3,6 +3,7 @@
groff_man \- GNU roff macro package for formatting man pages
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_man_C \n[.C]
.cp 0
.
@@ -1477,6 +1478,7 @@ Eric S.\& Raymond; he also originated the portability
advice.
.BR groff_mdoc (7)
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_man_C]
.
.
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index d5fd2c6..ecd9959 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1,4 +1,5 @@
'\" t
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_ms_C \n[.C]
.cp 0
.TH GROFF_MS @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
@@ -1796,6 +1797,7 @@ Larry Kollar
by Trent A.\& Fisher and Werner Lemberg
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_ms_C]
.
.
diff --git a/tmac/groff_trace.7.man b/tmac/groff_trace.7.man
index 484c3a9..9425712 100644
--- a/tmac/groff_trace.7.man
+++ b/tmac/groff_trace.7.man
@@ -6,6 +6,7 @@ groff_trace \- groff macro package trace.tmac
.\" File position: <groff-source>/tmac/groff_trace.man
.
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_trace_C \n[.C]
.cp 0
.
@@ -322,6 +323,7 @@ groff
file.
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_trace_C]
.
.
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index fe9bd0c..ba729c3 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -4,6 +4,7 @@ groff_www \- groff macros for authoring web pages
.
.\" User level guide to using the -mwww macroset
.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr groff_www_C \n[.C]
.cp 0
.do mso www.tmac
@@ -709,6 +710,7 @@ and
.BR netpbm (1)
.
.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[groff_www_C]
.
.\" Local Variables:
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 02/02: man pages: Comment compatibility-mode switching.,
G. Branden Robinson <=