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: b...@freebsd.org
Reporter: grahamper...@gmail.com
CC: d...@freebsd.org
Flags: maintainer-feedback?(b...@freebsd.org)
Assignee: b...@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.
