Documentation: sync git.txt command list and manual page title

Also reorders a handful entries to make each list sorted
alphabetically.

Signed-off-by: Junio C Hamano <junkio@cox.net>

Documentation/cmds-ancillaryinterrogators.txt

@@ -2,7 +2,7 @@ gitlink:git-annotate[1]::
 	Annotate file lines with commit info.
 
 gitlink:git-blame[1]::
-	Find out where each line in a file came from.
+	Show what revision and author last modified each line of a file.
 
 gitlink:git-check-ref-format[1]::
 	Make sure ref name is well formed.
@@ -29,25 +29,22 @@ gitlink:git-instaweb[1]::
 	Instantly browse your working repository in gitweb.
 
 gitlink:git-mailinfo[1]::
-	Extracts patch and authorship information from a single
-	e-mail message, optionally transliterating the commit
-	message into utf-8.
+	Extracts patch and authorship from a single e-mail message.
 
 gitlink:git-mailsplit[1]::
-	A stupid program to split UNIX mbox format mailbox into
-	individual pieces of e-mail.
+	Simple UNIX mbox splitter program.
 
 gitlink:git-merge-tree[1]::
 	Show three-way merge without touching index.
 
+gitlink:git-parse-remote[1]::
+	Routines to help parsing remote repository access parameters.
+
 gitlink:git-patch-id[1]::
 	Compute unique ID for a patch.
 
-gitlink:git-parse-remote[1]::
-	Routines to help parsing `$GIT_DIR/remotes/` files.
-
 gitlink:git-request-pull[1]::
-	git-request-pull.
+	Generates a summary of pending changes.
 
 gitlink:git-rev-parse[1]::
 	Pick out and massage parameters.
@@ -56,10 +53,11 @@ gitlink:git-runstatus[1]::
 	A helper for git-status and git-commit.
 
 gitlink:git-send-email[1]::
-	Send patch e-mails out of "format-patch --mbox" output.
+	Send a collection of patches as emails.
+
+gitlink:git-stripspace[1]::
+	Filter out empty lines.
 
 gitlink:git-symbolic-ref[1]::
 	Read and modify symbolic refs.
 
-gitlink:git-stripspace[1]::
-	Filter out empty lines.

Documentation/cmds-ancillarymanipulators.txt

@@ -2,17 +2,17 @@ gitlink:git-applypatch[1]::
 	Apply one patch extracted from an e-mail.
 
 gitlink:git-archimport[1]::
-	Import an arch repository into git.
+	Import an Arch repository into git.
 
 gitlink:git-convert-objects[1]::
 	Converts old-style git repository.
 
-gitlink:git-cvsimport[1]::
-	Salvage your data out of another SCM people love to hate.
-
 gitlink:git-cvsexportcommit[1]::
 	Export a single commit to a CVS checkout.
 
+gitlink:git-cvsimport[1]::
+	Salvage your data out of another SCM people love to hate.
+
 gitlink:git-cvsserver[1]::
 	A CVS server emulator for git.
 
@@ -23,7 +23,7 @@ gitlink:git-lost-found[1]::
 	Recover lost refs that luckily have not yet been pruned.
 
 gitlink:git-merge-one-file[1]::
-	The standard helper program to use with `git-merge-index`.
+	The standard helper program to use with git-merge-index.
 
 gitlink:git-prune[1]::
 	Prunes all unreachable objects from the object database.
@@ -37,15 +37,15 @@ gitlink:git-reflog[1]::
 gitlink:git-relink[1]::
 	Hardlink common objects in local repositories.
 
+gitlink:git-sh-setup[1]::
+	Common git shell script setup code.
+
 gitlink:git-svn[1]::
 	Bidirectional operation between a single Subversion branch and git.
 
 gitlink:git-svnimport[1]::
 	Import a SVN repository into git.
 
-gitlink:git-sh-setup[1]::
-	Common git shell script setup code.
-
 gitlink:git-symbolic-ref[1]::
 	Read and modify symbolic refs.
 

Documentation/cmds-mainporcelain.txt

@@ -1,11 +1,11 @@
 gitlink:git-add[1]::
-	Add paths to the index.
+	Add file contents to the changeset to be committed next.
 
 gitlink:git-am[1]::
-	Apply patches from a mailbox, but cooler.
+	Apply a series of patches from a mailbox.
 
 gitlink:git-applymbox[1]::
-	Apply patches from a mailbox, original version by Linus.
+	Apply a series of patches in a mailbox.
 
 gitlink:git-archive[1]::
 	Creates an archive of files from a named tree.
@@ -14,13 +14,13 @@ gitlink:git-bisect[1]::
 	Find the change that introduced a bug by binary search.
 
 gitlink:git-branch[1]::
