[Pkg-shadow-commits] r1727 - in upstream/trunk: . man

[nekral-guest at alioth.debian.org]

Author: nekral-guest
Date: 2008-01-22 20:56:13 +0000 (Tue, 22 Jan 2008)
New Revision: 1727

Modified:
   upstream/trunk/ChangeLog
   upstream/trunk/man/grpck.8.xml
Log:
Document the options with a list of options, as in the pwck(8) manpage.


Modified: upstream/trunk/ChangeLog
===================================================================
--- upstream/trunk/ChangeLog	2008-01-21 23:33:43 UTC (rev 1726)
+++ upstream/trunk/ChangeLog	2008-01-22 20:56:13 UTC (rev 1727)
@@ -1,5 +1,10 @@
 2008-01-22  Nicolas François  <nicolas.francois at centraliens.net>
 
+	* man/grpck.8.xml: Document the options with a list of options,
+	as in the pwck(8) manpage.
+
+2008-01-22  Nicolas François  <nicolas.francois at centraliens.net>
+
 	* NEWS, src/newgrp.c: Fix segfault when an user returns to an
 	unknown GID (either the user was deleted during the user's newgrp
 	session or the user's passwd entry referenced an invalid group).

Modified: upstream/trunk/man/grpck.8.xml
===================================================================
--- upstream/trunk/man/grpck.8.xml	2008-01-21 23:33:43 UTC (rev 1726)
+++ upstream/trunk/man/grpck.8.xml	2008-01-22 20:56:13 UTC (rev 1727)
@@ -23,6 +23,13 @@
 	<arg choice='plain'><replaceable>shadow</replaceable></arg>
       </arg>
     </cmdsynopsis>
+    <cmdsynopsis>
+      <command>grpck</command>    <arg choice='opt'>-s </arg>
+      <arg choice='opt'>
+	<arg choice='plain'><replaceable>group</replaceable></arg>
+	<arg choice='plain'><replaceable>shadow</replaceable></arg>
+      </arg>
+    </cmdsynopsis>
   </refsynopsisdiv>
 
   <refsect1 id='description'>
@@ -72,18 +79,35 @@
   <refsect1 id='options'>
     <title>OPTIONS</title>
     <para>
+      The options which apply to the <command>grpck</command> command are:
+    </para>
+    <variablelist remap='IP'>
+      <varlistentry>
+	<term><option>-r</option></term>
+	<listitem>
+	  <para>
+	    Execute the <command>grpck</command> command in read-only mode.
+	    This causes all questions regarding changes to be answered
+	    <emphasis>no</emphasis> without user intervention.
+	  </para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+	<term><option>-s</option></term>
+	<listitem>
+	  <para>
+	    Sort entries in <filename>/etc/group</filename> and
+	    <filename>/etc/gshadow</filename> by GID.
+	  </para>
+	</listitem>
+      </varlistentry>
+    </variablelist>
+    <para>
       By default, <command>grpck</command> operates on the files
       <filename>/etc/group</filename> and <filename>/etc/gshadow</filename>. 
       The user may select alternate files with the <emphasis
       remap='I'>group</emphasis> and <emphasis remap='I'>shadow</emphasis>
-      parameters. Additionally, the user may execute the command in
-      read-only mode by specifying the <option>-r</option> flag. This causes
-      all questions regarding changes to be answered <emphasis>no</emphasis>
-      without user intervention. <command>grpck</command> can also sort
-      entries in <filename>/etc/group</filename> and
-      <filename>/etc/gshadow</filename> by GID. To run it in sort mode pass
-      it <option>-s</option> flag. No checks are performed then, it just
-      sorts.
+      parameters.
     </para>
   </refsect1>