Focused on newly added manual pages.
---
debian/control | 6 +++---
doc/edit-patch.1 | 20 ++++++++++----------
doc/suspicious-source.1 | 20 ++++++++++----------
doc/what-patch.1 | 18 ++++++++++--------
doc/wrap-and-sort.1 | 32 ++++++++++++++++----------------
5 files changed, 49 insertions(+), 47 deletions(-)
diff --git a/debian/control b/debian/control
index ea047b5..57ab76f 100644
--- a/debian/control
+++ b/debian/control
@@ -176,8 +176,8 @@ Description: scripts to make the life of a Debian Package
maintainer easier
- rc-alert: list installed packages which have release-critical bugs [wget]
- rmadison: remotely query the Debian archive database about packages
[wget | curl, liburi-perl]
- - suspicious-source: outputs a list of files which are not common source
- files [python-magic].
+ - suspicious-source: output a list of files which are not common source
+ files [python-magic]
- svnpath: print svn repository paths [subversion]
- tagpending: runs from a Debian source tree and tags bugs that are to
be closed in the latest changelog as pending. [libsoap-lite-perl]
@@ -187,7 +187,7 @@ Description: scripts to make the life of a Debian Package
maintainer easier
- uscan: scan upstream sites for new releases of packages
[libcrypt-ssleay-perl, libwww-perl, unzip, xz-utils]
- uupdate: integrate upstream changes into a source package [patch]
- - what-patch: determines what patch system, if any, a source package is using
+ - what-patch: determine what patch system, if any, a source package is using
[patchutils]
- whodepends: check which maintainers' packages depend on a package
- who-uploads: determine the most recent uploaders of a package to the Debian
diff --git a/doc/edit-patch.1 b/doc/edit-patch.1
index 736c4f5..70b0ac9 100644
--- a/doc/edit-patch.1
+++ b/doc/edit-patch.1
@@ -4,31 +4,31 @@
source packages
.SH SYNOPSIS
-\fBedit-patch\fR <path to patch>
+\fBedit-patch\fR \fIpath/to/patch\fR
-\fBadd-patch\fR <path to patch>
+\fBadd-patch\fR \fIpath/to/patch\fR
.SH DESCRIPTION
-\fBedit-patch\fR is a wrapper script around the quilt, cdbs, and dpatch patch
+\fBedit-patch\fR is a wrapper script around the Quilt, CDBS, and dpatch patch
systems. It simplifies the process of preparing and editing patches to Debian
source packages and allows the user to not have to be concerned with which
patch
system is in use.
Run from inside the root directory of the source package, \fBedit-patch\fR can
-be used to edit existing patches located in /debian/patches.
+be used to edit existing patches located in \fIdebian/patches\fR.
It can also be used to incorporate new patches.
If pointed at a patch not already present, it will copy the patch to
-/debian/patches in the correct format for the patch system in use.
+\fIdebian/patches\fR in the correct format for the patch system in use.
Next, the patch is applied and a subshell is opened in order to edit the patch.
-Typing "exit" or pressing Ctrl-d will close the subshell and launch an editor
-to record the debian/changelog entry.
+Typing \fBexit\fR or pressing Ctrl-d will close the subshell and launch an
editor
+to record the \fIdebian/changelog\fR entry.
-\fBedit-patch\fR is integrated with the bzr and git version control systems.
-The patch will be automatically added to the tree, and the debian/changelog
+\fBedit-patch\fR is integrated with the Bazaar and Git version control systems.
+The patch will be automatically added to the tree, and the
\fIdebian/changelog\fR
entry will be used as the commit message.
If no patch system is present, the patch is applied inline,
-and a copy is stored in debian/patches-applied.
+and a copy is stored in \fIdebian/patches-applied\fR.
\fBadd-patch\fR is the non-interactive version of \fBedit-patch\fR.
The patch will be incorporated but no editor or subshell will be
diff --git a/doc/suspicious-source.1 b/doc/suspicious-source.1
index fbc2bb7..0cd5b18 100644
--- a/doc/suspicious-source.1
+++ b/doc/suspicious-source.1
@@ -29,27 +29,27 @@ not be the "preferred form of modification" that the GPL
and other licenses
require.
.PP
The files inside version control system directories (like
-".bzr/" or "CVS/") are not considered.
+\fI.bzr/\fR or \fICVS/\fR) are not considered.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
-show this help message and exit
+Show this help message and exit.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
-print more information
+Print more information.
.TP
-\fB\-d\fR DIRECTORY, \fB\-\-directory\fR=\fIDIRECTORY\fR
-check the files in the specified directory instead of the current directory
+\fB\-d \fIdirectory\fR, \fB\-\-directory=\fIdirectory\fR
+Check the files in the specified \fIdirectory\fR instead of the current
directory.
.TP
-\fB\-m\fR MIMETYPE, \fB\-\-mimetype\fR=\fIMIMETYPE\fR
-Add MIMETYPE to list of white-listed mime-types.
+\fB\-m \fImimetype\fR, \fB\-\-mimetype=\fImimetype\fR
+Add \fImimetype\fR to list of white-listed MIME types.
.TP
-\fB\-e\fR EXTENSION, \fB\-\-extension\fR=\fIEXTENSION\fR
-Add EXTENSION to list of white-listed extensions.
+\fB\-e \fIextension\fR, \fB\-\-extension=\fIextension\fR
+Add \fIextension\fR to list of white-listed extensions.
.SH AUTHORS
-\fBsuspicious\-source\fP and this manpage has been written by
+\fBsuspicious\-source\fP and this manpage have been written by
Benjamin Drung <[email protected]>.
.PP
Both are released under the ISC license.
diff --git a/doc/what-patch.1 b/doc/what-patch.1
index ce5ae6f..4e127d0 100644
--- a/doc/what-patch.1
+++ b/doc/what-patch.1
@@ -1,26 +1,26 @@
.TH WHAT\-PATCH "1" "Debian Utilities" "DEBIAN"
.SH NAME
-what\-patch \- detects which patch system a Debian package uses
+what\-patch \- detect which patch system a Debian package uses
.SH SYNOPSIS
-.B what\-patch [options]
+.B what\-patch\fR [\fIoptions\fR]
.SH DESCRIPTION
-\fBwhat\-patch\fR examines the debian/rules file to determine which patch
+\fBwhat\-patch\fR examines the \fIdebian/rules\fR file to determine which patch
system the Debian package is using.
.PP
\fBwhat\-patch\fR should be run from the root directory of the Debian source
package.
.SH OPTIONS
-Listed below are the command line options for what\-patch:
+Listed below are the command line options for \fBwhat\-patch\fR:
.TP
-.B \-h or \-\-help
+.BR \-h ", " \-\-help
Display a help message and exit.
.TP
.B \-v
Enable verbose mode.
-This will include the listing of any files modified outside or the debian/
+This will include the listing of any files modified outside or the
\fIdebian/\fR
directory and report any additional details about the patch system if
available.
@@ -34,7 +34,9 @@ Both are released under the GNU General Public License,
version 3 or later.
.SH SEE ALSO
The Ubuntu MOTU team has some documentation about patch systems at the Ubuntu
-wiki: \fBhttps://wiki.ubuntu.com/PackagingGuide/PatchSystems\fR
+wiki: \fIhttps://wiki.ubuntu.com/PackagingGuide/PatchSystems\fR
.PP
-.B cdbs\-edit\-patch(1), dbs\-edit\-patch(1), dpatch\-edit\-patch(1)
+.BR cdbs\-edit\-patch (1),
+.BR dbs\-edit\-patch (1),
+.BR dpatch\-edit\-patch (1)
diff --git a/doc/wrap-and-sort.1 b/doc/wrap-and-sort.1
index 3894a63..f7e6252 100644
--- a/doc/wrap-and-sort.1
+++ b/doc/wrap-and-sort.1
@@ -23,29 +23,29 @@ wrap-and-sort \- wrap long lines and sort items in Debian
packaging files
\fBwrap\-and\-sort\fP wraps the package lists in Debian control files. By
default the lists will only split into multiple lines if the entries are longer
than 80 characters. \fBwrap\-and\-sort\fP sorts the package lists in Debian
-control files and all .install files. Beside that \fBwrap\-and\-sort\fP removes
+control files and all \fI.install\fR files. Beside that \fBwrap\-and\-sort\fP
removes
trailing spaces in these files.
.PP
This script should be run in the root of a Debian package tree. It searches for
-control, control.in, copyright, copyright.in, install, and *.install in the
-debian directory.
+\fIcontrol\fR, \fIcontrol.in\fR, \fIcopyright\fR, \fIcopyright.in\fR,
\fIinstall\fR, and \fI*.install\fR in the
+\fIdebian\fR directory.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
-show this help message and exit
+Show this help message and exit.
.TP
\fB\-a\fR, \fB\-\-wrap\-always\fR
-wrap all package lists in the Debian control file
+Wrap all package lists in the Debian \fIcontrol\fR file
even if the entries are shorter than 80 characters and could fit in one line
-line
+line.
.TP
\fB\-s\fR, \fB\-\-short\-indent\fR
-only indent wrapped lines by one space (default is in\-line with the
-field name)
+Only indent wrapped lines by one space (default is in\-line with the
+field name).
.TP
\fB\-b\fR, \fB\-\-sort\-binary\-packages\fR
-sort binary package paragraphs by name
+Sort binary package paragraphs by name.
.TP
\fB\-k\fR, \fB\-\-keep\-first\fR
When sorting binary package paragraphs, leave the first one at the top.
@@ -54,21 +54,21 @@ Unqualified
configuration files are applied to the first package.
.TP
\fB\-n\fR, \fB\-\-no\-cleanup\fR
-do not remove trailing whitespaces
+Do not remove trailing whitespaces.
.TP
-\fB\-d \fIPATH\fR, \fB\-\-debian\-directory\fR=\fIPATH\fR
-location of the \fIdebian\fR directory (default: \fB./debian\fR)
+\fB\-d \fIpath\fR, \fB\-\-debian\-directory=\fIpath\fR
+Location of the \fIdebian\fR directory (default: \fI./debian\fR).
.TP
-\fB\-f\fI FILE\fR, \fB\-\-file\fR=\fIFILE\fR
-Wrap and sort only the specified file.
+\fB\-f \fIfile\fR, \fB\-\-file=\fIfile\fR
+Wrap and sort only the specified \fIfile\fR.
You can specify this parameter multiple times.
All supported files will be processed if no files are specified.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
-print all files that are touched
+Print all files that are touched.
.SH AUTHORS
-\fBwrap\-and\-sort\fP and this manpage has been written by
+\fBwrap\-and\-sort\fP and this manpage have been written by
Benjamin Drung <[email protected]>.
.PP
Both are released under the ISC license.
--
1.7.5.3
--
To unsubscribe, send mail to [email protected].
