Bug 237694 - route(8) manpage does not render correctly
Summary: route(8) manpage does not render correctly
Status: Closed Works As Intended
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2019-05-01 16:01 UTC by Wolfram Schneider
Modified: 2020-05-19 09:07 UTC (History)
2 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Wolfram Schneider freebsd_committer freebsd_triage 2019-05-01 16:01:08 UTC 
If you call the route(8) manpage then some parts of the page are not rendered correctly due a groff issue.

how to reproduce:
$ zcat /usr/share/man/man8/route.8.gz | nroff -man >/dev/null
<standard input>:137: environment stack underflow
<standard input>:137: cannot chop empty macro


The problem is apparently at the line 137

.Cm flush Oc Oo Ar family Oc Op Fl fib Ar number


the expected result is:

     The flush command has the syntax:
           route [-n] flush [family] [-fib number]
Comment 1 Conrad Meyer freebsd_committer freebsd_triage 2019-05-02 00:51:36 UTC 
Manual pages are now formatted with mandoc(1), not nroff(1).
Comment 2 Benedict Reuschling freebsd_committer freebsd_triage 2020-05-19 09:07:32 UTC 
I'm closing this one. The man page renders correctly and line 137 looks exactly as shown. Perhaps it was a misunderstanding that we are not using nroff any more, as Conrad has pointed out.