Bug 263310 - cxgbetool(8) wanting groff on 12.x and other rendering issues
Summary: cxgbetool(8) wanting groff on 12.x and other rendering issues
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-bugs (Nobody)
URL: https://cgit.freebsd.org/src/tree/usr...
Keywords:
Depends on: 268568
Blocks:
  Show dependency treegraph
 
Reported: 2022-04-16 02:14 UTC by Pau Amma
Modified: 2023-04-12 01:04 UTC (History)
4 users (show)

See Also:


Attachments
Screenshot: two Konsole windows (182.46 KB, image/png)
2022-12-26 13:51 UTC, Graham Perrin
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Pau Amma 2022-04-16 02:14:39 UTC
~% man cxgbetool
This manpage needs groff(1) to be rendered
First install groff(1): 
pkg install groff

I haven't heard from 13.x users what happens there, but someone in IRC mentioned it had rendering issues and needed linting on 14-current.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-12-26 13:48:34 UTC
<https://github.com/freebsd/freebsd-src/blob/main/usr.sbin/cxgbetool/cxgbetool.8#L208-L211> are lines 208–211 significant? 


.TS
center expand;
cb cb cbw(40m)
cb l l.


Also, it will help to have an empty line (when rendered) between the table heading and the paragraph that precedes the heading.
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-12-26 13:51:31 UTC
Created attachment 239031 [details]
Screenshot: two Konsole windows

(In reply to Pau Amma from comment #0)

> … rendering issues …

Maybe the gaps pictured in the window to the right? 

The environment in the window to the left has MANWIDTH set. 

% echo $MANWIDTH
tty
%
Comment 3 Pau Amma 2022-12-26 21:57:45 UTC
(In reply to Graham Perrin from comment #2)

I don't remember what they said the rendering issues were (or whether). But I just tried now that I have a 13.1 handy, and that manual page wants groff here as well.
Comment 4 Yuri 2022-12-27 04:06:26 UTC
(In reply to Graham Perrin from comment #1)
It's a table (tbl(7)) previously processed by tbl(8) and now processed by mandoc that does not seem to have macros inside the table cells implemented hence the UNSUPP warnings and the need for groff.

review D37881 tries to implement the table using Bl -column (and fixes other issues reported by lint).