*.[157].man: Save and restore compatibility mode.

...where needed.  Several pages were using escapes not documented in
CSTR #54 (1992 revision).

There were no _egregious_ portability offenses here; the problems were
mainly:

1. Use of \~ and \: escapes.  It's worth noting that the
"makevarescape.sed" script I introduced means that \: escapes can be
hidden inside @FOODIR@ macro expansions.  Whether they actually appear
depends on how the "configure" script is invoked, but it's pretty safe
bet, since the script injects them after every "/" in a pathname.

2. Use of \[xx] special character escapes.

There are only 3 man pages left that do not require compatibility mode;
they now use the Vim hint "filetype=nroff" if they didn't already.  (Vim
distinguishes groff and nroff syntax highlighting; furthermore, my
private fork of nroff.vim is enhanced to show me many more potential
portability problems.)

Also update comments to make the editor hints consistent and remove some
stale or redundant comments (mostly about installation paths and
filename transformations).

10 files changed, 103 insertions, 43 deletions

diff --git a/contrib/eqn2graph/eqn2graph.1.man b/contrib/eqn2graph/eqn2graph.1.man
index 811322771..3d817d8f4 100644
--- a/contrib/eqn2graph/eqn2graph.1.man
+++ b/contrib/eqn2graph/eqn2graph.1.man
@@ -3,6 +3,11 @@
 eqn2graph \- convert an EQN equation into a cropped image
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr eqn2graph_C \n[.C]
+.cp 0
+.
+.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -152,7 +157,12 @@ by W.\& Richard Stevens.
 .IR \%convert (1)
 .
 .
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[eqn2graph_C]
+.
+.
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/contrib/gdiffmk/gdiffmk.1.man b/contrib/gdiffmk/gdiffmk.1.man
index 1e20d473c..f56805fd5 100644
--- a/contrib/gdiffmk/gdiffmk.1.man
+++ b/contrib/gdiffmk/gdiffmk.1.man
@@ -3,6 +3,11 @@
 gdiffmk \- mark differences between groff/nroff/troff files
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr gdiffmk_C \n[.C]
+.cp 0
+.
+.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -254,7 +259,13 @@ Mike Bianchi
 .BR gtroff (@MAN1EXT@),
 .BR diff (@MAN1EXT@)
 .
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[gdiffmk_C]
+.
+.
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/contrib/glilypond/glilypond.1.man b/contrib/glilypond/glilypond.1.man
index 2a026895c..37bf0e31b 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -2,9 +2,11 @@
 .SH NAME
 glilypond \- integrate lilypond parts into groff
 .
-.\" glilypond - integrate 'lilypond' parts into 'groff' files
-.\" Source file position:  <groff_source_top>/contrib/glilypond.man
-.\" Installed position:    <prefix>/share/man/man1/glilypond.1
+.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr glilypond_C \n[.C]
+.cp 0
+.
 .
 .\" TODO: This page needs a thorough edit by a native English speaker.
 .
@@ -957,11 +959,12 @@ file into an
 format.
 .
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[glilypond_C]
+.
 .
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/contrib/gperl/gperl.1.man b/contrib/gperl/gperl.1.man
index ba5cac4f7..aaef2b362 100644
--- a/contrib/gperl/gperl.1.man
+++ b/contrib/gperl/gperl.1.man
@@ -2,6 +2,12 @@
 .SH NAME
 gperl \- groff preprocessor for Perl parts in roff files
 .
+.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr gperl_C \n[.C]
+.cp 0
+.
+.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -498,11 +504,12 @@ are
 .BR \%perl (@MAN7EXT@).
 .
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[gperl_C]
+.
 .
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/contrib/gpinyin/gpinyin.1.man b/contrib/gpinyin/gpinyin.1.man
index db634fdd8..45d366850 100644
--- a/contrib/gpinyin/gpinyin.1.man
+++ b/contrib/gpinyin/gpinyin.1.man
@@ -3,6 +3,12 @@
 .SH NAME
 gpinyin \- use Hanyu Pinyin Chinese in roff
 .
