[Bug 274343] man(1) fails to render manpages that work correctly both with gnroff and mdocml

From: <bugzilla-noreply_at_freebsd.org>
Date: Sat, 07 Oct 2023 20:44:04 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=274343

            Bug ID: 274343
           Summary: man(1) fails to render manpages that work correctly
                    both with gnroff and mdocml
           Product: Base System
           Version: 13.2-RELEASE
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: bin
          Assignee: bugs@FreeBSD.org
          Reporter: tg@mirbsd.org

Hi again,

still the ports/shells/mksh upstream with bugreports directed my way by my
users.

The user is on 13.2-RELEASE and reports that the mksh(1) manpage does not
display correctly:

  $ man mksh | head -5

  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-

However, invoking not only GNU groff directly (I told him to use “nroff -mdoc
-c mksh.1 | less”) works, but it also works if he invokes mdocml directly:

$ mandoc mksh.1 | head -10
MKSH(1)                 FreeBSD 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 ...]
[…]

I *was* suspecting the mdocml version at first because older mdocml releases
failed to render manpages with *roff commands/macros in them at all, but that
has been fixed at some point, and apparently, he’s carrying a version that
does.

At this point, and without access to a FreeBSD system myself, my triage ends
and I have to defer to whomever maintains the man/groff/mdocml subsystems at
your site.

-- 
You are receiving this mail because:
You are the assignee for the bug.