From sheldonh@axl.iafrica.com  Mon Aug 25 13:05:40 1997
Received: from axl.iafrica.com (sheldonh@axl.iafrica.com [196.31.1.167])
          by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id NAA06048
          for <FreeBSD-gnats-submit@freebsd.org>; Mon, 25 Aug 1997 13:05:38 -0700 (PDT)
Received: (from sheldonh@localhost)
	by axl.iafrica.com (8.8.7/8.8.7) id WAA08992;
	Mon, 25 Aug 1997 22:05:12 +0200 (SAT)
Message-Id: <199708252005.WAA08992@axl.iafrica.com>
Date: Mon, 25 Aug 1997 22:05:12 +0200 (SAT)
From: sheldonh@iafrica.com
Reply-To: sheldonh@iafrica.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: su manpage ambiguous regarding command prompt
X-Send-Pr-Version: 3.2

>Number:         4383
>Category:       docs
>Synopsis:       su manpage ambiguous regarding command prompt
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 25 13:10:00 PDT 1997
>Closed-Date:    Sat Sep 13 10:44:40 PDT 1997
>Last-Modified:  Sat Sep 13 10:46:08 PDT 1997
>Originator:     Sheldon Hearn
>Release:        FreeBSD 2.2-STABLE i386
>Organization:
NYFB
>Environment:

	2.2-STABLE

>Description:

	Existing su(1) manpage misleadingly implies that the su program
	itself changes the super-user command prompt to '#'.

	| By default (unless the prompt is reset by a startup file) the 
	| super-user prompt is set to ``#'' to remind one of its awesome
	| power.

>How-To-Repeat:

	man su

>Fix:
	
	Clearly note that su itself does nothing to the command prompt.

	Apply the following patch to su.1 :


--- su.1.ORIG	Wed Aug 13 08:38:16 1997
+++ su.1	Mon Aug 25 21:25:42 1997
@@ -157,10 +157,19 @@
 .Dq root ,
 unless this group is empty.
 .Pp
-By default (unless the prompt is reset by a startup file) the super-user
-prompt is set to
-.Dq Sy \&#
-to remind one of its awesome power.
+When using
+.Nm
+to become super-user, note that the invoked shell dictates the new
+command prompt and not
+.Nm su .
+Even when
+.Nm
+is invoked with the
+.Fl l
+option, the command prompt is still determined by the shell's startup
+files, specifically their manipulation of the
+.Ev PS1
+variable.
 .Sh SEE ALSO
 .Xr csh 1 ,
 .Xr kerberos 1 ,

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: wosch 
State-Changed-When: Sat Sep 13 10:44:40 PDT 1997 
State-Changed-Why:  
Submitted patch applied.  src/usr.bin/su/su.1,v rev 1.11 
Thanks! 
>Unformatted:
