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

ПРОГРАММА:

ИМЯ

wiggle - применять отклоненные патчи и выполнять словесные различия

СИНТАКСИС

покачивание [Функция] [опции] файл [файлы]

ОПИСАНИЕ

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

Отличительное отличие покачивание в том, что он попытается применить патч, даже если
«до» часть патча не полностью соответствует целевому файлу. Это достигается
разбиение файла и патча на слова и поиск наилучшего выравнивания слов в файле
со словами в патче. Как только это совпадение будет найдено, любые различия (словесные)
в патче прилагаются к файлу как можно лучше.

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

покачивание гарантирует, что каждое изменение в патче каким-то образом применяется к целевому файлу. Если
конкретное изменение не может быть внесено в файл, файл снабжен аннотацией, чтобы показать, где
изменение должно производиться аналогично слияние(1) программа с -A вариант. Каждый
аннотация содержит 3 компонента: часть исходного файла, в которой должны быть внесены изменения.
быть применен, часть патча, которая не может быть точно сопоставлена ​​в файле, и
текст, который должен заменить эту часть патча. Они разделены линиями
содержащий ровно 7 одинаковых символов, либо '<', '|', '=', или '>', возможно
за которым следует описательное слово. Так
<<<<<<< найдено
Некоторая часть исходного файла
||||||| ожидал
текст для замены
=======
текст, чтобы заменить его на
>>>>>>> замена
указывает, что "текст для замены" следует где-то заменить на "текст для замены"
в части исходного файла. тем не мение покачивание не смог найти место, чтобы сделать
это изменение.

покачивание может также создавать отчеты о конфликтах, показывающие только те слова, которые используются, а
чем показывать целые строки. В этом случае результат выглядит так:
<<< --- оригинал ||| старый === новый --- >>>

Одно возможное использование покачивание должен бежать заплата применить какой-нибудь патч и собрать список
отклоняет, отслеживая сообщения об ошибках от patch. Затем для каждого файла, для которого
отклонить найден, запустить
wiggle - заменить исходный файл originalfile.rej

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

В качестве альтернативы исходный файл патча можно передать на просматривать режим как
wiggle -B <файл-патч

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

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ
Следующие параметры понимаются покачивание. Некоторые из них объясняются более подробно.
подробнее в следующих разделах о СЛИЯНИИ, РАЗЛИЧИИ, ВЫДЕРЖИВАНИИ и ПРОСМОТРЕ.

-m, - объединить
Выберите функцию «слияние». Это функция по умолчанию.

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

-x, --извлекать
Выберите функцию «извлечь». Это извлекает одну ветвь патча или файла слияния.

-B, --просматривать
Выберите функцию «просмотр». Это похоже на "слияние" (или "diff") только с
разная презентация. Вместо того, чтобы просто отправить результат в стандартный
вывод, он представлен с использованием графического интерфейса на основе ncurses, так что каждый кусок патча
можно изучить, чтобы понять, какие конфликты были задействованы и что необходимо
игнорируется, чтобы патч можно было вставить на место.

-w, --слова
Запросите, чтобы все операции и отображение были основаны на словах. Это значение по умолчанию для
функция "diff".

-l, --линии
Попросите, чтобы все операции и отображение были линейными.

-b, --игнорировать пробелы
Снижение выделения пробелов (пробел, табуляция и новая строка) определяет различия и
изменений.

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

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

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

-b не имеет никакого эффекта в --линия Режим.

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

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

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

-o, --output =
Вместо того, чтобы записывать результат в стандартный вывод или заменять исходный файл, этот
запрашивает запись вывода в данный файл. Это только имеет смысл
- объединить or --просматривать когда предоставляется одно слияние для просмотра.

Эта опция отменяет -r.

-R, --задний ход
При использовании с Разница функции, поменяйте файлы местами перед вычислением
различия. При использовании с слияние or просматривать функции, покачивание пытается
отменить изменения, а не применять их.

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

-W, --show-покачивается
При использовании с - объединить, конфликты, которые могут быть устранены, сообщаются как
конфликтует с дополнительной строфой, которая показывает, каков был бы результат, если бы этот флаг
не использовался. Дополнительная строфа вводится строкой, содержащей 7
амперсанд (&) символов таким образом:
<<<<<<< найдено
Некоторая часть исходного файла
||||||| ожидал
текст для замены
=======
текст, чтобы заменить его на
&&&&&&& разрешающая способность
Текст, полученный в результате успешного покачивания
>>>>>>> замена

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

