dgit(1), dgit-maint-merge(7): Copy-edit changes since dgit 9.16

Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>

1 files changed, 9 insertions, 7 deletions

diff --git a/dgit.1 b/dgit.1
index 4bad5aa..b9d8286 100644
--- a/dgit.1
+++ b/dgit.1
@@ -237,9 +237,11 @@ Tagging, signing and actually uploading should be left to dgit push.
 \fBdgit push-source\fR [\fIsuite\fP]
 Does an `upload': sends the current HEAD
 to dgit-repos (as git commits),
-and to the archive (as a source package, built by dgit push-source).
+and to the archive (as a source package, built by this command).
 
-This is the usual way to upload to Debian.
+This is the usual way to upload to Debian.  It is like saying "update the
+source code in the archive to match my git HEAD, and let the autobuilders do
+the rest."
 
 In more detail: dgit push-source
 builds a source package from HEAD.
@@ -275,12 +277,12 @@ to the archive.
 The package must already
 have been built ready for upload, with the .dsc and .changes
 left in the parent directory.  It is normally best to do the build
-with dgit too (eg with dgit sbuild): some existing build tools pass
+with dgit too (e.g. with dgit sbuild): some existing build tools pass
 unhelpful options to dpkg-source et al by default, which can result in
 the built source package not being identical to the git tree.
 
 dgit will check that the .dsc corresponds exactly to the current HEAD,
-ensuring that all users whether of the dgit git view,
+ensuring that all users, whether of the dgit git view,
 or of the traditional archive,
 see the same source package.
 .TP
@@ -321,12 +323,12 @@ public key in its keyring (but not your private key, obviously).
 Configurable aliases for
 .BR "dgit push-built"
 and
-.BR "dgit rpush-built" ,
-which will in the future change to mean
+.BR "dgit rpush-built".
+These aliases will in the future change to mean
 .BR "dgit push-source"
 and
 .BR "dgit rpush-source" ,
-and therefore currently generate a warning.
+and therefore they currently generate a warning.
 
 The behaviour of dgit push is controlled by the
 .B dgit.default.push-subcmd