Использование Emacs совместно с системами контроля версий

Основной командой в пакете VC является vc-next-action, которая выполняет следующую логическую команду для данной системы контроля версий. В зависимости от используемой системы контроля версий, порядок команд в цепочке действий может отличаться.

Для систем, которые требуют блокировки файла (это RCS, SCCS, и CVS при соответствующей настройке), порядок действий следующий:

Для систем не поддерживающих концепцию блокировок, порядок выполнения действия следующий:

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

Ввод описания изменения производится в специальном буфере, который называется *VC-Log*. В нем вы можете ввести сообщение, и подтвердить изменения используя сочетание клавиш C-c C-c, находясь в этом буфере. Чтобы не подтверждать изменения, просто покиньте это буфер без использования C-c C-c. А если вы хотите использовать одно и то же сообщение для нескольких файлов, то вы можете воспользоваться сочетаниями клавиш M-n, M-p, M-s и M-r, которые работают так же как и в мини-буфере, позволяя перемещаться по истории сообщений.

Пакет VC позволяет пользователю просматривать изменения внесенные в процессе работы с файлами. Для получения списка изменений между вашей рабочей версией и последней подтвержденной версией, пользователь может воспользоваться командой vc-diff (сочетание клавиш C-x v =). При использовании данной команды с префиксным аргументом, пользователь может получить список изменений между двумя произвольными версиями. Команда vc-version-other-window (сочетание C-x v ~) позволяет получить произвольную версию файла, и показать ее в отдельном буфере. А некоторые версии систем контроля версий позволяют получать аннотированные версии файлов, находящихся под управлением системы контроля версий. Эту задачу реализует команда vc-annotate, которая запускается сочетанием C-x v g. Аннотированная версия позволяет понять как вносились изменения, и просматривать изменения внесенные в конкретных версиях.

Вы можете отменить внесенные изменения с помощью команд, определенных пакетом. Пакет определяет две команды отмены изменений — vc-revert-buffer (сочетание C-x v u), которая возвращает файл связанный с буфером к версии, на которой он был основан, а команда vc-cancel-version (сочетание C-x v c) отменяет последнее подтвержденное изменение. Для последней команды, вы можете не откатывать изменения для текущего буфера, так что вы можете внести новые изменения, основанные на промежуточных результатах. После выполнения команды vc-revert-buffer файл остается не заблокированным, так что для внесения изменений, вас необходимо снова заблокировать его.

Регистрация файла в системе контроля версий производится с помощью команды vc-register (сочетание клавиш C-x v i). Выбор системы контроля версий в которой файл будет зарегистрирован, зависит от нескольких параметров. Если в данном каталоге есть файлы, зарегистрированные в какой-либо системе контроля версий, то используется именно она. Если в каталоге находятся файлы зарегистрированные в нескольких системах контроля версий, то используется та, которая находится первой в списке vc-handled-backends. А если нет ни одного зарегистрированного файла в данном каталоге, то используется первая запись из списка vc-handled-backends. Так что вы зарегистрируете файл в CVS в пустом каталоге только явно указав использовать эту систему контроля версий :-)

По умолчанию, новый файл получает номер версии равный 1.1. Вы можете использовать другое число, если вы используете числовой аргумент при выполнении данной команды. В том случае, если переменная vc-initial-comment имеет не пустое значение, то данная команда запросит у пользователя комментарий, который будет использован для описания файла.

Пакет VC поддерживает переименование зарегистрированных файлов. Для этой цели вы можете использовать команду vc-rename-file, которая переименовывает рабочий файл, а также «главный» файл. К тому же эта команда, обновляет все снимки, чтобы они ссылались на новое имя файла. Но вы не можете использовать эту команду для заблокированных файлов.

Для получения информации о текущем файле вы можете использовать команду vc-print-log, которая привязана к сочетанию клавиш C-x v l. Данная команда отображает историю изменений, включая текст комментариев к этим изменениям.

Команды описанные в предыдущих разделах в первую очередь предназначены для работы с отдельными файлами. Но для больших проектов, часто необходимо работать с множеством файлов — просматривать какие файлы изменились, список изменений и т.п. Для реализации этих действий, пакет VC поддерживает специальный режим — vc-dired-mode. Для создания буфера, использующего такой режим, используется команда vc-directory (сочетание C-x v d). Буфер созданный такой командой почти не отличается от обычного буфера Dired. В буфер помещается рекурсивный список файлов, зарегистрированных в системе контроля версий.

При работе с буфером dired, данные могут отображаться в сокращенном или полном режиме. В сокращенном режиме показываются только измененные или не обновленные файлы. В полном режиме, показываются все файлы зарегистрированные в системе контроля версий. Пользователь может переключаться между полным и сокращенным режимом с помощью сочетания клавиш v t. При показе данных в буфере, отображается имя пользователя (для систем поддерживающих блокировки) или статус файла (для остальных систем).

В буфере с vc-dired-mode действуют все команды dired, за исключением команды v, которая используется в качестве префиксной для команд пакета VC. Команды VC те же самые, что и описанные в прочих разделах, только не используется префикс C-x, и они могут выполняться к множеству помеченных файлов.

