Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 30 Apr 2019 08:53:51 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 237514] ZFS(8) Section "SUBCOMMANDS" does not contain names of sub-commands
Message-ID:  <bug-237514-9-TNoBdygfi9@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-237514-9@https.bugs.freebsd.org/bugzilla/>
References:  <bug-237514-9@https.bugs.freebsd.org/bugzilla/>

next in thread | previous in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D237514

Wolfram Schneider <wosch@FreeBSD.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |doc@FreeBSD.org,
                   |                            |mav@FreeBSD.org
           Assignee|wosch@FreeBSD.org           |mav@FreeBSD.org
          Component|Website                     |Manual Pages

--- Comment #4 from Wolfram Schneider <wosch@FreeBSD.org> ---
The problem first occurred in

commit 184cebbed99a0025594b410876510fc4064c6b0b
Author: mav <mav@FreeBSD.org>
Date:   Mon Jul 30 22:39:30 2018 +0000

    MFV r336944: 9286 want refreservation=3Dauto


since then groff+mdoc cannot parse the page anymore, and report an error
message. It is easily to reproduce

$ nroff -man zfs.8
zfs.8:1485: environment stack underflow
zfs.8:1485: cannot chop empty macro
mdoc warning: Empty input line #1702
mdoc warning: Empty input line #1739
mdoc warning: Empty input line #1739
[...]

The issue is around the lines


+.Sy reservation
+property on pool version 8 or earlier
+.Pc
+after the volume has been created.


where you have a closing bracket (.Pc), but there was not opening bracket
(.Po), see the mdoc documentation
https://man.freebsd.org/mdoc.samples

Since FreeBSD 12 we migrated from groff to mandoc. Apparently, mandoc handle
the error differently.

Nevertheless, this is an error on the manpage, and you may get a broken out=
put
on any OS which use the traditional GNU groff/mdoc (FreeBSD before version =
12,
any linux distro).

--=20
You are receiving this mail because:
You are on the CC list for the bug.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-237514-9-TNoBdygfi9>