Re: [RFC 01/10] submodule: add 'core.submodulesFile' to override the '.gitmodules' path
- From
Stefan Beller <sbeller@google.com>
- Date
- Apr 16, 2018, 21:22 UTC
- Message-ID
- <CAGZ79kajTdkPKpcjH3NXBE75qWnNCCq_OefAjQsw17hK_VEyCw@mail.gmail.com>
- In-Reply-To
- <20180416183742.032530a4d44faccd44189ea6@ao2.it>
On Mon, Apr 16, 2018 at 9:37 AM, Antonio Ospite <ao2@ao2.it> wrote:
Show 25 quoted lines
> On Thu, 12 Apr 2018 16:50:03 -0700
> Stefan Beller <sbeller@google.com> wrote:
>
>> Hi Antonio,
>>
>> On Thu, Apr 12, 2018 at 3:20 PM, Antonio Ospite <ao2@ao2.it> wrote:
>> > When multiple repositories with detached work-trees take turns using the
>> > same directory as their work-tree, and more than one of them want to use
>> > submodules, there will be conflicts about the '.gitmodules' file.
>>
>> unlike other files which would not conflict?
>> There might be file names such as LICENSE, Readme.md etc,
>> which are common enough that they would produce conflicts as well?
>> I find this argument on its own rather weak. ("Just delete everything in
>> the working dir before using it with another repository"). I might be
>> missing a crucial bit here?
>>
>
> All the vcsh repositories _share_ the same work-tree; they may control
> it taking turns but, in general, all files are meant to be checked out
> at all times as the basic use case is: *distinct* sets of config files.
>
> Maybe saying that the repositories "take turns" is confusing.
> It's an unnecessary information, so I will omit that part form the
> commit message.So they all have the same workdir, do they track the same set of files or do they track a disjoint set of files, and ignoring the other repositories files via the ignore mechanism?
This sounds like an interesting setup. I never though of that as something useful (in either configuration).
Show 11 quoted lines
> After your question I've done some research and I've seen other vcsh > users managing conflicting LICENSE and README files using git > sparse-checkouts, to have these files in the single repositories but > not checked out in the shared work-tree: > https://github.com/RichiH/vcsh/issues/120#issuecomment-42639619 > https://github.com/jwhitley/vcsh-root/commit/30b0d495c2cbe47ae9617ace9c2c14720d961d78 > > However I guess that my point here is that the gitmodules file is > something that influences git behavior so it should not be on the user's > shoulder to manage conflicts for it, and most importantly it needs to > be checked out for git to access it, doesn't it?
Good point! I wonder if the cleaner solution would be to just tell git to use HEAD:.gitmodules and not check out the file? then you would not need to come up with a namespace for names of the .gitmodules files and scatter them into the worktree as well?
Show 14 quoted lines
>> > - value=$(git config -f .gitmodules submodule."$name"."$option")
>> > + gitmodules_file=$(git config core.submodulesfile)
>> > + : ${gitmodules_file:=.gitmodules}
>> > + value=$(git config -f "$gitmodules_file" submodule."$name"."$option")
>>
>> I wonder if it would be cheaper to write a special config lookup now, e.g.
>> in builtin/submodule--helper.c we could have a "config-from-gitmodules"
>> subcommand that is looking up the modules file and then running the config
>> on that file.
>>
>
> Can you give an example from the user point of view of such a
> "config-from-gitmodules" command?
>git submodule config <name> <option>
as an 'alias' for
gitmodules_file=$(git config core.submodulesfile)
: ${gitmodules_file:=.gitmodules}
value=$(git config -f "$gitmodules_file"
submodule."$name"."$option")The helper would figure out which config file to load form (.gitmodules in tree, HEAD:.gitmodules, your new proposed gitmodules file, .git/config... or the special ref) and then return the <option> for <name>
So maybe:
$ git clone https://gerrit.googlesource.com/gerrit && cd gerrit
# ^ My goto-repo with submodules $ git submodule config "plugins/hooks" URL
../plugins/hooks> I might look into it, but that can also be a followup change.
Show 24 quoted lines
>> > diff --git a/submodule.c b/submodule.c
>> > index 9a50168b2..2afbdb644 100644
>> > --- a/submodule.c
>> > +++ b/submodule.c
>> > @@ -36,13 +36,13 @@ static struct oid_array ref_tips_after_fetch;
>> > */
>> > int is_gitmodules_unmerged(const struct index_state *istate)
>> > {
>> > - int pos = index_name_pos(istate, GITMODULES_FILE, strlen(GITMODULES_FILE));
>> > + int pos = index_name_pos(istate, submodules_file, strlen(submodules_file));
>>
>> Ah, regarding the coverletter: This clearly assumes the modules
>> file is in the tree. So at least here we would make an exception
>> for files outside the tree to either not check for un-merged-ness or
>> disallow that case entirely.
>>
>
> Sorry I am not sure I follow what you are saying here, keep in mind
> that I am new to git internals.
>
> Do you mean that, even if we ensure (in
> config.c::git_default_core_config) that only paths relative to
> the work-tree are allowed, we still have to check here that the
> constraint is respected? And is so, why?index_name_pos looks up a position of a file in the index, which would fail for any file not in the index.
So if we give a path outside the tree, the lookup would fail and we'd treat it as no .gitmodules file would be found, which implies is_gitmodules_unmerged = false.
That sounds about right, but I think we could make the distinction clearer, i.e. out-of-tree .gitmodule files *cannot* be "unmerged" as that requires them to be part of a git repository with a merge in progress.
Show 9 quoted lines
>> There are quite a few functions in submodule.c which access the new global. :/ >> So moving them to the_repository should be fine, but eventually (not >> in this series) >> all these functions would would want to take a repository argument as well >> such that they work on more than the_repository. >> > > I will surely get rid of the global variable, but about changing the > functions signatures I don't feel like promising anything just yet.
Yes, I would just use the_repository->... for now and as said by "(not in this series)" we can do that later. It was more of a reminder to myself, sorry for the confusion.
Thanks, Stefan