- add the -m option to the example commands because they would fail w/o it

  as the ``man'' user does not have a valid shell by default.

PR:		docs/121713
Approved by:	trhodes
MFC after:	3 days

1 files changed, 9 insertions, 4 deletions

diff --git a/usr.bin/su/su.1 b/usr.bin/su/su.1
index 56d3f98..b8c14ca 100644
--- a/usr.bin/su/su.1
+++ b/usr.bin/su/su.1
@@ -32,7 +32,7 @@
 .\"	@(#)su.1	8.2 (Berkeley) 4/18/94
 .\" $FreeBSD$
 .\"
-.Dd September 13, 2006
+.Dd July 1, 2008
 .Dt SU 1
 .Os
 .Sh NAME
@@ -196,13 +196,18 @@ PAM configuration for
 .El
 .Sh EXAMPLES
 .Bl -tag -width 5n -compact
-.It Li "su man -c catman"
+.It Li "su -m man -c catman"
 Runs the command
 .Li catman
 as user
 .Li man .
 You will be asked for man's password unless your real UID is 0.
-.It Li "su man -c 'catman /usr/share/man /usr/local/man'"
+Note that the
+.Fl m
+option is required since user
+.Dq man
+does not have a valid shell by default.
+.It Li "su -m man -c 'catman /usr/share/man /usr/local/man'"
 Same as above, but the target command consists of more than a
 single word and hence is quoted for use with the
 .Fl c
@@ -210,7 +215,7 @@ option being passed to the shell.
 (Most shells expect the argument to
 .Fl c
 to be a single word).
-.It Li "su -c staff man -c 'catman /usr/share/man /usr/local/man'"
+.It Li "su -m -c staff man -c 'catman /usr/share/man /usr/local/man'"
 Same as above, but the target command is run with the resource limits of
 the login class
 .Dq staff .