[Bug 273245] textproc/groff: groff_mdoc(7): output from 'man 7 groff_mdoc' is badly broken

From: <bugzilla-noreply_at_freebsd.org>
Date: Sun, 20 Aug 2023 13:22:32 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=273245

            Bug ID: 273245
           Summary: textproc/groff: groff_mdoc(7): output from 'man 7
                    groff_mdoc' is badly broken
           Product: Ports & Packages
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Individual Port(s)
          Assignee: bapt@FreeBSD.org
          Reporter: grahamperrin@gmail.com
                CC: doc@FreeBSD.org
             Flags: maintainer-feedback?(bapt@FreeBSD.org)
          Assignee: bapt@FreeBSD.org

<https://docs.freebsd.org/en/books/fdp-primer/book/#manual-pages-resources>
lists groff_mdoc(7) amongst the resources for manual page writers. 

man 7 groff_mdoc

ented package for writing manual pages with Its predecessor,  the
package,  primarily addressed page layout and presentational con-
cerns, leaving the selection of fonts and other  typesetting  de-
tails  to  the individual author.  This discretion has led to di-
vergent styling practices among authors using it.  organizes  its
macros  into  The lays out the page and comprises titles, section
headings, displays, and lists.  The supplies macros to  quote  or
style  text,  or  to interpolate common noun phrases.  The offers
semantic macros corresponding to the terminology used by  practi-
tioners  in  discussion of commands, routines, and files.  Manual
domain macros distinguish  command-line  arguments  and  options,
function  names, function parameters, pathnames, variables, cross
references to other manual pages, and so  on.   These  terms  are
meaningful  both  to the author and the readers of a manual page.
It is hoped that the resulting increased consistency of  the  man
page  corpus  will enable easier translation to future documenta-
tion tools.  Throughout documentation, a manual entry is referred
:<standard input>:2882: warning: table wider than line length minus indentation
<standard input>:4852: warning: table wider than line length minus indentation


----

% pkg iinfo groff && uname -aKU
groff-1.23.0
FreeBSD mowa219-gjp4-8570p-freebsd 14.0-ALPHA2 FreeBSD 14.0-ALPHA2 amd64
1400094 #5 main-n264868-edacf4b4824a-dirty: Sat Aug 19 00:45:03 BST 2023    
grahamperrin@mowa219-gjp4-8570p-freebsd:/usr/obj/usr/src/amd64.amd64/sys/GENERIC-NODEBUG
amd64 1400094 1400094
%

-- 
You are receiving this mail because:
You are on the CC list for the bug.