Как и другие пакеты для интеграции с системами контроля версий, пакет VC поддерживает работу с разными ветвями версий. Пакет поддерживает создание ветвей, переключение между ними, а также слияние изменений между разными ветвями. Для переключения на другую ветвь разработки пользователю необходимо лишь задать префиксный аргумент для команды vc-next-action. Пользователь может указывать не конкретную версию, а лишь номер ветви. Следующая работа будет производиться именно в этой ветви.

Создание новой версии производится аналогичным образом — необходимо лишь при подтверждении изменений с помощью команды vc-next-action указать новый номер версии используя префиксный аргумент. Если пользователь укажет номер для не существующей ветви, то она будет создана. После создания ветви, все остальные действия будут производиться в рамках этой ветви. Для работы с другой веткой, пользователь должен явно переключиться на нее.

Для слияния изменений используется команда vc-merge, которая привязана к сочетанию клавиш C-x v m. Данная команда запрашивает у вас откуда необходимо брать изменения, и применяет их к вашей рабочей версии. Если вы ничего не ввели в ответ на запрос, то будут взяты изменения из ветви с которой вы работаете, если они были подтверждены за время работы с вашим файлом. Если во время работы возникают конфликты, то пакет оповещает пользователя об этом, и помечает конфликты в файле, или даже может запустить Ediff для их разрешения. Вы можете воспользоваться командой vc-resolve-conflicts для разрешения возникших конфликтов. Она запускает новую сессию Ediff, где вы можете просматривать возникшие конфликты, и применять или отвергать предлагаемые изменения.

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

При первом редактировании файла, создается локальная копия изменяемого файла. Это позволяет выполнять команды получения списка изменений, или отмены внесенных изменений, без какого-либо сетевого взаимодействия. Создаваемая копия файла имеет имя FILE.~VERSION.~. При подтверждении изменений в репозиторий, локальная копия удаляется. Пользователи также могут создавать резервные копии вручную, используя команду vc-version-other-window, разница между резервными копиями созданными автоматически и вручную, лишь в лишнем знаке точка перед знаком ~. Многие команды VC могут использовать любую из резервных копий.

«Снимок» (snapshot) — это именованный набор версий файлов, который может рассматриваться как отдельная единица. Некоторые системы контроля версий сами поддерживают концепцию «снимков», тогда пакет VC использует эти возможности. Для прочих систем контроля версий, пакет VC сам реализует поддержку «снимков». В этом случае, эти «снимки» видны только при использовании пакета VC.

Для работы со «снимками» пакет VC определяет две команды. Команда vc-create-snapshot (сочетание C-x v s) создает «снимок» на базе версий файлов находящихся в текущем каталоге, или ниже. Команда vc-retrieve-snapshot (сочетание клавиш C-x v r) позволяет пользователю получить «снимок» с заданным именем.

Многие команды пакета VC позволяют использовать имена «снимков» в качестве аргументов вместо номеров версий файлов. Это особенно полезно просмотре списка изменений между релизами программ.

Обычно, для файлов находящихся под управлением системы контроля версий, для каждого файла ведется отдельный список изменений. Но в проектах GNU списки изменений ведутся для всего проекта, или для отдельных каталогов. Для организации взаимодействия между этими двумя подходами, пакет VC определяет отдельную команду vc-update-change-log (она привязана к сочетанию C-x v a), которая обновляет общий список изменений на основании списка изменений для отдельных файлов. При использовании префиксов, данная команда позволяет обновить общий список изменений, только изменениями для отдельных файлов.

Вы можете вставлять в файлы специальные идентификационные заголовки. Эти заголовки зависят от конкретной используемой системы контроля версий, и в некоторых системах, они используются для служебных целей. Для вставки такого заголовка, вы можете использовать команду vc-insert-headers (сочетание клавиш C-x v h). VC автоматически выбирает заголовок подходящий для системы контроля версий. Заголовки хранятся в переменных вида vc-BACKEND-header, так что вы можете изменять их значения, для вставки собственных заголовков.

Для перемещения по буферу *cvs* используются команды cvs-mode-next-line (клавиша n) — для перемещения на следующую строку и cvs-mode-previous-line (клавиша p), которая приводит к переходу на предыдущую строку.

Для работы с пометками используются множество разных команд. Для пометки одного файла используется команда cvs-mode-mark (клавиша m), а для снятия пометки — команда cvs-mode-unmark (клавиша u). Для пометки всех файлов используется клавиша M (команда cvs-mode-mark-all-files), а противоположной ей командой является cvs-mode-unmark-all-files, которая привязана к сочетанию клавиш M-<DEL>. Вы также можете пометить файлы, имена которых подпадают под заданное регулярное выражение — команда cvs-mode-mark-matching-files (клавиша %), или которые имеют определенный статус — команда cvs-mode-mark-on-state (клавиша S).

