Unable to track files within Git submodules
Problem: to add files at ./shells/smallApps/*
to Git at ./.git/
when I do not have the files at ./.git/info/exclude
nor at any .gitignore
-files.
This question is based on this tread where the problem is not solved completely.
I run
$git status ~/bin
# On branch master
nothing to commit (working directory clean)
$git ls-files ~/bin
Screen/dev/vim-open.screen
--- cut ---
I note that I do not have the files "shells/smallApps/*" at my Git
$ls shells/smallApps/ ~/bin
devTodo extract
~/bin
I want to add them to my Git by running
$git add shells/smallApps/devTodo shells/smallApps/extract
fatal: Path 'shells/smallApps/devTodo' is in submodule 'shells/smallApps'
$git add .
I note that the files are not added to my Git for some reason such that
$git status ~/bin
# On branch master
nothing to commit (working directory clean)
I do not have the files at .git/info/exclude nor at .gitignore -files.
What does the last warning mean?
UPDATE
There are two general reasons why Git will ignore a file: gitignore
and submodules
.
To be more specific, the following conditions will cause Git to ignore a file when ' git add
' is invoked:
$GIT_DIR/exclude
. .gitignore
file inside the repo. .gitignore
file (specified by ' git config --global core.excludesfile
'). Forcing ' git add
' on an ignored file:
You can check to see if a particular file is ignored by invoking ' git add full/path/to/file
'.
The man page states that "If an ignored file is explicitly specified on the command line, the command will fail with a list of ignored files."
If the file is ignored, you can force it to be added with ' git add --force full/path/to/file
'.
Instructions to eliminate a submodule reference:
As noted in a previous answer, shells/smallApps
is a submodule in your repository.
If the file is part of a submodule, the situation is more complex. You cannot modify the contents of the submodule from within the main project.
If you want to eliminate the submodule reference and directly track the files in your main repo, there are several steps that must be performed. You cannot simply remove the ".git" directory from the submodule. There are three links between your main repository and the submodule:
.gitmodules
file in your main repo. .git/config
of your main repo. Per this related SO question, you need to perform the following steps to completely remove the sub-module:
NOTE: If another branch depends on this submodule, then removing it can corrupt your repository! This is a dangerous operation...use with caution.
.gitmodules
file. .git/config
. git rm --cached path_to_submodule
(no trailing slash). The files that were part of the submodule are now untracked and you may decide to keep or delete them as desired (with the one caveat mentioned below).
If you don't need these files, you may simply delete them.
Caveat: If you want to keep these files (which you appear to want), you must manually remove the .git
directory from the submodule folder:
cd path_to_submodule
rm .git
cd ..
git add path_to_submodule
git status
git commit
UPDATE:
Request for further information:
To assist debugging this issue, please post the output of the following complete session of commands:
cd to the top-level directory in your repo
ls -al
cat .git/config
find . -name ".git*"
git status
git add editors
git add shells
git status
Based on the description of what you have done so far, I expect to see:
.gitmodules
file anywhere .git
directory (found at the root of your repo) .git
directory in editors/vim/vimdoclet
.git
directory in shells/smallApps
I see you've got git add
saying something about submodules. Do you have nested Git repositories? Do this:
$ find . -name .git
How many .git
directories are listed? If there is more than one, then you've got multiple nested repositories and that could be a cause of some of this confusion.
You should consider posting this question to the Git mail list ( git@vger.kernel.org
). You will likely get a more prompt and complete response.
If you do decide to post there, be sure to include:
ls -al
cat .git/config
find . -name ".git*"
git status
git add editors
git add shells
git status
下一篇: 无法跟踪Git子模块内的文件