Bug 250332

Summary: zfs(8) manpage subcommand lines missing
Product: Documentation Reporter: ivanngeow
Component: Manual PagesAssignee: freebsd-bugs (Nobody) <bugs>
Status: Open ---    
Severity: Affects Many People CC: doc, gbe, ivanngeow, wosch
Priority: --- Flags: ivanngeow: maintainer-feedback-
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://www.freebsd.org/cgi/man.cgi?query=zfs&apropos=0&sektion=0&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html
Bug Depends on: 237514    
Bug Blocks:    
Attachments:
Description Flags
missing subcommand lines none

Description ivanngeow 2020-10-14 07:59:45 UTC
Created attachment 218731 [details]
missing subcommand lines

On the Subcommands section of the zfs(8) manpage, a subcommand is listed followed by the description of what it does, and its options.

When rendered on the FreeBSD manpage site, the line that states the subcommand (eg 'zfs create [-pu] [-o property=value]... filesystem') is missing.

This problem is seen across all display formats rendered by the site: html, ascii, pdf. It has been reproduced using the Micro$oft Edge (screenshot attached) and Firefox browsers.

This problem occurs when viewing the 12.1-RELEASE and 11.4-RELEASE versions of the manpage.

eg https://www.freebsd.org/cgi/man.cgi?query=zfs&apropos=0&sektion=0&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html

This problem is NOT seen when viewing the 10.4-RELEASE version of the manpage.

https://www.freebsd.org/cgi/man.cgi?query=zfs&apropos=0&sektion=0&manpath=FreeBSD+10.4-RELEASE&arch=default&format=html

IMPACT:
The manpage is essentially useless for its purpose of being a reference for the subcommands, if the subcommand it is describing is missing. The impact is HIGH.
Comment 1 Wolfram Schneider freebsd_committer 2020-10-14 15:11:04 UTC
I think this is a duplicate of #237514

It was fixed in 13-current, but apparently not back ported to 11.3 and 12 series