Summary: | man(1) fails to render manpages that work correctly both with gnroff and mdocml | ||
---|---|---|---|
Product: | Documentation | Reporter: | mirabilos <tg> |
Component: | Manual Pages | Assignee: | freebsd-bugs (Nobody) <bugs> |
Status: | Open --- | ||
Severity: | Affects Some People | CC: | doc, g.branden.robinson |
Priority: | --- | ||
Version: | Latest | ||
Hardware: | Any | ||
OS: | Any | ||
Bug Depends on: | |||
Bug Blocks: | 273903 |
Description
mirabilos
2023-10-07 20:44:04 UTC
Tentatively: blocked by bug 273903. Hmm, I don’t follow. On a Debian system (unstable/sid chroot) with GNU groff 1.23 the manpage *also* renders okay, even with -mandoc: $ nroff -c -mandoc mksh.1 | head -10 MKSH(1) General Commands Manual MKSH(1) NAME mksh, sh — MirBSD Korn shell SYNOPSIS mksh [-+abCefhiklmnprUuvXx] [-T [!]tty | -] [-+o option] [-c string | -s | file [argument ...]] builtin‐name [argument ...] So it’s not a GNU groff issue. I can reproduce the problem on my Debian system with the following. $ zcat /usr/share/man/man1/mksh.1.gz | groff -man -Tutf8 | head is a command interpreter intended for both interactive and shell script use. Its command language is a superset of the shell lan‐ guage and largely compatible to the original Korn shell. At times, this manual page may give scripting advice; while it some‐ times does take portable shell scripting or various standards into account all information is first and foremost presented with in mind and should be taken as such. Please refer to: Most builtins can be called directly, for example if a link points from its name to the shell; not all make sense, have been tested In other words, all I had to do was say "-man" instead of "-mandoc". That would make this a duplicate of bug #273245 (and bug #273565). (In reply to G. Branden Robinson from comment #3) No, that’s wrong. For normal manpages, you *must* use -mandoc because you can’t know ahead of time whether they want -man or -mdoc (-mandoc is a “switch”: it checks from the first macro the manpage calls whether it’s a -man or a -mdoc page and loads the correct one). You're saying the same thing I am. I described how I was able to reproduce the problem--by using the "wrong" macro package selection. Please see comment #3 in bug #273245. Also, I am familiar with the operation of andoc.tmac. https://git.savannah.gnu.org/cgit/groff.git/log/tmac/andoc.tmac |