Добавление файлов производится очень простым способом — просто отметьте все нужные файлы (обычно они имеют статус Unknown), и нажмите на клавишу a (команда cvs-mode-add). Статус файлов будет изменен на Added, и затем вы должны подтвердить изменения в репозиторий (см. раздел Работа с изменениями). Вы также можете использовать эту команду и для файлов со статусом Removed, что приведет к их восстановлению.

Удаление файлов производится аналогичным образом — вы помечаете файлы, и выполняете команду cvs-mode-remove-file (клавиша r). При выполнении этой команды у вас будет запрошено подтверждение, и затем файлы будут удалены из каталога. В том случае, если файлы находятся под контролем CVS, то для них также будет выполнена команда cvs remove. Как и в предыдущем случае, вам также нужно будет подтвердить изменения в репозиторий.

Обновление файлов производится с помощью команды cvs-mode-update, которая привязана к клавише O. Это заставляет выполнить команду cvs update для файлов имеющих статус Need-update.

Иногда, вам требуется хранить в каталогах проекта, файлы, не зарегистрированные в репозитории. Такие файлы обычно отображаются со статусом Unknown, но вы можете сообщить CVS, что эти файлы необходимо игнорировать при выполнении команд, просто перечислив их в файле .cvsignore. Для помещения выбранного файла в этот файл, используется команда cvs-mode-ignore, которая привязана к клавише i. Используя ее, вы можете быстро поместить мешающие файлы в список игнорируемых объектов.

Для подтверждения изменений в репозиторий вам нужно лишь выбрать файлы, изменения для которых вы хотите подтвердить, а зачем нажать c (cvs-mode-commit) или C (cvs-mode-commit-setup). Это приведет к возникновению нового буфера с именем *cvs-commit*, в котором вы можете ввести описание вносимых изменений. После ввода сообщения, вам необходимо лишь нажать C-c C-c и изменения будут внесены в репозиторий. Вы можете прервать этот процесс в любое время, просто не выполняя команду C-c C-c. Разница между командами c и C заключается в том, как они относятся к содержимому буфера *cvs-commit*. Первая команда сохраняет предыдущее содержимое буфера, в то время как вторая команда создает буфер заново.

Если вы изменили файл, но не хотите вносить данные изменения в репозиторий, то вы можете использовать команду cvs-mode-undo-local-changes, которая привязана к клавише U. Эта команда удаляет файл с вашими изменениями, и получает последнюю версию из репозитория.

Вы можете просмотреть изменения внесенные в файл с помощью нескольких команд. Наиболее часто используемой командой является cvs-mode-diff, которая вызывается с помощью клавиши = или сочетания d =. Эта команда показывает между измененным файлом и его базовой версией. Кроме этого, также определен набор команд, которые выполняют следующие действия:

Также, для работы с изменениями вы можете использовать утилиты Ediff и Emerge. Команда cvs-mode-idiff (привязана к сочетанию клавиш d e) запускает Ediff или Emerge (зависит от выбранных настроек), что позволяет вам интерактивно работать с изменениями. При использовании команды cvs-mode-imerge (сочетание клавиш d E) вы можете выполнить трехстороннее интерактивное слияние изменений, но если уже существует конфликт в выбранных файлах, то их содержимое не будет использоваться при работе, и после завершения работы, все изменения сделанные CVS, будут затерты.

Для получения информации о файлах может использоваться две команды. Команда cvs-mode-log (клавиша l) выполняет команду cvs log для выбранных файлов и результат отображается в буфере *cvs-info*. А команда cvs-mode-status (клавиша s) выполняет cvs status для выбранных файлов и результат отображается в буфере *cvs-info*.

Команда cvs-mode-tag (клавиша t) позволяет вам установить тег на выбранные файлы. По умолчанию, данная команда применяется только к каталогам, но это поведение зависит от настроек клиента.

Иногда вам может понадобиться, чтобы в буфере *cvs* не отображались некоторые записи. Вы можете сделать это двумя способами — использовать команду cvs-mode-remove-handled (клавиша x), которая удаляет из буфера уже обработанные записи, например, файлы со статусом Up-to-date, или использовать команду cvs-mode-acknowledge (она привязана к сочетанию C-k), которая просто удаляет нужные строки. Обработанные записи могут удаляться автоматически, в том случае, если переменная cvs-auto-remove-handled имеет значение не равное nil.

Чтобы обновить содержимое буфера *cvs*, вы можете использовать команду cvs-mode-revert-buffer, которая привязана к клавише g. А для выхода из буфера *cvs* используется команда cvs-mode-quit, которая привязана к клавише q.

Режим PCL-CVS также определяет несколько дополнительных режимов — для редактирования сообщений для журнала изменений, а также режим для просмотра журнала изменений.

Для работы с архивами используется команда tla-archives (или сочетание клавиш C-x T A). При ее вызове, пользователю будет показан список зарегистрированных архивов, по которому он сможет перемещаться, и просматривать их содержимое.

При работе в данном режиме, в буфере действует специальный режим, для которого определено некоторое количество команд — регистрация архивов, работа с закладками и т.п. Наиболее часто используемые команды вынесены в отдельное меню, которое называется Archives. Эти же команды доступны через набор определенных клавиш, список наиболее часто используемых клавиш и команд приведен ниже (в скобках приведено название команды, вызываемой указанным сочетанием клавиш):

