[bug #62773] [man] warn if `TH` macro not called

[G. Branden Robinson]

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

                 Summary: [man] warn if `TH` macro not called
                 Project: GNU troff
               Submitter: gbranden
               Submitted: Sat 16 Jul 2022 10:38:30 AM UTC
                Category: Macro man
                Severity: 1 - Wish
              Item Group: Warning/Suspicious behaviour
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Sat 16 Jul 2022 10:38:30 AM UTC By: G. Branden Robinson <gbranden>
...and try to degrade gracefully.

groff 1.22.4 trucked along just fine if `TH` was omitted, even though this is
expressly out of spec.


$ cat EXPERIMENTS/no-TH.man 
.P
Foo.
.SH Description
Bar.
$ groff -Tutf8 -man EXPERIMENTS/no-TH.man | cat -s
troff: EXPERIMENTS/no-TH.man:1: warning: macro 'P' not defined
troff: EXPERIMENTS/no-TH.man:3: warning: macro 'SH' not defined
Foo.  Bar.

$ ./build/test-groff -ww -Tutf8 -mandoc EXPERIMENTS/no-TH.man | cat -s
troff:EXPERIMENTS/no-TH.man:1: warning: macro 'P' not defined
troff:EXPERIMENTS/no-TH.man:3: warning: macro 'SH' not defined
Foo.  Bar.

$ ./build/test-groff -ww -Tutf8 -man EXPERIMENTS/no-TH.man | cat -s
troff:EXPERIMENTS/no-TH.man:1: warning: register 'PS' not defined
troff:EXPERIMENTS/no-TH.man:1: warning: register 'VS' not defined
troff:EXPERIMENTS/no-TH.man:1: warning: register 'PD' not defined
troff:EXPERIMENTS/no-TH.man:1: warning: register 'an-margin' not defined
troff:EXPERIMENTS/no-TH.man:3: warning: register 'PS-SH' not defined
troff:EXPERIMENTS/no-TH.man:3: warning: register 'an-is-in-diversion' not
defined
grotty:<standard input>:10: error: output above first line discarded
grotty:<standard input>:11: error: output above first line discarded
grotty:<standard input>:12: error: output above first line discarded
grotty:<standard input>:12: error: output above first line discarded
grotty:<standard input>:12: error: output above first line discarded
grotty:<standard input>:12: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:21: error: output above first line discarded
grotty:<standard input>:30: error: output above first line discarded
grotty:<standard input>:30: error: output above first line discarded
grotty:<standard input>:30: error: output above first line discarded
grotty:<standard input>:30: error: output above first line discarded









    _______________________________________________________

Reply to this item at:

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

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