mirrors/git
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
93f9cc675d6ca9d9170f72def005ecffd9590e9c
git/Documentation
History
J. Bruce Fields 93f9cc675d tutorial: revise index introduction 
The embarassing history of this tutorial is that I started it without
really understanding the index well, so I avoided mentioning it.

And we all got the idea that "index" was a word to avoid using around
newbies, but it was reluctantly mentioned that *something* had to be
said.  The result is a little awkward: the discussion of the index never
actually uses that word, and isn't well-integrated into the surrounding
material.

Let's just go ahead and use the word "index" from the very start, and
try to demonstrate its use with a minimum of lecturing.

Also, remove discussion of using git-commit with explicit filenames.
We're already a bit slow here to get people to their first commit, and
I'm not convinced this is really so important.

Signed-off-by: "J. Bruce Fields" <bfields@citi.umich.edu>
2007-05-19 01:00:27 -04:00
..
howto
user-manual: move howto/using-topic-branches into manual
2007-05-17 21:20:10 -04: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
Document core.excludesfile for git-add
2007-05-17 17:36:38 -07: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
Documentation: Added [verse] to SYNOPSIS where necessary
2007-05-18 21:47:40 -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
Documentation: Added [verse] to SYNOPSIS where necessary
2007-05-18 21:47:40 -07: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
…
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
Documentation: Added [verse] to SYNOPSIS where necessary
2007-05-18 21:47:40 -07:00
git-for-each-ref.txt
Documentation: Reformatted SYNOPSIS for several commands
2007-05-18 21:47:45 -07: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
…
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
…
git-index-pack.txt
Documentation: Reformatted SYNOPSIS for several commands
2007-05-18 21:47:45 -07: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: Reformatted SYNOPSIS for several commands
2007-05-18 21:47:45 -07:00
git-local-fetch.txt
Documentation: Reformatted SYNOPSIS for several commands
2007-05-18 21:47:45 -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
…
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
…
git-mktree.txt
…
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
Documentation: Added [verse] to SYNOPSIS where necessary
2007-05-18 21:47:40 -07:00
git-p4import.txt
Documentation: Reformatted SYNOPSIS for several commands
2007-05-18 21:47:45 -07: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
Documentation: Reformatted SYNOPSIS for several commands
2007-05-18 21:47:45 -07: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
Documentation: Added [verse] to SYNOPSIS where necessary
2007-05-18 21:47:40 -07: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
…
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
…
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
Documentation: git-rev-list's "patterns"
2007-05-18 17:12:10 -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
…
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
…
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
…
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
…
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
…
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: expand and clarify some definitions, prune cross-references
2007-05-17 21:03:59 -04:00
hooks.txt
Updated documentation of hooks in git-receive-pack.
2007-05-12 11:13:08 -07:00
howto-index.sh
…
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
…
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
GIT v1.5.1.5
2007-05-18 17:21:43 -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
tutorials: add user-manual links
2007-05-19 00:57:19 -04:00
tutorial.txt
tutorial: revise index introduction
2007-05-19 01:00:27 -04: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
user-manual: reorganize public git repo discussion
2007-05-17 23:23:08 -04:00