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

ПРОГРАММА:

ИМЯ

git-commit - Записывает изменения в репозиторий

СИНТАКСИС

мерзавец совершать [-a | - интерактивный | --patch] [-s] [-v] [-u ] [--исправлять]
[--dry-run] [(-c | -C | --fixup | --squash) ]
[-F | -м ] [--reset-author] [--allow-empty]
[--allow-empty-message] [--no-verify] [-e] [--author = ]
[--date = ] [--cleanup = ] [--[нет положения]
[-i | -Операционные системы[ ]] [-] [ ...]

ОПИСАНИЕ

Сохраняет текущее содержимое индекса в новой фиксации вместе с сообщением журнала из
пользователь, описывающий изменения.

Добавляемый контент можно указать несколькими способами:

1. с помощью мерзавец Добавить для постепенного «добавления» изменений в индекс перед использованием совершать
команда (Примечание: даже измененные файлы должны быть «добавлены»);

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

3. перечисляя файлы в качестве аргументов совершать команда, и в этом случае фиксация будет
игнорировать изменения, внесенные в индекс, и вместо этого записывать текущее содержимое
перечисленные файлы (которые уже должны быть известны Git);

4. с помощью переключателя -a с совершать команда для автоматического "добавления" изменений из всех
известные файлы (то есть все файлы, которые уже перечислены в индексе) и автоматически
"rm" файлы в индексе, которые были удалены из рабочего дерева, а затем выполнить
фактическая фиксация;

5. с помощью переключателей --interactive или --patch с совершать команда, чтобы решить один
тем, какие файлы или фрагменты должны быть частью фиксации, перед завершением
операция. См. Раздел «Интерактивный режим» в git-добавить(1) научиться работать
эти режимы.

Параметр --dry-run может использоваться для получения сводной информации о том, что включено в любой из
выше для следующего коммита, задав тот же набор параметров (параметры и пути).

Если вы совершите фиксацию, а затем сразу после этого обнаружите ошибку, вы можете восстановить
это с мерзавец сброс.

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

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

-p, --патч
Используйте интерактивный интерфейс выбора патчей, чтобы выбрать, какие изменения следует зафиксировать. Видеть
git-добавить(1) для подробностей.

-C , --reuse-message =
Возьмите существующий объект фиксации и повторно используйте сообщение журнала и авторство
информация (включая временную метку) при создании фиксации.

-c , --reedit-message =
Подобно -C, но с -c вызывается редактор, чтобы пользователь мог дальше редактировать
зафиксировать сообщение.

--fixup =
Создайте сообщение фиксации для использования с rebase --autosquash. Сообщение фиксации будет
быть темой указанного коммита с префиксом «fixup!». Видеть мерзавец
перебазировать(1) для подробностей.

--squash =
Создайте сообщение фиксации для использования с rebase --autosquash. Сообщение фиксации
строка темы взята из указанного коммита с префиксом «сквош!». Может быть
используется с дополнительными параметрами сообщения фиксации (-m / -c / -C / -F). Видеть git-перебазировать(1) для
Детали.

--reset-автор
При использовании с -C / -c / - параметры исправления или при фиксации после конфликтующего
cherry-pick, заявляем, что авторство получившегося коммита теперь принадлежит
коммиттер. Это также обновляет метку времени автора.

--короткая
При выполнении пробного прогона дайте результат в кратком формате. Видеть git-статус(1) для
Детали. Подразумевает --dry-run.

--ветвь
Показывать информацию о ветке и отслеживании даже в сокращенном формате.

--фарфор
Выполняя пробный прогон, дайте результат в формате, готовом для фарфора. Видеть git-статус(1)
для подробностей. Подразумевает --dry-run.

--длинный
При выполнении пробного прогона дайте результат в длинном формате. Подразумевает --dry-run.

-з, --нуль
При отображении короткого или фарфорового вывода состояния завершите записи в выводе состояния.
с NUL вместо LF. Если формат не указан, подразумевается выходной формат --porcelain.

-F , --file =
Возьмите сообщение фиксации из данного файла. Использовать - прочитать сообщение из
стандартный ввод.

--author =
Заменить автора фиксации. Укажите явного автора, используя стандартный AU Thor
<[электронная почта защищена]> формат. Иначе считается шаблоном и используется
для поиска существующей фиксации этого автора (например, rev-list --all -i
--author = ); затем автор фиксации копируется из первой найденной такой фиксации.

--date =
Заменить дату автора, используемую в коммите.

-м , --сообщение =
Используйте данный как сообщение фиксации. Если указано несколько параметров -m, их
значения объединяются в отдельные абзацы.

-t , --template =
При редактировании сообщения фиксации запустите редактор с содержимым данного файла.
Переменная конфигурации commit.template часто используется для предоставления этой опции
неявно к команде. Этот механизм может использоваться проектами, которые хотят направлять
подсказывают участникам, что и в каком порядке писать в сообщении. Если
пользователь выходит из редактора без редактирования сообщения, фиксация прерывается. Это не имеет
действует, когда сообщение передается другими способами, например, с опциями -m или -F.

-s, --signoff
Добавьте строку Signed-off-by коммиттера в конец сообщения журнала фиксации. В
значение подписи зависит от проекта, но обычно он удостоверяет, что коммиттер
имеет право представить эту работу под той же лицензией и соглашается с Разработчиком
Сертификат происхождения (см. http://developercertificate.org/ Для получения дополнительной информации).

-n, --no-проверить
Эта опция обходит перехватчики pre-commit и commit-msg. Смотрите также гитхуки(5).

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

--allow-empty-сообщение
Как и --allow-empty, эта команда предназначена в первую очередь для использования в сценариях внешнего интерфейса SCM.
Это позволяет вам создать фиксацию с пустым сообщением фиксации без использования сантехники.
такие команды, как git-коммит-дерево(1).

--cleanup =
Эта опция определяет, как предоставленное сообщение фиксации должно быть очищено перед
совершение. В может быть полосой, пробелом, дословно, ножницами или по умолчанию.

полоса
Удалите начальные и конечные пустые строки, конечные пробелы, комментарии и
свернуть последовательные пустые строки.

пробельные
То же, что и полоса, за исключением того, что # комментарий не удаляется.

дословно
Ни в коем случае не меняйте сообщение.

ножницы
То же, что и пробел, за исключением того, что все, начиная с (и включая) строки "#
------------------------> 8 ------------------------ "усекается, если сообщение
подлежит редактированию. "#" можно настроить с помощью core.commentChar.

по умолчанию
То же, что и полоса, если сообщение редактируется. В противном случае пробел.

Значение по умолчанию можно изменить с помощью коммит.очистка переменная конфигурации (см. мерзавец
конфиг(1 г.)).

-e, --edit
Сообщение, взятое из файла с -F, командной строки с -m и из объекта фиксации с
-C обычно используется как неизмененное сообщение журнала фиксации. Эта опция позволяет вам дальше
редактировать сообщение, взятое из этих источников.

--нет-редактировать
Использовать выбранное сообщение фиксации без запуска редактора. Например, git commit
--amend --no-edit изменяет фиксацию без изменения ее сообщения фиксации.

--исправлять
Замените верхушку текущей ветки, создав новую фиксацию. Записанное дерево
подготовлены как обычно (включая действие параметров -i и -o и явного
pathspec), а сообщение из исходной фиксации используется в качестве отправной точки,
вместо пустого сообщения, когда в командной строке не указано другое сообщение
с помощью таких параметров, как -m, -F, -c и т. д. У нового коммита те же родители и автор, что и
текущий (параметр --reset-author может отменить это).

Это приблизительный эквивалент:

$ git reset - мягкая ГОЛОВКА ^
$ ... сделай что-нибудь еще, чтобы получить правильное дерево ...
$ git совершить -c ORIG_HEAD

но может использоваться для изменения фиксации слияния.

Вы должны понимать последствия перезаписи истории, если вы изменяете коммит, который
уже опубликовано. (См. Раздел «ВОССТАНОВЛЕНИЕ ИЗ ИСХОДНОЙ БАЗЫ» в мерзавец
перебазировать(1)).

--no-post-rewrite
Обойти ловушку пост-перезаписи.

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

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

-u [ ], --untracked-files [= ]
Показать неотслеживаемые файлы.

Параметр режима является необязательным (по умолчанию Найти), и используется для указания обработки
неотслеживаемых файлов; когда -u не используется, по умолчанию "обычные", т.е. показывать неотслеживаемые
файлы и каталоги.

Возможные варианты:

· нет - Не показывать неотслеживаемые файлы

· "обычные" - Показывает неотслеживаемые файлы и каталоги

· Найти - Также показывает отдельные файлы в неотслеживаемых каталогах.

Значение по умолчанию можно изменить с помощью конфигурации status.showUntrackedFiles.
переменная задокументирована в git-конфигурация(1).

-v, --подробный
Показать единую разницу между фиксацией HEAD и тем, что будет зафиксировано в нижней части
шаблон сообщения фиксации, чтобы помочь пользователю описать фиксацию, напоминая, что
меняет коммит. Обратите внимание, что этот вывод diff не имеет префиксов для строк
#. Эта разница не будет частью сообщения о фиксации.

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

-к, --тишина
Подавить сводное сообщение о фиксации.

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

--положение дел
Включите вывод git-статус(1) в шаблоне сообщения фиксации при использовании
редактор, чтобы подготовить сообщение о фиксации. По умолчанию включено, но может использоваться для отмены
переменная конфигурации commit.status.

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

-S [ ], --gpg-sign [= ]
GPG-подписывает коммиты. Аргумент keyid является необязательным и по умолчанию используется коммиттер.
личность; если указано, он должен быть прикреплен к опции без пробела.

--no-gpg-знак
Countermand commit.gpgSign конфигурационная переменная, которая настроена на принудительное использование каждого
обязательство быть подписанным.

--
Не интерпретируйте никакие аргументы как варианты.

...
Когда файлы задаются в командной строке, команда фиксирует содержимое
именованные файлы, без записи уже внесенных изменений. Содержимое этих файлов
также подготовлены для следующего коммита поверх того, что было поставлено ранее.

ДАТА ФОРМАТЫ

Переменные среды GIT_AUTHOR_DATE, GIT_COMMITTER_DATE и параметр --date
поддерживают следующие форматы даты:

Внутренний формат Git
это , куда это количество
секунд с эпохи UNIX. положительное или отрицательное смещение
от UTC. Например, CET (что на 2 часа опережает UTC) составляет +0200.

RFC 2822
Стандартный формат электронной почты, описанный в RFC 2822, например, четверг, 07 апреля 2005 г.
22:13:13 +0200.

ISO 8601
Время и дата указаны в стандарте ISO 8601, например 2005-04-07T22: 13: 13. В
синтаксический анализатор также принимает пробел вместо символа T.

Внимание
Кроме того, часть даты принимается в следующих форматах: ГГГГ.ММ.ДД,
ММ / ДД / ГГГГ и ДД.ММ.ГГГГ.

ПРИМЕРЫ

При записи вашей собственной работы содержимое измененных файлов в вашем рабочем дереве
временно хранится в промежуточной области, называемой «индексом», с мерзавец Добавить. Файл может быть
вернулся назад, только в индексе, но не в рабочем дереве, к тому, что было при последней фиксации
с git reset HEAD - , что эффективно возвращает мерзавец Добавить и предотвращает изменения
в этот файл от участия в следующей фиксации. После построения государства быть
совершается постепенно с помощью этих команд, git commit (без параметра pathname)
используется для записи того, что было поставлено до сих пор. Это самая простая форма команды.
Пример:

$ редактировать hello.c
$ git rm до свидания.c
$ git добавить hello.c
$ git совершить

Вместо того, чтобы размещать файлы после каждого отдельного изменения, вы можете указать git commit, чтобы он заметил
изменения в файлах, содержимое которых отслеживается в вашем рабочем дереве, и
соответствующие git add и git rm для вас. То есть этот пример делает то же самое, что и
предыдущий пример, если в вашем рабочем дереве нет других изменений:

$ редактировать hello.c
$ RM Goodbye.c
$ git совершить -а

Команда git commit -a сначала просматривает ваше рабочее дерево, замечает, что вы изменили
hello.c и удалил goodbye.c, и выполнит для вас необходимые git add и git rm.

После внесения изменений во многие файлы вы можете изменить порядок записи изменений,
указав пути к git commit. Когда указаны пути, команда совершает фиксацию
который записывает только изменения, внесенные в именованные пути:

$ редактировать hello.c hello.h
$ git добавить hello.c hello.h
$ редактировать Makefile
$ git совершить Makefile

Это делает фиксацию, которая записывает изменения в Makefile. Изменения, внесенные в
hello.c и hello.h не включаются в результирующий коммит. Однако их изменения
не потеряны - они все еще инсценированы и просто сдерживаются. После указанной выше последовательности, если вы
делать:

$ git совершить

эта вторая фиксация запишет изменения в hello.c и hello.h, как и ожидалось.

После слияния (по инициативе мерзавец слияние or мерзавец тянуть) останавливается из-за конфликтов, чисто
объединенные пути уже подготовлены для фиксации за вас, а конфликтующие пути
осталось в незавершенном состоянии. Вам нужно сначала проверить, какие пути конфликтуют с мерзавец
статус и после исправления их вручную в вашем рабочем дереве вы бы инсценировали результат как
обычно с мерзавец Добавить:

$ git статус | grep не объединен
не объединенный: hello.c
$ редактировать hello.c
$ git добавить hello.c

После разрешения конфликтов и постановки результата git ls-files -u перестанет упоминать
конфликтный путь. Когда вы закончите, запустите git commit, чтобы наконец записать слияние:

$ git совершить

Как и в случае с записью собственных изменений, вы можете использовать параметр -a, чтобы сохранить ввод. Один
разница в том, что во время разрешения слияния вы не можете использовать git commit с путями к
изменить порядок фиксации изменений, потому что слияние должно быть записано как
одиночная фиксация. Фактически, команда отказывается запускаться, когда заданы пути (но см. -I
опция).

ОБСУЖДЕНИЕ

Хотя это и не обязательно, рекомендуется начинать сообщение о фиксации с одного короткого
(менее 50 символов) строка с кратким описанием изменения, за которой следует пустая строка, а затем
более подробное описание. Текст до первой пустой строки в сообщении фиксации:
рассматривается как заголовок фиксации, и этот заголовок используется во всем Git. Например, мерзавец
формат-патч(1) превращает коммит в электронное письмо, и он использует заголовок в строке темы и
остальная часть коммита в теле.

Git в некоторой степени не зависит от кодировки символов.

· Содержимое больших двоичных объектов представляет собой неинтерпретируемые последовательности байтов. Здесь нет
кодирование перевода на базовом уровне.

· Имена путей кодируются в форме нормализации UTF-8 C. Это относится к объектам дерева,
индексный файл, имена ссылок, а также имена путей в аргументах командной строки,
переменные среды и файлы конфигурации (.git / config (см. git-конфигурация(1)), gitignore(5)
gitattributes(5) и gitmodules(5 г.)).

Обратите внимание, что Git на базовом уровне обрабатывает имена путей просто как последовательности, отличные от NUL.
байтов, преобразование кодировки имени пути не выполняется (кроме Mac и Windows).
Следовательно, использование имен путей, отличных от ASCII, в основном будет работать даже на платформах и файловых
системы, использующие устаревшие расширенные кодировки ASCII. Однако репозитории, созданные на
такие системы не будут работать должным образом в системах на основе UTF-8 (например, Linux, Mac, Windows)
наоборот. Кроме того, многие инструменты на основе Git просто предполагают, что имена путей
UTF-8 и не сможет правильно отображать другие кодировки.

· Сообщения журнала фиксации обычно кодируются в UTF-8, но другие расширенные кодировки ASCII
также поддерживаются. Сюда входят ISO-8859-x, CP125x и многие другие, но не
Многобайтовые кодировки UTF-16/32, EBCDIC и CJK (GBK, Shift-JIS, Big5, EUC-x, CP9xx
и т.д.).

Хотя мы рекомендуем кодировать сообщения журнала фиксации в UTF-8, как ядро, так и
Git Porcelain спроектирован так, чтобы не использовать UTF-8 в проектах. Если все участники
конкретному проекту удобнее использовать устаревшие кодировки, Git не запрещает
Это. Однако следует помнить о нескольких вещах.

1. мерзавец совершать и мерзавец дерево фиксации выдает предупреждение, если ему предоставлено сообщение журнала фиксации
не выглядит как допустимая строка UTF-8, если вы явно не укажете, что ваш проект использует
устаревшая кодировка. Можно сказать, что i18n.commitencoding находится в .git / config.
файл, например:

[и18н]
фиксация = ISO-8859-1

Объекты фиксации, созданные с помощью вышеуказанного параметра, записывают значение i18n.commitencoding.
в заголовке кодировки. Это сделано для того, чтобы помочь другим людям, которые посмотрят на них позже. Отсутствие
этот заголовок подразумевает, что сообщение журнала фиксации закодировано в UTF-8.

2. мерзавец журнал, мерзавец показывать, мерзавец обвинять и друзья смотрят на заголовок кодировки коммита
объект и попробуйте перекодировать сообщение журнала в UTF-8, если не указано иное. Ты
можно указать желаемую кодировку вывода с помощью i18n.logoutputencoding в .git / config
файл, например:

[и18н]
logoutputencoding = ISO-8859-1

Если у вас нет этой переменной конфигурации, значение i18n.commitencoding равно
используется вместо

Обратите внимание, что мы сознательно решили не перекодировать сообщение журнала фиксации, когда фиксация
сделано, чтобы заставить UTF-8 на уровне объекта фиксации, потому что перекодирование в UTF-8 не
обязательно обратимая операция.

ОКРУЖАЮЩАЯ СРЕДА И КОНФИГУРАЦИЯ ПЕРЕМЕННЫЕ

Редактор, используемый для редактирования сообщения журнала фиксации, будет выбран из GIT_EDITOR
переменная среды, переменная конфигурации core.editor, среда VISUAL
переменная или переменная среды EDITOR (в указанном порядке). Видеть git-вар(1) для подробностей.

КРЮКИ

Эта команда может запускать перехватчики commit-msg, prepare-commit-msg, pre-commit и post-commit.
Читать гитхуки(5) для получения дополнительной информации.

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