В любой реальной рабочей копии среди версионированных файлов и каталогов почти наверняка обнаружатся и другие файлы и каталоги, которые не версионированы и не должны быть таковыми. Текстовые редакторы мусорят, создавая каталоги с резервными копиями файлов. Компиляторы программного кода генерируют временные — или даже результирующие — файлы, которые обычно нет смысла версионировать. Сами пользователи также бросают различные файлы и каталоги там, где им проще — в том числе нередко и в каталогах рабочей копии.
Было бы нелепо ожидать, что рабочие копии Subversion окажутся в стороне от такого рода мусора и беспорядка. При этом Subversion считает своей важной особенностью то, что ее рабочие копии являются самыми обычными каталогами, такими же как и неверсионированные структуры каталогов. Однако не подлежащие версионированию файлы и каталоги могут вызывать у пользователей Subversion некоторое раздражение. Например, поскольку команды svn add и svn import по умолчанию действуют рекурсивно и не знают, какие из вновь созданных файлов в данном каталоге вы не собираетесь версионировать, очень легко случайно добавить под версионный контроль всякий хлам, о котором вы даже не думали. Кроме того, много лишнего может выводить команда svn status, поскольку по умолчанию она выдает отчет по каждому элементу в рабочей копии, включая неверсионированные файлы и каталоги.
Исходя из этого, Subversion поддерживает два способа для того, чтобы указать, на какие файлы желательно просто не обращать внимание. Первый способ затрагивает систему настройки среды исполнения Subversion (см. «Параметры времени выполнения»), и, следовательно, применяется ко всем операциям Subversion, использующим эти настройки среды исполнения (которые, как правило, производятся на конкретном компьютере или конкретным пользователем компьютера). Другой способ использует поддерживаемые в Subversion свойства каталогов, он более тесно связан с самим версионированным деревом каталогов и, следовательно, действует для всех, кто оперирует рабочей копией этого дерева. Оба механизма используют маски файлов.
Система настройки среды исполнения Subversion
имеет параметр global-ignores,
значением которой служит разделенный пробелами набор масок
файлов. Эти маски применяются к файлам, являющимся кандидатами
на добавление под версионный контроль, а также к неверсионированным
файлам, попадающим в поле зрения команды svn status.
Если имя файла соответствуют одной из масок, Subversion будет
действовать так, как будто файла вовсе не существует.
Это действительно полезно для масок файлов, которые вы однозначно
не хотите версионировать — например, файлов резервных копий,
создаваемых редакторами, таких как файлы *~
и .*~ от Emacs.
Свойство svn:ignore, задаваемое для
версионированного каталога, содержит список масок файлов
(каждая маска записывается с новой строки), с помощью которого
Subversion должна определять, какие объекты следует игнорировать
в этом каталоге. Эти маски не переопределяют те, что заданы
параметром среды исполнения global-ignores,
а дополняют их. Стоит отметить, что в отличие от параметра
global-ignores, маски, перечисленные в свойстве
svn:ignore, применяются только к тому каталогу,
в свойстве которого они заданы, не затрагивая любые его подкаталоги.
Свойство svn:ignore — это хороший способ
попросить Subversion пропускать файлы, которые, вероятно,
присутствуют во всех пользовательских рабочих копиях —
например, результаты компиляции или, если взять пример, более
подходящий этой книге, файлы HTML, PDF или PostScript,
генерируемые в результате преобразования исходных файлов
формата DocBook XML в более удобный для чтения выходной формат.
![[Внимание]](images/warning.png)
|
Внимание |
|---|---|
|
Реализованная в Subverion поддержка масок пропуска файлов действует только в момент добавления неверсионированного файла или каталога под версионный контроль. Если объект уже находится под управлением Subversion, механизм масок пропуска больше к нему не применяется. Иными словами, не следует ожидать, что Subversion не будет фиксировать изменения, сделанные в версионированном файле, только на том основании, что его имя соответствует маске пропуска — Subversion всегда просматривает все версионированные объекты. |
Глобальный список масок пропуска в большей степени подходит
для задания личных предпочтений, и завязан больше на
конкретный набор пользовательских инструментов, чем на
специфику конкретной рабочей копии. Исходя из этого,
остаток данной главы будет посвящен использованию свойства
svn:ignore.
Допустим, что команда svn status выдает нам следующее:
$ svn status calc M calc/button.c ? calc/calculator ? calc/data.c ? calc/debug_log ? calc/debug_log.1 ? calc/debug_log.2.gz ? calc/debug_log.3.gz
В примере видно, что вы изменили некоторые свойства файла
button.c, и, кроме того, в рабочей копии
есть несколько неверсионированных файлов: программа
calculator, скомпилированная из
исходных кодов, файл исходного кода data.c
и набор файлов с отладочными сообщениями. Вам известно, что
ваша система сборки всегда генерирует программу с именем
calculator.
[17]
Также вам известно, что после тестового прогона всегда остаются
те самые файлы с отладочными сообщениями. Это справедливо
не только для вашей, но и для всех остальных рабочих копий
данного проекта.
Вы точно знаете, что вам не хотелось бы видеть эти отладочные
файлы при каждом запуске команды svn status,
и вы абсолютно уверены, что так же их не хотелось бы видеть и
остальным. Исходя из этого, можно добавить необходимые маски
пропуска для каталога calc, выполнив
команду svn propedit svn:ignore calc.
Например, вы могли бы добавить в значение свойства
svn:ignore такие строки:
calculator debug_log*
Результатом добавления этого свойства станет локальное
изменение свойств в каталоге calc.
Обратите внимание, чем еще отличается теперь вывод
команды svn status:
$ svn status M calc M calc/button.c ? calc/data.c
Заметьте, весь "мусор" исчез из вывода! Конечно, скомпилированная
программа calculator и упоминавшиеся файлы
отладочных сообщений никуда не делись из вашей рабочей копии.
Просто Subversion больше не напоминает вам об их существовании. Теперь,
когда весь не представляющий интереса "мусор" исчез с экрана, вам
остается разобраться с более интересными элементами — в частности,
с исходным файлом data.c, который вы, вероятно,
забыли добавить под версионный контроль.
Конечно же, вам доступен не только этот короткий отчет
о статусе вашей рабочей копии. Если в какой-то момент времени вам
действительно захочется увидеть в составе статусного отчета
проигнорированные файлы, вы можете воспользоваться опцией
--no-ignore:
$ svn status --no-ignore M calc M calc/button.c I calc/calculator ? calc/data.c I calc/debug_log I calc/debug_log.1 I calc/debug_log.2.gz I calc/debug_log.3.gz
Как отмечалось выше, список файловых масок для пропуска
также учитывается командами svn add и svn
import. В результате обеих операций Subversion
берет под управление некоторое множество файлов и каталогов.
Прежде чем требовать у пользователя, чтобы он выбирал те файлы
в структуре каталогов, которые необходимо версионировать,
Subversion применяет маски пропуска — как глобальные,
так и назначенные отдельным каталогам — чтобы определить,
какие файлы не должны подхватываться системой управления версиями
в ходе рекурсивной операции добавления или импорта. И снова вы можете
воспользоваться опцией --no-ignore, чтобы предложить
Subversion не учитывать списки пропуска и обрабатывать все имеющиеся
файлы и каталоги.