From 7903a1b7670e6f0cc10c340ff2a8b8676e36ecc4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nicolas=20Fran=C3=A7ois?= <nicolas.francois@centraliens.net>
Date: Sun, 4 Aug 2013 23:45:31 +0200
Subject: [PATCH] Fix su/1 documentation of -

	* man/su.1.xml: With getopt, '-' does not need to be the last
	option, but it is recommended for portability.
	Closes https://bugs.launchpad.net/bugs/1100775
---
 ChangeLog    | 6 ++++++
 man/su.1.xml | 8 +++++---
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index a8c6f11c..7d0cd6e6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2013-08-04  Nicolas François  <nicolas.francois@centraliens.net>
+
+	* man/su.1.xml: With getopt, '-' does not need to be the last
+	option, but it is recommended for portability.
+	Closes https://bugs.launchpad.net/bugs/1100775
+
 2013-08-04  Nicolas François  <nicolas.francois@centraliens.net>
 
 	* NEWS: Add NEWS entries.
diff --git a/man/su.1.xml b/man/su.1.xml
index b67041c8..b950148a 100644
--- a/man/su.1.xml
+++ b/man/su.1.xml
@@ -175,9 +175,11 @@
 	    the user logged in directly.
 	  </para>
 	  <para>
-	    When <option>-</option> is used, it must be specified as the last
-	    <command>su</command> option.
-	    The other forms (<option>-l</option> and <option>--login</option>)
+	    When <option>-</option> is used, it must be specified before any
+	    <option>username</option>.  For portability it is recommended
+	    to use it as last option, before any
+	    <option>username</option>.  The other forms
+	    (<option>-l</option> and <option>--login</option>)
 	    do not have this restriction.
 	  </para>
 	</listitem>