git-submodule - Интернет в облаке

ПРОГРАММА:

ИМЯ

git-submodule - Инициализирует, обновляет или проверяет подмодули

СИНТАКСИС

мерзавец подмодуль [--quiet] добавить [-b ] [-f | --force] [--name ]
[--ссылка ] [--глубина ] [-] [ ]
мерзавец подмодуль [--quiet] status [--cached] [--recursive] [-] [ ...]
мерзавец подмодуль [--quiet] init [-] [ ...]
мерзавец подмодуль [--quiet] deinit [-f | --force] [-] ...
мерзавец подмодуль [--quiet] update [--init] [--remote] [-N | --no-fetch]
[-f | --force] [--rebase | --merge] [--reference ]
[--глубина ] [--рекурсивный] [-] [ ...]
мерзавец подмодуль [--quiet] сводка [--cached | --files] [(-n | --summary-limit) ]
[совершить] [--] [ ...]
мерзавец подмодуль [--quiet] foreach [--recursive]
мерзавец подмодуль [--quiet] sync [--recursive] [-] [ ...]

ОПИСАНИЕ

Проверяет, обновляет и управляет подмодулями.

Подмодуль позволяет хранить другой репозиторий Git в подкаталоге вашего
репозиторий. Другой репозиторий имеет свою историю, которая не мешает работе
история текущего репозитория. Это можно использовать для внешних зависимостей, таких как
например сторонние библиотеки.

Однако при клонировании или извлечении репозитория, содержащего подмодули, они не будут
извлечено по умолчанию; в инициализации и обновление подкоманды будут поддерживать подмодули проверенными
вне и при соответствующей ревизии в вашем рабочем дереве.

Подмодули состоят из так называемой записи дерева gitlink в основном репозитории, которая
относится к конкретному объекту фиксации во внутреннем репозитории, который полностью
отдельный. Запись в .gitmodules (см. gitmodules(5)) файл в корне источника
tree присваивает подмодулю логическое имя и описывает URL-адрес по умолчанию для подмодуля.
должен быть клонирован из. Логическое имя может использоваться для переопределения этого URL в вашем
конфигурация локального репозитория (см. подмодуль инициализации).

Подмодули не следует путать с пультами, которые являются другими репозиториями того же
проект; подмодули предназначены для разных проектов, которые вы хотели бы сделать частью своей
дерево исходных текстов, в то время как история двух проектов по-прежнему остается полностью независимой и
вы не можете изменять содержимое подмодуля из основного проекта. Если хочешь
объединить истории проекта и рассматривать агрегированное целое как единый проект.
с этого момента вы можете захотеть добавить пульт для другого проекта и использовать поддерево слияние
стратегия, вместо того, чтобы рассматривать другой проект как подмодуль. Каталоги из
оба проекта могут быть клонированы и извлечены как единое целое, если вы решите пойти по этому пути.

КОМАНДЫ

Добавить
Добавить данный репозиторий как подмодуль по указанному пути к набору изменений, который будет
зафиксировано рядом с текущим проектом: текущий проект называется
«суперпроект».

Для этого требуется хотя бы один аргумент: . Необязательный аргумент это
относительное расположение клонированного подмодуля в суперпроекте. Если является
не указано, используется "гуманная" часть исходного репозитория ("репо" для
"/path/to/repo.git" и "foo" вместо "host.xz: foo / .git"). В также используется как
логическое имя подмодуля в его записях конфигурации, если --name не используется для указания
логичное имя.

- это URL-адрес исходного репозитория нового подмодуля. Это может быть либо
абсолютный URL или (если он начинается с ./ или ../) расположение относительно
исходный репозиторий суперпроекта (обратите внимание, что для указания репозитория foo.git
который находится рядом с суперпроектом бар.git, вам придется использовать ../foo.git
вместо ./foo.git - как и следовало ожидать, следуя правилам относительных URL-адресов
- поскольку оценка относительных URL-адресов в Git идентична оценке относительных
каталоги). Если суперпроект не имеет источника, настроенный суперпроект
является его собственным авторитетным апстримом, и вместо него используется текущий рабочий каталог.

- относительное расположение клонированного подмодуля в суперпроекте.
Если не существует, то подмодуль создается путем клонирования из указанного URL.
Если существует и уже является действующим репозиторием Git, затем он добавляется в
набор изменений без клонирования. Эта вторая форма предназначена для упрощения создания нового
подмодуль с нуля, и предполагает, что пользователь позже отправит подмодуль в
данный URL.

