git-apply

Файлы, из которых нужно прочитать патч. Для чтения из стандартного ввода можно использовать -.

Вместо применения патча вывести статистику diff для входных данных. Отключает «apply».

Похоже на --stat, но показывает количество добавленных и удалённых строк в десятичной записи, а имя пути выводит без сокращений, чтобы упростить машинную обработку. Для двоичных файлов выводит два значения - вместо сообщения 0 0. Отключает «apply».

Вместо применения патча вывести краткую сводку информации из расширенных заголовков git diff, например о создании файлов, переименованиях и изменениях режима. Отключает «apply».

Вместо применения патча проверить, применим ли он к текущему рабочему дереву и/или файлу индекса, и обнаружить ошибки. Отключает «apply».

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

Применить патч только к индексу, не затрагивая рабочее дерево. Если используется --check, только проверить, что патч корректно применится к записи индекса.

При применении патча только к рабочему дереву пометить новые файлы для последующего добавления в индекс (см. параметр --intent-to-add команды git-add[1]). Этот параметр игнорируется, если используются --index или --cached, и не действует вне репозитория Git. Обратите внимание, что --index может подразумеваться другими параметрами, например --3way.

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

Вместо того чтобы оставлять конфликты в файле, разрешить их в пользу нашей стороны (или их стороны, или обеих сторон). Требуется --3way.

В более новых версиях вывода git diff встроены index information для каждого блоба, помогающие определить исходную версию, к которой применяется патч. Если указан этот флаг и исходные версии блобов доступны локально, создаётся временный индекс, содержащий эти блобы.

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

Применить патч в обратном порядке.

Для обеспечения атомарности git apply по умолчанию отклоняет весь патч и не изменяет рабочее дерево, если некоторые фрагменты не удалось применить. Этот параметр позволяет применить применимые части патча, а отклонённые фрагменты сохранить в соответствующих файлах *.rej.

Если указан параметр --numstat, не преобразовывать имена путей, а использовать машиночитаемый формат с завершающим NUL-символом.

Без этого параметра имена путей с «нестандартными» символами заключаются в кавычки, как описано для переменной конфигурации core.quotePath (см. git-config[1]).

Удалить <n> начальных компонентов пути (разделённых косыми чертами) из путей в традиционном формате diff. Например, при использовании -p2 патч для a/dir/file будет применён непосредственно к file. По умолчанию используется значение 1.

Проверить, что перед каждым изменением и после него совпадает не менее <n> строк окружающего контекста. Если строк окружающего контекста меньше, должны совпасть все имеющиеся строки. По умолчанию контекст не игнорируется.

По умолчанию git apply ожидает, что применяемый патч представляет собой унифицированный diff как минимум с одной строкой контекста. Это обеспечивает надёжную защиту, но мешает применению diff, созданного с помощью --unified=0. Чтобы обойти эти проверки, используйте --unidiff-zero.

По указанным выше причинам использование патчей без контекста не рекомендуется.

Если использовать любой из приведённых выше параметров, помеченных как «отключает apply», git apply считывает и выводит запрошенную информацию, не применяя патч. Укажите этот флаг после этих параметров, чтобы также применить патч.

При применении патча игнорировать добавления, внесённые патчем. Этот параметр можно использовать для извлечения общей части двух файлов: сначала выполнить для них diff, а затем применить результат с этим параметром. В этом случае будут применены удаления, но не добавления.

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

Не применять изменения к файлам, соответствующим шаблону <path-pattern>. Это может быть полезно при импорте наборов патчей, если нужно исключить определённые файлы или каталоги.

Применять изменения к файлам, соответствующим шаблону <path-pattern>. Это может быть полезно при импорте наборов патчей, если нужно включить определённые файлы или каталоги.

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

При применении патча при необходимости игнорировать изменения пробельных символов в строках контекста. Пробельные символы в строках контекста сохраняются, и такие строки не исправляются независимо от значения параметра --whitespace. Новые строки при этом всё равно исправляются.

При применении патча обнаруживать новые или изменённые строки с ошибками в пробельных символах. Определение таких ошибок задаётся настройкой core.whitespace. По умолчанию ошибками считаются пробелы в конце строк (включая строки, состоящие только из пробельных символов), а также пробел, за которым сразу следует символ табуляции в начальном отступе строки.

По умолчанию команда выводит предупреждения, но применяет патч. Если параметр git-apply используется для получения статистики без применения патча, по умолчанию выбирается nowarn.

Для управления поведением можно использовать различные значения <action>:

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

Выводить сведения о ходе выполнения в stderr. По умолчанию печатается только сообщение о применяемом патче. Этот параметр включает вывод дополнительной информации.

Подавить вывод в stderr. Сообщения о состоянии патча и ходе выполнения выводиться не будут.

Не доверять количеству строк в заголовках фрагментов, а определять его по содержимому патча (например, после редактирования патча без соответствующего исправления заголовков фрагментов).

Добавить <root> в начало всех имён файлов. Если также указан аргумент -p, он применяется до добавления нового корневого каталога.

Например, патч, в котором говорится об обновлении a/git-gui.sh до b/git-gui.sh, можно применить к файлу в рабочем дереве modules/git-gui/git-gui.sh, выполнив git apply --directory=modules/git-gui.

По умолчанию патч, затрагивающий файлы за пределами рабочей области (рабочего дерева, контролируемого Git, либо текущего рабочего каталога, если git apply используется вместо GNU patch), отклоняется как ошибочный (или злонамеренный).

Если git apply используется как «улучшенная версия GNU patch», пользователь может указать параметр --unsafe-paths, чтобы обойти эту проверку безопасности. Этот параметр не действует, если используется --index или --cached.

Не возвращать ошибку для патчей, не содержащих diff. К ним относятся пустые патчи и патчи, содержащие только текст коммита.

Если установлено значение change, указывает git apply игнорировать изменения пробельных символов так же, как при использовании параметра --ignore-space-change. Если задано одно из значений no, none, never, false, указывает git apply учитывать все различия в пробельных символах.

Указывает git apply, как обрабатывать пробельные символы, так же, как при использовании параметра --whitespace.