Bug 263310

Summary: cxgbetool(8) wanting groff on 12.x and other rendering issues
Product: Documentation Reporter: Pau Amma <pauamma>
Component: Manual PagesAssignee: freebsd-bugs (Nobody) <bugs>
Status: Open ---    
Severity: Affects Some People CC: doc, freebsd, grahamperrin, yuri
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://cgit.freebsd.org/src/tree/usr.sbin/cxgbetool/cxgbetool.8
See Also: https://reviews.freebsd.org/D37881
Bug Depends on: 268568    
Bug Blocks:    
Attachments:
Description Flags
Screenshot: two Konsole windows none

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).