Ticket #2493: usermod-2.patch

basicnet/connect/ppp.xml

@@ -88 +88 @@
     </indexterm>
 
     <para>Create (as <systemitem class="username">root</systemitem>)
-    the group for users who may run <application>PPP</application>:</para>
+    the group for users who may run <application>PPP</application> and add them to
+    that group:</para>
 
-<screen role="root"><userinput>groupadd -g 52 pppusers</userinput></screen>
+<screen role="root"><userinput>groupadd -g 52 pppusers
+usermod -a -G pppusers <replaceable>&lt;username&gt;</replaceable>
+</userinput></screen>
 
     <para>Install <application>PPP</application> by running the
     following commands:</para>

multimedia/libdriv/alsa-utils.xml

@@ -167 +167 @@
 EOF
 chmod -v 644 /etc/udev/rules.d/40-alsa.rules</userinput></screen>
 
+      <para>All sound devices are not accessable for any user except 
+      <systemitem class="username">root</systemitem> and members of the
+      <systemitem class="groupname">audio</systemitem> group. Add any users
+      that might use the sound devices to that group:</para>
+<screen role="root"><userinput>usermod -a -G audio <replaceable>&lt;username&gt;</replaceable></userinput></screen>
+
+      <note>
+        <para>You may need to log out and back in again to refresh your group
+        memberships. '<command>su <replaceable>&lt;username&gt;</replaceable></command>'
+        should work around this as well.</para>
+      </note>
+
     </sect3>
 
   </sect2>

server/other/svnserver.xml

@@ -79 +79 @@
       user to that group with the following commands:</para>
 
 <screen role="root"><userinput>groupadd -g 57 svntest &amp;&amp;
-usermod -G svntest svn</userinput></screen>
+usermod -G svntest -a svn</userinput></screen>
 
       <para>Additionally you should set <command>umask 002</command> while
       working with a repository so that all new files will be writable by
@@ -159 +159 @@
 <screen role="root"><userinput>chown -R svn:svntest /srv/svn/repositories/svntest &amp;&amp;
 chmod -R g+w /srv/svn/repositories/svntest &amp;&amp;
 chmod g+s /srv/svn/repositories/svntest/db &amp;&amp;
-usermod -G svn,svntest,<replaceable>&lt;insert existing groups&gt;</replaceable> <replaceable>&lt;username&gt;</replaceable></userinput></screen>
+usermod -G svn,svntest -a <replaceable>&lt;username&gt;</replaceable></userinput></screen>
 
       <para><systemitem class="groupname">svntest</systemitem> is the group
       assigned to the svntest repository. As mentioned earlier, this eases

x/installing/x-setup.xml

@@ -274 +274 @@
     Mode  0660
 EndSection</literal></screen>
 
+    <para>The DRI devices are not accessable for any user except 
+      <systemitem class="username">root</systemitem> and members of the
+      <systemitem class="groupname">video</systemitem> group. Add any users
+      that might use X to that group:</para>
+<screen role="root"><userinput>usermod -a -G video <replaceable>&lt;username&gt;</replaceable></userinput></screen>
+
     <note><para>DRI configuration may differ if you are using alternate
     drivers, such as those from
     <ulink url="http://www.nvidia.com/page/home.html">NVIDIA</ulink> or

general/sysutils/hal.xml

@@ -276 +276 @@
 
       <para>Now add the users you would like to the <systemitem
       class="groupname">halusers</systemitem> group to use
-      <application>HAL</application>. Note that these users still need
+      <application>HAL</application>.</para>
+<screen role="root"><userinput>usermod -a -G halusers <replaceable>&lt;username&gt;</replaceable></userinput></screen>
+      <para>Note that these users still need
       to have appropriate permissions to access the devices that
       <application>HAL</application> will invoke its methods on.</para>
 

general/genlib/libusb.xml

@@ -149 +149 @@
     </indexterm>
 
     <para>To have raw USB devices set up properly, add the following
-    <application>udev</application> rule and add any users
-    that need to access raw USB devices to the "usb" group.</para>
+    <application>udev</application> rule.</para>
 
 <screen><literal>cat &gt; /etc/udev/rules.d/23-usb.rules &lt;&lt; "EOF"
 # Set group ownership for raw USB devices
@@ -176 +175 @@
 <screen><literal>usbfs  /proc/bus/usb  usbfs  devgid=14,devmode=0660  0  0</literal></screen>
 -->
 
+    <para>Add any users that need to access raw USB devices to the 
+    <systemitem class="groupname">usb</systemitem> group.</para>
+<screen role="root"><userinput>usermod -a -G usb <replaceable>&lt;username&gt;</replaceable></userinput></screen>
+
   </sect2>
 
   <sect2 role="content">