-	Create and Show branches.
+	List, create, or delete branches.
 
 gitlink:git-checkout[1]::
 	Checkout and switch to a branch.
 
 gitlink:git-cherry-pick[1]::
-	Cherry-pick the effect of an existing commit.
+	Apply the change introduced by an existing commit.
 
 gitlink:git-clean[1]::
 	Remove untracked files from the working tree.
@@ -35,7 +35,7 @@ gitlink:git-diff[1]::
 	Show changes between commits, commit and working tree, etc.
 
 gitlink:git-fetch[1]::
-	Download from a remote repository via various protocols.
+	Download objects and refs from another repository.
 
 gitlink:git-format-patch[1]::
 	Prepare patches for e-mail submission.
@@ -47,13 +47,13 @@ gitlink:gitk[1]::
 	The git repository browser.
 
 gitlink:git-log[1]::
-	Shows commit logs.
+	Show commit logs.
 
 gitlink:git-ls-remote[1]::
-	Shows references in a remote or local repository.
+	List references in a remote repository.
 
 gitlink:git-merge[1]::
-	Grand unified merge driver.
+	Join two or more development histories together.
 
 gitlink:git-mv[1]::
 	Move or rename a file, a directory, or a symlink.
@@ -62,13 +62,13 @@ gitlink:git-pack-refs[1]::
 	Pack heads and tags for efficient repository access.
 
 gitlink:git-pull[1]::
-	Fetch from and merge with a remote repository or a local branch.
+	Fetch from and merge with another repository or a local branch.
 
 gitlink:git-push[1]::
 	Update remote refs along with associated objects.
 
 gitlink:git-rebase[1]::
-	Rebase local commits to the updated upstream head.
+	Forward-port local commits to the updated upstream head.
 
 gitlink:git-repack[1]::
 	Pack unpacked objects in a repository.
@@ -89,19 +89,20 @@ gitlink:git-rm[1]::
 	Remove files from the working tree and from the index.
 
 gitlink:git-shortlog[1]::
-	Summarizes 'git log' output.
+	Summarize 'git log' output.
 
 gitlink:git-show[1]::
-	Show one commit log and its diff.
+	Show various types of objects.
 
 gitlink:git-show-branch[1]::
 	Show branches and their commits.
 
 gitlink:git-status[1]::
-	Shows the working tree status.
+	Show the working tree status.
 
 gitlink:git-verify-tag[1]::
 	Check the GPG signature of tag.
 
 gitlink:git-whatchanged[1]::
-	Shows commit logs and differences they introduce.
+	Show logs with difference each commit introduces.
+

Documentation/cmds-plumbinginterrogators.txt

@@ -4,14 +4,14 @@ gitlink:git-cat-file[1]::
 gitlink:git-describe[1]::
 	Show the most recent tag that is reachable from a commit.
 
-gitlink:git-diff-index[1]::
-	Compares content and mode of blobs between the index and repository.
-
 gitlink:git-diff-files[1]::
 	Compares files in the working tree and the index.
 
+gitlink:git-diff-index[1]::
+	Compares content and mode of blobs between the index and repository.
+
 gitlink:git-diff-stages[1]::
-	Compares two "merge stages" in the index.
+	Compares two merge stages in the index.
 
 gitlink:git-diff-tree[1]::
 	Compares the content and mode of blobs found via two tree objects.
@@ -23,13 +23,13 @@ gitlink:git-fsck-objects[1]::
 	Verifies the connectivity and validity of the objects in the database.
 
 gitlink:git-ls-files[1]::
-	Information about files in the index and the working tree.
+	Show information about files in the index and the working tree.
 
 gitlink:git-ls-tree[1]::
-	Displays a tree object in human readable form.
+	List the contents of a tree object.
 
 gitlink:git-merge-base[1]::
-	Finds as good common ancestors as possible for a merge.
+	Find as good common ancestors as possible for a merge.
 
 gitlink:git-name-rev[1]::
 	Find symbolic names for given revs.
@@ -41,20 +41,20 @@ gitlink:git-rev-list[1]::
 	Lists commit objects in reverse chronological order.
 
 gitlink:git-show-index[1]::
-	Displays contents of a pack idx file.
+	Show packed archive index.
 
 gitlink:git-show-ref[1]::
 	List references in a local repository.
 
 gitlink:git-tar-tree[1]::
-	Creates a tar archive of the files in the named tree object.
+	Create a tar archive of the files in the named tree object.
 
 gitlink:git-unpack-file[1]::
 	Creates a temporary file with a blob's contents.
 
 gitlink:git-var[1]::