+.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr gpinyin_C \n[.C]
+.cp 0
+.
+.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -335,11 +341,12 @@ and the available glyph repertoire,
 respectively.
 .
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[gpinyin_C]
+.
 .
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/contrib/grap2graph/grap2graph.1.man b/contrib/grap2graph/grap2graph.1.man
index bf13d6d2e..da989ef66 100644
--- a/contrib/grap2graph/grap2graph.1.man
+++ b/contrib/grap2graph/grap2graph.1.man
@@ -3,6 +3,11 @@
 grap2graph \- convert a GRAP diagram into a cropped image
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr grap2graph_C \n[.C]
+.cp 0
+.
+.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -169,7 +174,12 @@ by W.\& Richard Stevens.
 .IR \%convert (1)
 .
 .
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[grap2graph_C]
+.
+.
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/contrib/groff_filenames/groff_filenames.5.man b/contrib/groff_filenames/groff_filenames.5.man
index 8f87abe10..2a01b0afa 100644
--- a/contrib/groff_filenames/groff_filenames.5.man
+++ b/contrib/groff_filenames/groff_filenames.5.man
@@ -2,7 +2,11 @@
 .SH NAME
 groff_filenames \- filename extensions for roff and groff
 .
-.\" ad l
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr groff_filenames_C \n[.C]
+.cp 0
+.
+.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -646,11 +650,12 @@ You can get this package with the shell command:
 .RE
 .
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[groff_filenames_C]
+.
 .
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/contrib/groffer/groffer.1.man b/contrib/groffer/groffer.1.man
index 39ab25225..85901e335 100644
--- a/contrib/groffer/groffer.1.man
+++ b/contrib/groffer/groffer.1.man
@@ -3,14 +3,9 @@
 groffer \- display groff files and man pages on X and tty
 .
 .
-.\"*********************************************************************
-.\"
-.\" This man page doesn't use extended groff syntax!
-.\" XXX: Yes, it does--"\~" is ubiquitous.  "\/" and "\," also occur.
-.\" Formatting it with and without groff's option '-C' should always
-.\" give the same result.
-.\"
-.\"*********************************************************************
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr groffer_C \n[.C]
+.cp 0
 .
 .
 .\" ====================================================================
@@ -3802,11 +3797,12 @@ The decompression programs supported by
 .BR \%groffer .
 .
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[groffer_C]
+.
 .
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/contrib/groffer/roff2.1.man b/contrib/groffer/roff2.1.man
index 6013b583d..ffd2ce16e 100644
--- a/contrib/groffer/roff2.1.man
+++ b/contrib/groffer/roff2.1.man
@@ -2,10 +2,10 @@
 .SH NAME
 roff2@ROFF2MODE@ \- transform roff code into @ROFF2MODE@ mode
 .
-.\" roff2@ROFF2MODE@.1 - man page for roff2@ROFF2MODE@ (section 1).
 .
-.\" Source file position: <groff_source_top>/contrib/groffer/roff2.man
-.\" Installed position:   $prefix/share/man/man1/roff2@ROFF2MODE@.1
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr roff2_C \n[.C]
+.cp 0
 .
 .
 .\" ====================================================================
@@ -219,11 +219,12 @@ Bernd Warken
 .BR \%gxditview (@MAN1EXT@).
 .
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[roff2_C]
+.
 .
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:
diff --git a/contrib/pic2graph/pic2graph.1.man b/contrib/pic2graph/pic2graph.1.man
index a19062740..0e03d3d08 100644
--- a/contrib/pic2graph/pic2graph.1.man
+++ b/contrib/pic2graph/pic2graph.1.man
@@ -3,6 +3,11 @@
 pic2graph \- convert a PIC diagram into a cropped image
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr pic2graph_C \n[.C]
+.cp 0
+.
+.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -198,7 +203,12 @@ W.\& Richard Stevens,
 .IR \%convert (1)
 .
 .
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n[pic2graph_C]
+.
+.
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72: