За допомогою виділення кольорами KDiff3 точно покаже вам відмінності у файлах. Якщо вам потрібно виконати значну кількість коду, ви оціните переваги, які надає ця можливість.

Різниця у пробілах і символах табуляції стає видимою. Якщо рядки відрізняються лише наявність (чи відсутністю) пробілів, це можна визначити з першого погляду на стовпчик резюме, розташований ліворуч. (Вам більше не потрібно буде перейматися випадками, коли розробник змінює лише відступи.)

За її допомогою можна аналізувати одразу три файли і бачити різницю між ними.

Ліве/середнє/праве вікна мають назви A/B/C і відповідні кольори: синій/зелений/малиновий.

Якщо певний рядок у одному з файлів збігається з базою, але відрізняється від бази у іншому файлі, колір відповідного рядка покаже вам, у якому саме файлі було внесено зміни. Червоний колір позначатиме рядки, які було змінено у обох файлах.

KDiff3 можна скористатися для об'єднання двох або трьох вхідних файлів, таке об'єднання буде за можливості виконано у автоматичному режимі. Результат буде показано у вікні, у якому ви зможете редагувати текст і розв'язувати більшість конфліктів одним клацанням кнопкою миші: вам достатньо буде натиснути одну з кнопок ... у вікнах A/B/C, на панелі кнопок, щоб вибрати джерело об'єднання, яке буде використано. Ви також можете вибрати одразу декілька джерел. Оскільки вікно результату є вікном редактора, у ньому можна розв'язати навіть конфлікти, які потребують подальшого виправлення, — вам не потрібно буде використовувати сторонні інструменти.

