From 699ac6598d3c54fc6890c9be6780410c82f817ea Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Sun, 30 Jun 2019 03:44:40 +1000
Subject: *.[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).
---
 contrib/gperl/gperl.1.man | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

(limited to 'contrib/gperl')

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:
-- 
cgit v1.2.1