[bug #62926] [mdoc] align styling of titles and man page cross references with man(7)

[Ingo Schwarze]

Follow-up Comment #3, bug #62926 (project groff):

[comment #2 comment #2:]
 
> It should surprise no one that my idea is to support the `MF` string in
_mdoc_(7) just as is already done in _man_(7).

Yikes.  Are you aware that the mdoc(7) language API does not contain a single
user-visible register yet?
Starting to go down that rabbit hole seems like a very bad idea to me.

> I reckon this would be used to style `Xr`'s first argument,
> and the page header.

Very grudgingly, yes, if you must pollute the API with \*(MF.

> `Nm`' first (or implied) argument,

No, absolutely not.  This is getting worse and worse!

.Nm has always been formatted as \fB and that is very important because it is
a fixed string that the user has to type verbatim.
It would be extremely confusing to use anything other than \fB for .Nm,
especially in the SYNOPSIS, but also in other places.

> While I'm in the neighborhood, page footers are _already_ out of sync
between man and mdoc

True, and synching that might make sense.  Either way, the footer line is less
important than the header line, so i don't feel strongly about it.

mdoc: OS - date - OS
man:  OS - date - title

Arguably, the man(7) way is more useful and the mdoc(7) way somewhat redundant
in this respect.


    _______________________________________________________

Reply to this item at:

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

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