bin/52710: Error in vis(1) manpage

[jamie%dyslexicfish.net@localhost]

>Number:         52710
>Category:       bin
>Synopsis:       Error in vis(1) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Nov 09 17:20:00 +0000 2017
>Originator:     Jamie Landeg Jones
>Release:        head
>Organization:
>Environment:
n/a (not running netbsd)
>Description:
The -F and -f options are incorrectly specified, as detailed in the attached fix patch to the manual pages source file.

For convenience, the diff from the resultant text is:

30,38c30,37
<      -F foldwidth
<              Causes vis to fold output lines to foldwidth columns (default
<              80), like fold(1), except that a hidden newline sequence is used,
<              (which is removed when inverting the file back to its original
<              form with unvis(1)).  If the last character in the encoded file
<              does not end in a newline, a hidden newline sequence is appended
<              to the output.  This makes the output usable with various editors
<              and other utilities which typically don't work with partial
<              lines.
---
>      -f      Causes vis to fold output lines at N columns (default 80, over&#8208;
>              ridden by -F.), like fold(1), except that a hidden newline
>              sequence is used, (which is removed when inverting the file back
>              to its original form with unvis(1)).  If the last character in
>              the encoded file does not end in a newline, a hidden newline
>              sequence is appended to the output.  This makes the output usable
>              with various editors and other utilities which typically don't
>              work with partial lines.

40c39,40
<      -f      Same as -F.
---
>      -F foldwidth
>              Set the column width to foldwidth when using -f.

51,52c51,52
<              still doubled and hidden newline sequences inserted if -f or -F
<              is selected.  When combined with the -f flag, vis becomes like an
---
>              still doubled and hidden newline sequences inserted if -f is
>              selected.  When combined with the -f flag, vis becomes like an

>How-To-Repeat:
man vis
>Fix:
# Patch errors in "vis(1)" manpage:
--- contrib/vis/vis.1.orig      2016-12-02 01:00:16.614591000 +0000
+++ contrib/vis/vis.1   2016-12-23 04:14:50.771339000 +0000
@@ -75,10 +75,12 @@
 .Ar extra ,
 per
 .Xr svis 3 .
-.It Fl F Ar foldwidth
+.It Fl f
 Causes
 .Nm
-to fold output lines to foldwidth columns (default 80), like
+to fold output lines at N columns (default 80, overridden by
+.Fl F . ) ,
+like
 .Xr fold 1 ,
 except
 that a hidden newline sequence is used, (which is removed
@@ -89,9 +91,11 @@
 This makes
 the output usable with various editors and other utilities which
 typically don't work with partial lines.
-.It Fl f
-Same as
-.Fl F .
+.It Fl F Ar foldwidth
+Set the column width to
+.Ar foldwidth
+when using
+.Fl f .
 .It Fl h
 Encode using the URI encoding from RFC 1808.
 .Pq Dv VIS_HTTPSTYLE
@@ -106,8 +110,6 @@
 Turns off any encoding, except for the fact that backslashes are
 still doubled and hidden newline sequences inserted if
 .Fl f
-or
-.Fl F
 is selected.
 When combined with the
 .Fl f