docs/157078: [patch] su.1: clarify use of -c as shell argument

[Warren Block]

>Number:         157078
>Category:       docs
>Synopsis:       [patch] su.1: clarify use of -c as shell argument
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon May 16 00:00:25 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Warren Block
>Release:        8-STABLE
>Organization:
>Environment:
FreeBSD lightning 8.2-STABLE FreeBSD 8.2-STABLE #0: Sat May 14 23:49:51 MDT 2011     root at lightning:/usr/obj/usr/src/sys/LIGHTNING  i386
>Description:
su(1) uses -c in an example, but does not explain that it is passed to a shell, not su's -c option.
>How-To-Repeat:
Compare the description of su's -c option in su.1 with the use of -c in the first example.
>Fix:
Apply patch.

Patch attached with submission follows:

--- usr.bin/su/su.1.orig	2011-05-15 16:57:35.000000000 -0600
+++ usr.bin/su/su.1	2011-05-15 17:29:24.000000000 -0600
@@ -197,10 +197,9 @@
 .Sh EXAMPLES
 .Bl -tag -width 5n -compact
 .It Li "su -m man -c catman"
-Runs the command
-.Li catman
-as user
-.Li man .
+As user
+.Li man , start a shell with the arguments
+.Dq "-c catman" .
 You will be asked for man's password unless your real UID is 0.
 Note that the
 .Fl m


>Release-Note:
>Audit-Trail:
>Unformatted: