[Bug 241959] su documentation is misleading

[bugzilla-noreply at freebsd.org]

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

            Bug ID: 241959
           Summary: su documentation is misleading
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Manual Pages
          Assignee: bugs at FreeBSD.org
          Reporter: dewayne at heuristicsystems.com.au
                CC: doc at FreeBSD.org

su use and documentation is misleading.  Please review the following:

# /usr/bin/su -m root -C  ; # This was intentional to get usage
Unknown option: `-C'
Usage: _su [ -bcdefilmnqstvVxX ] [ argument ... ].

# /usr/bin/su -h
su: illegal option -- h
usage: su [-] [-flms] [-c class] [login [args]]

The latter is what is documented in the man page, but the actual use is
described by the former.

It must be very confusing for newbies (or oldies that look into what they use).

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