является графическим инструментом для слияния и сравнения текстовых файлов\&. Она может сравнить произвольное число файлов в представлении бок о бок, предоставляет пользователям возможность вручную корректировать соответствие строк и редактировать файлы напрямую\&.
Если опция справки определена, только параметр должен быть указан в командной строке\&. Программа
Diffuse
немедленно закроется после отображения справочной информации\&.
.PP
\fB\-h\fR, \fB\-?\fR, \fB\-\-help\fR
.RS4
Отобразить информацию по использованию\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS4
Отобразить информацию о номере версии и авторских правах\&.
.RE
.SS"Параметры Конфигурации"
.PP
Если опция конфигурации определена, она должна быть первым параметром, указываемым в командной строке\&.
.PP
\fB\-\-no\-rcfile\fR
.RS4
Не читать файлы инициализации\&.
.RE
.PP
\fB\-\-rcfile \fR\fB\fIfile\fR\fR
.RS4
Только прочитать команды инициализации из файла под именем
\fIfile\fR\&.
.RE
.SS"Общие Параметры"
.PP
\fB\-c\fR, \fB\-\-commit\fR\fIrev\fR
.RS4
Открыть отдельные вкладки сравнения файлов для всех файлов, затрагиваемых фиксацией
\fIrev\fR
из остающихся путей, определенных в параметрах командной строки\&.
.RE
.PP
\fB\-D\fR, \fB\-\-close\-if\-same\fR
.RS4
Закрыть все не имеющие различий вкладки\&.
.RE
.PP
\fB\-e\fR, \fB\-\-encoding\fR\fIcodec\fR
.RS4
Использовать
\fIcodec\fR
(кодек) для чтения и записи файлов\&.
.RE
.PP
\fB\-L\fR, \fB\-\-label\fR\fIlabel\fR
.RS4
Отображать
\fIlabel\fR
ярлык вместо имени файла\&.
.RE
.PP
\fB\-m\fR, \fB\-\-modified\fR
.RS4
Открыть отдельные вкладки сравнения файлов для всех модифицированных файлов из остающихся путей, определенных в параметрах командной строки\&.
.RE
.PP
\fB\-r\fR, \fB\-\-revision\fR\fIrev\fR
.RS4
Включить ревизию
\fIrev\fR
следующего файла, названного в параметрах командной строки, во вкладку сравнения файлов\&.
.RE
.PP
\fB\-s\fR, \fB\-\-separate\fR
.RS4
Открыть все остающиеся файлы, определенные в параметрах командной строки, на отдельных вкладках сравнения файлов\&.
.RE
.PP
\fB\-t\fR, \fB\-\-tab\fR
.RS4
Запустить новую вкладку для любых остающихся файлов, названных в параметрах командной строки\&.
.RE
.PP
\fB\-\-line \fR\fB\fIline\fR\fR
.RS4
Начать с выбранной
\fIline\fR
строки\&.
.RE
.PP
\fB\-\-null\-file\fR
.RS4
Создать пустое субокно сравнения файла\&.
.RE
.SS"Параметры Отображения"
.PP
Опции отображения, определенные в параметрах командной строки, имеют приоритет над сохраненными значениями предпочтений\&.
.PP
\fB\-b\fR, \fB\-\-ignore\-space\-change\fR
.RS4
Игнорировать изменения количества свободного места (пробелы, символы табуляции и пустой строки)\&.
.RE
.PP
\fB\-B\fR, \fB\-\-ignore\-blank\-lines\fR
.RS4
Игнорировать те изменения, чьи строки все пустые\&.
.RE
.PP
\fB\-E\fR, \fB\-\-ignore\-end\-of\-line\fR
.RS4
Игнорировать различия окончания строк (терминаторы)\&.
.RE
.PP
\fB\-i\fR, \fB\-\-ignore\-case\fR
.RS4
Игнорировать различия регистра символов в содержании файла\&.
.RE
.PP
\fB\-w\fR, \fB\-\-ignore\-all\-space\fR
.RS4
Игнорировать все пробелы, символы табуляции и пустой строки\&.
.RE
.SH"СРАВНЕНИЕ ФАЙЛОВ"
.PP
Используйте пункты меню
Файл \(-> Новое 2\-Оконное Слияние Файлов
и
Файл \(-> Новое 3\-Оконное Слияние Файлов, чтобы создать дополнительные вкладки для сравнения текстовых файлов\&. Имена файлов и ревизий могут быть указаны либо в параметрах командной строки, используемых для вызова
Diffuse, либо в полях диалога Открыть Файл\&.
.PP
Программа
Diffuse
отображает файлы бок о бок, вставляя разрывы для выравнивания подобных строк текста\&. Различия выделяются отличным цветом фона\&.
.SS"Сводка Сравнения"
.PP
Сводка сравненных файлов располагается в дальнем правом поле\&. Сводка иллюстрирует, где были вставлены разрывы для выравнивания соответствующих строк текста и подсветку различий, используя цвет\&. Ручные редактирования также выделяются зеленым цветом\&. Синий курсор идентифицирует в настоящий момент просматриваемую область\&. Просматриваемая область может быть изменена щелками где угодно на сводке\&.
.SS"Выборка"
.PP
Строки текста могут быть выбраны, используя указатель мыши или клавиатуру\&. Выбирайте строки текста указателем мыши, щелкая по строке\&. Щелкайте и перетаскивайте указатель для выбора множественных строк\&. Удержание клавиши Shift при щелчке расширит текущий выбор\&. Выбирайте строки текста с клавиатуры, нажимая клавиши страница вверх/страница вниз или клавиши со стрелками\&. Расширяйте текущий выбор удержанием клавиши Shift и нажатием страница вверх/страница вниз или клавиш со стрелками\&. Перемещайте выбор в смежный файл, используя клавиши стрелка влево и стрелка вправо\&.
.SS"Соответствие Строк"
.PP
Указатель мыши или клавиатура могут использоваться для выравнивания (подгонки) строк текста вручную в смежных файлах\&. Чтобы выровнять (подогнать) строки текста указателем мыши, выберите строку текста левой кнопкой мыши, щелкните правой кнопкой мыши по строке текста в смежном файле и выберите пункт всплывающего меню
Выровнять с Выборкой\&. Чтобы выровнять строки текста с клавиатуры, переместите выбор клавишами управления курсором, нажмите клавишу Space (Пробел), чтобы выбрать текущую строку текста, затем переместите выбор клавишами управления курсором на строку текста в смежном файле и нажмите клавишу Space (Пробел), чтобы выбрать целевую строку текста\&. Нажатие клавиши
Escape
отменит эту операцию\&.
.PP
Используйте пункт меню
Изолировать
для предотвращения того, чтобы выбранные строки сопоставлялись любым строкам из смежных файлов\&.
.SS"Редактирование"
.PP
Нажатие клавиши
Enter
или двойной щелчок на области текста для ввода режима редактирования текста\&. Курсор изменится, чтобы указать на включение режима редактирования текста, а строка состояния внизу окна отобразит номер столбца/колонки, где находится курсор (т\&.е\&. по сути, отображается номер символа, находящегося слева от курсора, в текущей строке с учетом пробелов)\&.
.PP
В режиме редактирования текста, текст может быть выбран указателем мыши, щелчком и перетаскиванием курсора\&. Текущий выбор может быть расширен удержанием клавиши Shift и перемещением указателя мыши (т\&.е\&. щелчок в начале требуемого \- нажатие и удержание Shift \- щелчок в конце требуемого) или нажатием любой клавиши\-стрелки, Нome, End или страница вверх/страница вниз\&. Отдельные слова могут быть выбраны двойным щелчком указателя мыши по ним\&. Целые строки могут быть выбраны тройным щелчком указателя мыши по ним\&.
.PP
Изменяйте текст, вводя с клавиатуры\&. Измененные строки будут выделены зеленым цветом\&. Используйте пункты меню
Отменить
и
Вернуть, чтобы отменить и восстановить ранее выполненные операции\&.
.PP
Нажмите клавишу
Еscape
или щелкните левой кнопкой мыши на области текста в другом файле, чтобы выйти из режима редактирования\&.
.SS"Слияние"
.PP
Используйте различные кнопки или пункты меню для перемещения между блоками различий в пределах файла\&. На навигации,
Diffuse
переместит указатель мыши в следующий сплошной набор строк с различиями или редактированиями\&.
.PP
Используйте кнопки слияния или пункты меню, чтобы скопировать блоки текста в выбранный диапазон строк\&. Пункты меню
Отменить
и
Вернуть
могут использоваться для отмены и восстановления ранее выполненных операций\&. Все изменения к набору строк могут быть возвращены к исходному состоянию, используя пункт меню
Очистить Правки
независимо от порядка выполнения редактирований\&.
.SH"КОНТРОЛЬ ВЕРСИЙ"
.PP
Diffuse
может извлекать ревизии файла из нескольких систем управления версиями через их интерфейс командной строки\&. Microsoft Windows сборка
Diffuse
способна использовать как Cygwin, так и собственные версии поддерживаемых систем управления версиями\&. При использовании
Diffuse
с Cygwin, убедитесь, что предпочтения Cygwin программы
Diffuse
правильно описывают вашу систему\&. Если пункт предпочтений
Обновлять пути для Cygwin
существует для данной системы управления версиями, он должен быть задействован для использования версии Cygwin\&.
.PP
Системы управления версиями чувствительны к системному пути и к другим настройкам среды\&. Пункт предпочтений
Запуск из оболочки Bash login
может использоваться, чтобы легко установить среду для Cygwin систем управления версиями\&.
.SS"Просмотр Незафиксированных Модификаций"
.PP
Опция
\fB\-m\fR
заставит
Diffuse
открывать вкладки сравнения для каждого файла, на который указывает система управления версиями, как на имеющий незафиксированные (несвязанные) модификации\&. Это удобно для просмотра всех изменений перед фиксацией транзакции или разрешением конфликта слияния\&. Если никакие пути не будут определены, то текущий рабочий каталог будет использоваться\&. Например, можно просмотреть все свои незафиксированные модификации с этой командной строкой:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-m\fR
.fi
.ifn\{\
.RE
.\}
.PP
Ревизия по умолчанию файла будет использоваться для сравнения, если только один файл будет определен\&. Например, чтобы отобразить 2\-оконное слияние между ревизией по умолчанию
foo\&.C
и локальным файлом
foo\&.C:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.sp
.SS"Определение Ревизий"
.PP
Опция
\fB\-r\fR
может также использоваться, чтобы явно указать определенную ревизию файла\&. Любой спецификатор ревизии, понятный для системы управления версиями, может использоваться\&. Локальный файл будет использоваться для сравнения, если только одна ревизия файла будет определена\&.Например, чтобы отобразить 2\-оконное слияние между ревизией 123
foo\&.C
и локальным файлом
foo\&.C:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-r 123 foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.PP
Множественные ревизии файла могут быть сравнены вводом множественных опций
\fB\-r\fR
\&. Например, чтобы отобразить 2\-оконное слияние между ревизией 123 файла
foo\&.C
и ревизией 321 файла
foo\&.C:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-r 123 \-r 321 foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.PP
Локальные файлы могут быть смешаны с файлами от системы управления версиями\&. Например, чтобы отобразить 3\-оконное слияние между ревизией MERGE_HEAD файла
foo\&.C, локальным файлом
foo\&.C
и ревизией HEAD файла
foo\&.C:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-r MERGE_HEAD foo\&.C foo\&.C \-r HEAD foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.PP
Опция
\fB\-c\fR
может использоваться, чтобы легко определить пару последовательных ревизий\&. Например, чтобы отобразить 2\-оконное слияние между ревизией 1\&.2\&.2 файла
foo\&.C
и ревизией 1\&.2\&.3 файла
foo\&.C:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-c 1\&.2\&.3 foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.PP
Программа
Diffuse
не ограничивает количество субокон, используемых для сравнения файлов\&. Вводы к Git octopus слиянию могли бы быть просмотрены с командной строкой, как ниже:
Ресурсы могут использоваться для индивидуализации некоторых аспектов внешнего вида программы
Diffuse
и ее поведения, например, изменение используемых в интерфейсе пользователя цветов, настройки клавиатурных комбинаций вызова, добавление или замена правил подсветки синтаксиса или изменение отображения от расширений файла до правил подсветки синтаксиса\&.
.PP
Когда программа
Diffuse
запускается, она считает команды из файла общесистемной инициализации
/etc/diffuserc
(%INSTALL_DIR%\ediffuserc
на Microsoft Windows), а затем считывает персональный файл инициализации
~/\&.config/diffuse/diffuserc
(%HOME%\e\&.config\ediffuse\ediffuserc
на Microsoft Windows)\&. Это поведение может быть изменено при помощи опций конфигурации
\fB\-\-no\-rcfile\fR
и
\fB\-\-rcfile\fR\&. Bourne shell\-like лексический анализатор используется для парсинга (синтаксического анализа/разбора) команд инициализации\&. Комментарии и специальные символы могут быть вставлены, используя тот же самый стиль перехода, который используется в Bourne shell скриптах (сценариях)\&.
.SS"Общее"
.PP
\fBimport \fR\fB\fIfile\fR\fR
.RS4
Команды инициализации процессов из файла под именем
\fIfile\fR\&. Файлы инициализации будут обработаны только один раз\&.
\fIname\fR\&. Подсветка синтаксиса использует простой автомат с конечным числом состояний, который переходит из одного состояния в другое, когда определенные образчики являются сочетающимися\&. Начальное состояние для конечного автомата будет
\fIinitial_state\fR\&. Все символы, не соответствующие образчику, будут помечены как
Добавляет образчик к ранее объявленному стилю синтаксиса\&. Образчики пробуются по одному в порядке, в которым они были объявлены, пока первое соответствиене будет найдено\&. Образчик будет использоваться только для сопоставления символов, если конечный автомат будет в состоянии
\fIinitial_state\fR\&. Конечный автомат перейдет в состояние
\fIfinal_state\fR, если определяемый
\fIpattern\fR
образчик будет соответствующим\&. Будет использоваться нечувствительное к регистру сопоставление с образчиком, если определено
\fBignorecase\fR\&. Все символы, соответствующие образчику, будут помечены как тег для подсветки\&.
