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/glilypond/glilypond.1.man | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

(limited to 'contrib/glilypond/glilypond.1.man')

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