git-commit-vandalism/Documentation
Johannes Schindelin 126640afbc Add a birdview-on-the-source-code section to the user manual
In http://thread.gmane.org/gmane.comp.version-control.git/42479,
a birdview on the source code was requested.

J. Bruce Fields suggested that my reply should be included in the
user manual, and there was nothing of an outcry, so here it is,
not 2 months later.

It includes modifications as suggested by J. Bruce Fields, Karl
Hasselström and Daniel Barkalow.

Signed-off-by: Johannes Schindelin <Johannes.Schindelin@gmx.de>
2007-05-16 20:36:13 -04:00
..
howto Add a HOWTO for setting up a standalone git daemon 2007-03-19 22:17:38 -07:00
technical Merge branch 'maint' 2007-03-22 03:05:25 -07:00
.gitignore Ignore all man sections as they are generated files. 2007-04-23 22:19:36 -07:00
asciidoc.conf escape tilde in Documentation/git-rev-parse.txt 2006-10-03 01:04:19 -07:00
blame-options.txt Update -L documentation for git-blame/git-annotate 2007-04-26 22:43:10 -07:00
build-docdep.perl Documentation/build-docdep.perl: Fix dependencies for included asciidoc files 2007-03-01 13:24:54 -08:00
callouts.xsl spurious .sp in manpages 2006-12-13 09:41:18 -08:00
cmd-list.perl Documentation: tighten dependency for git.{html,txt} 2007-04-06 21:29:16 -07:00
config.txt Document 'opendiff' value in config.txt and git-mergetool.txt 2007-05-03 22:56:23 -07:00
core-intro.txt Merge branch 'maint' 2007-02-17 16:16:48 -08:00
core-tutorial.txt Remove git-resolve. 2007-02-12 19:33:03 -08:00
cvs-migration.txt Documentation: mention module option to git-cvsimport 2007-03-04 16:47:32 -08:00
diff-format.txt diff format documentation: describe raw combined diff format 2007-05-04 16:58:17 -07:00
diff-options.txt Document --quiet option to git-diff 2007-03-24 22:32:55 -07:00
diffcore.txt Remove git-diff-stages. 2007-02-12 19:33:03 -08:00
docbook-xsl.css Documentation: add git user's manual 2007-01-07 20:33:06 -05:00
everyday.txt git-fsck-objects is now synonym to git-fsck 2007-01-28 16:33:58 -08:00
fetch-options.txt Document additional options for git-fetch 2007-04-26 22:43:10 -07:00
git-add.txt Documentation: Correct minor typo in git-add documentation. 2007-03-01 13:26:18 -08:00
git-am.txt git-am: Clean up the asciidoc documentation 2007-05-14 17:25:02 -07:00
git-annotate.txt Update git-annotate/git-blame documentation 2007-04-16 01:14:46 -07:00
git-apply.txt Update git-apply documentation 2007-04-16 01:14:46 -07:00
git-applymbox.txt Documentation: format-patch has no --mbox option 2007-05-14 17:23:52 -07:00
git-applypatch.txt Documentation: suggest corresponding Porcelain-level in plumbing docs. 2007-01-17 13:03:29 -08:00
git-archimport.txt git-archimport: allow remapping branch names 2007-03-07 10:30:22 -08:00
git-archive.txt Update git-archive documentation 2007-04-18 22:06:21 -07:00
git-bisect.txt Documentation: bisect: make a comment fit better in the man page. 2007-03-23 23:29:29 -07:00
git-blame.txt Update git-annotate/git-blame documentation 2007-04-16 01:14:46 -07:00
git-branch.txt Documentation/branch: fix small typo in -D example 2007-05-14 20:17:00 -07:00
git-bundle.txt fix various doc typos 2007-03-01 03:27:36 -08:00
git-cat-file.txt Update git-cat-file documentation 2007-01-31 13:32:38 -08:00
git-check-ref-format.txt Some doc typo fixes 2006-06-07 11:49:35 -07:00
git-checkout-index.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-checkout.txt Reverse the order of -b and --track in the man page. 2007-04-23 16:58:10 -07:00
git-cherry-pick.txt Update git-cherry-pick documentation 2007-04-18 22:07:57 -07:00
git-cherry.txt git-cherry: document limit and add diagram 2006-10-26 18:53:18 -07:00
git-clean.txt Teach git-clean optional <paths>... parameters. 2006-05-08 16:40:45 -07:00
git-clone.txt tiny fix in documentation of git-clone 2007-05-12 09:20:51 -07:00
git-commit-tree.txt Add missing reference to GIT_COMMITTER_DATE in git-commit-tree documentation 2007-04-29 01:34:59 -07:00
git-commit.txt git-commit: add a --interactive option 2007-03-09 00:05:23 -08:00
git-config.txt Update git-config documentation 2007-04-18 22:08:16 -07:00
git-convert-objects.txt Convert usage of GIT and Git into git 2005-10-10 16:01:31 -07:00
git-count-objects.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-cvsexportcommit.txt Documentation: don't reference non-existent 'git-cvsapplycommit' 2007-05-06 23:30:38 -07:00
git-cvsimport.txt cvsimport: Improve formating consistency 2007-04-06 16:46:23 -07:00
git-cvsserver.txt cvsserver: small corrections to asciidoc documentation 2007-04-07 23:01:54 -07:00
git-daemon.txt git-daemon documentation on enabling services. 2007-01-24 15:29:07 -08:00
git-describe.txt Update describe documentation. 2007-01-28 02:08:51 -08:00
git-diff-files.txt Removing -n option from git-diff-files documentation 2007-04-26 22:43:10 -07:00
git-diff-index.txt Minor grammar fixes for git-diff-index.txt 2006-11-02 18:03:31 -08:00
git-diff-tree.txt Move --pretty options into Documentation/pretty-formats.txt 2006-11-22 16:06:32 -08:00
git-diff.txt Merge branch 'master-for-junio' of git://repo.or.cz/git/fastimport; branch 'maint' 2007-03-05 21:23:46 -08:00
git-fast-import.txt Fix documentation of tag in git-fast-import.txt 2007-05-09 19:04:54 -07:00
git-fetch-pack.txt fetch & clone: do not output progress when not on a tty 2007-02-19 19:20:05 -08:00
git-fetch.txt git-fetch: document automatic tag following. 2007-02-09 15:41:35 -08:00
git-fmt-merge-msg.txt Update git-fmt-merge documentation 2007-04-26 22:43:10 -07:00
git-for-each-ref.txt git-for-each-ref doesn't return "the bit after $GIT_DIR/refs" 2007-02-05 13:48:59 -08:00
git-format-patch.txt Merge branch 'js/attach' 2007-03-10 23:38:18 -08:00
git-fsck-objects.txt git-fsck-objects is now synonym to git-fsck 2007-01-28 16:33:58 -08:00
git-fsck.txt git-fsck-objects is now synonym to git-fsck 2007-01-28 16:33:58 -08:00
git-gc.txt git-gc: run pack-refs by default unless the repo is bare 2007-02-13 09:19:34 -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 Update git-grep documentation 2007-04-26 22:43:10 -07:00
git-hash-object.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-http-fetch.txt Update git-http-fetch documentation 2007-04-26 22:43:11 -07:00
git-http-push.txt Update git-http-push documentation 2007-04-26 22:43:10 -07:00
git-imap-send.txt Several trivial documentation touch ups. 2006-05-05 14:21:18 -07:00
git-index-pack.txt remove .keep pack lock files when done with refs update 2006-11-03 00:24:07 -08:00
git-init-db.txt Document git-init 2007-01-11 12:58:10 -08:00
git-init.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-instaweb.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-local-fetch.txt Update git-local-fetch documentation 2007-04-26 22:43:10 -07:00
git-log.txt Document -g (--walk-reflogs) option of git-log 2007-04-15 16:05:24 -07:00
git-lost-found.txt Documentation: minor edits of git-lost-found manpage 2007-04-16 01:10:28 -07:00
git-ls-files.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-ls-remote.txt Documentation: a few spelling fixes 2007-01-17 08:44:32 -08:00
git-ls-tree.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-mailinfo.txt Documentation: format-patch has no --mbox option 2007-05-14 17:23:52 -07:00
git-mailsplit.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-merge-base.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-merge-file.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-merge-index.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-merge-one-file.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-merge-tree.txt Documentation: add a couple of missing docs. 2006-04-13 00:21:06 -07:00
git-merge.txt Convert update-index references in docs to add. 2007-02-17 10:20:27 -08:00
git-mergetool.txt Document 'opendiff' value in config.txt and git-mergetool.txt 2007-05-03 22:56:23 -07:00
git-mktag.txt Remove the version tags from the manpages 2005-10-10 14:49:52 -07:00
git-mktree.txt Documentation: add a couple of missing docs. 2006-04-13 00:21:06 -07:00
git-mv.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-name-rev.txt name-rev: introduce the --refs=<pattern> option 2007-02-17 11:26:49 -08:00
git-p4import.txt use 'init' instead of 'init-db' for shipped docs and tools 2007-01-12 13:36:16 -08:00
git-pack-objects.txt git-pack-objects progress flag documentation and cleanup 2006-11-07 16:05:37 -08:00
git-pack-redundant.txt git-fsck-objects is now synonym to git-fsck 2007-01-28 16:33:58 -08:00
git-pack-refs.txt Documentation: pack-refs --all vs default behaviour 2007-01-26 00:02:51 -08:00
git-parse-remote.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-patch-id.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-peek-remote.txt rename --exec to --upload-pack for fetch-pack and peek-remote 2007-01-24 16:12:15 -08:00
git-prune-packed.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-prune.txt git-fsck-objects is now synonym to git-fsck 2007-01-28 16:33:58 -08:00
git-pull.txt Documentation/git-pull: describe default behaviour and config interactions 2007-02-08 23:35:43 -08:00
git-push.txt rename --exec to --receive-pack for push and send-pack 2007-01-19 17:54:33 -08:00
git-quiltimport.txt Documentation/git-quiltimport.txt: Fix labeled list formatting 2007-03-01 13:25:14 -08:00
git-read-tree.txt read-tree: document --exclude-per-directory 2006-12-05 23:44:23 -08:00
git-rebase.txt Convert update-index references in docs to add. 2007-02-17 10:20:27 -08:00
git-receive-pack.txt Change {pre,post}-receive hooks to use stdin 2007-03-11 22:56:03 -07:00
git-reflog.txt git reflog show 2007-02-08 15:35:24 -08:00
git-relink.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-remote.txt Documentation: fix typo in git-remote.txt 2007-05-05 23:10:59 -07:00
git-repack.txt Fixed some typos in git-repack docs 2007-02-10 22:48:57 -08:00
git-repo-config.txt [PATCH] Rename git-repo-config to git-config. 2007-01-28 16:16:53 -08:00
git-request-pull.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-rerere.txt Convert update-index references in docs to add. 2007-02-17 10:20:27 -08:00
git-reset.txt Documentation/git-reset.txt: suggest git commit --amend in example. 2007-04-23 23:55:08 -07:00
git-rev-list.txt Document --left-right option to rev-list. 2007-04-05 14:12:41 -07:00
git-rev-parse.txt SPECIFYING RANGES typo fix: it it => it is 2007-05-10 13:26:26 -07:00
git-revert.txt Refer users to git-rev-parse for revision specification syntax. 2007-01-17 20:45:41 -08:00
git-rm.txt git-rm documentation: remove broken behaviour from the example. 2007-01-16 11:50:29 -08:00
git-runstatus.txt Convert update-index references in docs to add. 2007-02-17 10:20:27 -08:00
git-send-email.txt send-email documentation: clarify --smtp-server 2007-04-30 16:50:55 -07:00
git-send-pack.txt Assorted typo fixes 2007-02-03 21:49:54 -08:00
git-sh-setup.txt Documentation/git-sh-setup.txt: programmer's docs 2007-01-17 01:13:05 -08:00
git-shell.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-shortlog.txt git shortlog documentation: add long options and fix a typo 2007-04-27 23:17:58 -07:00
git-show-branch.txt show-branch -g: default to the current branch. 2007-02-03 23:34:22 -08:00
git-show-index.txt Convert usage of GIT and Git into git 2005-10-10 16:01:31 -07:00
git-show-ref.txt Documentation: show-ref: document --exclude-existing 2007-04-09 18:54:52 -07:00
git-show.txt Fix git-show man page formatting in the EXAMPLES section 2007-02-27 15:38:05 -08:00
git-ssh-fetch.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-ssh-upload.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-status.txt Convert update-index references in docs to add. 2007-02-17 10:20:27 -08:00
git-stripspace.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-svn.txt Add --no-rebase option to git-svn dcommit 2007-05-04 15:08:31 -07:00
git-svnimport.txt Documentation/git-svnimport.txt: fix typo. 2007-03-29 01:38:11 -07:00
git-symbolic-ref.txt add logref support to git-symbolic-ref 2007-01-28 02:16:46 -08:00
git-tag.txt Add discussion section to git-tag documentation. 2007-02-11 22:29:12 -08:00
git-tar-tree.txt git-tar-tree: complete deprecation conversion message 2007-04-18 17:57:25 -07:00
git-tools.txt Add hg-to-git conversion utility. 2007-02-05 13:52:45 -08:00
git-unpack-file.txt Remove the version tags from the manpages 2005-10-10 14:49:52 -07:00
git-unpack-objects.txt unpack-objects -r: call it "recover". 2006-09-13 12:59:49 -07:00
git-update-index.txt Add core.symlinks to mark filesystems that do not support symbolic links. 2007-03-02 16:58:05 -08:00
git-update-ref.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-update-server-info.txt Documentation: HTTP needs update-server-info. 2005-12-17 11:39:39 -08:00
git-upload-archive.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git-upload-pack.txt Fixup no-progress for fetch & clone 2007-02-24 00:26:18 -08:00
git-var.txt [PATCH] Rename git-repo-config to git-config. 2007-01-28 16:16:53 -08:00
git-verify-pack.txt Fix up docs where "--" isn't displayed correctly. 2006-05-05 14:21:52 -07:00
git-verify-tag.txt Remove trailing dot after short description 2006-03-09 11:44:11 -08:00
git-whatchanged.txt Documentation/git-whatchanged.txt: show -<n> instead of --max-count. 2007-01-17 01:11:56 -08:00
git-write-tree.txt Documentation: sync git.txt command list and manual page title 2007-01-18 15:53:37 -08:00
git.txt user-manual: stop deprecating the manual 2007-05-07 01:03:53 -04:00
gitk.txt Assorted typo fixes 2007-02-03 21:49:54 -08:00
glossary.txt glossary: clean up cross-references 2007-03-18 23:06:00 -04:00
hooks.txt Updated documentation of hooks in git-receive-pack. 2007-05-12 11:13:08 -07:00
howto-index.sh Allow asciidoc formatted documentation in howto/ 2005-08-29 22:38:12 -07:00
i18n.txt Documentation/i18n.txt: it is i18n.commitencoding not core.commitencoding 2007-02-18 15:58:20 -08:00
install-doc-quick.sh Makefile: add quick-install-doc for installing pre-built manpages 2006-12-23 09:22:30 -08:00
install-webdoc.sh user-manual: install user manual stylesheet with other web documents 2007-03-10 23:05:02 -05:00
Makefile Documentation: tighten dependency for git.{html,txt} 2007-04-06 21:29:16 -07:00
merge-options.txt git-merge --squash 2006-06-24 01:11:19 -07:00
merge-strategies.txt Documentation: recursive is the default strategy these days. 2005-12-08 14:04:33 -08:00
pretty-formats.txt pretty-formats: add 'format:<string>' 2007-02-22 21:03:41 -08:00
pull-fetch-param.txt Documentation: remove master:origin example from pull-fetch-param.txt 2007-01-01 14:38:08 -08:00
RelNotes-1.5.0.1.txt GIT 1.5.0.1 2007-02-18 16:18:43 -08:00
RelNotes-1.5.0.2.txt GIT 1.5.0.2 2007-02-26 00:26:06 -08:00
RelNotes-1.5.0.3.txt GIT 1.5.0.3 2007-03-04 17:20:38 -08:00
RelNotes-1.5.0.4.txt GIT 1.5.0.4 2007-03-14 15:56:49 -07:00
RelNotes-1.5.0.5.txt GIT 1.5.0.5 2007-03-18 14:43:29 -07:00
RelNotes-1.5.0.6.txt GIT 1.5.0.6 2007-03-28 15:28:14 -07:00
RelNotes-1.5.0.7.txt GIT 1.5.0.7 2007-04-03 19:27:41 -07:00
RelNotes-1.5.0.txt git-clone: Sync documentation to usage note. 2007-02-19 18:14:29 -08:00
RelNotes-1.5.1.1.txt git-svn: don't allow globs to match regular files 2007-04-18 12:39:04 -07:00
RelNotes-1.5.1.2.txt GIT 1.5.1.2 2007-04-21 13:57:07 -07:00
RelNotes-1.5.1.3.txt GIT v1.5.1.3 2007-04-30 17:09:48 -07:00
RelNotes-1.5.1.4.txt GIT v1.5.1.4 2007-05-08 22:11:17 -07:00
RelNotes-1.5.1.5.txt Prepare for 1.5.1.5 Release Notes 2007-05-14 17:51:12 -07:00
RelNotes-1.5.1.txt GIT 1.5.1 2007-04-03 22:47:01 -07:00
repository-layout.txt Clarify that git-update-server-info should be run for every git-push 2007-02-12 22:00:45 -08:00
SubmittingPatches Clarify SubmittingPatches Checklist 2007-04-30 16:39:18 -07:00
tutorial-2.txt Convert update-index references in docs to add. 2007-02-17 10:20:27 -08:00
tutorial.txt Mention version 1.5.1 in tutorial and user-manual 2007-05-04 16:58:03 -07:00
urls.txt Fix formatting for urls section of fetch, pull, and push manpages 2006-12-31 18:40:17 -08:00
user-manual.conf Documentation: add git user's manual 2007-01-07 20:33:06 -05:00
user-manual.txt Add a birdview-on-the-source-code section to the user manual 2007-05-16 20:36:13 -04:00