* v1.8.0-150-gb0b00a3: Weird documentation for git-rm
@ 2012-11-14 18:15 Horst H. von Brand
2012-11-14 18:49 ` [PATCH] docs: move submodule section Matt Kraai
0 siblings, 1 reply; 3+ messages in thread
From: Horst H. von Brand @ 2012-11-14 18:15 UTC (permalink / raw)
To: git; +Cc: gitster, Horst H. von Brand
The file Documentation/git-rm.txt says:
---8><---- 8><-------
Using ``git add -A''
~~~~~~~~~~~~~~~~~~~~
When accepting a new code drop for a vendor branch, you probably
want to record both the removal of paths and additions of new paths
as well as modifications of existing paths.
Typically you would first remove all tracked files from the working
tree using this command:
Submodules
~~~~~~~~~~
---8><---- 8><-------
I believe a command is missing here.
The explanation also leaves me scratching my head...
(In Fedora's git-1.7.7.6-1.fc16.x86_64 there is a command and some further
explanation).
--
Dr. Horst H. von Brand User #22616 counter.li.org
Departamento de Informatica Fono: +56 32 2654431
Universidad Tecnica Federico Santa Maria +56 32 2654239
Casilla 110-V, Valparaiso, Chile 2340000 Fax: +56 32 2797513
^ permalink raw reply [flat|nested] 3+ messages in thread
* [PATCH] docs: move submodule section
2012-11-14 18:15 v1.8.0-150-gb0b00a3: Weird documentation for git-rm Horst H. von Brand
@ 2012-11-14 18:49 ` Matt Kraai
2012-11-14 18:50 ` Matt Kraai
0 siblings, 1 reply; 3+ messages in thread
From: Matt Kraai @ 2012-11-14 18:49 UTC (permalink / raw)
To: git, gitster, Horst H. von Brand; +Cc: Matt Kraai
293ab15e ("submodule: teach rm to remove submodules unless they
contain a git directory", 2012-09-26) inserted the "Submodules"
section between a sentence describing a command and the command. Move
the "Submodules" section further down.
Signed-off-by: Matt Kraai <kraai@ftbfs.org>
---
Documentation/git-rm.txt | 30 +++++++++++++++---------------
1 files changed, 15 insertions(+), 15 deletions(-)
diff --git a/Documentation/git-rm.txt b/Documentation/git-rm.txt
index 882cb11..262436b 100644
--- a/Documentation/git-rm.txt
+++ b/Documentation/git-rm.txt
@@ -107,21 +107,6 @@ as well as modifications of existing paths.
Typically you would first remove all tracked files from the working
tree using this command:
-Submodules
-~~~~~~~~~~
-Only submodules using a gitfile (which means they were cloned
-with a git version 1.7.8 or newer) will be removed from the work
-tree, as their repository lives inside the .git directory of the
-superproject. If a submodule (or one of those nested inside it)
-still uses a .git directory, `git rm` will fail - no matter if forced
-or not - to protect the submodule's history.
-
-A submodule is considered up-to-date when the HEAD is the same as
-recorded in the index, no tracked files are modified and no untracked
-files that aren't ignored are present in the submodules work tree.
-Ignored files are deemed expendable and won't stop a submodule's work
-tree from being removed.
-
----------------
git ls-files -z | xargs -0 rm -f
----------------
@@ -149,6 +134,21 @@ use the following command:
git diff --name-only --diff-filter=D -z | xargs -0 git rm --cached
----------------
+Submodules
+~~~~~~~~~~
+Only submodules using a gitfile (which means they were cloned
+with a git version 1.7.8 or newer) will be removed from the work
+tree, as their repository lives inside the .git directory of the
+superproject. If a submodule (or one of those nested inside it)
+still uses a .git directory, `git rm` will fail - no matter if forced
+or not - to protect the submodule's history.
+
+A submodule is considered up-to-date when the HEAD is the same as
+recorded in the index, no tracked files are modified and no untracked
+files that aren't ignored are present in the submodules work tree.
+Ignored files are deemed expendable and won't stop a submodule's work
+tree from being removed.
+
EXAMPLES
--------
`git rm Documentation/\*.txt`::
--
1.7.2.5
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH] docs: move submodule section
2012-11-14 18:49 ` [PATCH] docs: move submodule section Matt Kraai
@ 2012-11-14 18:50 ` Matt Kraai
0 siblings, 0 replies; 3+ messages in thread
From: Matt Kraai @ 2012-11-14 18:50 UTC (permalink / raw)
To: git, gitster, Horst H. von Brand
On Wed, Nov 14, 2012 at 10:49:04AM -0800, Matt Kraai wrote:
> 293ab15e ("submodule: teach rm to remove submodules unless they
> contain a git directory", 2012-09-26) inserted the "Submodules"
> section between a sentence describing a command and the command. Move
> the "Submodules" section further down.
>
> Signed-off-by: Matt Kraai <kraai@ftbfs.org>
Sorry, I amended the patch to include a Reported-by line but forgot to
reformat it before sending. It should have included:
Reported-by: "Horst H. von Brand" <vonbrand@inf.utfsm.cl>
--
Matt Kraai
https://ftbfs.org/kraai
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2012-11-14 18:51 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-11-14 18:15 v1.8.0-150-gb0b00a3: Weird documentation for git-rm Horst H. von Brand
2012-11-14 18:49 ` [PATCH] docs: move submodule section Matt Kraai
2012-11-14 18:50 ` Matt Kraai
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).