git submodule update - why from toplevel

Question

I've always been puzzled by this:

$ git submodule
You need to run this command from the toplevel of the working tree.

Why do I need to run it from the top level directory? Is it a technical reason, or just because of a convention / possible flaw ?

Community · Accepted Answer · 2017-05-23 12:28:43Z

2

Note: since git 1.8.4 (August 2013), and commit 091a6eb, you don't have to be at top-level to run git submodule update.
This is because git rev-parse has a new --prefix option.

--prefix <arg>

Behave as if git rev-parse was invoked from the <arg> subdirectory of the working tree.
Any relative filenames are resolved as if they are prefixed by <arg> and will be printed in that form.

That same limitation is gone for git submodule add as well.

edited May 23, 2017 at 12:28

CommunityBot

11 silver badge

answered Feb 18, 2014 at 14:21

VonC

1.4m569 gold badges4.8k silver badges5.7k bronze badges

Sign up to request clarification or add additional context in comments.

Collectives™ on Stack Overflow

git submodule update - why from toplevel

1 Answer 1

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related