У верхній частині кожного з вікон ви побачите «інформаційний рядок». У інформаційних рядках вікон вхідних даних містяться літери A, B та C, придатне для редагування поле назви файла, кнопка навігації і номер першого з видимих рядків у вікні. (Зауважте, що вікно C не є обов'язковим.) Кожен з інформаційних рядків має власний колір.

Після вибору іншого файла за допомогою інструменту навігації або завершення редагування назви файла вам слід натиснути клавішу Enter. Програма завантажить новий файл і порівняє його з вже завантаженими файлами.

Трьом вікнам вхідних даних буде призначено літери A, B і C. Літері A відповідатиме синій колір, B — зелений, а C — малиновий. (Це типові кольори, але ви можете їх змінити за допомогою меню «Параметри».)

За виявлення відмінності програма змінюватиме колір вмісту вікна вхідних даних. Якщо дані відрізнятимуться у обох вікнах вхідних даних, їх, типово, буде позначено червоним кольором (Колір конфліктів у вікні Параметри). Подібна схема кольорів особливо корисна у випадку порівняння трьох файлів вхідних даних, як це можна буде бачити з наступного розділу (Об'єднання).

Ліворуч від тексту буде показано «стовпчик резюме». Якщо у рядку буде знайдено відмінності, його буде показано відповідним кольором. Якщо відмінності полягають лише у розташуванні пробілів, у стовпчик резюме буде розфарбовано як шахівницю. Якщо ви працюєте з файлами вихідних кодів мовами програмування, де розташування пробілів не є важливим, ви зможете з першого погляду визначити, чи було змінено щось суттєве. (У C/C++ пробіли мають значення лише у рядках, коментарях, у рядках, призначених для інструменту попередньої обробки, і у певних досить екзотичних випадках.)

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

У правій частині області вікна, ліворуч від вертикальної смужки гортання, буде показано стовпчик «огляду». У цьому стовпчику буде показано резюме вхідних даних A. Ви зможете одразу побачити всі відмінності і конфлікти. Якщо використовується лише дві області вхідних даних, всі відмінності буде показано червоним кольором, оскільки відмінності у такому випадку є конфліктами. Чорною прямокутною рамкою буде показано видиму частину вхідних даних. Якщо файли, які порівнюються є достатньо об'ємними, кількість рядків у файлі може перевищити кількість пікселів у стовпчику огляду, отже декілька рядків відповідатимуть одній лінії у стовпчику огляду. У такому випадку показу конфліктів надаватиметься перевага перед показом простих відмінностей, які, у свою чергу, матимуть пріоритет перед відсутністю відмінностей. Отже буде показано всі відмінності і конфлікти. Наведення вказівника на певне місце у стовпчику огляду з наступним клацанням лівою кнопкою миші призведе до показу відповідного фрагмента файла у області показу.

Іноді алгоритмові обробки тексту, використаному у програмі, не вдається розташувати належні рядки один навпроти одного. У вас також може виникнути бажання порівняти фрагмент тексту з фрагментом тексту, розташованим у зовсім іншому місці файла, з яким виконується порівняння. У таких випадках ви можете вказати KDiff3 рядки для вирівнювання вручну. Позначте текст, вирівнювання якого ви бажаєте покращити за допомогою вказівника миші у першому перегляді даних так, як ви це робите, коли бажаєте скопіювати фрагмент тексту, а потім скористайтеся пунктом Додати вирівнювання різниці вручну з меню Diffview (клавіатурне скорочення Ctrl+Y). Поряд з вибраним фрагментом тексту у стовпчику огляду з'явиться жовтогарячий прямокутник. Повторіть процедуру для другої і (якщо така є) третьої області даних. KDiff3 негайно переобчислюватиме відмінності після виконання вами дій і вирівнюватиме вибрані рядки. Звичайно ж, деякі з рядків, які збігалися за попереднього порівняння, можуть стати відмінними за нового порівняння.

У поточній версії програми ви не можете втручатися вручну у процес об'єднання.

У певних випадках KDiff3 визначить забагато або замало розділів відмінностей для об'єднання. У такому випадку ви можете об'єднати або поділити існуючі розділи.

Додайте нові розділи: спочатку виберіть текст у рядках, які відповідають один одному у кожній з областей вхідних даних (так як ви це робите під час копіювання даних до буфера). Потім скористайтеся пунктом Розділити різницю на вибраному з меню Об'єднання. Розрізи буде додано над першим рядком і під останнім рядком вибраного тексту. Якщо ви бажаєте додати лише один розділ, виберіть текст, що починається з іншого розрізу розділів.

Щоб об'єднати розділи у всіх областях вхідних даних, оберіть певну частину рядків розділів, які слід з'єднати. (Ви можете з'єднувати декілька розділів за один крок.) Після цього оберіть пункт Об'єднати вибрані різниці з меню Об'єднання.

У області редактора виводу об'єднання також передбачено стовпчик резюме, розташований ліворуч. У цьому стовпчику буде показано літеру варіанта, з якого було взято рядок, або нічого, якщо всі у всіх трьох джерелах рядок є однаковим. Конфліктні рядки буде позначено символом знака питання («?»), а у самому рядку буде показано червоний запис «Конфлікт об'єднання». Оскільки порядкове розв'язання конфліктів є справою досить марудною, рядки буде впорядковано за групами з однаковими відмінностями і характеристиками конфліктів. Конфлікти, які полягають лише у розташуванні пробілів, буде відокремлено від інших конфліктів, щоб полегшити об'єднання файлів, де зміни у відступах було внесено до багатьох рядків.

Після наведення вказівника миші у стовпчику резюме будь-якої з областей на певну позицію і клацання лівою кнопкою миші програма відкриє у всіх вікнах фрагмент тексту на початку групи, до якої належить позначений клацанням рядок. Після цього група стане «поточною групою». Цю групу буде позначено Кольором тла поточного діапазону різниці (можна змінити за допомогою пункту Інтеграція діалогового вікна параметрів програми), а зліва від тексту буде показано чорну рамку.

На панелі з кнопками, розташованій під смужкою меню, містяться три кнопки вибору вхідних даних, які позначено літерами A, B і C. Натисніть кнопку вибору вхідних даних, щоб вставити рядки (або вилучити рядки, якщо ці рядки вже було раніше вставлено) з відповідного джерела. Щоб позначити рядки з декількох вхідних джерел натисніть відповідні кнопки у потрібному порядку. Наприклад, якщо ви бажаєте, щоб рядкам з B було надано перевагу перед рядками з A у вихідних даних, спочатку натисніть B, а вже потім A.

Якщо ви використовуєте автоматичний перехід (позначено пункт «Автоматично перейти до наступного конфлікту за визначення джерела»), вам слід вимкнути його перед вибором рядків з декількох джерел або редагуванням рядків після вибору. Якщо ви цього не зробите, KDiff3 перейде до наступного конфлікту після вибору першого джерела даних.

Часто корисно напряму змінити вивід об'єднання. У перегляді резюме буде показано літеру «m» навпроти всіх рядків, які було змінено вручну. Якщо, наприклад, відмінності вирівняно таким чином, що простого вибору потрібного джерела буде недостатньо, ви можете позначити потрібний текст і скористатися звичайною дією з копіювання з вставленням, щоб розмістити потрібний фрагмент тексту у області виводу об'єднання.

Іноді, якщо певний рядок було вилучено або у результаті автоматично об'єднання, або редагування, і у групі більше не залишиться жодного рядка, програма показуватиме у відповідному рядку текст <Немає рядка джерела>. Цей рядок є лише заповнювачем для групи на випадок, якщо ви зміните свою думку і захочете знову позначити якийсь текст. Відповідний текст заповнювача не буде показано у збереженому файлі, його не буде включено до жодного з фрагментів, які ви копіюватимете і вставлятимете.

Якщо ви спробуєте скопіювати і вставити певний текст, що містить такий рядок, у буфері обміну даними буде лише рядок «<Конфлікт об'єднання>». Але будьте обережними, коли виконуєте подібне копіювання.

Звичайне об'єднання починатиметься з автоматичного розв'язання простих конфліктів. Але у меню Об'єднання передбачено і деякі інші пункти для виконання типових завдань. Якщо ви бажаєте вибрати певне джерело даних для розв'язання більшості конфліктів, ви можете вказати джерело A, B або C всюди або лише для ще нерозв'язаних конфліктів або для нерозв'язаних конфліктів, що полягають у різній кількості пробілів. Якщо ви бажаєте вирішувати кожен з конфліктів окремо, ви можете позначити пункт Застосувати різницю до конфліктів. Якщо ви бажаєте повернутися до автоматичного вибору KDiff3, скористайтеся пунктом Автоматично розв'язувати прості конфлікти. Після вибору цього пункту KDiff3 виконає об'єднання повторно. Якщо використання певного пункту меню змінюватиме результати попереднього редагування, KDiff3 запитає у вас підтвердження, перш ніж виконувати відповідну дію.

Значна кількість систем керування версіями підтримує особливі ключові слова (наприклад "$Date$", "$Header$", "$Author$", "$Log$" тощо). Під час синхронізації системи керування версіями змінюють ці рядки. Наприклад, "$Date$" перетвориться на "$Date: 2009/03/22 18:45:01 $". Оскільки цей рядок буде різним у кожній з версій файла, під час спроби об'єднання потрібне буде втручання користувача.

У KDiff3 передбачено автоматичне об'єднання таких елементів. Для простих рядків, які відповідатимуть значенню параметра «Формальний вираз автооб'єднання» у всіх файлах вхідних даних, KDiff3 обере рядок з B або, у разі доступності, з C. Крім того, потрібно, щоб відповідні рядки стояли поруч у області порівняння, а попередній рядок не містив конфліктів. Подібне автоматичне об'єднання можна виконати або негайно після запуску об'єднання (позначенням пункту Запустити автооб'єднання за формальними виразом на початку об'єднання»), або пізніше, за допомогою пункту меню Об'єднання → Запустити автооб'єднання за формальними виразом на початку об'єднання.

Програмою підтримується і автоматичне об'єднання за журналом системи керування версіями. Автоматичне об'єднання за журналом можна виконати негайно після запуску об'єднання, якщо позначити пункт Об'єднувати за журналом керування версіями на початку об'єднання або пізніше за допомогою пункт меню Об'єднання → Автоматично розв'язувати конфлікти у журналі.

Зазвичай, журнал системи керування версіями починається з рядка, що містить ключове слово «$Log$». Початок журналу має відповідати значенню параметра Початковий формальний вираз журналу. KDiff3 визначає, які з рядків належать до журналу, аналізуючи початкові символи, які передують ключовому слову «$Log$». Якщо такі самі «початкові коментарі» зустрічаються і у наступних рядках, ці рядки також буде включено до журналу.

Під час кожної транзакції система керування версіями записує унікальний рядок з відомостями щодо версії, дати і часу транзакції та коментарів користувача. З цих елементів утворюється окремий запис журналу. Цей розділ журналу збільшується під час кожної транзакції, найсвіжіші записи з'являтимуться у верхній частині журналу (після початкового рядка журналу).

Якщо під час розробки двоє або декілька розробників вивантажують свої версії одного файл, у журналі об'єднання міститимуться декілька записів, які вважатимуться конфліктними під час об'єднання гілок. Оскільки подібні об'єднання можуть бути досить марудною справою, у KDiff3 передбачено підтримку двох можливих стратегій: простої вставки інформації від обох розробників у верхню частину журналу або впорядкування інформації журналу за визначеним користувачем ключем.

Налаштувати спосіб одночасної вставки всіх записів простіше. Слід просто вказати KDiff3 метод визначення рядків, які належатимуть до одного запису журналу. У більшості систем керування версіями після кожного запису журналу додається порожній рядок. Якщо система керування версіями не додає порожніх рядків у інших випадках, подібні рядки можуть слугувати достатнім критерієм для KDiff3. Достатньо вказати порожнє значення для параметра Початковий формальний вираз елемента історії на сторінці Об'єднання діалогового вікна параметрів програми. Якщо використання критерію порожнього рядка є недостатнім, ви можете вказати формальний вираз, за яким можна визначити початок запису журналу.

Зауважте, що KDiff3 вилучатиме записи журналу, що повторюватимуться. Якщо запис журналу зустрічається декілька разів у журналі певного вхідного файла, у виведених даних залишиться лише один запис.

Якщо ви бажаєте впорядкувати журнал, вам слід вказати спосіб побудови ключа впорядкування. Скористайтеся круглими дужками у полі параметра Початковий формальний вираз елемента історії на сторінці Об'єднання діалогового вікна параметрів програми для групування частин формального виразу, який пізніше буде використано як ключ впорядкування. Після цього вкажіть у полі Порядок сортування початків записів за ключем відокремлений комами список чисел, які відповідають позиції групи у формальному виразі.

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

Приклад: припустімо журнал виглядає так:

/**************************************************************************
** HISTORY:    $Log: \toms_merge_main_view\MyApplication\src\complexalgorithm.cpp $
**
**     \main\integration_branch_12   2 Apr 2001 10:45:41   tom
**  Merged branch simon_branch_15.
**
**     \main\henry_bugfix_branch_7\1   30 Mar 2001 19:22:05   henry
**  Improved the speed for subroutine convertToMesh().
**  Fixed crash.
**************************************************************************/

Початковому рядку журналу відповідатиме формальний вираз ".*\$Log.*\$.*". Після цього рядка йдуть записи журналу.

Рядок з записом ключового слова «$Log$» починається з двох символів «*», за якими слідує пробіл. KDiff3 вважає перший непробільний рядок «початковим коментарем» і припускає, що журнал завершується першим же рядком без такого коментаря. У нашому прикладі останній з рядків завершується фрагментом тексту, який також починається з двох символів «*», але замість символу пробілу за ними слідують додаткові символи «*». Отже цей рядок є кінцевим рядком журналу.

Якщо впорядкування журналу не потрібне, формальний вираз початку запису журналу може виглядати так (рядок було розбито на два через обмеження на довжину):

\s*\\main\\\S+\s+[0-9]+ (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)
 [0-9][0-9][0-9][0-9] [0-9][0-9]:[0-9][0-9]:[0-9][0-9]\s+.*

Докладніше про формальні вирази можна дізнатися з документації щодо формальних виразів. Зауважте, що «\s» (з маленьким «s») відповідає будь-якій кількості пробілів, а «\S» (з великим «S») відповідає будь-якій послідовності символів, що не містить пробілів. У нашому прикладі початок запису журналу містить спочатку інформацію про версію з формальним виразом «\\main\\\S+», дату, що складається з дня «[0-9]+», місяця «(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)» і року «[0-9][0-9][0-9][0-9]», час у форматі «[0-9][0-9]:[0-9][0-9]:[0-9][0-9]» і нарешті назву облікового запису розробника «.*».

Зауважте, що символи «початкового коментаря» (у нашому прикладі «**») буде попередньо вилучено KDiff3 ще перед порівнянням, отже формальний вираз починається з пошуку жодного або іншої кількості символів пробілу «\s*». Оскільки символи коментаря можуть бути різними у різних файлах (наприклад, у C/C++ використовуються символи коментування, відмінні від тих, які використовуються у скриптах Perl), KDiff3 сам визначає початкові символи коментаря, отже вам не потрібно вказувати їх у формальному виразі.

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

\s*\\main\\(\S+)\s+([0-9]+) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)
 ([0-9][0-9][0-9][0-9]) ([0-9][0-9]:[0-9][0-9]:[0-9][0-9])\s+(.*)

Тепер у дужках містяться: 1. інформація про версію, 2. день, 3. місяць, 4. рік, 5. час, 6. назва облікового запису. Але якщо нам потрібне впорядкування за часом і датою, доведеться побудувати ключ впорядкування за допомогою елементів у іншій послідовності: спочатку рік, далі місяць, день, час, інформація про версію і назва облікового запису. Отже, порядок рядків має бути таким: «4,3,2,5,1,6».

Оскільки назви місяців не є гарним критерієм впорядкування (наприклад, «Apr» (квітень) буде першим), KDiff3 проаналізує послідовність, у якій було вказано назви, а потім використає замість назв відповідні номери («Apr»->«04»). Якщо буде знайдено якесь число, програма перетворить його на 4-цифрове значення за допомогою додавання початкових нулів, а потім застосує впорядкування. Нарешті, остаточний ключ впорядкування для початкового рядка першого запису журналу виглядатиме так:

2001 04 0002 10:45:41 integration_branch_12   tom

Докладніші відомості можна отримати з розділу Параметри об'єднання.

Крім того, передбачено кнопку Автоматично перейти до наступного конфлікту за визначення джерела (автоматичне продовження). Якщо ви позначите відповідний пункт, за вибору одного з джерел KDiff3 переходитиме до наступного нерозв'язаного конфлікту у автоматичному режимі. Подібна поведінка буде корисною, якщо ви маєте намір під час розв'язання завжди обирати лише одне з джерел даних. Якщо вам потрібні два джерела, або результат доведеться редагувати, ймовірно, вам слід зняти позначку з відповідного пункту. Перш ніж перейти до наступного нерозв'язаного конфлікту, KDiff3 деякий час показуватиме вам результат вашого вибору. Тривалість затримки можна визначити у параметрах Об'єднання: ви можете вказати значення Автоматичне продовження за (у мс) у діапазоні від 0 до 2000. Підказка: втомилися клацати? — зменшіть значення автоматичного продовження і скористайтеся клавіатурними скороченнями Ctrl+1/2/3 для вибору джерела A/B/C, якщо конфліктів дуже багато.

Вибрати моноширинний шрифт. (У деяких системах у цьому діалоговому вікні буде показано і шрифти зі змінною шириною символів, але вам не слід їх використовувати.)

Зміна кольорів у режимі порівняння тек набуде чинності лише під час наступного порівняння тек.

У системах, відеопідсистема яких може показувати лише 16 або 256 кольорів, певні кольори не можна буде показати у початковій формі. У таких системах точний колір можна вибрати за допомогою кнопки Типовий.

Під час порівняння файлів KDiff3 спочатку намагається знайти однакові рядки у всіх файлах вхідних даних. Лише на цьому етапі програма може ігнорувати пробіли. На другому етапі програма порівнює всі рядки окремо. На цьому етапі програма не ігноруватиме пробіли. Крім того, пробіли не ігноруватимуться під час об'єднання.

Ці параметри використовуватимуться під час сканування теки і виконання об'єднання: докладніше про це можна дізнатися з розділу щодо порівняння тек/об'єднання.

Крім того, тут є ще один параметр, пов'язаних зі збереженням окремих файлів:

(Доступ до цих параметрів можна отримати за допомогою меню або кнопок панелі інструментів.)

У поточній версії програми можливість налаштування клавіатурних скорочень користувачем підтримується лише у версії програми для Frameworks. (Меню Параметри → Налаштувати скорочення...)

Цей розділ є лише вступом, у якому обговорено найпростіші можливості команди sed. Докладніші відомості можна знайти на сторінці info:/sed або http://www.gnu.org/software/sed/manual/html_mono/sed.html. Зібрану версію цієї програми для Windows® можна знайти за адресою http://unxutils.sourceforge.net. Зауважте, що у наведених нижче прикладах припускається, що файл програми sed зберігається у одній з тек, які вказано у змінній середовища PATH. Якщо це не так, вам доведеться вказувати повний абсолютний шлях до файла програми.

У цьому контексті використовується лише команда заміни sed:

sed 's/ФОРМАЛЬНИЙ_ВИРАЗ/ЗАМІННИК/ПРАПОРЦІ'

Перш ніж користуватися новою командою у KDiff3, вам слід спочатку випробувати її у консолі. Для такої перевірки вам знадобиться команда echo. Приклад:

echo abrakadabra | sed 's/a/o/'
   -> obrakadabra

У цьому прикладі ми продемонстрували дуже просту команду sed, яка заміняє перше знайдене «a» на «o». Якщо ви бажаєте замінити всі «a», вам слід скористатися прапорцем «g»:

echo abrakadabra | sed 's/a/o/g'
   -> obrokodobro

Символ «|» використовується для створення конвеєрів: дані, виведені попередньою командою, передаються як вхідні дані наступній команді. Якщо ви бажаєте виконати перевірку на великому файлі, вам слід скористатися командою cat у UNIX®-подібних системах або командою type у Windows®-подібних системах. sed виконає заміну у всіх рядках.

cat назва файла | sed параметри

Дані буде пропущено через всі внутрішні та зовнішні препроцесори у такому порядку:

Після обробки звичайним препроцесором дані не буде змінено: їх буде показано і об'єднано у початковому вигляді. За допомогою інших дій у програмі можна буде змінити лише дані, які було повернуто алгоритмом пошуку відповідних рядків.

У рідкісних випадках використання звичайного препроцесора зауважте, що препроцесор пошуку відповідних рядків оброблятиме лише рядки, передані йому звичайним препроцесором.

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

З цієї причини під час об'єднання, якщо було використано звичайну команду-препроцесор, KDiff3 повідомить вас про це і запитає про те, бажаєте ви вимкнути наслідки дії цієї команди чи ні. Але програма не попереджатиме вас про використання команди-препроцесора, призначеної для пошуку відповідних рядків. Об'єднання не буде завершено, доки ви не розв'яжете всі конфлікти. Якщо ви знімете позначку з пункту «Показувати пробіли», відмінності, які було вилучено командою-препроцесором пошуку відповідних рядків, також стануть невидимими. Якщо після цього ви не зможете зробити кнопку «Зберегти» активною під час об'єднання (оскільки залишатимуться не розв'язані конфлікти), знову позначте пункт «Показувати пробіли». Якщо ви не бажаєте виконувати розв'язання цих малозначущих конфліктів вручну, ви можете скористатися пунктами «Вибрати A/B/C для всіх нерозв'язаних конфліктів пробілів» з меню «Об'єднання».

kdiff3 тека1 тека2
   kdiff3 тека1 тека2 -o тека_призначення

Якщо не буде вказано теки призначення, KDiff3 використовуватиме тека2.

kdiff3 тека1 тека2 тека3
   kdiff3 тека1 тека2 тека3 -o тека_призначення

Якщо об'єднуються три теки, базовою для об'єднання буде тека1. Якщо теки призначення не вказано, KDiff3 використає з цією метою тека3.

Зауважте, що автоматично починається лише порівняння, але не об'єднання. Щоб виконати об'єднання, вам слід скористатися відповідним пунктом меню або натиснути клавішу F7 (докладніше про це згодом).

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

Типово, теки буде згорнуто. Розгортати або згортати теки можна натисканням кнопки «+»/«-», подвійним на позначці теки або за допомогою натискання клавіш зі стрілочками ліворуч і праворуч на клавіатурі. Крім того, у меню Тека міститься два пункти, Згорнути всі підтеки і Розгорнути всі підтеки, за допомогою яких ви можете згортати або розгортати всі теки одразу.

Після наведення вказівника миші на позначку файла з наступним подвійним клацанням лівою кнопкою миші буде відкрито перегляд відмінностей для відповідного файла.

Зображення у стовпчику назви відповідатиме типу файла у першій теці (A). Можливі такі варіанти:

Якщо типи файлів у теках відрізнятимуться, ви зможете помітити це за стовпчиками A/B/C, а також за вікном докладними відомостями щодо вибраного пункту. Зауважте, що у таких випадках вибір автоматичного об'єднання неможливий. Якщо користувач викличе дію з об'єднання, його буде попереджено про проблеми з типом файлів.

Як можна бачити на наведеному вище зображенні для стовпчиків A/B/C використовуються червоний, зелений, жовтий і чорний кольори.

Але елементи, які є однаковими у всіх теках колір теж буде однаковим, хоча їх вік і відрізнятиметься.

Теки вважатимуться однаковими, якщо всі елементи, які у них містяться, є однаковими. Однакові елементи програма показуватиме однаковим кольором. Під час визначення кольору вік теки до уваги не братиметься.

Ідею подібного розфарбування запозичено з програми dirdiff. Кольори відповідають кольорам листя: воно зелене, коли тільки-но з'являється на деревах, пізніше перетворюється на жовте, а згодом на червоне.

Після порівняння тек KDiff3 намагається визначитися пропозиціями щодо дії з об'єднання. Ці пропозиції буде показано у стовпчику Дія. Ви можете змінити дію натисканням позначки дії, яку ви бажаєте змінити. Програма відкриє невеличке меню, за допомогою якого ви зможете вибрати дію для відповідного пункту. Крім того, ви можете вибрати одну з найпоширеніших дій за допомогою клавіатури. Натискання комбінацій клавіш Ctrl+1/2/3/4/Del призведе до вибору дій A/B/C/Об'єднати/Вилучити, відповідно. Вибрану вами дію буде виконано під час об'єднання. Перелік можливих дій і режим об'єднання залежатиме від вибраного пункту. Можливі такі режими об'єднання:

Під час виконання об'єднання трьох тек логіка програми виглядає так: Якщо елемент...

Під час виконання об'єднання двох тек логіка програми виглядає так: Якщо елемент...

Режим синхронізації буде задіяно, лише якщо виконується порівняння двох тек, а призначення не вказано явним чином, і якщо позначено пункт Синхронізувати теки. У такому разі KDiff3 обере типову дію, після виконання якої обидві теки будуть однаковими. Якщо...

Якщо виконується об'єднання двох тек і позначено пункт Копіювати новіший, замість об'єднання, KDiff3 виконуватиме визначення дат зміни файлів і пропонуватиме вибрати новіший файл. Якщо файли мають різний вміст, але однакову дату зміни, дія міститиме напис «Помилка: Дати однакові, а файли відрізняються». У такому разі, хоча елементи існують, неможливо розпочати об'єднання тек.

Під час об'єднання файли оброблятимуться один за одним. У стовпчику стану буде показано слово Виконано для пунктів, для яких дія з об'єднання була успішною, та інший текст, якщо сталося щось непередбачене. Після завершення дії об'єднання вам слід перевірити, чи для всіх пунктів стан об'єднання є задовільним.

Якщо у параметрах програми увімкнено режим Повний аналіз, KDiff3 покаже додаткові стовпчики з кількістю нерозв'язаних і розв'язаних конфліктів, а також кількістю конфліктів у пробілах і конфліктів, не пов'язаних з пробілами. Стовпчик розв'язаних конфліктів буде показано лише у випадку порівняння або об'єднання трьох тек.

Переліком файлів, показаних у цьому списку, керує декілька параметрів. Доступ до деяких з них можна отримати за допомогою діалогового вікна параметрів. У меню Тека містяться такі пункти:

Позначте пункти Показувати лише для тих елементів, які ви бажаєте бачити у списку. Якщо, наприклад, ви бажаєте бачити у списку лише ті елементи, які існують або у A, або у B, але не у обох теках, вам слід позначити пункти Показувати файли лише у A і Показувати файли лише у B і зняти позначки з усіх інших пунктів (Показувати однакові файли, Показувати різні файли, Показувати файли лише у C). Після внесення змін список буде негайно оновлено відповідним чином.

Ці параметри буде також використано і для тек, за одним винятком: зняття позначки з пункту Показувати різні файли не призведе до приховування жодної з тек. Цей параметр призначено лише для файлів у цих теках.

Зауважте, що серед усіх цих параметрів програма зберігатиме значення лише параметра Показувати однакові файли. Інші пункти буде знову позначено після наступного запуску KDiff3.

Зазвичай, перегляд списку об'єднання тек залишатиметься видимим під час порівняння або об'єднання окремого файла. За допомогою вказівника миші ви можете пересунути смужку роздільника, який відокремлює список файлів від областей відмінностей у тексті. Якщо ж такий варіант вас не влаштовує, ви можете зняти позначку з пункту «Розділений перегляд тексту і тек» меню «Тека». Після цього ви можете скористатися пунктом «Перемкнути перегляд» меню «Тека» для перемикання між списком і переглядом відмінностей у тексті, кожен з яких повністю використовуватиме площу вікна програми.

Ймовірно, ви надасте перевагу простому подвійному клацанню лівою кнопкою миші на позначці файла для його порівняння. Крім того, ви можете скористатися відповідним пунктом з меню Тека. Ви також можете безпосереднього наказати програмі виконати об'єднання окремого файла: достатньо вибрати цей файл і скористатися пунктом Об'єднати поточний файл з меню Об'єднання. Після зберігання результату стан відповідного пункту у списку буде змінено на «Виконано», програма не виконуватиме повторного об'єднання, якщо ви накажете їй виконати об'єднання цілих тек.

Але зауважте, що ці дані про стан буде втрачено, якщо ви накажете програмі повторно виконати сканування тек: меню Тека, пункт Пересканувати

Іноді у вас виникатиме потреба у порівнянні або об'єднанні файлів з різними назвами (наприклад поточного файла і його резервної копії у цій же теці).

Оберіть потрібний файл натисканням піктограми на стовпчику A, B або C. Перший з файлів, вибраних у такий спосіб буде позначено як A, другий і третій — B і C, незалежно від стовпчика, у якому їх було відкрито. Таким чином можна обирати не більше трьох файлів.

Скористайтеся пунктом Порівняти явно вибрані файли або Об'єднати явно вибрані файли з меню Тека. Для зручності ці пункти меню є і у контекстному меню кожного з файлів. Викликати контекстне меню можна за допомогою наведення вказівника миші на позначку файла з наступним клацанням правою кнопкою миші.

Порівняння або об'єднання файлів відбувається у одному вікні. Якщо цим методом скористатися для тек, програма відкриє нове вікно.