Detect renames.
-C::
- Detect copies as well as renames.
+ Detect copies as well as renames. See also `--find-copies-harder`.
--diff-filter=[ACDMRTUXB*]::
Select only files that are Added (`A`), Copied (`C`),
that matches other criteria, nothing is selected.
--find-copies-harder::
- For performance reasons, by default, -C option finds copies only
+ For performance reasons, by default, `-C` option finds copies only
if the original file of the copy was modified in the same
changeset. This flag makes the command
inspect unmodified files as candidates for the source of
copy. This is a very expensive operation for large
- projects, so use it with caution.
+ projects, so use it with caution. Giving more than one
+ `-C` option has the same effect.
-l<num>::
-M and -C options require O(n^2) processing time where n
Working branch; defaults to HEAD.\r
</p>\r
</dd>\r
+<dt>\r
+<limit>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Do not report commits up to (and including) limit.\r
+</p>\r
+</dd>\r
</dl>\r
</div>\r
<h2>Author</h2>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:04 UTC\r
+Last updated 12-Jun-2007 16:08:47 UTC\r
</div>\r
</div>\r
</body>\r
<head>::
Working branch; defaults to HEAD.
+<limit>::
+ Do not report commits up to (and including) limit.
+
Author
------
Written by Junio C Hamano <junkio@cox.net>
</dt>\r
<dd>\r
<p>\r
- Detect copies as well as renames.\r
+ Detect copies as well as renames. See also <tt>--find-copies-harder</tt>.\r
</p>\r
</dd>\r
<dt>\r
</dt>\r
<dd>\r
<p>\r
- For performance reasons, by default, -C option finds copies only\r
+ For performance reasons, by default, <tt>-C</tt> option finds copies only\r
if the original file of the copy was modified in the same\r
changeset. This flag makes the command\r
inspect unmodified files as candidates for the source of\r
copy. This is a very expensive operation for large\r
- projects, so use it with caution.\r
+ projects, so use it with caution. Giving more than one\r
+ <tt>-C</tt> option has the same effect.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:07 UTC\r
+Last updated 12-Jun-2007 16:08:47 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Detect copies as well as renames.\r
+ Detect copies as well as renames. See also <tt>--find-copies-harder</tt>.\r
</p>\r
</dd>\r
<dt>\r
</dt>\r
<dd>\r
<p>\r
- For performance reasons, by default, -C option finds copies only\r
+ For performance reasons, by default, <tt>-C</tt> option finds copies only\r
if the original file of the copy was modified in the same\r
changeset. This flag makes the command\r
inspect unmodified files as candidates for the source of\r
copy. This is a very expensive operation for large\r
- projects, so use it with caution.\r
+ projects, so use it with caution. Giving more than one\r
+ <tt>-C</tt> option has the same effect.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:08 UTC\r
+Last updated 12-Jun-2007 16:08:47 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Detect copies as well as renames.\r
+ Detect copies as well as renames. See also <tt>--find-copies-harder</tt>.\r
</p>\r
</dd>\r
<dt>\r
</dt>\r
<dd>\r
<p>\r
- For performance reasons, by default, -C option finds copies only\r
+ For performance reasons, by default, <tt>-C</tt> option finds copies only\r
if the original file of the copy was modified in the same\r
changeset. This flag makes the command\r
inspect unmodified files as candidates for the source of\r
copy. This is a very expensive operation for large\r
- projects, so use it with caution.\r
+ projects, so use it with caution. Giving more than one\r
+ <tt>-C</tt> option has the same effect.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:08 UTC\r
+Last updated 12-Jun-2007 16:08:48 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Detect copies as well as renames.\r
+ Detect copies as well as renames. See also <tt>--find-copies-harder</tt>.\r
</p>\r
</dd>\r
<dt>\r
</dt>\r
<dd>\r
<p>\r
- For performance reasons, by default, -C option finds copies only\r
+ For performance reasons, by default, <tt>-C</tt> option finds copies only\r
if the original file of the copy was modified in the same\r
changeset. This flag makes the command\r
inspect unmodified files as candidates for the source of\r
copy. This is a very expensive operation for large\r
- projects, so use it with caution.\r
+ projects, so use it with caution. Giving more than one\r
+ <tt>-C</tt> option has the same effect.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:09 UTC\r
+Last updated 12-Jun-2007 16:08:48 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Detect copies as well as renames.\r
+ Detect copies as well as renames. See also <tt>--find-copies-harder</tt>.\r
</p>\r
</dd>\r
<dt>\r
</dt>\r
<dd>\r
<p>\r
- For performance reasons, by default, -C option finds copies only\r
+ For performance reasons, by default, <tt>-C</tt> option finds copies only\r
if the original file of the copy was modified in the same\r
changeset. This flag makes the command\r
inspect unmodified files as candidates for the source of\r
copy. This is a very expensive operation for large\r
- projects, so use it with caution.\r
+ projects, so use it with caution. Giving more than one\r
+ <tt>-C</tt> option has the same effect.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:12 UTC\r
+Last updated 12-Jun-2007 16:08:49 UTC\r
</div>\r
</div>\r
</body>\r
</dt>\r
<dd>\r
<p>\r
- Initialize the submodules, i.e. clone the git repositories specified\r
- in the .gitmodules file and checkout the submodule commits specified\r
- in the index of the containing repository. This will make the\r
- submodules HEAD be detached.\r
+ Initialize the submodules, i.e. register in .git/config each submodule\r
+ path and url found in .gitmodules. The key used in git/config is\r
+ <tt>submodule.$path.url</tt>. This command does not alter existing information\r
+ in .git/config.\r
</p>\r
</dd>\r
<dt>\r
</dt>\r
<dd>\r
<p>\r
- Update the initialized submodules, i.e. checkout the submodule commits\r
- specified in the index of the containing repository. This will make\r
- the submodules HEAD be detached.\r
+ Update the registered submodules, i.e. clone missing submodules and\r
+ checkout the commit specified in the index of the containing repository.\r
+ This will make the submodules HEAD be detached.\r
</p>\r
</dd>\r
</dl>\r
</div>\r
<h2>FILES</h2>\r
<div class="sectionbody">\r
-<p>When cloning submodules, a .gitmodules file in the top-level directory\r
+<p>When initializing submodules, a .gitmodules file in the top-level directory\r
of the containing repository is used to find the url of each submodule.\r
This file should be formatted in the same way as $GIR_DIR/config. The key\r
to each submodule url is "module.$path.url".</p>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 08-Jun-2007 16:08:34 UTC\r
+Last updated 12-Jun-2007 16:08:49 UTC\r
</div>\r
</div>\r
</body>\r
repository. This command is the default command for git-submodule.
init::
- Initialize the submodules, i.e. clone the git repositories specified
- in the .gitmodules file and checkout the submodule commits specified
- in the index of the containing repository. This will make the
- submodules HEAD be detached.
+ Initialize the submodules, i.e. register in .git/config each submodule
+ path and url found in .gitmodules. The key used in git/config is
+ `submodule.$path.url`. This command does not alter existing information
+ in .git/config.
update::
- Update the initialized submodules, i.e. checkout the submodule commits
- specified in the index of the containing repository. This will make
- the submodules HEAD be detached.
+ Update the registered submodules, i.e. clone missing submodules and
+ checkout the commit specified in the index of the containing repository.
+ This will make the submodules HEAD be detached.
OPTIONS
FILES
-----
-When cloning submodules, a .gitmodules file in the top-level directory
+When initializing submodules, a .gitmodules file in the top-level directory
of the containing repository is used to find the url of each submodule.
This file should be formatted in the same way as $GIR_DIR/config. The key
to each submodule url is "module.$path.url".