[bug #52444] Half the man pages save and restore compatibility mode like macro packages

[G. Branden Robinson]

URL:
  <http://savannah.gnu.org/bugs/?52444>

                 Summary: Half the man pages save and restore compatibility
mode like macro packages
                 Project: GNU troff
            Submitted by: gbranden
            Submitted on: Sun 19 Nov 2017 05:37:28 AM UTC
                Category: None
                Severity: 3 - Normal
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

About half (29 of 62) in-tree man pages do some tomfoolery like this:


$ grep -n -C 1 -F .cp ./src/utils/hpftodit/hpftodit.1.man
7-.do nr groff_C \n[.C]
8:.cp 0
9-.
--
372-.
373:.cp \n[groff_C]
374-.


What is the point of doing this in a man page?  That's a "terminal" document,
not something that's going to get sourced by another document.

Is this something cargo-culted in?  Or is there a good reason for it, and the
other 33 man pages should be following suit?


$ grep -lF .cp $(find -name "*.man")
./src/utils/hpftodit/hpftodit.1.man
./src/roff/groff/groff.1.man
./src/devices/grodvi/grodvi.1.man
./src/devices/grops/grops.1.man
./src/devices/grotty/grotty.1.man
./src/devices/gropdf/gropdf.1.man
./src/preproc/preconv/preconv.1.man
./src/preproc/tbl/tbl.1.man
./src/preproc/soelim/soelim.1.man
./src/preproc/eqn/eqn.1.man
./src/preproc/pic/pic.1.man
./src/preproc/grn/grn.1.man
./contrib/hdtbl/groff_hdtbl.7.man
./contrib/mm/groff_mm.7.man
./contrib/mm/groff_mmse.7.man
./contrib/pdfmark/pdfroff.1.man
./contrib/mom/groff_mom.7.man
./contrib/chem/chem.1.man
./man/groff_tmac.5.man
./man/groff_out.5.man
./man/groff_diff.7.man
./man/groff_char.7.man
./man/groff.7.man
./man/roff.7.man
./man/groff_font.5.man
./tmac/groff_trace.7.man
./tmac/groff_ms.7.man
./tmac/groff_man.7.man
./tmac/groff_www.7.man





    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?52444>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/