[bug #60616] [mdoc] groff_mdoc(7) shows section headings in internal TOC in small font

[G. Branden Robinson]

Update of bug #60616 (project groff):

                 Summary: [mdoc] doesn't format some things as man(7) does =>
[mdoc] groff_mdoc(7) shows section headings in internal TOC in small font

    _______________________________________________________

Follow-up Comment #3:

Actually I'll rescope this back to my original complaint because the problem
is obvious and I don't think anyone would defend it.

groff_mdoc(7) has an internal table of contents where it uses the `Tn` ("trade
name/type name/acronym") macro to set the names of subsequent section
headings.

Because `Tn` drops the size of its arguments by a point, to cater to the
1960's U.S. defense industry fetish of setting of acryonyms in small capitals
(and which early Unix manuals slavishly imitated after troff was written,
_because they *could*_), the result looks bad.

Arguably this is an abuse of the `Tn` macro's purpose, but it's already pretty
murky and I don't want to get involved in litigating its "true" meaning when
the simpler solution of having `Tn` just not mess with the type size is
readily at hand.

Anyway, I'm again attempting to attach an illustration of the problem.

To reproduce, obtain any recent checkout of groff Git.


$ ./build/test-groff -t -mdoc ./build/tmac/groff_mdoc.7 > foo.ps
$ evince foo.ps


(file #52909)
    _______________________________________________________

Additional Item Attachment:

File name: groff_mdoc_bad_type_size.png   Size:101 KB
   
<https://file.savannah.gnu.org/file/groff_mdoc_bad_type_size.png?file_id=52909>



    _______________________________________________________

Reply to this item at:

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

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