[Bug 242191] man pages: sysctl -n option incorrectly described

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=242191

            Bug ID: 242191
           Summary: man pages: sysctl -n option incorrectly described
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Manual Pages
          Assignee: bugs at FreeBSD.org
          Reporter: stilezy at gmail.com
                CC: doc at FreeBSD.org

Current misleading description, suggests it outputs value of sysctls only,
whereas it can output anything (type/descript etc). Its actual function is to
suppress name, not output value only.

Current misleading description:

"-n:  Show only variable values, not their names.  This option is useful for
setting shell variables.  For instance, to save the pagesize in variable psize,
use:

 set psize=`sysctl -n hw.pagesize"


Suggested improved wording:

-n:  Suppress variable names. The output will be the bare value, description,
type, or other details, according to the other options used. This option is
useful for setting shell variables.  For instance, to save the pagesize in
variable psize, use:

 set psize=`sysctl -n hw.pagesize"


Sorry, not up to speed on SVN, hence unconfident to push as a change myself.

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