Date: Sun, 20 Aug 2023 13:22:32 +0000 From: bugzilla-noreply@freebsd.org To: ports-bugs@FreeBSD.org Subject: [Bug 273245] textproc/groff: groff_mdoc(7): output from 'man 7 groff_mdoc' is badly broken Message-ID: <bug-273245-7788@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D273245 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.=20 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 indenta= tion <standard input>:4852: warning: table wider than line length minus indentat= ion ---- % 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=20= =20=20=20 grahamperrin@mowa219-gjp4-8570p-freebsd:/usr/obj/usr/src/amd64.amd64/sys/GE= NERIC-NODEBUG amd64 1400094 1400094 % --=20 You are receiving this mail because: You are the assignee for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-273245-7788>