Полный список клавиш, определенных для данного режима, вы можете получить с помощью сочетания клавиш C-h m.

Кроме использования tla-archives вы можете использовать команду tla-browse для просмотра списка зарегистрированных архивов и веток разработки, в более красивом виде. Вы можете видеть результат выполнения на рисунке Результат выполнения tla-browse.

Рисунок 1. Результат выполнения tla-browse

Закладки сильно облегчают работу разработчика в том случае, если он работает с большим количеством репозиториев. Для наиболее часто используемых версий, разработчик может определить закладки и быстро переходить к нужным архивам и веткам разработки. Для работы с закладками существует специальная команда — tla-bookmarks, которая вызывается сочетанием клавиш C-x T b. После ее выполнения будет создан буфер с именем *tla-bookmarks*, который вы можете использовать для работы с закладками. Для удобства работы также создается меню Tla-Bookmarks, которое содержит часто используемые команды.

Вы можете помечать несколько проектов как партнерские, и использовать затем команды для группы закладок, что особенно удобно в тех случаях, если ведется много веток разработки, и вы хотите быть в курсе разных ветвей разработки. Необходимо лишь пометить нужные проекты и выполнить команду tla-bookmarks-marked-are-partners (она привязана к сочетанию клавиш M-p).

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

При работе в буфере *tla-bookmarks* в нем определены следующие команды:

Кроме работы с закладками из буфера *tla-bookmarks*, вы можете выполнять действия относящиеся к закладкам из других буферов, например, из буфера для работы с архивами (команда b).

При работе с выбранным репозиторием пользователь может выполнять самые разные действия — добавлять и удалять файлы, вставлять теги GNU Arch, и многое другое. Для этого выделены отдельные команды. Однако, более удобным способом работы будет использование буфера объектов (inventories).

Команда tla-inventory (или сочетание клавиш C-x T i) создает буфер *tla-inventory*, который содержит список объектов для выбранного каталога. Вы можете видеть результаты выполнения этой команды на рисунке Окно буфера *tla-inventory*. Используя данный буфер пользователь может интерактивно работать с объектами репозитория — добавлять и удалять объекты, указывать их тип, просматривать изменения, и выполнять множество других операций. Для выполнения основных команд может использоваться меню Inventory, создаваемое данной командой.

Рисунок 2. Окно буфера *tla-inventory*

При работе с буфером *tla-inventory* определены следующие команды:

Пользователь может управлять отображением объектов в буфере, например, скрывая файлы резервных копий (baclup), или файлы, заведомо содержащие ненужные данные (junk). Для этого используются команды tla-inventory-toggle-...

