Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 08 Jun 2022 16:28:22 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 264501] bc(1): Multiple issues in manual page
Message-ID:  <bug-264501-9-Xuiy5ASrDK@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-264501-9@https.bugs.freebsd.org/bugzilla/>
References:  <bug-264501-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=3D264501

Stefan E=C3=9Fer <se@FreeBSD.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|Open                        |In Progress

--- Comment #4 from Stefan E=C3=9Fer <se@FreeBSD.org> ---
(In reply to Gavin D. Howard from comment #3)

I have found the cause of the broken elements and URLs:

The man page is rendered with "groff -man", and with default settings this
enables block justification and hyphenation.

Adding 2 macros (.nh and .ad l) to the start of the man page solves the iss=
ue.

This causes left justified ragged lines and disables hyphenation.

But since the default settings are inappropriate (at least for man pages th=
at
contain long options in the SYNOPSYS and long URLs in the text), I'm wonder=
ing
whether it might be possible to run "groff" with options that change the
processing to no hyphenation and ragged lines without the need of macros in
each affected man-page.

And I still do not understand why the man pages are formatted with groff,
anyway.=20

We have mandoc and it seems its default formatting option are sane ...

--=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-264501-9-Xuiy5ASrDK>