From: Jonathan Nieder <jrnieder@uchicago.edu>
To: git@vger.kernel.org
Cc: Junio C Hamano <gitster@pobox.com>,
Christian Couder <chriscool@tuxfamily.org>,
Nguyen Thai Ngoc Duy <pclouds@gmail.com>,
Jon Loeliger <jdl@jdl.com>
Subject: [PATCH 0/7] Some superficial documentation changes
Date: Mon, 30 Jun 2008 16:56:56 -0500 (CDT) [thread overview]
Message-ID: <Pine.GSO.4.62.0806301650530.7190@harper.uchicago.edu> (raw)
This patch series is an updated version of a patch I sent this morning.
The purpose of the patches is to make the absence of git- commands not
so jarring while reading the manual. It does this by holding fast to a
distinction between programs (like git-clone) and command lines (like
"git clone <repo>").
Issues:
- It is a huge patch touching most of the manpages, not made by any
automated process
- Sometimes it is not clear whether a mention of git-diff, say, is
referring to the `git-diff` program or the command line `git diff`
(without any options). So we guess.
- Most non-git man pages use 'italics' for the names of programs, but I
stuck to `teletype text` because that is what seems to be most common
in the Git docs. If people want to change this, I can send a separate
patch to that end.
- There are not enough cross-references (the "see also" sections are
too often absent).
But at least I was able to check that patch 6/7 (which redistributes the
dashes in the world) doesn't touch anything but spaces and hyphens.
Hopefully that should make this easier to review.
Enjoy...
Documentation: fix links to tutorials and other new manual pages
whitespace fix in Documentation/git-repack.txt
Documentation: complicate example of "man git-blah"
git-daemon(1): don't assume git-daemon in /usr/bin
Documentation: prepare to be consistent about "git-" versus "git "
Documentation: be consistent about "git-" versus "git "
Documentation formatting and cleanup
Documentation/diff-options.txt | 2 +-
Documentation/git-add.txt | 4 +-
Documentation/git-am.txt | 4 +-
Documentation/git-annotate.txt | 2 +-
Documentation/git-apply.txt | 14 ++--
Documentation/git-archimport.txt | 8 +-
Documentation/git-archive.txt | 8 +-
Documentation/git-bisect.txt | 8 +-
Documentation/git-blame.txt | 6 +-
Documentation/git-branch.txt | 16 ++--
Documentation/git-bundle.txt | 41 ++++----
Documentation/git-cat-file.txt | 4 +-
Documentation/git-check-attr.txt | 2 +-
Documentation/git-check-ref-format.txt | 4 +-
Documentation/git-checkout-index.txt | 22 ++--
Documentation/git-checkout.txt | 12 +-
Documentation/git-cherry-pick.txt | 4 +-
Documentation/git-cherry.txt | 10 +-
Documentation/git-citool.txt | 4 +-
Documentation/git-clean.txt | 6 +-
Documentation/git-clone.txt | 14 ++--
Documentation/git-commit-tree.txt | 4 +-
Documentation/git-commit.txt | 28 +++---
Documentation/git-config.txt | 38 ++++----
Documentation/git-count-objects.txt | 4 +-
Documentation/git-cvsexportcommit.txt | 13 ++-
Documentation/git-cvsimport.txt | 20 ++--
Documentation/git-cvsserver.txt | 45 +++++-----
Documentation/git-daemon.txt | 34 ++++----
Documentation/git-describe.txt | 14 ++--
Documentation/git-diff-files.txt | 4 +-
Documentation/git-diff-index.txt | 34 ++++----
Documentation/git-diff-tree.txt | 18 ++--
Documentation/git-diff.txt | 18 ++--
Documentation/git-fast-export.txt | 10 +-
Documentation/git-fast-import.txt | 24 +++---
Documentation/git-fetch-pack.txt | 18 ++--
Documentation/git-fetch.txt | 4 +-
Documentation/git-filter-branch.txt | 14 ++--
Documentation/git-fmt-merge-msg.txt | 4 +-
Documentation/git-for-each-ref.txt | 8 +-
Documentation/git-format-patch.txt | 6 +-
Documentation/git-fsck-objects.txt | 2 +-
Documentation/git-fsck.txt | 10 +-
Documentation/git-gc.txt | 16 ++--
Documentation/git-get-tar-commit-id.txt | 8 +-
Documentation/git-grep.txt | 4 +-
Documentation/git-gui.txt | 24 +++---
Documentation/git-hash-object.txt | 4 +-
Documentation/git-help.txt | 6 +-
Documentation/git-http-fetch.txt | 4 +-
Documentation/git-http-push.txt | 2 +-
Documentation/git-imap-send.txt | 6 +-
Documentation/git-index-pack.txt | 12 +-
Documentation/git-init-db.txt | 2 +-
Documentation/git-init.txt | 6 +-
Documentation/git-instaweb.txt | 8 +-
Documentation/git-log.txt | 6 +-
Documentation/git-lost-found.txt | 2 +-
Documentation/git-ls-files.txt | 10 +-
Documentation/git-ls-remote.txt | 4 +-
Documentation/git-ls-tree.txt | 2 +-
Documentation/git-mailinfo.txt | 8 +-
Documentation/git-mailsplit.txt | 2 +-
Documentation/git-merge-base.txt | 10 +-
Documentation/git-merge-file.txt | 14 ++--
Documentation/git-merge-index.txt | 20 ++--
Documentation/git-merge-one-file.txt | 4 +-
Documentation/git-merge-tree.txt | 2 +-
Documentation/git-merge.txt | 24 +++--
Documentation/git-mergetool.txt | 18 ++--
Documentation/git-mktag.txt | 2 +-
Documentation/git-mktree.txt | 2 +-
Documentation/git-mv.txt | 6 +-
Documentation/git-name-rev.txt | 8 +-
Documentation/git-pack-objects.txt | 10 +-
Documentation/git-pack-redundant.txt | 10 +-
Documentation/git-pack-refs.txt | 4 +-
Documentation/git-patch-id.txt | 4 +-
Documentation/git-peek-remote.txt | 6 +-
Documentation/git-prune-packed.txt | 2 +-
Documentation/git-prune.txt | 14 ++--
Documentation/git-pull.txt | 5 +-
Documentation/git-push.txt | 4 +-
Documentation/git-quiltimport.txt | 2 +-
Documentation/git-read-tree.txt | 46 +++++-----
Documentation/git-rebase.txt | 38 ++++----
Documentation/git-receive-pack.txt | 24 +++---
Documentation/git-relink.txt | 2 +-
Documentation/git-remote.txt | 12 +-
Documentation/git-repack.txt | 15 ++--
Documentation/git-repo-config.txt | 2 +-
Documentation/git-request-pull.txt | 2 +-
Documentation/git-rerere.txt | 14 ++--
Documentation/git-reset.txt | 2 +-
Documentation/git-rev-list.txt | 16 ++--
Documentation/git-rev-parse.txt | 18 ++--
Documentation/git-revert.txt | 2 +-
Documentation/git-rm.txt | 10 +-
Documentation/git-send-email.txt | 2 +-
Documentation/git-send-pack.txt | 16 ++--
Documentation/git-shell.txt | 2 +-
Documentation/git-shortlog.txt | 6 +-
Documentation/git-show-branch.txt | 8 +-
Documentation/git-show-index.txt | 6 +-
Documentation/git-show-ref.txt | 10 +-
Documentation/git-show.txt | 8 +-
Documentation/git-stash.txt | 22 ++--
Documentation/git-status.txt | 6 +-
Documentation/git-stripspace.txt | 2 +-
Documentation/git-submodule.txt | 14 ++--
Documentation/git-svn.txt | 153 +++++++++++++++---------------
Documentation/git-symbolic-ref.txt | 4 +-
Documentation/git-tag.txt | 18 ++--
Documentation/git-tar-tree.txt | 6 +-
Documentation/git-unpack-file.txt | 2 +-
Documentation/git-unpack-objects.txt | 4 +-
Documentation/git-update-index.txt | 26 +++---
Documentation/git-update-ref.txt | 10 +-
Documentation/git-update-server-info.txt | 4 +-
Documentation/git-upload-archive.txt | 4 +-
Documentation/git-upload-pack.txt | 8 +-
Documentation/git-var.txt | 4 +-
Documentation/git-verify-pack.txt | 6 +-
Documentation/git-verify-tag.txt | 4 +-
Documentation/git-web--browse.txt | 10 +-
Documentation/git-whatchanged.txt | 10 +-
Documentation/git-write-tree.txt | 2 +-
Documentation/git.txt | 30 +++---
Documentation/gitattributes.txt | 18 ++--
Documentation/gitcore-tutorial.txt | 127 ++++++++++++-------------
Documentation/gitcvs-migration.txt | 24 +++---
Documentation/gitdiffcore.txt | 34 ++++----
Documentation/githooks.txt | 10 +-
Documentation/gitignore.txt | 8 +-
Documentation/gitk.txt | 3 +-
Documentation/gitrepository-layout.txt | 24 +++---
Documentation/gittutorial-2.txt | 40 ++++----
Documentation/gittutorial.txt | 66 +++++++-------
Documentation/user-manual.txt | 85 ++++++++---------
140 files changed, 961 insertions(+), 964 deletions(-)
next reply other threads:[~2008-06-30 21:58 UTC|newest]
Thread overview: 40+ messages / expand[flat|nested] mbox.gz Atom feed top
2008-06-30 21:56 Jonathan Nieder [this message]
2008-06-30 22:01 ` [PATCH 1/7] Documentation: fix links to tutorials and other new manual pages Jonathan Nieder
2008-06-30 23:30 ` Christian Couder
2008-06-30 22:05 ` [PATCH 2/7] whitespace fix in Documentation/git-repack.txt Jonathan Nieder
2008-06-30 22:10 ` [PATCH 3/7] Documentation: complicate example of "man git-command" Jonathan Nieder
2008-06-30 23:39 ` Christian Couder
2008-07-01 16:23 ` J. Bruce Fields
2008-07-01 23:54 ` Junio C Hamano
2008-07-02 21:31 ` J. Bruce Fields
2008-07-03 1:45 ` Jonathan Nieder
2008-07-03 18:18 ` J. Bruce Fields
2008-07-03 6:06 ` Christian Couder
2008-07-03 7:44 ` Junio C Hamano
2008-06-30 22:15 ` [PATCH 4/7] git-daemon(1): don't assume git-daemon is in /usr/bin Jonathan Nieder
2008-06-30 22:17 ` [PATCH 5/7] Documentation: prepare to be consistent about "git-" versus "git " Jonathan Nieder
2008-06-30 22:29 ` [PATCH 6/7] Documentation: " Jonathan Nieder
2008-06-30 22:36 ` [RFC/PATCH 7/7] Documentation formatting and cleanup Jonathan Nieder
2008-07-01 13:09 ` Olivier Marin
2008-07-01 21:34 ` Junio C Hamano
2008-07-03 2:09 ` Jonathan Nieder
2008-07-03 2:28 ` Jonathan Nieder
2008-07-01 8:42 ` [PATCH 0/7] Some superficial documentation changes Junio C Hamano
2008-07-03 4:31 ` Jonathan Nieder
2008-07-03 4:47 ` [PATCH 01/15] git-format-patch(1): fix stray \ in output Jonathan Nieder
2008-07-03 4:54 ` [PATCH 02/15] Documentation: fix gitlinks Jonathan Nieder
2008-07-03 5:03 ` [PATCH 03/15] manpages: fix bogus whitespace Jonathan Nieder
2008-07-03 23:55 ` Junio C Hamano
2008-07-04 1:14 ` Jonathan Nieder
2008-07-03 5:08 ` [PATCH 04/15] git(1): add comma Jonathan Nieder
2008-07-03 5:13 ` [PATCH 05/15] git-commit(1): depersonalize description Jonathan Nieder
2008-07-03 5:20 ` [PATCH 06/15] Documentation: rewrap to prepare for "git-" vs "git " change Jonathan Nieder
2008-07-03 5:28 ` [PATCH 07/15] Documentation: more "git-" versus "git " changes Jonathan Nieder
2008-07-03 5:30 ` [PATCH 08/15] gitdiffcore(7): fix awkward wording Jonathan Nieder
2008-07-03 5:36 ` [PATCH 09/15] manpages: italicize command names in synopses Jonathan Nieder
2008-07-03 5:37 ` [PATCH 10/15] manpages: italicize command names Jonathan Nieder
2008-07-03 5:45 ` [PATCH 11/15] manpages: italicize git command names (which were in teletype font) Jonathan Nieder
2008-07-03 5:49 ` [PATCH 12/15] manpages: italicize gitk's name (where it was " Jonathan Nieder
2008-07-03 5:55 ` [PATCH 13/15] manpages: italicize nongit command names (if they are " Jonathan Nieder
2008-07-03 5:59 ` [PATCH 14/15] manpages: italicize git subcommand names (which were " Jonathan Nieder
2008-07-03 6:06 ` [PATCH 15/15] manpages: use teletype font for sample command lines Jonathan Nieder
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=Pine.GSO.4.62.0806301650530.7190@harper.uchicago.edu \
--to=jrnieder@uchicago.edu \
--cc=chriscool@tuxfamily.org \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=jdl@jdl.com \
--cc=pclouds@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).