Lars Hjemli 70c7ac22de Add git-submodule command ...

This command can be used to initialize, update and inspect submodules. It
uses a .gitmodules file, readable by git-config, in the top level directory
of the 'superproject' to specify a mapping between submodule paths and
repository url.

Example .gitmodules layout:

[module "git"]
	url = git://git.kernel.org/pub/scm/git/git.git

With this entry in .gitmodules (and a commit reference in the index entry for
the path "git"), the command 'git submodule init' will clone the repository
at kernel.org into the directory "git".

Known issues
============
There is currently no way to override the url found in the .gitmodules file,
except by manually creating the subproject repository. The place to fix this
in the script has a rather long comment about a possible plan.

Funny paths will be quoted in the output from git-ls-files, but git-submodule
does not attempt to unquote (or even detect the presence of) such paths.

Signed-off-by: Lars Hjemli <hjemli@gmail.com>
Signed-off-by: Junio C Hamano <junkio@cox.net>

2007-05-26 20:24:07 -07: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

Documentation: unbreak user-manual.

2007-03-28 16:48:50 -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

Add git-submodule command

2007-05-26 20:24:07 -07:00

config.txt

Merge branch 'maint'

2007-05-23 22:37:23 -07:00

core-intro.txt

Merge branch 'maint'

2007-02-17 16:16:48 -08:00

core-tutorial.txt

core-tutorial: minor fixes

2007-04-25 13:44:45 -07: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

Merge branch 'maint'

2007-05-17 17:36:57 -07:00

git-am.txt

Teach mailsplit about Maildir's

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

Merge branch 'maint'

2007-05-18 21:50:56 -07:00

git-bisect.txt

Documentation: bisect: "start" accepts one bad and many good commits

2007-04-05 15:13:14 -07:00

git-blame.txt

blame -s: suppress author name and time.

2007-04-29 02:05:06 -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-attr.txt

Document git-check-attr

2007-04-15 16:01:35 -07: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

Fix minor documentation errors

2007-05-07 15:39:57 -07:00

git-clone.txt

tiny fix in documentation of git-clone

2007-05-12 09:20:51 -07:00

git-commit-tree.txt

Fall back to $EMAIL for missing GIT_AUTHOR_EMAIL and GIT_COMMITTER_EMAIL

2007-04-29 02:05:06 -07:00

git-commit.txt

git-commit: add a --interactive option

2007-03-09 00:05:23 -08:00

git-config.txt

git-config: Correct asciidoc documentation for --int/--bool

2007-05-20 16:00:23 -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

Merge branch 'fl/cvsserver'

2007-04-17 22:17:46 -07:00

git-daemon.txt

git-daemon documentation on enabling services.

2007-01-24 15:29:07 -08:00

git-describe.txt

Teach git-describe how to run name-rev

2007-05-21 23:56:28 -07: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

Documentation: Split description of pretty formats of commit log

2007-05-13 18:44:50 -07: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

Add custom subject prefix support to format-patch (take 3)

2007-04-11 18:48:30 -07: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

Fix lost-found to show commits only referenced by reflogs

2007-04-05 15:00:03 -07:00

git-gc.txt

Add --aggressive option to 'git gc'

2007-05-10 15:24:40 -07: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

Merge branch 'maint'

2007-05-18 21:50:56 -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

Documentation: Split description of pretty formats of commit log

2007-05-13 18:44:50 -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

Merge branch 'maint-1.5.1' into maint

2007-05-26 01:30:40 -07:00

git-ls-remote.txt

Documentation: a few spelling fixes

2007-01-17 08:44:32 -08:00

git-ls-tree.txt

Add an option to git-ls-tree to display also the size of blob

2007-05-20 21:43:46 -07:00

git-mailinfo.txt

Documentation: format-patch has no --mbox option

2007-05-14 17:23:52 -07:00

git-mailsplit.txt

Teach mailsplit about Maildir's

2007-05-24 19:01:56 -07: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

Teach git-describe how to run name-rev

2007-05-21 23:56:28 -07:00

git-p4import.txt

Documentation: Reformatted SYNOPSIS for several commands

2007-05-18 21:47:45 -07:00

git-pack-objects.txt

Custom compression levels for objects and packs

2007-05-10 15:23:09 -07: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

git-read-tree --index-output=<file>

2007-04-03 23:44:32 -07: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

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

Increase pack.depth default to 50

2007-05-08 22:47:17 -07: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

git-rev-list: Add regexp tuning options

2007-05-20 20:31:50 -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

Add --ignore-unmatch option to exit with zero status when no files are removed.

2007-04-17 00:19:11 -07: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

Documentation: Split description of pretty formats of commit log

2007-05-13 18:44:50 -07: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

git-status: respect core.excludesFile

2007-05-21 18:36:02 -07:00

git-stripspace.txt

Remove trailing dot after short description

2006-03-09 11:44:11 -08:00

git-submodule.txt

Add git-submodule command

2007-05-26 20:24:07 -07: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

git-tag(1): -v option is a subcommand; fix code block

2007-05-03 23:27:03 -07: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

Added a reference to git-add in the documentation for git-update-index

2007-05-07 00:15:00 -07:00

git-update-ref.txt

git-update-ref: add --no-deref option for overwriting/detaching ref

2007-05-10 15:24:44 -07: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

GIT 1.5.2

2007-05-20 00:30:39 -07:00

gitattributes.txt

Use $Id$ as the ident attribute keyword rather than $ident$ to be consistent with other VCSs

2007-05-14 19:03:32 -07:00

gitk.txt

Assorted typo fixes

2007-02-03 21:49:54 -08:00

glossary.txt

Documentation: Add definition of "evil merge" to GIT Glossary

2007-05-25 20:54:38 -07:00

hooks.txt

Minor fixup to documentation of hooks in git-receive-pack.

2007-05-12 15:46:55 -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/Makefile: fix section (5) installation

2007-04-22 00:21:17 -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

Documentation: Split description of pretty formats of commit log

2007-05-13 18:44:50 -07:00

pretty-options.txt

Documentation: Split description of pretty formats of commit log

2007-05-13 18:44:50 -07: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 1.5.1.6

2007-05-20 00:15:53 -07:00

RelNotes-1.5.1.6.txt

GIT 1.5.1.6

2007-05-20 00:15:53 -07:00

RelNotes-1.5.1.txt

GIT 1.5.1

2007-04-03 22:47:01 -07:00

RelNotes-1.5.2.txt

GIT 1.5.2

2007-05-20 00:30:39 -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

Merge branch 'maint-1.5.1' into maint

2007-05-21 18:42:35 -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

Merge branch 'maint' to synchronize with 1.5.1.6

2007-05-20 00:19:30 -07:00