# Shelved patch: Changes shelved on 2007-08-11 17:30:17
--- man/apport-cli.1	1970-01-01 00:00:00 +0000
+++ man/apport-cli.1	2007-08-01 13:31:07 +0000
@@ -0,0 +1,76 @@
+.TH apport\-cli 1 "August 01, 2007" "Martin Pitt"
+
+.SH NAME
+
+apport\-cli \- Command line client for reporting problems
+
+.SH SYNOPSIS
+
+.B apport\-cli
+
+.B apport\-cli \-c
+.I report
+
+.B apport\-cli \-f \-p
+.I package
+
+.B apport\-cli \-f \-P
+.I pid
+
+.SH DESCRIPTION
+
+.B apport 
+automatically collects data from crashed processes and compiles a problem
+report in 
+.I /var/crash/\fR. This is a command line frontend for reporting
+those crashes to the developers. It can also be used to report bugs
+about packages or running processes.
+
+For desktop systems with a graphical user interface, you should
+consider installing the GTK or Qt user interface (apport-gtk or
+apport-qt).
+.B apport\-cli
+is mainly intended to be used on servers.
+
+When called without any options, it processes the pending crash
+reports and offers to report them one by one. You can also display the
+entire report to see what is sent to the software developers.
+
+.SH OPTIONS
+
+.TP
+.B \-c \fIreport\fR, \fB\-\-crash\-file\fR=\fIreport
+Instead of walking over the new crash reports in
+.I /var/crash/\fR,
+report a particular report in an arbitrary file location.
+This is useful for copying a crash report to a machine with internet
+connection and reporting it from there.
+
+.TP
+.B \-f, \-\-file\-bug
+Report a (non-crash) problem. Requires specifying
+.B \-\-package
+or
+.B \-\-pid\fR.
+This will automatically attach information about your operating sytem
+and the package version etc. to the bug report, so that the developers
+have some important context.
+
+.TP
+.B \-p \fIpackage\fR, \fB\-\-package\fR=\fIpackage
+When being used in
+.B \-\-file\-bug
+mode, specify the package to report the problem against.
+
+.TP
+.B \-P \fIpid\fR, \fB\-\-pid\fR=\fIpid
+When being used in
+.B \-\-file\-bug
+mode, specify the PID (process ID) of a running program to report the
+problem against. This can be determined with e. g.
+.B ps -ux\fR.
+
+.SH AUTHOR
+.B apport
+and the accompanying tools are developed by Martin Pitt
+<martin.pitt@ubuntu.com>.
--- man/dupdb-admin.1	1970-01-01 00:00:00 +0000
+++ man/dupdb-admin.1	2007-08-01 13:44:26 +0000
@@ -0,0 +1,71 @@
+.TH dupdp\-admin 1 "August 01, 2007" "Martin Pitt"
+
+.SH NAME
+
+dupdb\-admin \- Manage the duplicate database for apport\-retrace.
+
+.SH SYNOPSIS
+
+.B dupdb\-admin \-f
+.I dbpath
+.B status
+
+.B dupdb\-admin \-f
+.I dbpath
+.B dump
+
+.B dupdb\-admin \-f
+.I dbpath
+.B changeid
+.I oldid newid
+
+.SH DESCRIPTION
+
+.BR apport\-retrace (1)
+has the capability of checking for duplicate bugs (amonst other
+things). It uses an SQLite database for keeping track of master bugs.
+.B dupdb\-admin
+is a small tool to manage that database.
+
+The central concept in that database is a "crash signature", a string
+that uniquely identifies a particular crash. It is built from the
+executable path name, the signal number or exception name, and the
+topmost functions of the stack trace.
+
+The database maps crash signatures to the 'master' crash id and thus
+can close duplicate crash reports with a reference to that master ID.
+It also tracks the status of crashes (open/fixed in a particular
+version) to be able to identify regressions.
+
+.SH MODES
+
+.TP
+.B status
+Print general status of the duplicate db. For now, it only shows the
+time when the database was "consolidated" last, i. e. when the bug
+states (open/fixed) in the SQLite database where updated to the actual
+states in the bug tracking system.
+
+.TP
+.B dump
+Print a list of all database entries.
+
+.TP
+.B changeid
+Change the associated crash ID for a particular crash.
+
+.SH OPTIONS
+
+.TP
+.B \-f \fIpath\fR, \fB\-\-database-file\fR=\fIpath
+Instead of walking over the new crash reports in
+.I /var/crash\fR,
+process, report a particular report in an arbitrary file location.
+This is useful for copying a crash report to a machine with internet
+connection and reporting it from there. This defaults to
+.I ./apport_duplicates.db\fR.
+
+.SH AUTHOR
+.B apport
+and the accompanying tools are developed by Martin Pitt
+<martin.pitt@ubuntu.com>.
--- debian/apport-retrace.manpages	2007-03-27 09:26:32 +0000
+++ debian/apport-retrace.manpages	2007-08-01 13:54:41 +0000
@@ -1 +1,2 @@
 man/apport-retrace.1
+man/dupdb-admin.1
--- debian/apport.manpages	2007-03-27 09:26:32 +0000
+++ debian/apport.manpages	2007-08-01 13:14:35 +0000
@@ -1,2 +1,3 @@
 man/apport-unpack.1
+man/apport-cli.1
 debian/local/ubuntu-bug.1
--- debian/changelog	2007-08-01 12:41:15 +0000
+++ debian/changelog	2007-08-01 13:44:40 +0000
@@ -2,8 +2,9 @@
 
   * general-hooks/automatix.py: Remove hashbang, it's not an executable
     script.
+  * Create man pages for apport-cli, dupdb-admin.
 
- -- Martin Pitt <martin.pitt@ubuntu.com>  Wed, 01 Aug 2007 14:41:00 +0200
+ -- Martin Pitt <martin.pitt@ubuntu.com>  Wed, 01 Aug 2007 15:44:28 +0200
 
 apport (0.94) gutsy; urgency=low
 
