From a4b62f0df511939a5f9d7d19c12b98a71982516e Mon Sep 17 00:00:00 2001
From: Ben Pfaff <blp@cs.stanford.edu>
Date: Tue, 24 Jan 2012 22:09:18 -0800
Subject: [PATCH] pspp-dump-sav: Add manpage.

---
 Makefile.am               |  1 +
 utilities/automake.mk     |  2 +-
 utilities/pspp-dump-sav.1 | 55 +++++++++++++++++++++++++++++++++++++++
 3 files changed, 57 insertions(+), 1 deletion(-)
 create mode 100644 utilities/pspp-dump-sav.1

diff --git a/Makefile.am b/Makefile.am
index 28e9ffc6..3d2e6916 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -40,6 +40,7 @@ noinst_LTLIBRARIES=
 noinst_PROGRAMS=
 check_PROGRAMS=
 bin_PROGRAMS=
+man_MANS =
 DIST_HOOKS =
 INSTALL_DATA_HOOKS = 
 UNINSTALL_DATA_HOOKS =
diff --git a/utilities/automake.mk b/utilities/automake.mk
index ec4ccf20..0a30558a 100644
--- a/utilities/automake.mk
+++ b/utilities/automake.mk
@@ -1,7 +1,7 @@
 bin_PROGRAMS += utilities/pspp-dump-sav
+man_MANS += utilities/pspp-dump-sav.1
 utilities_pspp_dump_sav_SOURCES = \
 	src/libpspp/integer-format.c \
 	src/libpspp/float-format.c \
 	utilities/pspp-dump-sav.c
 utilities_pspp_dump_sav_CPPFLAGS = $(AM_CPPFLAGS) -DINSTALLDIR=\"$(bindir)\"
-
diff --git a/utilities/pspp-dump-sav.1 b/utilities/pspp-dump-sav.1
new file mode 100644
index 00000000..e5ebabc3
--- /dev/null
+++ b/utilities/pspp-dump-sav.1
@@ -0,0 +1,55 @@
+.\" -*- nroff -*-
+.de IQ
+.  br
+.  ns
+.  IP "\\$1"
+..
+.TH pspp\-dump\-sav 1 "January 2012" "PSPP" "PSPP Manual"
+.
+.SH NAME
+pspp\-dump\-sav \- dissect SPSS system file
+.
+.SH SYNOPSIS
+\fBpspp\-dump\-sav\fR [\fB\-d \fR| \fB\-\-data\fR[\fB=\fImaxcases\fR]] \fIfile\fR...
+.br
+\fBpspp\-dump\-sav \-\-help\fR | \fB\-h\fR
+.br
+\fBpspp\-dump\-sav \-\-version\fR | \fB\-v\fR
+.
+.SH DESCRIPTION
+The \fBpspp\-dump\-sav\fR program reads each SPSS system file
+\fIfile\fR and prints its contents.  The output format is useful for
+debugging system file readers and writers and for discovering how to
+interpret unknown or poorly understood records.  End users may find
+the output useful for providing the PSPP developers information about
+system files that PSPP does not accurately read.
+.
+.SH "OPTIONS"
+.
+.IP "\fB\-d\fR[\fImaxcases\fR]"
+.IQ "\fB\-\-data\fR[\fB=\fImaxcases\fR]"
+By default, \fBpspp\-dump\-sav\fR does not print any of the data in a
+system file, only the file headers.  Specify this option to print the
+data as well.  If \fImaxcases\fR is specified, then it limits the
+number of cases printed.
+.
+.IP "\fB\-h\fR"
+.IQ "\fB\-\-help\fR"
+Prints a usage message on stdout and exits.
+.
+.IP "\fB\-v\fR"
+.IQ "\fB\-\-version\fR"
+Prints version information on stdout and exits.
+.
+.SH "BUGS"
+Some errors that prevent files from being interpreted successfully
+cause \fBpspp\-dump\-sav\fR to exit without reading any additional
+files given on the command line.
+.
+.SH "AUTHORS"
+Ben Pfaff and John Darrington.
+.
+.SH "SEE ALSO"
+.
+.BR pspp (1),
+.BR psppire (1).
-- 
2.30.2