-h, --Помогите
Распечатайте простое справочное сообщение. Если указано после одного из селекторов функций
(- объединить, --diff, --извлекать, --просматривать) отображается справка, относящаяся к этой функции.

-V, --версия
Показать номер версии покачивание.

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

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

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

MERGE
Функция слияния изменяет данный текст, находя все изменения между двумя другими текстами.
и внесение этих изменений в данный текст.

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

покачивание извлекает три необходимых текста из файлов, перечисленных в командной строке.
В списке могут быть 1, 2 или 3 файла, и любой из них может быть одиночным дефисом, обозначающим
стандартный ввод.

Если дан один файл и -p параметр отсутствует, файл рассматривается как слияние
файл, то есть результат «слияния -А» или «покачивания». Такой файл неявно содержит три
потоки, и они извлекаются и сравниваются.

Если даны два файла, то первый просто содержит основной текст, а второй -
обрабатывается как файл исправления (вывод "diff -u" или "diff -c", или файл ".rej" из
заплата) и два других текста извлечены из этого.

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

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

Обычно результат слияния выводится на стандартный вывод. Если -r дан флаг,
вывод записывается в файл, который заменяет исходный данный файл. В этом случае
исходный файл переименован, чтобы иметь .пориг суффикс (от "исправленного оригинала", что имеет смысл
если вы впервые используете заплата применить патч, а затем использовать покачивание чтобы втиснуть отбраковки).

Далее, если -o опция указывается с именем файла, вывод будет записан в этот
файл. В этом случае резервная копия не создается.

Если ошибок нет (например, ошибок доступа к файлам) покачивание выйдет со статусом 0, если все
изменения были успешно объединены, и со статусом выхода 1 и кратким сообщением, если таковое имеется
изменения не могли быть полностью объединены и вместо этого были вставлены как аннотации. Однако если
или --report-покачивается or --show-покачивается были даны варианты, покачивание также будет существовать с
status 1, если нужно было внести какие-либо изменения, даже если это было успешно.

Функция слияния может работать в трех разных режимах по отношению к строкам или словам.

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

Для --слова вариант, отдельные слова сравниваются, и любые конфликты сообщаются просто
прикрытие затронутых слов. Используется формат конфликта <<< ||| === >>>.

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

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

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

2 Если обнаружено изменение, которое просто добавляет B и текст, непосредственно предшествующий и
после вставки находятся рядом в исходном файле в подходящем
место, тогда B вставляется между этими соседними текстами.

3 Если обнаружено изменение, которое меняет A в B и это появляется (в зависимости от контекста), чтобы
согласовать с B в оригинале, то предполагается, что это изменение уже
применено, и изменение игнорируется. Когда это происходит, появляется сообщение, отражающее
количество проигнорированных изменений печатается покачивание. Эта оптимизация может быть
подавлен -i флаг.

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

DIFF
Функция diff предназначена в первую очередь для проверки совмещений, которые покачивание
вычисляется между текстами и используется для выполнения слияния.

Вывод функции diff аналогичен унифицированному выводу функции diff. Однако пока
diff не выводит длинные фрагменты обычного текста, покачиваниережим diff выводит все.

При вычислении выравнивания по словам (по умолчанию), покачивание может потребоваться показать это слово -
основанные на различиях. Это делается с помощью расширения формата unified-diff. Если линия
начинается с вертикальной черты, затем может содержать разделы, окруженные специальными мульти-
скобки символов. Скобки «<<< ++» и «++ >>>» окружают добавленный текст, а «<<< -»
и "- >>>" окружают удаленный текст.

покачивание можно дать два текста для сравнения одним из трех способов.

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

Если даны два файла, то они обычно считаются простыми текстами для сравнения.

Если два файла указаны вместе с параметром --patch, то предполагается, что второй файл
быть патчем и извлекается либо первая (со значением -1), либо вторая (со значением -2) ветвь и
по сравнению с текстом, найденным в первом файле.

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

ВЫПИСКА
Функция извлечения покачивание просто предоставляет внутреннюю функциональность для извлечения
одна ветка патча или файла слияния.

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