Работа с изменениями ведется аналогично работе с изменениями в пакете PCL-CVS. Вы можете просмотреть список измененных файлов с помощью команды tla-changes (или используя сочетание клавиш C-x T c), которая покажет вам список измененных файлов (он отображается в буфере *tla-changes*), и сами изменения. С помощью команды tla-changes-edit-log (клавиша c в буфере *tla-changes* вы можете ввести сообщение, описывающее изменения, и затем установить изменения в репозиторий, используя сочетание клавиш C-c C-c. Можно также вносить изменения только для отмеченных файлов, что помогает делать изменения атомарными.

Команды навигации по буферу *svn-status* аналогичны командам других пакетов для работы с системами контроля версий — вы можете использовать либо клавишу управления курсором, либо команду svn-status-previous-line (привязана к клавише C-p) для перемещения на предыдущую строку, и команду svn-status-next-line (привязана к клавише C-n) для перехода на следующую строку. Эти привязки несколько отличаются от других режимов, которые для аналогичных команд используют клавиши n и p.

Для установки пометок на файлы PSVN использует те же самые клавиши, что и остальные режимы — для пометки объекта используется клавиша m (команда svn-status-unset-user-mark), а для снятия пометки — клавиша u (команда svn-status-set-user-mark). Кроме этого для снятия всех установленных пометок используется команда svn-status-unset-all-usermarks (сочетания клавиш M-DEL или * !), а для снятия пометки с файла, находящегося перед курсором, может использоваться команда svn-status-unset-user-mark-backwards, привязанная к клавише DEL.

Также определены команды для пометки файлов с разным статусом. Так, для пометки измененных файлов может использоваться команда svn-status-mark-modified (сочетание клавиш * M), для пометки добавленных файлов команда svn-status-mark-added (сочетание клавиш * A), а для пометки файлов не находящихся под контролем Subversion, команда svn-status-mark-unknown (сочетание клавиш * ?).

Добавление файлов в репозиторий можно производить с помощью нескольких команд. Базовой командой является svn-status-add-file (она привязана к клавише a), которая добавляет текущий файл в репозиторий (или выбранные файлы). В качестве дополнения к ней, пакет PSVN определяет команду svn-status-add-file-recursively (клавиша A), которая рекурсивно добавляет файлы в репозиторий и команду svn-status-make-directory (клавиша +), которая создает новый каталог в репозитории. Не забудьте, что удаление файлов производится только в вашей рабочей копии репозитория, так что изменения будут внесены только после явного подтверждения.

Удаление файлов производится командой svn-status-rm (клавиша D или сочетание C-d), что запускает команду svn rm. Поскольку Subversion поддерживает явное переименование файлов с сохранением истории файла, то и пакет PSVN имеет в своем арсенале соответствующую команду svn-status-mv, которая привязана к клавише R. Как и в предыдущем случае, вам после выполнения данных команд необходимо подтвердить внесенные изменения.

Вы можете выполнить обновление вашего рабочего каталога из репозитория, что часто бывает удобно при одновременной работе нескольких разработчиков над одним проектов. Обновление производится с помощью команды svn-status-update-cmd (клавиша U), которая запускает команду svn update. Кроме этого, вы можете вытянуть нужную версию файла с помощью команды svn-status-get-specific-revision (клавиша ~). При работе этой команды создается файл F.~REVISION~, который и содержит нужную версию файла. А также вы можете просмотреть состояние и родительского каталога, с помощью команды svn-status-examine-parent, которая привязана к клавише ^.

Вы можете просматривать и редактировать файлы непосредственно из буфера *svn-status*. Это возможно с помощью команд svn-status-find-files (клавиша f), которая открывает файл непосредственно в том же окне, которое и содержит буфер *svn-status*. Для открытия файла в другом окне может использоваться команда svn-status-find-file-other-window (клавиша o), вы можете просматривать, а не редактировать файл с помощью команды svn-status-view-file-other-window (клавиша v), что бывает очень полезно, если вы хотите лишь посмотреть на файл, не редактируя его. Клавиша RET (команда svn-status-find-file-or-examine-directory) играет двоякую роль — она либо открывает файл, либо отображает состояние файлов в соответствующем каталоге.

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

Как уже упоминалось выше, вы должны подтвердить изменения в репозиторий. Подтверждение выполняется с помощью команды svn-status-commit-file (клавиша c). После подтверждения, ваши изменения будут видны всем людям, работающим с репозиторием.

Кроме подтверждения изменений, иногда необходимо отменить внесенные изменения. Для этого используется команда svn-status-revert, которая привязана к клавише r. Subversion поддерживает возможность явного удаления статуса наличия конфликтов с файлов, которые имеют такой статус. Для удаления статуса конфликта PSVN предоставляет команду svn-status-resolved (клавиша V), которая запускает команду svn resolved.

Также как и другие пакеты для работы с системами контроля версий, PSVN предоставляет возможность получения списка изменений для выбранных файлов по сравнению с базовой версией. Для этого определено несколько команд. Команда svn-status-show-svn-diff (клавиша =), выполняет сравнение с головной версией в репозитории (если она новее чем базовая) или с базовой версией текущего файла. Команда svn-status-show-svn-diff-for-marked-files (сочетание C-=) может выполнить сравнение сразу нескольких выбранных файлов с их базовыми версиями. А команда svn-status-ediff-with-revision (клавиша E) использует для сравнения пакет Ediff. Все эти команды могут выполнять сравнение с произвольной версией, если им будет задан префиксный аргумент перед их выполнением.

Система контроля версий Subversion позволяет пользователю привязывать различные метаданные к файлам и версиям. Кроме этого, существуют метаданные, не привязанные к конкретной версии. Изменения в метаданных распространяются вместе с изменениями, внесенными в обычные файлы. Подробнее о метаданных и работе с ними вы можете прочитать в книге "Version Control with Subversion", которая доступна на сайте данной системы.

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

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

К первой группе относятся команды: svn-status-property-parse (сочетание P p) используется для разбора записи, svn-status-property-set (сочетание P s) задает значение для конкретной записи, svn-status-property-delete (сочетание P d) удаляет выбранную запись, svn-status-property-list (сочетание P l) отображает список определенных для данного объекта записей, svn-status-property-edit-one-entry (сочетание P e) позволяет изменить запись.

Во вторую группу входят следующие команды: svn-status-property-edit-svn-ignore (сочетание P TAB) позволяет вам отредактировать список файлов, которые не будут учитываться при Subversion, svn-status-property-ignore-file (сочетание P i) вносит текущий файл в список игнорируемых объектов, svn-status-property-ignore-file-extension (сочетание P I) позволяет пополнить список игнорируемых объектов шаблоном для выборки всех файлов с расширением как у текущего, svn-status-property-set-eol-style (сочетание P y) позволяет задать какой стиль обозначения перевода строк используется для данного объекта, svn-status-property-set-keyword-list (сочетание P y) позволяет отредактировать список ключевых слов связанных с данным объектом.

Для получения информации о текущем файле может использоваться команда svn-status-info, которая привязана к клавише i. При ее использовании, в буфере *svn-process* будет отображен результат выполнения команды svn info. Информация может показаться слишком подробной, и для ее обработки может быть использована команда svn-status-parse-info (клавиша I), которая разбирает результат предыдущей команды, и приводит его к более компактному виду. Для получения информации об авторе и версии для указанного файла, может использоваться команда svn-status-blame (клавиша b), а для просмотра логов для выбранных файлов, используется команда svn-status-show-svn-log (клавиша l).

Обновить содержимое буфера *svn-status* вы можете с помощью команды svn-status-update (клавиша g), а посмотреть на вывод команды svn вы можете использовав клавишу s (команда svn-status-show-process-buffer). Вы также можете управлять тем, объекты с каким статусом будут отображаться в буфере *svn-status*. Для скрытия не изменявшихся файлов используется команда svn-status-toggle-hide-unmodified (клавиша _), а для скрытия незарегистрированных файлов — команда svn-status-toggle-hide-unknown (клавиша ?). Обе эти команды являются переключателями, и могут использоваться как для отключения показа файлов, так и для включения показа.

Для выхода из буфера *svn-status* и его удаления используется команда svn-status-bury-buffer, которая привязана к клавише q, также как и в других пакетах.

Пакет clearcase старается в своей работе поддерживать логику операций, которые предоставляются пакетом VC. Для этого, определены команды clearcase-next-action-current-buffer и clearcase-next-action-dired-files, которые выполняют следующую операцию в цепочке действий над текущим буфером, или над выбранными файлами. Изменение состояния текущего буфера производится с помощью команды clearcase-toggle-read-only (сочетание клавиш C-x C-q), что приводит к переводу его либо в состояние доступности для внесения изменений, либо в состояние доступности только для чтения.

Пакет поддерживает массовое выполнение операций получения данных из репозитория и подтверждения данных в репозиторий. Для получения данных из репозитория могут использоваться команды clearcase-checkout-current-buffer, clearcase-checkout-dired-files и clearcase-dired-checkout-current-dir, которые приводят к получению версий из репозитория для текущего буфера, отмеченных файлов и текущего каталога. А задачи по подтверждению данных производятся с помощью команд, имеющих аналогичные имена — clearcase-checkin-current-buffer, clearcase-checkin-dired-files и clearcase-dired-checkin-current-dir. Отмена получения данных производится с помощью команд clearcase-uncheckout-current-buffer (она привязана к сочетаниям C-x v c и C-x v u), clearcase-uncheckout-dired-files (она имеет те же привязки, что и предыдущая команда, но они определены только при работе в режиме clearcase-dired-mode) и команды clearcase-dired-uncheckout-current-dir.

Регистрация файлов в системе контроля версий ClearCase производится с помощью команды clearcase-mkelem-current-buffer (сочетание клавиш C-x v i), которая регистрирует текущий буфер, или с помощью команды clearcase-mkelem-dired-files, которая регистрирует выбранные файлы.

Обновление данных в текущем буфере, каталоге или файлах в буфере dired производится с помощью команд clearcase-update-current-buffer, clearcase-update-default-directory, clearcase-update-dired-files и clearcase-update-view. А получить конкретную версию файла можно с помощью команды clearcase-version-other-window, которая привязана к сочетанию клавиш C-x v ~.

Создание новой ветки производится с помощью команды clearcase-mkbrtype, которая привязана к сочетанию клавиш C-x v m.

Команды работы с изменениями можно разделить на две группы. Первая группа для получения списков изменений использует команду diff (они имеют название начинающееся с clearcase-diff), а вторая группа команд, для этого использует пакет ediff (для них используется префикс clearcase-ediff). Ниже перечислены только команды первой группы, команды второй группы имеют аналогичные имена, с учетом вышеуказанных отличий.

Для получения описания файлов используются две команды. Команда clearcase-describe-current-buffer (сочетание клавиш C-x v ?) используется для получения описания файла в текущем буфере, а команда clearcase-describe-dired-file используется для получения описания файлов, выбранных в буфере dired.

Пользователи также могут получить аннотированную версию текущего буфера или отмеченных файлов с помощью команд clearcase-annotate-current-buffer (сочетание клавиш C-x v g) и clearcase-annotate-dired-file. А для получения истории текущего буфера или файла в буфере dired используются команды clearcase-list-history-current-buffer (привязанная к C-x v l) и clearcase-list-history-dired-file.

Пакет clearcase поддерживает работу со свойствами файлов ClearCase, которые связываются с зарегистрированными файлами. Пользователь может просматривать эти свойства с помощью команды clearcase-fprop-display-properties, а также вставлять их в текущий буфер с помощью команды clearcase-fprop-dump-to-current-buffer.

Пакет clearcase позволяет использовать множество утилит, входящих в состав ClearCase, не покидая удобную среду Emacs.

Пакет также определяет набор команд для просмотра изменений с помощью внешних утилит:

Редактирование конфигурации ClearCase производится с помощью команд, которые начинаются с clearcase-edcs. Для редактирования конфигурации определен специальный режим — clearcase-edcs-mode, который включается одноименной командой. Редактирование конфигурации производится с помощью команды clearcase-edcs-edit, которая привязана к сочетанию клавиш C-x v e. Для сохранения изменений используется команда clearcase-edcs-save. Для завершения работы с конфигурацией ClearCase используется команда clearcase-edcs-finish.

Пакет clearcase обеспечивает возможность отслеживания состояния самого себя с помощью трассировки выполняемых команд. Для включения и выключения трассировки используются команды clearcase-enable-tracing и clearcase-disable-tracing. Кроме этого, пользователь может получить данные о внутреннем состоянии пакета с помощью команды clearcase-dump. Но эти возможности в основном нужны в тех случаях, когда пакет работает не так как нужно. Если вы нашли ошибку в работе пакета, то вы можете сообщить о ней используя команду clearcase-submit-bug-report, которая соберет данные о значениях переменных, версии Emacs и прочую информацию, необходимую для воссоздания ошибки и ее исправления.

Команды clearcase-integrate и clearcase-unintegrate явно устанавливают или удаляют хуки и команды, которые обеспечивают интеграцию с системой контроля версий ClearCase.

Синхронизация локальных файлов с репозиторием производится с помощью команды p4-get (сочетание C-x p G). Команда позволяет синхронизировать как отдельные файлы, так и все файлы клиента. Пользователь может указать номер версии, с которой будет синхронизироваться клиент.

После получения файлов из репозитория пользователь может открыть его для изменения с помощью команды p4-edit (сочетание клавиш C-x p e). При выполнении данной команды, сервер уведомляется что файл открывается для изменения и файл переводится из состояния только для чтения, в состояние доступное для изменения. Пользователь может указать номер изменения, к которому будут относиться новые изменения, а также тип файла. Можно открыть файл с новыми параметрами (тип файла или номер изменения), для этого в пакете p4 определена команда p4-reopen (C-x p E). Кроме этого, пользователь может открыть файл напрямую в репозитории, с помощью команды p4-depot-find-file, которая привязана к сочетанию клавиш C-x p C-f.

Добавление файла в репозиторий производится с помощью команды p4-add (сочетание C-x p a). С помощью аргументов, пользователь может указать тип файла — текстовый или двоичный, а также связать новый файл с указанным отложенным изменением. Если тип файла не был указан явно, то он определяется автоматически. Удаление файла из репозитория производится с помощью команды p4-delete (сочетание клавиш C-x p x). Файл удаляется как из репозитория, так и у клиента. Если файл уже открыт, то он пере-открывается для удаления и помещается в указанное неподтвержденное изменение. Переименование файла производится с помощью команды p4-rename (C-x p m). Данная команда поддерживает использование шаблонных символов, так что можно одновременно переименовывать множество файлов.

Работа с заданиями (jobs) в Perforce реализуется пакетом p4 с помощью нескольких команд. Команда p4-jobs (C-x p J) используется для получения списка всех заданий определенных в системе. С помощью аргументов пользователь может сужать список заданий, список поддерживаемых аргументов вы можете найти в документации на пакет p4. Создание и изменение заданий производится с помощью команды p4-job (сочетание клавиш C-x p j). С помощью префиксных аргументов, данная команда может удалять задания, а также изменять их. А команда p4-fix (сочетание C-x p X) используется для связывания задания с номером изменения. Связанные с изменениями задания закрываются в том случае, если изменения подтверждаются.

Спецификации веток могут редактироваться с помощью команды p4-branch, которая привязана к сочетанию клавиш C-x p B. Пользователь может выполнить слияние изменений между ветками с помощью команды p4-integ (C-x p I). Можно выполнять слияние как между отдельными файлами, так и между полными ветками. С помощью аргументов, пользователь может указать в какое изменение будет производиться слияние.

Пакет также поддерживает работу с метками. Для получения списка пометок используется команда p4-labels (C-x p L). Редактирование спецификации метки производится с помощью команды p4-label (сочетание клавиш C-x p L), а синхронизация меток с клиентом производится с помощью команды p4-labelsync (сочетание клавиш C-x p l).

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

Получить список изменений, внесенных пользователем можно получить с помощью команды p4-changes, которая привязана к C-x p C. Эта команда выдает список отложенных и подтвержденных изменений для указанного файла. Если не было передано никаких аргументов, то данная команда выдает список изменений для файлов в текущем каталоге, и каталогах лежащих ниже. Список файлов, которые открыты для отложенного изменения, пользователь может получить с помощью команды p4-opened (сочетание клавиш C-x p o).

Детальный список изменений, внесенных пользователем можно получить с помощью нескольких команд, однако основной командой является команда p4-diff (сочетание клавиш C-x p =) — с ее помощью можно получить список изменений между текущим файлом и версией в репозитории. Однако изменения для текущего файла выдаются только в том случае, если этот файл был открыт для редактирования. Если текущий файл не открыт для изменения, то выдается список изменений для всех открытых файлов и их соответствующих версий в репозитории. Кроме этого, задавая ключи командной строки для команды diff, можно изменять выдаваемые данные для получения данных от открытых файлов, файлов отсутствующих клиентов и т.д.

Кроме указанной выше команды, существует еще несколько команд для получения детального списка изменений. Для сравнения двух файлов в репозитории можно использовать команду p4-diff2 (сочетание клавиш C-x p d). Команда p4-diff-head выдает изменения между файлами текущего клиента и самыми последними версиями в репозитории. Для сравнения файлов можно использовать пакет Ediff, что и делают две команды — p4-ediff и p4-ediff2. Первая команда выполняет сравнение текущего файла с его базовой версией, а вторая команда сравнивает между собой два файла в репозитории.

Подтверждение изменения осуществляется с помощью команды p4-submit (сочетание клавиш C-x p S). При выполнении этой команды, отложенное изменение и связанные с ним файлы вносятся в репозиторий. В том случае, если перед подтверждением программа не смогла заблокировать все файлы, затрагиваемые изменением, то процесс прекращается и подтверждения не происходит. Пользователь может оповещать других пользователей о вносимых изменениях. Для этого может использоваться команда p4-notify (сочетание клавиш C-x p n), которая выполняется пользователем. Но кроме этого, может использоваться автоматическое оповещение пользователей при каждом подтверждении изменений. Список пользователей, которые будут оповещены при изменении, задается с помощью команды p4-set-notify-list. Оповещение пользователей производится с помощью электронной почты, так что вы должны задать корректный путь к программе sendmail.

Отмена изменений в текущем файле производится с помощью команды p4-revert, которая привязана к сочетанию клавиш C-x p r. Если аргумент SHOW-OUTPUT имеет истинное значение, то результаты выполнения команды будут отображены в буфере *P4 Output*. Для обновления изменений в не-открытых файлах используется команда p4-refresh (C-x p R), так что вам нужно использовать обе команды, если у вас есть открытые и не-открытые файлы в одном каталоге и вы хотите обновить их из репозитория.

Для получения информации о конкретном изменении, может использоваться команда p4-describe (она привязана к сочетанию клавиш C-x p D). Она отображает описание изменения, его номер, имя пользователя, дату и прочую информацию, включающую в себя список файлов, список конкретных изменений и т.п.

Просмотр истории изменений для текущего файла может быть выполнен с помощью команды p4-filelog (сочетание клавиш C-x p f). Информация отображается в порядке убывания времени, вплоть до самого начала истории файла, когда он был добавлен в репозиторий.

Чтобы получить файл из репозитория вместе с историей изменения, пользователь может использовать команду p4-print-with-rev-history (сочетание C-x p V). Для получения только самого файла, без истории, пользователь может использовать команду ` p4-print' (C-x p p). Эти две команды не затрагивают список файлов полученных данным клиентом.

Для получения информации о клиенте и сервере может использоваться команда p4-info (сочетание C-x p i), которая выдает информацию о клиенте — имя пользователя, название клиента и каталог, а также некоторую информацию о сервере.

Чтобы узнать как соотносятся между собой имена локальных файлов и имена соответствующих файлов в репозитории, пользователь может использовать команду p4-where, которая привязана к C-x p w. А список версий, которые были в последний раз получены, пользователь может получить с помощью команды p4-have (C-x p H). Получить список файлов в репозитории можно с помощью команды p4-files (сочетание клавиш C-x p F). Пользователь может получить список всех файлов, или только файлов, совпадающих с заданной маской.

Пакет p4 позволяет управлять репозиторием Perforce не покидая Emacs. Сюда относятся команды управления пользователями, группами пользователей и клиентами.

Создание нового пользователя производится с помощью команды p4-user (сочетание клавиш C-x p u). Эта же команда используется для редактирования спецификации уже существующего пользователя. Спецификация сохраняется во временный и файл и для ее редактирования запускается редактор, определенный переменной среды EDITOR. В спецификацию пользователя входят его имя, полное имя, уровень доступа и другие параметры. Обычно, спецификация пользователя создается автоматически при запуске любой команды, которая может обновить репозиторий. Список существующих пользователей можно получить с помощью команды p4-users (сочетание C-x p U).

Аналогичным образом организована и работа с группами пользователей. Для получения списков уже существующих групп, может использоваться команда p4-groups, а для создания группы пользователей используется команда p4-group. Но для создания группы пользователей, текущий пользователь должен обладать специальными правами.

Редактирование спецификации клиента производится с помощью команды p4-client, которая привязана к сочетанию клавиш C-x p c. В спецификацию клиента входят его имя, описание, список файлов, которые будут видны в репозитории, и другие параметры. По умолчанию, новые клиенты создаются с возможностью просмотра всех файлов в репозитории.

Сочетание клавиш C-x p h запускает команду p4-help, которая может использоваться для получения справочной информации о работе с пакетом, или о работе с конкретной командой. Описание привязок клавиш, предоставляемых пакетом p4, можно получить с помощью команды p4-describe-bindings (сочетание клавиш C-x p ?).

Номер используемой версии пакета p4 пользователь может получить с помощью команды p4-emacs-version, которая привязана к сочетанию клавиш C-x p v. В том случае, если вы нашли ошибку в работе пакета, то вы можете сообщить о ней с помощью команды p4-bug-report (сочетание клавиш C-x p b).

В том случае, если сервер Perforce недоступен или вы работаете отключившись от сети, то вы можете отключить проверку версий, при открытии файлов. Включение и отключение этой проверки пользователь может выполнить с помощью команды p4-toggle-vc-mode (сочетание клавиш C-x p t).