update docs for xargs

[oweals/busybox.git] / docs / busybox.sgml

diff --git a/docs/busybox.sgml b/docs/busybox.sgml
index e81523046422a53ad24ceee673654561028259a6..9c017901180471db479bd97240243026c1dcfce4 100644 (file)
--- a/docs/busybox.sgml
+++ b/docs/busybox.sgml
@@ -1,5 +1,4 @@
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-]>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ ]>
 <book id="BusyBoxDocumentation">
  <bookinfo>
   <title>BusyBox - The Swiss Army Knife of Embedded Linux</title>
@@ -746,6 +745,19 @@
                </para>
        </sect1>
 
+       <sect1 id="dos2unix">
+           <title>dos2unix</title>
+
+               <para>
+               Usage: dos2unix < dosfile > unixfile
+               </para>
+
+               <para>
+               Converts a text file from dos format to unix format.
+               </para>
+
+       </sect1>
+
        <sect1 id="du">
            <title>du</title>
 
@@ -1567,14 +1579,16 @@
                        # /bin/sh invocations on selected ttys
                        #
                        # Start an "askfirst" shell on the console (whatever that may be)
-                       ::askfirst:/bin/sh
-                       # Start an "askfirst" shell on /dev/tty2
-                       tty2::askfirst:/bin/sh
+                       ::askfirst:-/bin/sh
+                       # Start an "askfirst" shell on /dev/tty2-4
+                       tty2::askfirst:-/bin/sh
+                       tty2::askfirst:-/bin/sh
+                       tty2::askfirst:-/bin/sh
 
                        # /sbin/getty invocations for selected ttys
                        #
-                       tty4::respawn:/sbin/getty 38400 tty4
-                       tty5::respawn:/sbin/getty 38400 tty5
+                       tty4::respawn:/sbin/getty 38400 tty5
+                       tty5::respawn:/sbin/getty 38400 tty6
 
                        # Example of how to put a getty on a serial line (for a terminal)
                        #
@@ -1585,8 +1599,8 @@
                        #ttyS2::respawn:/sbin/getty -x0 -s 57600 ttyS2
 
                        # Stuff to do before rebooting
-                       ::ctrlaltdel:/bin/umount -a -r &gt; /dev/null 2&gt;&amp;1
-                       ::ctrlaltdel:/sbin/swapoff -a &gt; /dev/null 2&gt;&amp;1
+                       ::ctrlaltdel:/bin/umount -a -r
+                       ::ctrlaltdel:/sbin/swapoff
                </screen>
                </para>
                </sect2>
@@ -1908,6 +1922,7 @@
                        -A      Do not list implied . and ..
                        -C      List entries by columns
                        -F      Append indicator (one of */=@|) to entries
+                       -L      list entries pointed to by symbolic links
                        -R      List subdirectories recursively
                </screen>
                </para>
@@ -3392,6 +3407,32 @@
                </screen>
                </para>
        </sect1>
+       
+       <sect1 id="unix2dos">
+           <title>unix2dos</title>
+
+               <para>
+               Usage: unix2dos < unixfile > dosfile
+               </para>
+
+               <para>
+               Converts a text file from unix format to dos format.
+               </para>
+
+       </sect1>
+
+       <sect1 id="unrpm">
+           <titleunrpmuniq</title>
+
+               <para>
+               Usage: unrpm < package.rpm | gzip -d | cpio -idmuv
+               </para>
+
+               <para>
+               Extracts an rpm archive.
+               </para>
+
+       </sect1>
 
        <sect1 id="update">
            <title>update</title>
@@ -3619,6 +3660,40 @@
                </para>
        </sect1>
 
+       <sect1 id="xargs">
+           <title>xargs</title>
+
+               <para>
+               Usage: xargs [OPTIONS] [COMMAND] [ARGS...]
+               </para>
+
+               <para>
+               Executes COMMAND on every item given by standard input.
+               </para>
+
+               <para>
+               Options:
+               </para>
+
+               <para>
+               <screen>
+                       -t      Print the command just before it is run
+               </screen>
+               </para>
+
+
+               <para>
+               Example:
+               </para>
+
+               <para>
+               <screen>
+                       $ ls | xargs gzip
+                       $ find . -name '*.c' -print | xargs rm
+               </screen>
+               </para>
+       </sect1>
+
        <sect1 id="yes">
            <title>yes</title>