Add dpkg-deb documentation

diff --git a/docs/busybox.pod b/docs/busybox.pod
index ccd8734..30f71e4 100644 (file)
--- 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 62ef4e3..52850b4 100644 (file)
--- 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>