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>