Выбор филиала осуществляется путем предоставления одного из -1, -2или -3 с очевидным смыслом.

ПРОСМАТРИВАТЬ
Функция просмотра покачивание представляет результат слияния или (с -d) различие в
текстовый графический интерфейс, по которому можно перемещаться с помощью клавиш, аналогичных vi(1) или Emacs(1).

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

Браузер предоставляет ряд контекстно-зависимых справочных страниц, к которым может получить доступ
набирая '?'

В правом верхнем углу графического интерфейса будет отображаться тип текста под курсором, который также
обозначается цветом текста. Варианты: "Без изменений", "Изменено", "Несовпадено",
Посторонние, уже применяемые и конфликтные. Если их значения немного ясны
эксперименты должны помочь.

Ограниченное количество редактирования разрешено в просматривать режим. Текущий текст
нежелательные могут быть отброшены x. Это преобразует конфликт или изменение в неизменное,
и «Несовпадено» на «Изменено» (что фактически заменяет его пустой строкой). сходным образом
текст можно пометить как желаемый с помощью c. Это превратит Конфликт или Постороннее в
Измененный. Повторное использование того же ключа отменит изменение.

Наконец, заглавные буквы X отменит все изменения в текущей строке.

Чтобы внести более радикальные изменения, вы можете использовать v который запускает редактор, предпочитая $ ВИЗУАЛЬНО or
РЕДАКТОР если они установлены в среде.

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

ПРЕДУПРЕЖДЕНИЕ

Всегда следует проявлять осторожность при применении отбракованного пластыря с покачивание. Когда заплата
отклоняет патч, он делает это по уважительной причине. Хотя покачивание может найти
правдоподобное место для применения каждого текстового изменения, нет гарантии, что результат
правильный в любом смысловом смысле. Результат всегда следует проверять, чтобы убедиться, что он
исправить.

ПРИМЕРЫ

покачивание --заменять файл файл.rej
Это нормальное использование покачивание и примет любые изменения в файл.rej который заплата может
не применяются, и объединить их в файл.

покачивание -dp1 файл файл.rej
Будет выполнено словесное сравнение между файл и до Ветви
различие в файл.rej и отобразить различия. Это позволяет вам увидеть, где находится данный патч
будет применяться.

покачивание - объединить --Помогите
Получите справку о функции слияния покачивание.

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

покачивание может быть интегрирован с мерзавец так что он используется как инструмент слияния по умолчанию, а diff
орудие труда. Этого можно добиться, добавив следующие строки в .gitconfig в доме пользователя
каталог.
[объединить "покачиваться"]
name = "Wiggle гибкое слияние"
драйвер = покачиваться -o% A% A% O% B
рекурсивный = двоичный
[объединить]
инструмент = покачиваться
[mergetool "wiggle"]
cmd = wiggle -B -o $ MERGED $ LOCAL $ BASE $ REMOTE
[difftool "покачивание"]
cmd = wiggle -Bd $ LOCAL $ REMOTE
Это сделает мерзавец инструмент слияния и мерзавец инструмент дифференциала использование покачивание.

Если вы хотите, мерзавец всегда использовать покачивание для слияний (что может быть опасно) вы можете добавить
* слияние = покачивание
соответствующему gitattributes файл, такой как $ HOME / .config / git / атрибуты.

ЦЕНЫ

Имя покачивание был вдохновлен следующей цитатой.

Проблема, которую я обнаруживаю, заключается в том, что я часто хочу взять
(файл1 + патч) -> файл2,
когда у меня нет file1. Но инструменты слияния хотят взять
(файл1 | файл2) -> файл3.
Я не видел графического инструмента, который поможет вам пошевелить патчем
в файл.
- Эндрю Мортон - 2002 г.

НЕДОСТАТКИ

- покачивание не может прочитать расширенный вывод unified-diff, который он производит для --diff
--слова.

- покачивание не может прочитать формат слияния на основе слов, который он создает для --merge
--слова.

- покачивание не понимает Unicode и поэтому будет много обрабатывать все символы, отличные от ASCII
так же, как он обрабатывает знаки препинания - он будет рассматривать каждое слово как отдельное слово. В
браузер не будет правильно отображать символы, отличные от ASCII.

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