-	Displays a git logical variable.
+	Show a git logical variable.
 
 gitlink:git-verify-pack[1]::
-	Validates packed git archive files.
+	Validate packed git archive files.
 

Documentation/cmds-plumbingmanipulators.txt

@@ -1,28 +1,26 @@
 gitlink:git-apply[1]::
-	Reads a "diff -up1" or git generated patch file and
-	applies it to the working tree.
+	Apply a patch on a git index file and a working tree.
 
 gitlink:git-checkout-index[1]::
 	Copy files from the index to the working tree.
 
 gitlink:git-commit-tree[1]::
-	Creates a new commit object.
+	Create a new commit object.
 
 gitlink:git-hash-object[1]::
-	Computes the object ID from a file.
+	Compute object ID and optionally creates a blob from a file.
 
 gitlink:git-index-pack[1]::
-	Build pack idx file for an existing packed archive.
+	Build pack index file for an existing packed archive.
 
 gitlink:git-init[1]::
-	Creates an empty git repository, or reinitialize an
-	existing one.
+	Create an empty git repository or reinitialize an existing one.
 
 gitlink:git-merge-file[1]::
-	Runs a threeway merge.
+	Run a three-way file merge.
 
 gitlink:git-merge-index[1]::
-	Runs a merge for files needing merging.
+	Run a merge for files needing merging.
 
 gitlink:git-mktag[1]::
 	Creates a tag object.
@@ -31,7 +29,7 @@ gitlink:git-mktree[1]::
 	Build a tree-object from ls-tree formatted text.
 
 gitlink:git-pack-objects[1]::
-	Creates a packed archive of objects.
+	Create a packed archive of objects.
 
 gitlink:git-prune-packed[1]::
 	Remove extra objects that are already in pack files.
@@ -40,13 +38,14 @@ gitlink:git-read-tree[1]::
 	Reads tree information into the index.
 
 gitlink:git-repo-config[1]::
-	Get and set options in .git/config.
+	Get and set repository or global options.
 
 gitlink:git-unpack-objects[1]::
-	Unpacks objects out of a packed archive.
+	Unpack objects from a packed archive.
 
 gitlink:git-update-index[1]::
-	Registers files in the working tree to the index.
+	Register file contents in the working tree to the index.
 
 gitlink:git-write-tree[1]::
-	Creates a tree from the index.
+	Create a tree object from the current index.
+

Documentation/cmds-synchingrepositories.txt

@@ -1,46 +1,39 @@
 gitlink:git-fetch-pack[1]::
-	Updates from a remote repository (engine for ssh and
-	local transport).
+	Receive missing objects from another repository.
 
 gitlink:git-http-fetch[1]::
-	Downloads a remote git repository via HTTP by walking
-	commit chain.
+	Download from a remote git repository via HTTP.
+
+gitlink:git-http-push[1]::
+	Push objects over HTTP/DAV to another repository.
 
 gitlink:git-local-fetch[1]::
-	Duplicates another git repository on a local system by
-	walking commit chain.
+	Duplicate another git repository on a local system.
 
 gitlink:git-peek-remote[1]::
-	Lists references on a remote repository using
-	upload-pack protocol (engine for ssh and local
-	transport).
+	List the references in a remote repository.
 
 gitlink:git-receive-pack[1]::
-	Invoked by 'git-send-pack' to receive what is pushed to it.
+	Receive what is pushed into the repository.
 
 gitlink:git-send-pack[1]::
-	Pushes to a remote repository, intelligently.
-
-gitlink:git-http-push[1]::
-	Push missing objects using HTTP/DAV.
+	Push objects over git protocol to another reposiotory.
 
 gitlink:git-shell[1]::
-	Restricted shell for GIT-only SSH access.
+	Restricted login shell for GIT-only SSH access.
 
 gitlink:git-ssh-fetch[1]::
-	Pulls from a remote repository over ssh connection by
-	walking commit chain.
+	Fetch from a remote repository over ssh connection.
 
 gitlink:git-ssh-upload[1]::
-	Helper "server-side" program used by git-ssh-fetch.
+	Push to a remote repository over ssh connection.
 
 gitlink:git-update-server-info[1]::
-	Updates auxiliary information on a dumb server to help
-	clients discover references and packs on it.
+	Update auxiliary info file to help dumb servers.
 
 gitlink:git-upload-archive[1]::
-	Invoked by 'git-archive' to send a generated archive.
+	Send archive back to git-archive.
 
 gitlink:git-upload-pack[1]::
-	Invoked by 'git-fetch-pack' to push
-	what are asked for.
+	Send objects packed back to git-fetch-pack.
+