[bug #61820] groff_tmac(5): reorganize and move to section 7

[G. Branden Robinson]

URL:
  <https://savannah.gnu.org/bugs/?61820>

                 Summary: groff_tmac(5): reorganize and move to section 7
                 Project: GNU troff
            Submitted by: gbranden
            Submitted on: Fri 14 Jan 2022 04:59:37 AM UTC
                Category: General
                Severity: 1 - Wish
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

This page rambles a bit.

But the biggest of its problems is that it is in section 5
despite not actually documenting a file format.  As we are at
pains to observe:


There is no syntactical difference between a macro file and any
other roff document; only its purpose distinguishes it.


This man page should move to section 7 where it can continue to
introduce its subject and document macro files that don't have
pages of their own.

The later sections about writing macros are better relocated to
groff(7) (or roff(7), if sufficiently general), and parallelized
with corresponding nodes in our Texinfo manual.





    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?61820>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/