В любом случае указанный URL записывается в .gitmodules для использования последующими пользователями.
клонирование суперпроекта. Если URL указан относительно суперпроекта
репозиторий, предполагается, что репозитории суперпроекта и подмодулей будут
хранятся вместе в одном и том же относительном местоположении, и только URL-адрес суперпроекта должен
быть предоставленным: git-submodule правильно найдет подмодуль, используя относительный URL
в .gitmodules.

статус
Показать статус субмодулей. Это напечатает SHA-1 текущего проверенного
out коммит для каждого подмодуля, а также путь к подмодулю и вывод мерзавец
описывать для SHA-1. Каждый SHA-1 будет иметь префикс - если субмодуль не
инициализировано, + если текущий извлеченный подмодуль фиксации не соответствует SHA-1
найдено в индексе содержащего репозитория и U, если подмодуль имеет слияние
конфликты.

Если указан --recursive, эта команда будет рекурсивна во вложенные подмодули, и
показать их статус.

Если вас интересуют только изменения инициализированных в настоящее время подмодулей с
относительно фиксации, записанной в индексе или HEAD, git-статус(1) и git-diff(1)
также предоставит эту информацию (а также может сообщить об изменениях в работе подмодуля
дерево).

инициализации
Инициализируйте подмодули, записанные в индекс (которые были добавлены и зафиксированы
в другом месте), скопировав имена и URL-адреса подмодулей из .gitmodules в .git / config.
По желанию аргументы ограничивают, какие подмодули будут инициализированы. Это также будет
скопируйте значение submodule. $ name.update в .git / config. Ключ, используемый в .git / config
это подмодуль. $ name.url. Эта команда не изменяет существующую информацию в
.git / config. Затем вы можете настроить URL-адреса клонов подмодулей в .git / config для вашего
локальная настройка и переход к обновлению подмодуля git; вы также можете просто использовать подмодуль git
update --init без явного инициализации шаг, если вы не собираетесь настраивать какие-либо
расположение подмодулей.

деинит
Отмените регистрацию данных подмодулей, т.е. удалите весь раздел submodule. $ Name из
.git / config вместе со своим деревом работы. Дальнейшие вызовы обновления подмодуля git, git
submodule foreach и git submodule sync пропустят все незарегистрированные подмодули до тех пор, пока
они снова инициализируются, поэтому используйте эту команду, если вы не хотите иметь локальный
проверка подмодуля в вашем рабочем дереве больше. Если вы действительно хотите удалить
подмодуль из репозитория и зафиксируйте, что используют git-rm(1) вместо этого.

Если указан --force, дерево работы подмодуля будет удалено, даже если оно содержит
местные модификации.

обновление
Обновите зарегистрированные подмодули, чтобы они соответствовали ожиданиям суперпроекта путем клонирования.
отсутствие подмодулей и обновление рабочего дерева подмодулей. «Обновление» может
можно сделать несколькими способами в зависимости от параметров командной строки и значения
подмодуль. .update переменная конфигурации. Поддерживаемые процедуры обновления:

контроль
фиксация, записанная в суперпроекте, будет проверена в подмодуле на
ОТДЕЛЕННАЯ ГОЛОВА. Это делается, если задана опция --checkout или нет опции
данный и подмодуль. .update не настроен, или если для него установлено значение контроль.

Если указан --force, подмодуль будет извлечен (с помощью git checkout
--force, если необходимо), даже если фиксация указана в индексе
содержащий репозиторий, уже соответствует фиксации, извлеченной в подмодуле.

перебазировать
текущая ветвь подмодуля будет перебазирована на фиксацию, записанную в
суперпроект. Это делается, когда задана опция --rebase или нет опции
данный и подмодуль. .update установлен на перебазировать.

слияние
коммит, записанный в суперпроекте, будет объединен с текущей веткой в
подмодуль. Это делается, когда задана опция --merge или не задана никакая опция,
и подмодуль. .update установлен на слияние.

настраиваемая команда
произвольная команда оболочки, которая принимает единственный аргумент (sha1 фиксации
записано в суперпроекте). Это делается, когда не указано иное,
и подмодуль. .update имеет вид ! команда.

