Johan Herland 2dc53617a4 user-manual: Add section on ignoring files ...

The todo list at the end of the user manual says that something must be
said about .gitignore. Also, there seems to be a lack of documentation
on how to choose between the various types of ignore files (.gitignore
vs. .git/info/exclude, etc.).

This patch adds a section on ignoring files which try to introduce how
to tell git about ignored files, and how the different strategies
complement eachother.

The syntax of exclude patterns is explained in a simplified manner, with
a reference to git-ls-files(1) which already contains a more thorough
explanation.

Signed-off-by: Johan Herland <johan@herland.net>

2007-05-19 01:06:05 -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

…

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

…

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

…

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

…

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: Add section on ignoring files

2007-05-19 01:06:05 -04:00