Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/motemen/git-shared-submodule-update


https://github.com/motemen/git-shared-submodule-update

Last synced: 3 days ago
JSON representation

Awesome Lists containing this project

README

        

git-shared-submodule-update(1)
==============================

NAME
----

git-shared-submodule-update - Faster submodule-update by sharing .git directories

SYNOPSIS
--------
[verse]
'git shared-submodule-update' [--init] [--no-dissociate] []

DESCRIPTION
-----------

Simply does submodule-update but faster by `--reference` and locally cached repositories.

On shared-submodule-update, the submodule's remote repository is cloned to a
shared repository under `~/.git-shared-submodule` (configurable) first.

Then
the submodule is updated by `git submodule update` with `--reference` pointing
to the shared repo, making submodule-update faster if you are using same
submodule among many repositories.

OPTIONS
-------
--init::
Passed to `git submodule update`.

--no-dissociate::
By default shared-submodule-update passes `--dissociate` to
submodule-update. This option supresses this behavior.
+
*NOTE*: Do *not* use this option unless you have read the note
for git-clone's `--reference`, `--shared`, and `--dissociate`
options carefully.

CONFIGURATION
-------------

shared-submodule.root::
The directory under which the shared repositories are cloned. Defaults
to `~/.git-shared-submodule`. Can be overridden by environment
variable `GIT_SHARED_SUBMODULE_ROOT`.

AUTHOR
------
Written by motemen