Когда не указано ни одной опции и submodule. .update установлен на никто, подмодуль
не обновляется.

Если подмодуль еще не инициализирован, и вы просто хотите использовать настройку как
хранится в .gitmodules, вы можете автоматически инициализировать подмодуль с помощью --init
опцию.

Если указан --recursive, эта команда будет рекурсивна в зарегистрированные подмодули,
и обновите все вложенные подмодули внутри.

резюме
Показать сводку фиксации между данной фиксацией (по умолчанию HEAD) и работой
дерево / индекс. Для рассматриваемого подмодуля серия коммитов в подмодуле между
фиксация данного суперпроекта и индекс или рабочее дерево (переключается с помощью --cached)
показаны. Если задана опция --files, показать серию коммитов в подмодуле
между индексом суперпроекта и рабочим деревом подмодуля (это
параметр не позволяет использовать параметр --cached или предоставить явную фиксацию).

Используя параметр --submodule = log с git-diff(1) также предоставит эту информацию.

Еогеасп
Оценивает произвольную команду оболочки в каждом извлеченном подмодуле. Команда имеет
доступ к переменным $ name, $ path, $ sha1 и $ toplevel: $ name - это имя
соответствующий раздел подмодуля в .gitmodules, $ path - это имя подмодуля
относительно суперпроекта, $ sha1 - это фиксация, записанная в
superproject, а $ toplevel - это абсолютный путь к верхнему уровню суперпроекта.
Любые подмодули, определенные в суперпроекте, но не извлеченные, игнорируются этим
команда. Если не задано --quiet, foreach печатает имя каждого подмодуля перед
оценка команды. Если задано --recursive, подмодули просматриваются рекурсивно.
(т.е. данная команда оболочки также оценивается во вложенных подмодулях). Ненулевой
возврат из команды в любом подмодуле приводит к прекращению обработки. Это может
быть отменено добавлением || : до конца команды.

Например, git submodule foreach 'echo $ path `git rev-parse HEAD`' покажет
path и в настоящее время извлечен коммит для каждого подмодуля.

синхронизировать
Синхронизирует настройку конфигурации удаленного URL-адреса подмодулей со значением, указанным в
.gitmodules. Это повлияет только на те подмодули, в которых уже есть URL-адрес в
.git / config (это тот случай, когда они инициализированы или только что добавлены). Это
полезно, когда URL-адреса субмодулей изменяются в восходящем направлении, и вам необходимо обновить локальный
репозитории соответственно.

«git submodule sync» синхронизирует все подмодули, а «git submodule sync - A»
синхронизирует только подмодуль «А».

Если указан --recursive, эта команда будет рекурсивна в зарегистрированные подмодули,
и синхронизировать любые вложенные подмодули внутри.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-к, --тишина
Распечатывайте только сообщения об ошибках.

-б, --ветвь
Ветвь репозитория, которую нужно добавить как подмодуль. Название отделения записывается как
подмодуль. .branch в .gitmodules для обновления --remote.

-ф, --сила
Эта опция действительна только для команд add, deinit и update. При запуске добавления разрешите
добавление игнорируемого в противном случае пути подмодуля. При запуске deinit подмодуль работает
деревья будут удалены, даже если они содержат локальные изменения. При запуске обновления (только
эффективен с процедурой проверки), отбросьте локальные изменения в подмодулях, когда
переключение на другой коммит; и всегда запускать операцию проверки в подмодуле,
даже если фиксация, указанная в индексе содержащего репозитория, совпадает с фиксацией
выписано в подмодуле.

--кешированный
Эта опция действительна только для команд состояния и сводки. Эти команды обычно
использовать фиксацию, найденную в подмодуле HEAD, но с этой опцией фиксация сохраняется в
вместо него используется индекс.

--файлы
Эта опция действительна только для сводной команды. Эта команда сравнивает фиксацию в
индекс с индексом в подмодуле HEAD, когда используется эта опция.

-n, --summary-limit
Эта опция действительна только для сводной команды. Ограничьте размер сводки (количество
всего показано коммитов). Установка 0 отключит сводку; отрицательное число означает
неограниченно (по умолчанию). Это ограничение применяется только к измененным субмодулям. Размер
всегда ограничен 1 для добавленных / удаленных / измененных подмодулей.

