From 6a659921725267076f8ebc316f914f0607b60dbd Mon Sep 17 00:00:00 2001
From: Al Stone <ahs3@ahs3.net>
Date: Aug 27 2013 17:05:59 +0000
Subject: Add in basic man page for acpidump


---

diff --git a/debian/acpidump.1 b/debian/acpidump.1
index 3ce88b8..a3ab061 100644
--- a/debian/acpidump.1
+++ b/debian/acpidump.1
@@ -1,7 +1,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH ACPIDUMP 1 "June 2, 2013"
+.TH ACPIDUMP 1 "July 24, 2013"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -21,13 +21,82 @@ acpidump \- ACPI table dump utility
 .RI [ <option> ... ]
 
 .SH DESCRIPTION
-This manual page is currently a placeholder for the ACPICA version
-of the
-.B acpidump.
-command.  At present, the command is not implemented and a stub
-command has been include in the upstream source.  When a full
-implementation is available, this man page will be updated with
-the proper information.
+This manual page briefly documents the
+.B acpidump
+command.  The option list is taken from the interactive help.
+.PP
+The
+.B acpidump
+command extracts the ACPI tables currently in use from the running
+kernel in a form usable for later processing by the
+.B acpixtract
+command.
+.PP
+Invocation of
+.B acpidump
+without parameters will dump all available ACPI tables.  Multiple mixed
+instances of the
+.B \-a
+,
+.B \-f
+, and
+.B \-n
+parameters can be used.
+
+.SH OPTIONS
+.PP
+.TP
+.B \-b
+Dump tables in binary format (versus the default human-readable form)
+
+.PP
+.TP
+.B \-h | \-?
+Display this help message
+
+.PP
+.TP
+.B \-o <file>
+Redirect output to a file.  This file can be used later by
+.B acpixtract
+to examine the contents of the ACPI tables.
+
+.PP
+.TP
+.B \-s
+Print table summaries only.
+
+.PP
+.TP
+.B \-v
+Print the version of this utility.
+
+.PP
+.TP
+.B \-z
+Verbose mode.
+
+.PP
+.TP
+.B \-a <address>
+Get a table from a physical address (must be superuser and you must be
+careful which address you use -- dmesg will typically report the addresses
+for the various tables).
+
+.PP
+.TP
+.B \-f <binary-file>
+Get a table from a binary file (see the
+.B \-b
+option).
+
+.PP
+.TP
+.B \-n <signature>
+Get a table via it's name or signature (e.g., MADT or SSDT).
+
+.SH SEE ALSO
+.B acpixtract(1)
 
 .SH AUTHOR
 acpidump was written by Robert Moore <robert.moore@intel.com> and
diff --git a/debian/changelog b/debian/changelog
index a0c75cf..9e0a74b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,7 @@ acpica-unix (20130626-1) unstable; urgency=low
   * Update to latest upstream. 
   * Closes: bug#704822 -- properly clean up alternatives after purge;
     all the suggestions made in the bug have been applied
+  * Add in basic man page for acpidump
 
  -- Al Stone <ahs3@debian.org>  Wed, 24 Jul 2013 16:25:46 -0600