[Pkg-shadow-devel] Bug#340490: marked as forwarded (su(1) manpage does not document what -c -m -p or -s do)

[Debian Bug Tracking System]

Your message dated Mon, 28 Nov 2005 23:25:16 +0100
with message-id <20051128222513.GF32264 at djedefre.onera>
has caused the Debian Bug report #340490,
regarding su(1) manpage does not document what -c -m -p or -s do
to be marked as having been forwarded to the upstream software
author(s) Tomasz KÅ‚oczko <kloczek at zie.pg.gda.pl>.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

---------------------------------------
Received: (at 340490-forwarded) by bugs.debian.org; 28 Nov 2005 22:26:02 +0000
>From bubulle at kheops.frmug.org Mon Nov 28 14:26:02 2005
Return-path: <bubulle at kheops.frmug.org>
Received: from perrier.eu.org ([81.56.227.253] helo=kheops.perrier.eu.org)
	by spohr.debian.org with esmtp (Exim 4.50)
	id 1EgrRh-0002kQ-Lz; Mon, 28 Nov 2005 14:26:02 -0800
Received: from localhost (localhost [127.0.0.1])
	by kheops.perrier.eu.org (Postfix) with ESMTP id AC7DD4F979;
	Mon, 28 Nov 2005 23:25:28 +0100 (CET)
Received: from kheops.perrier.eu.org ([127.0.0.1])
	by localhost (kheops [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id 31815-03; Mon, 28 Nov 2005 23:25:27 +0100 (CET)
Received: from mykerinos.kheops.frmug.org (mykerinos.kheops.frmug.org [192.168.1.3])
	by kheops.perrier.eu.org (Postfix) with ESMTP id CCEB84F899;
	Mon, 28 Nov 2005 23:25:27 +0100 (CET)
Received: by mykerinos.kheops.frmug.org (Postfix, from userid 1000)
	id 850F340B59E; Mon, 28 Nov 2005 23:25:16 +0100 (CET)
Date: Mon, 28 Nov 2005 23:25:16 +0100
From: Christian Perrier <bubulle at debian.org>
To: Tomasz =?utf-8?Q?K=C5=82oczko?= <kloczek at zie.pg.gda.pl>
Cc: 340490-forwarded at bugs.debian.org
Subject: Missing option in su(1) man page
Message-ID: <20051128222513.GF32264 at djedefre.onera>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="RnlQjJ0d97Da+TV1"
Content-Disposition: inline
User-Agent: Mutt/1.5.11
X-Virus-Scanned: by amavisd-new-20030616-p10 (Debian) at kheops.frmug.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2005_01_02 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Level: 
X-Spam-Status: No, hits=-6.9 required=4.0 tests=BAYES_00,HAS_PACKAGE,
	HTML_20_30,HTML_MESSAGE,VALID_BTS_CONTROL autolearn=no 
	version=2.60-bugs.debian.org_2005_01_02


--RnlQjJ0d97Da+TV1
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

tags 340490 patch upstream
thanks

This bug never showed up in the mailing list:

Package: login
Version: 4.0.13-7
Severity: minor

The su(1) manpage doees not document what the -c, -m, -p and -s
options do. Luckily, su --help does... but they should probably be
documented in both places.

If I get a chance, I'll make a patch later (but the odds of that
happening rapidly are slim. ;-))


Don Armstrong


Tomasz, attached is a proposed (but unchecked) patch which applies to your CVS.


-- 



--RnlQjJ0d97Da+TV1
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename=diff

--- su.1.ori.xml	2005-11-28 23:13:25.058610015 +0100
+++ su.1.xml	2005-11-28 23:22:20.710844539 +0100
@@ -15,6 +15,9 @@
   <refsynopsisdiv id='synopsis'>
     <cmdsynopsis>
       <command>su</command>
+      <arg choice='opt'>
+	<replaceable>opts</replaceable>
+      </arg>
       <arg choice='opt'>- </arg>
       <arg choice='opt'>
 	<arg choice='plain'>
@@ -68,6 +71,58 @@
     </para>
   </refsect1>
 
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+    <para>The options which apply to the <command>su</command> command are:
+    </para>
+    <variablelist remap='IP'>
+      <varlistentry>
+	<term>
+	  <option>-</option>
+	</term>
+	<listitem>
+	  <para>
+	    make this a login shell
+	  </para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+	<term>
+	<term>
+	  <option>-c</option>, <option>--command</option>
+	  <replaceable>command</replaceable>
+	</term>
+	<listitem>
+	  <para>
+	    pass command to the invoked shell using its -c option.
+	  </para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+	<term>
+	  <option>-m</option>, <option>-p</option>, <option>--preserve-environment</option>
+	</term>
+	<listitem>
+	  <para>
+	    do not reset environment variables, and keep the same shell.
+	  </para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+	<term>
+	  <option>-s</option>, <option>--shell</option>
+	  <replaceable>shell</replaceable>
+	</term>
+	<listitem>
+	  <para>
+	    use shell instead of the default in /etc/passwd
+	  </para>
+	</listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+
   <refsect1 id='caveats'>
     <title>CAVEATS</title>
     <para>

--RnlQjJ0d97Da+TV1--