[src/trunk]: src/usr.bin/su Add some examples of usage. Modelled after what i...

[jdolecek <jdolecek%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/e0a87315623c
branches:  trunk
changeset: 485997:e0a87315623c
user:      jdolecek <jdolecek%NetBSD.org@localhost>
date:      Wed May 10 19:04:36 2000 +0000

description:
Add some examples of usage. Modelled after what is in Solaris manpage,
though no text has been actually copied from there (for legal reasons).

diffstat:

 usr.bin/su/su.1 |  18 +++++++++++++++++-
 1 files changed, 17 insertions(+), 1 deletions(-)

diffs (35 lines):

diff -r 3b7418d7f82e -r e0a87315623c usr.bin/su/su.1
--- a/usr.bin/su/su.1   Wed May 10 17:53:45 2000 +0000
+++ b/usr.bin/su/su.1   Wed May 10 19:04:36 2000 +0000
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"    from: @(#)su.1  8.2 (Berkeley) 4/18/94
-.\"    $NetBSD: su.1,v 1.18 2000/02/11 00:30:07 abs Exp $
+.\"    $NetBSD: su.1,v 1.19 2000/05/10 19:04:36 jdolecek Exp $
 .\"
 .Dd January 14, 2000
 .Dt SU 1
@@ -179,6 +179,22 @@
 prompt is set to
 .Dq Sy \&#
 to remind one of its awesome power.
+.Sh EXAMPLES
+To  become user username and use the same environment as in original shell, execute:
+.Bd -literal -offset indent
+su username
+.Ed
+
+To become user username and use environment as if full login would be performed,
+execute:
+.Bd -literal -offset indent
+su -l username
+.Ed
+
+To execute arbitrary command with privileges of user username, execute:
+.Bd -literal -offset indent
+su username -c "command args"
+.Ed
 .Sh SEE ALSO
 .Xr csh 1 ,
 .Xr login 1 ,