Работа с исправлениями
Исправления позволяют разработчикам вести совместную работу, не обращаясь к хранилищу.
Это полезно в тех случаях, когда разработчик желает внести свой вклад в проект, разрабатываемый в хранилище, к которому у него нет прав доступа на запись. В таких случаях разработчик может создать исправление и отправить его по электронной почте другому разработчику, у которого есть доступ на запись, или вложить исправление в сообщение об ошибке для системы учета ошибок на сервере разработки, согласно тому, как организована работа над проектом. Далее разработчик, у которого есть доступ на запись, может объединить исправление с проектом и внести изменения в хранилище.
Для того чтобы создать исправление из проекта CVS, выполните следующие действия:
- Выберите ресурс, содержащий изменения, которые будут включены в исправление. Можно выбирать ресурсы, хранящиеся в нескольких проектах и разных уровнях, так как мастер создания исправлений (при его запуске в режиме по умолчанию) может создавать исправления для нескольких проектов. Исправление следует устанавливать для тех же ревизий файлов, на основе которых оно было создано. Поэтому следует убедиться, что исправление применяется для того же самого среза ресурсов. Проще всего это достигается при создании исправления на основе версии.
- В выпадающем меню выберите Совместная работа > Создать исправление.... Откроется мастер Создать исправление.
- Укажите, где следует сохранить исправление:
- Сохранить в буфере обмена - исправление будет помещено в буфер обмена, откуда его можно будет вставить в текстовый редактор, например, в сообщение электронной почты.
- Сохранить в файле - исправление будет сохранено в заданном файле локальной файловой системы.
- Сохранить в рабочей области - исправление будет сохранено в заданном файле в одном из существующих проектов рабочей области.
Для исправлений небольшого размера перенос исправление через буфер обмена может быть оправдан, но в большинстве случаев рекомендуется использовать локальную файловую систему.
- Можно предварительно просматривать и доводить вариант исправления, раскрыв дерево ресурсов в панели Изменения. В исправление будут включены только элементы, отмеченные галочкой. Для настройки создания исправления нажмите Далее.
- Укажите, каким образом следует настроить исправление:
- В формате вывода diff - Позволяет выбрать один из форматов вывода diff. Unified - это формат, применяемый во многих приложениях исправлений, включая Eclipse. Формат, используемый в форматах вывода diff Context и Unified, позволяет применить исправление, даже в том случае, если неверно задан номер строки, указанный для hunk (терминология исправлений). Тогда, в процессе применения исправления, алгоритм выполняет сканирование в прямом и обратном направлениях, чтобы найти набор строк, который соответствует контексту, заданному для hunk.
- Корень исправления - определяет уровень, на котором расположен корень исправления. Возможные варианты - Рабочая область, Проект и Ресурс.
Вариант Рабочая область (выбор по умолчанию) позволяет включить в исправление ресурсы из нескольких проектов. Исправления для Рабочей области содержат достаточно информации для того, чтобы мастер Применения исправлений нашел необходимый ресурс в рабочей области.
Исправления, имеющие корень на уровне Проекта, могут содержать ресурсы конкретного проекта и должны быть применены к тому же самому проекту.
Исправления, имеющие корень на уровне Ресурса, применяются к тому же ресурсу.
- Нажмите Готово.
- После этого примените исправление для соответствующего проекта.
Для того чтобы установить исправление, выполните следующие действия:
- Выберите ресурс, для которого было создано исправление. Этот ресурс должен содержать те же самые ревизии файлов, для которых было создано исправление.
- В выпадающем меню выберите Совместная работа > Установить исправление.... Откроется мастер
Применение исправления.
То же самое можно сделать копированием содержимого исправления в буфер обмена
и вставкой непосредственно на панель Структура пакетов выбором команд Изменить > Вставить.
В этом случае можно пропустить следующий этап.
- Укажите, где расположено исправление:
- Файл - исправление хранится в файле локальной файловой системы. Введите полный путь к файлу или найдите его с помощью кнопки Обзор....
- Буфер обмена - исправление скопировано в буфер обмена. Предупреждение: безопаснее работать с исправлениями, хранящимися в файлах. При работе с буфером обмена могут быть ошибки, связанные с различиями в окончаниях строк, если исправление было создано на другой платформе (например, в Linux, а не в Windows).
- URL - на исправление указывает данный URL. Предупреждение:
Убедитесь, что введенный URL достоверен и содержит соответствующее исправление.
В противном случае исправление не будет применено. Также возможно,
что применение исправления непосредственно из URL может потребовать времени.
- Рабочая область - исправление сохранено в рабочей области.
Нажмите Далее, чтобы просмотреть результат установки исправления.
-
Дополнительный шаг: этот шаг выполняется только для исправлений, имеющих корень на уровне проекта или ресурса.
Для исправлений, имеющих корень на уровне рабочей области, будет автоматически открыта страница предварительного просмотра исправления. На странице указания места назначения исправления необходимо выбрать ресурс, который будет корнем исправления.
- На странице предварительного просмотра исправления показано, было ли исправление успешно установлено для файлов в рабочей области. Верхняя панель содержит список изменений, содержащихся в исправлении.
Там есть два вида записей: изменения файлов и сегменты исправлений без совпадений (известные как "кусок" в терминах patch).
- Если к файлу автоматически могут быть применены один или более сегментов исправления, файл будет показан
с индикатором входящих изменений. Изменение можно просмотреть, щелкнув два раза на файле.
- Если один или более кусков не могут быть применены автоматически, записи кусков появятся в качестве дочерних
по отношению к файлам в верхней панели, а красный восклицательный знак будет указывать на неполадку с исправлением или куском.
Кусок можно просмотреть, щелкнув на нем два раза. Затем можно вручную применить кусок из правой панели
к файлу в левой панели. Сохранение в левой панели обновит родительскую запись файла в верхней панели, но
не изменит файл на диске. Файл на диске изменится только, когда будет нажата кнопка Завершить.
Для того чтобы установить исправление полностью и корректно, необходимо устранить неполадки
(красные восклицательные знаки), вручную применив сегменты исправления, исключив сегмент исправления из работы
с помощью выбора Удалить из контекстного меню или настроив параметры мастера, как описано ниже в разделе Опции.
- Если все выполнено успешно, нажмите Готово, чтобы установить исправление. Теперь рабочая область будет содержать исходящие изменения для каждого файла, затронутого исправлением.
Исправления могут применяться путем синхронизации их с локальным содержимым
Для синхронизации с исправлением выполните следующее:
-
В проекции Синхронизация Совместной работы выберите действие Синхронизировать...
из группы действий кнопки выпадающего списка Синхронизация
.
-
Выберите Синхронизировать с исправлением из списка возможных типов синхронизации
и нажмите кнопку Далее.
- Укажите, где расположено исправление:
- Файл - исправление хранится в файле локальной файловой системы. Введите полный путь к файлу или найдите его с помощью кнопки Обзор....
- Буфер обмена - исправление скопировано в буфер обмена. Предупреждение: безопаснее работать с исправлениями, хранящимися в файлах. При работе с буфером обмена могут быть ошибки, связанные с различиями в окончаниях строк, если исправление было создано на другой платформе (например, в Linux, а не в Windows).
- URL - на исправление указывает данный URL. Предупреждение:
Убедитесь, что введенный URL достоверен и содержит соответствующее исправление.
В противном случае исправление не будет применено. Также возможно,
что применение исправления непосредственно из URL может потребовать времени.
- Рабочая область - исправление сохранено в рабочей области.
Нажмите Далее, чтобы просмотреть результат установки исправления.
-
Дополнительный шаг: этот шаг выполняется только для исправлений, имеющих корень на уровне проекта или ресурса.
Для исправлений, имеющих корень на уровне рабочей области, будет автоматически открыта страница предварительного просмотра исправления. На странице указания места назначения исправления необходимо выбрать ресурс, который будет корнем исправления.
-
Дополнительный шаг: этот шаг выполняется, только если исправление относится к недоступным проектам. Если все проекты из исправления присутствуют в рабочей области
и открыты, то эта страница будет пропущена. На странице Недоступные проекты можно открыть любой закрытый проект. Кроме того, выводятся сведения о несуществующих проектах.
Исправление не может быть применено к закрытым и несуществующим в рабочей области проектам.
-
На конечной странице нажмите кнопку Готово для просмотра изменений в результате исправлений на панели Синхронизация.
Опции для установки исправления
Следующие опции служат для того, чтобы можно было успешно установить файл исправления:
-
Вернитесь на первую страницу мастера Применить исправление и выберите именно те ресурсы, для которых был создан этот файл исправления.
-
Если общая часть пути к файлам исправления не соответствует путям в рабочей области, выберите Без учета начального пути.
-
Опция Без учета пробелов позволяет игнорировать различия в пробелах между файлом исправления и файлами рабочей области.
-
Измените Коэффициент отличия (терминология исправлений). Этот коэффициент указывает на количество строк контекста hunk, которые будут проигнорированы.
Если указан нулевой коэффициент отличия, то должны совпадать все строки.
Если коэффициент отличия больше нуля (например, 2), то игнорируются первые и
последние две строки контекста.
Нажмите Оценить для расчета коэффициента отличия, позволяющего
максимальному числу кусков иметь соответствия.
-
Параметр Отменить исправление служит для удаления исправления, которое было применено для файлов рабочей области. Так можно отменить исправление или установить его повторно.
-
Для изменений на уровне рабочей области можно применить изменение к другому проекту в рабочей области. Для этого выберите проект в верхней панели и выберите Переместить из контекстного меню. Откроется окно со списком доступных проектов в рабочей области. Для применения исправления к проекту выберите проект и нажмите OK.
-
Используйте опцию Показать исключения для отображения
кусков, которые были выбраны для исключения из исправления.
-
При синхронизации с исправлением рассмотренные опции доступны в выпадающем меню панели Синхронизация.
Также можно переключаться между доступными моделями для получения дополнительной информации о примененных изменениях.

Коллективное программирование с помощью CVS

Сравнение ресурсов
Синхронизация с хранилищем

Коллективная работа
CVS