Bug 242191

Summary: man pages: sysctl -n option incorrectly described
Product: Documentation Reporter: Stilez <stilezy>
Component: Manual PagesAssignee: freebsd-bugs (Nobody) <bugs>
Status: New ---    
Severity: Affects Some People CC: alfix86, doc
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   

Description Stilez 2019-11-24 14:54:35 UTC
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.