git/Documentation
J. Bruce Fields 23091e954c Documentation: revise top of git man page
I'm afraid I'll be accused of trying to suck all the jokes and the
personality out of the git documentation.  I'm not!  Really!

That said, "man git" is one of the first things a new user is likely try,
and it seems a little cruel to start off with a somewhat obscure joke
about the architecture of git.

So instead I'm trying for a relatively straightforward description of what
git does, and what features distinguish it from other systems, together
with immediate links to introductory documentation.

I also did some minor reorganization in an attempt to clarify the
classification of commands.  And revised a bit for conciseness (as is
obvious from the diffstat--hopefully I didn't cut anything important).

Signed-off-by: J. Bruce Fields <bfields@citi.umich.edu>
Signed-off-by: Junio C Hamano <junkio@cox.net>
2006-04-02 21:17:32 -07:00
..
howto Add howto about separating topics. 2006-02-12 05:02:42 -08:00
technical Documentation: fix missing links to git(7) 2005-12-12 23:55:09 -08:00
.gitignore Don't include ../README in git.txt - make a local copy 2006-01-24 23:16:31 -08:00
Makefile Documentation/Makefile: Some `git-*.txt' files aren't manpages. 2006-03-05 02:32:13 -08:00
SubmittingPatches SubmittingPatches: note on whitespaces 2006-02-17 16:15:26 -08:00
asciidoc.conf Tweak asciidoc output to work with broken docbook-xsl 2006-03-05 22:38:12 -08:00
build-docdep.perl
core-tutorial.txt git-commit: revamp the git-commit semantics. 2006-02-06 23:20:32 -08:00
cvs-migration.txt documentation: cvs migration - typofix. 2006-01-30 21:01:25 -08:00
diff-format.txt Documentation: diff -c/--cc 2006-01-28 02:26:30 -08:00
diff-options.txt Add --diff-filter= documentation paragraph 2006-02-09 12:06:57 -08:00
diffcore.txt
everyday.txt Documentation: typos and small fixes in "everyday". 2005-12-18 12:11:27 -08:00
fetch-options.txt git-fetch --upload-pack: disambiguate. 2006-01-26 18:11:06 -08:00
git-add.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-am.txt war on whitespaces: documentation. 2006-03-02 00:52:59 -08:00
git-apply.txt war on whitespaces: documentation. 2006-03-02 00:52:59 -08:00
git-applymbox.txt
git-applypatch.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-archimport.txt git/Documentation: fix SYNOPSIS style bugs 2006-03-05 17:02:02 -08:00
git-bisect.txt Documentation: talk about pathspec in bisect. 2005-12-05 00:15:24 -08:00
git-branch.txt Call out the two different uses of git-branch and fix a typo. 2006-03-17 20:42:30 -08:00
git-cat-file.txt Wrap synopsis lines and use [verse] to keep formatting 2006-01-05 18:44:28 -08:00
git-check-ref-format.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-checkout-index.txt Add --temp and --stage=all options to checkout-index. 2006-03-05 00:58:13 -08:00
git-checkout.txt Rewrite synopsis to clarify the two primary uses of git-checkout. 2006-03-17 20:42:38 -08:00
git-cherry-pick.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-cherry.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-clone-pack.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-clone.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-commit-tree.txt trivial: clarify, what are the config's user.name and user.email about 2006-01-05 17:23:21 -08:00
git-commit.txt Reference git-commit-tree for env vars. 2006-03-17 20:42:35 -08:00
git-convert-objects.txt
git-count-objects.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-cvsexportcommit.txt cvsexportcommit: add some examples to the documentation 2006-01-29 23:25:42 -08:00
git-cvsimport.txt Fix multi-paragraph list items in OPTIONS section 2006-03-20 14:37:33 -08:00
git-cvsserver.txt cvsserver: updated documentation 2006-03-05 02:22:53 -08:00
git-daemon.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-describe.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-diff-files.txt Documentation: diff -c/--cc 2006-01-28 02:26:30 -08:00
git-diff-index.txt Documentation: spell. 2005-12-29 01:32:56 -08:00
git-diff-stages.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-diff-tree.txt Document git-diff-tree --always 2006-02-07 13:19:40 -08:00
git-diff.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-fetch-pack.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-fetch.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-fmt-merge-msg.txt
git-format-patch.txt Describe how to add extra mail header lines in mail generated by git-format-patch. 2006-03-09 22:01:10 -08:00
git-fsck-objects.txt fsck-objects: Remove --standalone 2006-03-09 13:10:31 -08:00
git-get-tar-commit-id.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-grep.txt Format tweaks for asciidoc. 2006-03-22 11:06:19 -08:00
git-hash-object.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-http-fetch.txt Wrap synopsis lines and use [verse] to keep formatting 2006-01-05 18:44:28 -08:00
git-http-push.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-index-pack.txt
git-init-db.txt Document the default source of template files. 2006-03-17 20:42:31 -08:00
git-local-fetch.txt
git-log.txt
git-lost-found.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-ls-files.txt Merge branch 'master' into next 2006-03-26 23:44:14 -08:00
git-ls-remote.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-ls-tree.txt ls-tree: add --abbrev[=<n>] option 2006-03-17 14:10:24 -08:00
git-mailinfo.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-mailsplit.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-merge-base.txt
git-merge-index.txt Use uniform description for the '--' option. 2005-12-08 15:50:13 -08:00
git-merge-one-file.txt
git-merge.txt Examples of resetting. 2005-12-16 18:23:33 -08:00
git-mktag.txt
git-mv.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-name-rev.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-pack-objects.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-pack-redundant.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-parse-remote.txt
git-patch-id.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-peek-remote.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-prune-packed.txt cosmetics: change from 'See-Also' to 'See Also' 2006-03-05 00:57:37 -08:00
git-prune.txt git-prune: never lose objects reachable from our refs. 2005-12-08 23:18:41 -08:00
git-pull.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-push.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-read-tree.txt Documentation: read-tree --aggressive 2006-03-02 01:11:05 -08:00
git-rebase.txt Document git-rebase behavior on conflicts. 2006-03-26 19:07:43 -08:00
git-receive-pack.txt Documentation: push/receive hook references. 2005-12-05 00:58:23 -08:00
git-relink.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-repack.txt cosmetics: change from 'See-Also' to 'See Also' 2006-03-05 00:57:37 -08:00
git-repo-config.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-request-pull.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-rerere.txt git-rerere: reuse recorded resolve. 2006-02-06 21:53:11 -08:00
git-reset.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-resolve.txt
git-rev-list.txt Merge branch 'lt/rev-list' 2006-03-04 13:21:17 -08:00
git-rev-parse.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-revert.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-rm.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-send-email.txt send-email: Add --cc 2006-02-13 03:32:10 -05:00
git-send-pack.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-sh-setup.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-shell.txt git/Documentation: fix SYNOPSIS style bugs 2006-03-05 17:02:02 -08:00
git-shortlog.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-show-branch.txt Fix minor typo. 2006-03-17 20:42:36 -08:00
git-show-index.txt
git-show.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-ssh-fetch.txt
git-ssh-upload.txt
git-status.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-stripspace.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-svnimport.txt Fix multi-paragraph list items in OPTIONS section 2006-03-20 14:37:33 -08:00
git-symbolic-ref.txt
git-tag.txt Fix some inconsistencies in the docs 2006-03-09 11:43:58 -08:00
git-tar-tree.txt
git-tools.txt Add a Documentation/git-tools.txt 2006-03-03 23:29:56 -08:00
git-unpack-file.txt
git-unpack-objects.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-update-index.txt "assume unchanged" git: documentation. 2006-02-12 01:48:47 -08:00
git-update-ref.txt git/Documentation: fix SYNOPSIS style bugs 2006-03-05 17:02:02 -08:00
git-update-server-info.txt Documentation: HTTP needs update-server-info. 2005-12-17 11:39:39 -08:00
git-upload-pack.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-var.txt git/Documentation: fix SYNOPSIS style bugs 2006-03-05 17:02:02 -08:00
git-verify-pack.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-verify-tag.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-whatchanged.txt Format tweaks for asciidoc. 2006-03-22 11:06:19 -08:00
git-write-tree.txt Added documentation for few missing options. 2005-12-05 21:47:16 -08:00
git.txt Documentation: revise top of git man page 2006-04-02 21:17:32 -07:00
gitk.txt
glossary.txt glossary: explain "master" and "origin" 2006-01-10 16:02:54 -08:00
hooks.txt Clarify and expand some hook documentation. 2006-03-24 22:24:02 -08:00
howto-index.sh
install-webdoc.sh
merge-options.txt Documentation: recursive is the default strategy these days. 2005-12-08 14:04:33 -08:00
merge-strategies.txt Documentation: recursive is the default strategy these days. 2005-12-08 14:04:33 -08:00
pull-fetch-param.txt Docs: move git url and remotes text to separate sections 2006-02-06 21:14:56 -08:00
repository-layout.txt Clarify and expand some hook documentation. 2006-03-24 22:24:02 -08:00
sort_glossary.pl Documentation(glossary): minor formatting clean-ups. 2005-12-07 16:16:04 -08:00
tutorial.txt AsciiDoc fix for tutorial 2006-03-04 13:50:04 -08:00
urls.txt Docs: move git url and remotes text to separate sections 2006-02-06 21:14:56 -08:00