Bug 241959 - su documentation is misleading
Summary: su documentation is misleading
Status: Closed Overcome By Events
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-11-14 00:32 UTC by dewayne
Modified: 2020-07-04 21:17 UTC (History)
1 user (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 dewayne 2019-11-14 00:32:58 UTC 
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).