1 files changed, 65 insertions, 0 deletions
diff --git a/scripts/grep-excuses.1 b/scripts/grep-excuses.1
new file mode 100644
index 0000000..111e33d
--- /dev/null
+++ b/scripts/grep-excuses.1
@@ -0,0 +1,65 @@
+.TH GREP-EXCUSES 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*-
+.SH NAME
+grep-excuses \- search the testing excuses files for a specific maintainer
+.SH SYNOPSIS
+\fBgrep-excuses\fR [\fIoptions\fR] [\fImaintainer\fR|\fIpackage\fR]
+.SH DESCRIPTION
+\fBgrep-excuses\fR downloads the autoremovals and update_excuses.html files
+and greps them
+for the specified maintainer or package name.  The \fBwget\fR package is
+required for this script.  If no name is given on the command line,
+first the environment variable \fBDEBFULLNAME\fR is used if it is
+defined, and failing that, the configuration variable described below
+is used.
+.SH OPTIONS
+.TP
+\fB\-\-no-conf\fR, \fB\-\-noconf\fR
+Do not read any configuration files.  This can only be used as the
+first option given on the command-line.
+.TP
+\fB\-\-wipnity\fR, \fB\-w\fR
+Get information from <https://qa.debian.org/excuses.php>.
+One or more package names must be given when using this option.
+.TP
+.B \-\-help
+Show a brief usage message.
+.TP
+.B \-\-version
+Show version and copyright information.
+.TP
+.B \-\-autopkgtests
+Investigate and show autopkgtest (ci.debian.net) failures
+in your packages
+but apparently caused by new versions of other packages
+trying to migrate.
+.RB ( \-\-no-autopkgtests
+can be used to override GREP_EXCUSES_AUTOPKGTESTS.)
+.TP
+.B \-\-no\-autoremovals
+Investigate and show only testing propagation excuses, not autoremovals.
+.TP
+\fB\-\-experimental\fR, \fB\-e\fR
+Print pseudo-excuses for manual migration from experimental to unstable.
+.TP
+.B \-\-debug
+Print debugging output to stderr (including url(s) fetched).
+.SH "CONFIGURATION VARIABLES"
+The two configuration files \fI/etc/devscripts.conf\fR and
+\fI~/.devscripts\fR are sourced in that order to set configuration
+variables.  Command line options can be used to override configuration
+file settings.  Environment variable settings are ignored for this
+purpose.  The currently recognised variable is:
+.TP
+.B GREP_EXCUSES_MAINTAINER
+The default maintainer, email or package to grep for if none is
+specified on the command line.
+.TP
+.B GREP_EXCUSES_AUTOPKGTESTS
+Boolean: whether to show autopkgtest failures in other packages.
+See
+.BR \-\-autopkgtests .
+.SH "SEE ALSO"
+.BR devscripts.conf (5)
+.SH AUTHOR
+Joey Hess <joeyh@debian.org>;
+modifications by Julian Gilbey <jdg@debian.org>.