Add dpkg-deb documentation

2 files changed, 77 insertions, 13 deletions

diff --git a/docs/busybox.pod b/docs/busybox.pod
index ccd8734cf..30f71e4f4 100644
--- a/docs/busybox.pod
+++ b/docs/busybox.pod
@@ -56,16 +56,16 @@ terse runtime description of their behavior.
 Currently defined functions include:
 
 ar, basename, cat, chgrp, chmod, chown, chroot, chvt, clear, cp, cut, date, dc,
-dd, deallocvt, df, dirname, dmesg, dos2unix, du, dumpkmap, dutmp, echo, false,
-fbset, fdflush, find, free, freeramdisk, fsck.minix, getopt, grep, gunzip,
-gzip, halt, head, hostid, hostname, id, init, insmod, kill, killall, length,
-ln, loadacm, loadfont, loadkmap, logger, logname, ls, lsmod, makedevs, mkdir,
-mkfifo, mkfs.minix, mknod, mkswap, mktemp, more, mount, mt, mv, nc, nslookup,
-ping, poweroff, printf, ps, pwd, rdate, reboot, renice, reset, rm, rmdir,
-rmmod, sed, setkeycodes, sh, sleep, sort, swapoff, swapon, sync, syslogd, tail,
-tar, tee, telnet, test, touch, tr, true, tty, umount, uname, uniq, unix2dos,
-unrpm, update, uptime, usleep, uudecode, uuencode, wc, which, whoami, xargs,
-yes, zcat, [
+dd, deallocvt, df, dirname, dmesg, dos2unix, dpkg-deb, du, dumpkmap, dutmp,
+echo, false, fbset, fdflush, find, free, freeramdisk, fsck.minix, getopt, grep,
+gunzip, gzip, halt, head, hostid, hostname, id, init, insmod, kill, killall,
+length, ln, loadacm, loadfont, loadkmap, logger, logname, ls, lsmod, makedevs,
+mkdir, mkfifo, mkfs.minix, mknod, mkswap, mktemp, more, mount, mt, mv, nc,
+nslookup, ping, poweroff, printf, ps, pwd, rdate, reboot, renice, reset, rm,
+rmdir, rmmod, sed, setkeycodes, sh, sleep, sort, swapoff, swapon, sync, syslogd,
+tail, tar, tee, telnet, test, touch, tr, true, tty, umount, uname, uniq, 
+unix2dos, unrpm, update, uptime, usleep, uudecode, uuencode, wc, which, whoami,
+xargs, yes, zcat, [
 
 -------------------------------
 
@@ -421,6 +421,32 @@ Converts a text file from dos format to unix format.
 
 -------------------------------
 
+=item dpkg-deb
+
+Usage: dpkg-deb [-cexX] archive-file [directory]
+
+Debian package archive (.deb) manipulation tool
+
+Options:
+
+        -c      Lists the contents of the filesystem tree archive
+                portion  of  the  package archive.
+
+        -e      Extracts the control information files from a package
+                archive into the specified directory.
+        
+        -x      Silently extracts the filesystem tree from a package
+                archive into the specified directory.
+        
+        -X      Extracts the filesystem tree from a package archive
+                into the specified directory, list files as it goes.
+
+Example:
+
+        dpkg-deb -X ./busybox_0.48-1_i386.deb /tmp
+
+-------------------------------
+
 =item du
 
 Usage: du [OPTION]... [FILE]...
@@ -2294,4 +2320,4 @@ Enrique Zanardi <ezanardi@ull.es>
 
 =cut
 
-# $Id: busybox.pod,v 1.85 2001/01/02 22:54:12 kraai Exp $
+# $Id: busybox.pod,v 1.86 2001/01/03 01:06:30 bug1 Exp $
diff --git a/docs/busybox.sgml b/docs/busybox.sgml
index 62ef4e325..52850b494 100644
--- a/docs/busybox.sgml
+++ b/docs/busybox.sgml
@@ -137,8 +137,8 @@
 
                 <para>
                 ar, basename, cat, chgrp, chmod, chown, chroot, chvt, clear,
-                cp, cut, date, dc, dd, deallocvt, df, dirname, dmesg, du,
-                dumpkmap, dutmp, echo, false, fbset, fdflush, find, free,
+                cp, cut, date, dc, dd, deallocvt, df, dirname, dmesg, dpkg-deb,
+                du, dumpkmap, dutmp, echo, false, fbset, fdflush, find, free,
                 freeramdisk, fsck.minix, grep, gunzip, gzip, halt, head,
                 hostid, hostname, id, init, insmod, kill, killall, length, ln,
                 loadacm, loadfont, loadkmap, logger, logname, ls, lsmod,
@@ -758,6 +758,44 @@
 
         </sect1>
 
+        <sect1 id="dpkg-deb">
+            <title>dpkg-deb</title>
+
+                <para>
+                Usage: dpkg-deb [OPTION] archive [directory] 
+                </para>
+
+                <para>
+                Debian package archive (.deb) manipulation tool 
+                </para>
+
+                <para>
+                Options:
+                </para>
+                
+                <para>
+                <screen>
+                        -c      List the contents of the filesystem tree archive portion of the package 
+                        -e      Extracts the control information files from a package archive into the specified directory.
+                                If  no  directory  is specified then a subdirectory DEBIAN in the current directory is used.
+                        -x      Silently extracts the filesystem tree from a package archive into the specified directory.
+                        -X      Extracts the filesystem tree from a package archive into the specified directory, listing the files as it goes. 
+                        If required the specified directory (but not its parents) will be created.
+                </screen>
+                <para>
+
+                <para>
+                Example:
+                </para>
+
+                <para>
+                <screen>
+                        dpkg-deb -e ./busybox_0.48-1_i386.deb
+                        dpkg-deb -x ./busybox_0.48-1_i386.deb ./unpack_dir
+                </screen>
+                </para>
+        </sect1>
+
         <sect1 id="du">
             <title>du</title>