--дистанционный пульт
Эта опция действительна только для команды обновления. Вместо использования суперпроекта
записанный SHA-1 для обновления подмодуля, используйте статус подмодуля
ветка удаленного отслеживания. Используемый пульт - это удаленный ветвь (branch. .удаленный),
по умолчанию на происхождение. Удаленная ветка по умолчанию использовала как master, но имя ветки
может быть отменено установкой подмодуля. .branch вариант в .gitmodules
или .git / config (с приоритетом .git / config).

Это работает для любой из поддерживаемых процедур обновления (--checkout, --rebase и т. Д.).
Единственное изменение - это источник целевого SHA-1. Например, обновление подмодуля
--remote --merge объединит изменения подмодулей восходящего потока с подмодулями, в то время как
submodule update --merge объединит изменения суперпроекта gitlink в подмодули.

Чтобы гарантировать текущее состояние ветки отслеживания, update --remote извлекает
удаленного репозитория подмодуля перед вычислением SHA-1. Если ты не хочешь
fetch, вы должны использовать обновление подмодуля --remote --no-fetch.

Используйте эту опцию, чтобы интегрировать изменения из подпроекта восходящего потока с вашим
текущий подмодуль HEAD. В качестве альтернативы вы можете запустить git pull из подмодуля,
что эквивалентно, за исключением имени удаленной ветки: update --remote использует
исходный репозиторий и подмодуль по умолчанию. .branch, а git pull использует
ветвь подмодуля. .merge. Предпочитаю подмодуль. .branch, если вы хотите
распространить исходную ветвь по умолчанию с суперпроектом и ветвью. .merge
если вы хотите более естественного ощущения при работе с самим подмодулем.

-N, --no-fetch
Эта опция действительна только для команды обновления. Не извлекайте новые объекты из
удаленный сайт.

--проверить
Эта опция действительна только для команды обновления. Проверить фиксацию, записанную в
суперпроект на отдельной HEAD в подмодуле. Это поведение по умолчанию,
основное использование этой опции - переопределить подмодуль. $ name.update, если установлено значение
кроме оформления заказа. Если ключевой подмодуль. $ Name.update либо не установлен явно, либо
установлен на checkout, эта опция неявная.

- объединить
Эта опция действительна только для команды обновления. Объедините фиксацию, записанную в
суперпроект в текущую ветку подмодуля. Если указана эта опция,
HEAD подмодуля не будет отсоединен. Если сбой слияния препятствует этому процессу, вы
придется разрешать возникающие конфликты внутри подмодуля с помощью обычных
инструменты разрешения конфликтов. Если ключевой submodule. $ Name.update настроен на слияние, это
опция неявная.

--rebase
Эта опция действительна только для команды обновления. Перебазируйте текущую ветку на
коммит записан в суперпроект. Если задана эта опция, HEAD подмодуля
не будет отделяться. Если сбой слияния препятствует этому процессу, вам придется
разрешить эти сбои с помощью git-перебазировать(1). Если для ключевого submodule. $ Name.update установлено значение
rebase, этот параметр неявный.

--в этом
Эта опция действительна только для команды обновления. Инициализировать все подмодули, для которых
"git submodule init" до обновления не вызывался.

--имя
Эта опция действительна только для команды добавления. Он устанавливает имя подмодуля на
заданная строка вместо пути по умолчанию. Имя должно быть действительным как каталог
имя и не может заканчиваться /.

--ссылка
Эта опция действительна только для команд добавления и обновления. Эти команды иногда требуют
клонировать удаленный репозиторий. В этом случае эта опция будет передана в мерзавец
клонировать(1) команда.

ЗАМЕТКА: Делать не используйте эту опцию, если вы не прочитали примечание для git-клон(1)
--reference и --shared внимательно.

- рекурсивный
Эта опция действительна только для команд foreach, update, status и sync. Траверс
подмодули рекурсивно. Операция выполняется не только в подмодулях модуля
текущее репо, но также и во всех вложенных подмодулях внутри этих подмодулей (и так далее).

--глубина
Эта опция действительна для команд добавления и обновления. Создать мелкий клон с
история усечена до указанного количества ревизий. Видеть git-клон(1)

...
Пути к подмодулям. Если указано, это ограничит команду только работать
на подмодулях, найденных по указанным путям. (Этот аргумент требуется при добавлении).

Используйте git-submodule онлайн с помощью сервисов onworks.net