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

ПРОГРАММА:

ИМЯ

stg - Управление стопками патчей с помощью трекера содержимого Git.

СИНТАКСИС

СТГ [--version | --помощь]
СТГ [--помощь | --помощь]
СТГ [ВАРИАНТЫ КОМАНД] [АРГМЕНТЫ]

ОПИСАНИЕ

StGit (Stacked Git) - это приложение, которое обеспечивает удобный способ поддержки заплата
стек поверх ветки Git:

· Самым верхним (самым последним) коммитам ветки присваиваются имена. Такая именованная фиксация
называется заплата.

· После внесения изменений в рабочее дерево вы можете включить изменения в существующий
пластырь; это называется освежающий. Вы можете обновить любой патч, а не только самый верхний.

· Вы можете поп патч: временно отложите его, чтобы патч под ним стал
самый верхний патч. Позже вы можете протолкнуть. его снова в стек. Толкать и хлопать можно
использоваться для изменения порядка исправлений.

· Вы легко можете перебазировать ваш стек патчей поверх любого другого коммита Git. (В Использование темпера с изогнутым основанием в А
стек патчей - это самый последний коммит Git, который не является патчем StGit.) Например, если
вы начали делать патчи поверх чужой ветки, и этот человек публикует
обновленная ветка, вы можете взять все свои патчи и применить их поверх обновленных
филиал.

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

· Стек патчей - это просто дополнительные метаданные, прикрепленные к обычным коммитам Git, поэтому вы
может продолжать использовать большинство инструментов Git вместе со StGit.

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

Команды, представляющие интерес в этом рабочем процессе, например, rebase и mail.

Отделение развития
Даже если у вас нет «апстрима» для отправки патчей, вы можете использовать StGit как удобный
способ изменить недавнюю историю ветки Git. Например, вместо первого
совершение изменений Aзатем поменяй B, а затем A2 исправить A потому что это было не совсем
правильно, вы можете включить исправление прямо в A. Такой способ работы приводит к
гораздо более читаемую историю Git, чем если бы вы увековечили каждую ошибку, которую сделали
ваш путь к правильному решению.

Команды, представляющие интерес в этом рабочем процессе, например, uncommit, которые можно использовать для перемещения
база стека патчей вниз - то есть превратить Git коммиты в патчи StGit постфактум
- и совершаем обратное.
Для получения дополнительной информации см. учебник[1].

Указание патчи
Многие команды StGit принимают в качестве аргументов ссылки на патчи StGit. Патчи в стеке
идентифицируются короткими именами, каждое из которых должно быть уникальным в стеке.

Патчи в текущей ветке просто называются по имени. Некоторые команды позволяют
указать патч в другой ветке репозитория; это делается путем добавления префикса
имя патча с именем ветки и двоеточием (например, otherbranch: thatpatch).

Указание совершает
Некоторые команды StGit принимают коммиты Git в качестве аргументов. StGit принимает все выражения фиксации
что делает Git; и, кроме того, имя патча (необязательно с префиксом из имени ветки и
двоеточие) разрешено в этом контексте. Также разрешены обычные модификаторы Git ^ и ~; например,
abranch: apatch ~ 2 является прародителем коммита, который является патчем apatch на ветке
филиал.

Вместо имени патча вы можете сказать {base} для обозначения базы стека (фиксация просто
ниже самого нижнего патча); Итак, abranch: {base} - это основание стека в ветке
филиал.

Если вам нужно передать данную ссылку StGit команде Git, stg-id(1) преобразует его в
идентификатор фиксации Git для вас.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Доступны следующие общие флаги опций. Дополнительные опции доступны для
(и задокументированы) различными подкомандами.

--версия
Печатает версию StGit, а также версию других используемых компонентов, таких как Git и
Python.

--Помогите
Печатает синопсис и список всех подкоманд. Если дана подкоманда StGit,
печатает синпозицию для этой подкоманды.

СТГИТ КОМАНДЫ

Мы делим команды StGit на тематические группы, в зависимости от основного типа объекта, который они
создать или изменить.

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

Репозиторий команды
stg-клон(1)
Сделайте локальный клон удаленного репозитория

stg-id(1)
Распечатайте хеш-значение git ссылки StGit

Стек (филиал) команды
stg-ветка(1)
Операции веток: переключение, список, создание, переименование, удаление, ...

стг-чистый(1)
Удалите пустые патчи в серии

stg-фиксация(1)
Постоянно храните примененные патчи в базе стека.

stg-поплавок(1)
Сдвиньте патчи вверх, даже если они наложены

стг-гото(1)
Вставьте или вставьте патчи в заданный

stg-скрыть(1)
Скрыть патч в сериале

stg-инициализация(1)
Инициализировать текущую ветку для использования с StGIT

stg-журнал(1)
Показать журнал изменений патча

stg-следующий(1)
Вывести название следующего патча

stg-патчи(1)
Показать примененные патчи, изменяющие файл

стг-поп(1)
Извлечь один или несколько патчей из стека

stg-предыдущий(1)
Вывести название предыдущего патча

stg-публикация(1)
Отправьте изменения стека в удобную для слияния ветку

stg-pull(1)
Получение изменений из удаленного репозитория

stg-push(1)
Вставьте один или несколько патчей в стек

stg-rebase(1)
Переместите базу стека в другую точку истории

stg-повторить(1)
Отменить последнюю операцию отмены

stg-ремонт(1)
Исправить метаданные StGit, если ветка была изменена с помощью команд git

stg-сброс(1)
Сбросить стек патчей в более раннее состояние

stg-серия(1)
Распечатать серию патчей

stg-раковина(1)
Отправляйте патчи глубже в стек

stg-сквош(1)
Сдавите два или более патча в один

стг-топ(1)
Напечатайте название верхнего патча

stg-отменить фиксацию(1)
Превратите обычные коммиты git в патчи StGit

stg-отмена(1)
Отменить последнюю операцию

stg-показать(1)
Показать скрытый патч

Патчи команды
stg-удалить(1)
Удалить патчи

stg-редактировать(1)
Отредактируйте описание патча или разницу

stg-экспорт(1)
Экспорт патчей в каталог

stg-файлы(1)
Показать файлы, измененные патчем (или текущим патчем)

stg-складка(1)
Интегрировать патч GNU diff в текущий патч

stg-импорт(1)
Импортируйте файл различий GNU как новый патч

stg-mail(1)
Отправить патч или серию патчей по электронной почте

stg-новый(1)
Создайте новый пустой патч

stg-выбрать(1)
Импортировать патч из другой ветки или объекта фиксации

stg-обновить(1)
Создать новую фиксацию для текущего патча

stg-переименовать(1)
Переименовать патч

stg-шоу(1)
Показать фиксацию, соответствующую патчу

stg-синхронизация(1)
Синхронизировать патчи с веткой или серией

Индекс / рабочее дерево команды
stg-diff(1)
Показать разницу в дереве

КОНФИГУРАЦИЯ МЕХАНИЗМ

StGit использует тот же механизм настройки, что и Git. Видеть мерзавец(7) для получения более подробной информации.

ШАБЛОНЫ

Ряд команд StGit используют файлы шаблонов для предоставления полезных текстов по умолчанию для
может редактироваться пользователем. Эти Файлы шаблонов .tmpl ищутся в следующих
каталоги:

1. $ GITDIR / (на практике каталог .git / в вашем репозитории)

2. $ HOME / .stgit / templates /

3. / usr / share / stgit / templates /

ПРИМЕЧАНИЯ

1. учебник
[установить $ man.base.url.for.relative.links] /tutorial.html

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