darcs - Интернет в облаке

ПРОГРАММА:

ИМЯ

darcs - продвинутая система контроля версий

СИНТАКСИС

дарки команду <Аргументы|[кредита]> ...

Где команды и их соответствующие Аргументы

дарки помощь [<дарки_команду> [дарки_подкоманда]]
дарки <файл|каталог> ...
дарки удаление <файл|каталог> ...
дарки двигаться <источник> ...назначение>
дарки заменить <старый>новый>файл> ...
дарки возвращаться [файл|каталог] ...
дарки необратимый
дарки какие новости [файл|каталог] ...
дарки запись [файл|каталог] ...
дарки не записывать
дарки изменить [файл|каталог] ...
дарки Марк-конфликты
дарки день [название тэга]
дарки setpref <преф>ценностное >
дарки Разница [файл|каталог] ...
дарки журнал [файл|каталог] ...
дарки аннотированный [файл|каталог] ...
дарки расстояние
дарки тестXNUMX [[инициализация] команда]
дарки произошел фактов [файл] ...
дарки произошел файлов [файл|каталог] ...
дарки произошел индекс
дарки произошел нетронутый
дарки произошел РЕПО
дарки произошел Авторы
дарки произошел имеют теги
дарки произошел патч-индекс-все
дарки произошел патч-индекс-файлы
дарки произошел патч-индекс-статус
дарки произошел патч-индекс-тест
дарки тянуть [хранилище] ...
дарки получать [хранилище] ...
дарки уничтожать
дарки отмена [файл|каталог] ...
дарки протолкнуть. [хранилище]
дарки Отправить [хранилище]
дарки подать заявление <файл патча>
дарки клонировать <хранилище> [каталог>]
дарки инициализировать [<каталог>]
дарки оптимизировать чистым
дарки оптимизировать HTTP
дарки оптимизировать Изменение порядка
дарки оптимизировать включить-патч-индекс
дарки оптимизировать отключить индекс-патч
дарки оптимизировать сжимать
дарки оптимизировать распаковывать
дарки оптимизировать повторно связать
дарки оптимизировать нетронутый
дарки оптимизировать модернизация
дарки оптимизировать кэш <каталог> ...
дарки ремонт
дарки превращаются Даркс-2 <источник> [назначение>]
дарки превращаются экспорт
дарки превращаются Импортировать [<каталог>]
дарки перебазировать тянуть [хранилище] ...
дарки перебазировать подать заявление <файл патча>
дарки перебазировать приостановить
дарки перебазировать откладывать
дарки перебазировать уничтожать
дарки перебазировать журнал

ОПИСАНИЕ

Darcs - это бесплатная система контроля версий с открытым исходным кодом. Это:

· Распределенный: каждый пользователь имеет доступ к полному набору команд, удаляя границы между
сервер и клиент или коммиттер и некоммиттеры.

· Интерактивность: Darcs прост в освоении и эффективен в использовании, потому что он задает вам вопросы.
в ответ на простые команды, предоставляя вам возможность выбора в рабочем процессе. Вы можете выбрать
записывать одно изменение в файл, игнорируя другое. При обновлении из апстрима вы
может просмотреть имя каждого патча, даже полное `diff 'на наличие интересных патчей.

· Умный: darcs, изначально разработанный физиком Дэвидом Раунди, основан на уникальном
алгебра патчей. Эта сообразительность позволяет вам реагировать на меняющиеся потребности так, чтобы
иначе было бы невозможно. Узнайте больше о спонтанных ветвях с помощью darcs.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Разные команды Darcs принимают разные варианты. Каждая команда самая важная
варианты перечислены в КОМАНДЫ раздел. Для получения полного списка всех вариантов, принятых
конкретную команду, запустите `darcs команду --помощь'.

Выбор Патчи:
Параметр --patches дает патчи с именами, соответствующими * расширенному * регулярному выражению.
Посмотреть регулярное выражение(7) для подробностей. Параметр --matches дает исправления, соответствующие логическому
(Логическое) выражение: одно или несколько примитивных выражений, объединенных группировкой (круглые скобки)
и операторы дополнения (не), конъюнкции (и) и дизъюнкции (или). C
обозначения для логических операторов (!, && и ||) также могут быть использованы.

- --patches = regex является синонимом --matches = 'name regex' - --hash = HASH является синонимом
--matches = 'hash HASH' - --from-patch и --to-patch являются синонимами для --from-match = 'name ...
и --to-match = 'name ... - --from-patch и --to-match можно без проблем объединить:
`darcs changes --from-patch = 'html. * documentation' --to-match = 'date 20040212' '

Поддерживаются следующие примитивные логические выражения:

- Exact - сверяет буквальную строку с именем патча. - имя - проверить обычное
выражение против имени патча. - автор - проверить регулярное выражение на соответствие
имя автора. - hunk - сверять регулярное выражение с содержимым патча hunk. -
комментарий - сверьте регулярное выражение с сообщением журнала. - hash - соответствует полному хешу
или приставка для патча. - date - соответствует дате патча. - touch - сопоставить пути к файлам для
патч.

Вот несколько примеров:

darcs annotate --summary --match 'exact "Решение проблемы 17: использование динамической памяти
распределение. "'
darcs annotate --summary --match 'name issue17'
darcs annotate --summary --match 'name "^ [Rr] esolve issue17 \>"'
darcs annotate --summary --match 'автор "Дэвид Раунди"'
darcs annotate --summary --match 'author droundy'
darcs annotate --summary --match 'автор [электронная почта защищена]'
darcs annotate --summary --match 'hunk "foo = 2"'
darcs annotate --summary --match 'hunk "^ instance. * Foo where $"'
darcs annotate --summary --match 'comment "предотвращение взаимоблокировок"'
darcs annotate --summary --match 'hash c719567e92c3b0ab9eddd5290b705712b8b918ef'
darcs annotate --summary --match 'hash c7195'
darcs annotate --summary --match 'date "2006-04-02 22:41"'
darcs annotate --summary --match 'date "вчера время чая"'
darcs annotate --summary --match 'touch src / foo.c'
darcs annotate --summary --match 'touch src /'
darcs annotate --summary --match 'touch "src / *. (c | h)"'

КОМАНДЫ

дарки помощь [<дарки_команду> [дарки_подкоманда]]
Без аргументов darcs help печатает категоризированный список команд darcs и
краткое описание каждого. С дополнительным аргументом, `darcs help foo` печатает
подробная справка по команде darcs foo.

Изменение и Запросы работает копии:
дарки <файл|каталог> ...
Обычно репозиторий содержит оба файла, версия которых должна контролироваться (например,
исходный код) и файлы, которые Darcs следует игнорировать (например, исполняемые файлы, скомпилированные из
исходный код). Команда `darcs add` используется, чтобы сообщить Darcs, какие файлы нужно версия
контролировать.

Когда существующий проект впервые импортируется в репозиторий Darcs, обычно
запустите `darcs add -r *` или `darcs record -l`, чтобы добавить все исходные файлы в darcs.

Добавление символических ссылок (символических ссылок) не поддерживается.

Darcs игнорирует все файлы и папки, которые выглядят «утомительно». Параметр --boring
отменяет это поведение.

Darcs не будет добавлять файл, если другой файл в той же папке имеет то же имя, за исключением
на случай. Параметр --case-ok отменяет это поведение. Windows и OS X обычно
использовать файловые системы, которые не позволяют файлам в папке иметь одно и то же имя, за исключением случая
(например, ReadMe и README). Если используется `--case-ok`, репозиторий может быть
непригоден для использования в этих системах!

дарки удаление <файл|каталог> ...
Команда `darcs remove` существует в первую очередь для симметрии с` darcs add`, поскольку
обычный способ удалить файл из системы контроля версий - просто удалить его из
рабочее дерево. Эта команда полезна только в необычном случае, когда нужно
запишите патч удаления БЕЗ удаления копии в рабочем дереве (что может быть
повторно добавлен).

Обратите внимание, что применение исправления удаления к репозиторию (например, путем извлечения исправления) приведет к
ВСЕГДА влияют на рабочее дерево этого репозитория.

дарки двигаться <источник> ...назначение>
Darcs не может достоверно отличить удаляемый файл от добавляемого нового,
и файл перемещается. Поэтому Darcs всегда предполагает первое и предоставляет
Команда `darcs mv`, чтобы сообщить Darcs, когда вам нужно последнее. Эта команда также будет
переместить файл в рабочем дереве (в отличие от `darcs remove`), если он еще не был
переехал.

Darcs не будет переименовывать файл, если другой файл в той же папке имеет такое же имя,
кроме случая. Параметр --case-ok отменяет это поведение. Windows и OS X
обычно используют файловые системы, которые не позволяют файлам в папке иметь то же имя, за исключением
для case (например, `ReadMe` и` README`). Если используется `--case-ok`, репозиторий
может быть непригодным для использования в этих системах!

дарки заменить <старый>новый>файл> ...
Помимо линейных патчей, Darcs поддерживает ограниченную форму лексических
подмена. Файлы обрабатываются как последовательности слов, и каждое вхождение старого
слово заменяется новым словом. Это сделано для того, чтобы предоставить простой способ переименовать
функция или переменная. Такое переименование обычно затрагивает строки по всему исходному тексту.
кода, поэтому традиционный линейный патч с большой вероятностью будет конфликтовать с другими
ветки, требующие ручного слияния.

Файлы токенизируются по одному простому правилу: слова - это строки действительного токена.
символы, и все между ними (знаки препинания и пробелы) отбрасываются. От
по умолчанию допустимые символы токена - это буквы, цифры и знак подчеркивания (т. е.
`[A-Za-z0-9_]`). Однако, если старый и / или новый токен содержит дефис или
точка, ОБА дефис и точка считаются допустимыми (например, `[A-Za-z0-9 _.-]`).

Набор допустимых символов можно настроить с помощью параметра --token-chars. В
аргумент должен быть заключен в квадратные скобки. Если между двумя
символов в наборе, он рассматривается как установленный диапазон. Например, в большинстве регионов
«[AZ]« обозначает все буквы в верхнем регистре. Если первый символ - каретка, допустимо
жетоны считаются дополнением к остальным символам. Например,
`[^: \ n]` может использоваться для сопоставления полей в ПАРОЛЬ(5), где записи и поля
разделенные символом новой строки и двоеточием соответственно.

Если вы решите использовать `--token-chars`, вам НАСТОЯТЕЛЬНО рекомендуется это сделать.
последовательно. Последствия использования нескольких патчей замены с разными
Аргументы `--token-chars` в одном и том же файле плохо протестированы и поняты.

По умолчанию Darcs откажется выполнять замену, если новый токен уже находится в
использовать, потому что замены не будут отличаться от существующих
жетоны. Это поведение можно изменить, указав параметр --force, но
попытка `darcs rollback` результирующий патч повлияет на эти существующие токены.

Ограничения:

Токенизатор обрабатывает файлы как байтовые строки, поэтому для `--token-chars` это невозможно.
для включения многобайтовых символов, таких как части UTF-8, отличные от ASCII. Так же,
попытка замены символа "старшего разряда" из кодировки unibyte также приведет к
замена одного и того же байта в файлах с разными кодировками. Например, острый
a из ISO 8859-1 также будет соответствовать альфа из ISO 8859-7.

Из-за ограничений в формате файла патча аргументы --token-chars не могут содержать
буквальный пробел. Например, `[^ \ n \ t]` нельзя использовать для объявления всех символов.
за исключением пробела, табуляции и новой строки как действительных в слове, потому что он содержит
буквальное пространство.

В отличие от POSIX регулярное выражение(7) выражения в квадратных скобках, классы символов (такие как `[[: alnum:]]`)
НЕ поддерживаются параметром `--token-chars` и будут обрабатываться молча как простой набор
символы.

дарки возвращаться [файл|каталог] ...
Команда `darcs revert` отбрасывает незаписанные изменения рабочего дерева. Как и в случае с
`darcs record`, вас спросят, какие блоки (изменения) нужно отменить. Переключатель `--all`
можно использовать, чтобы избежать таких подсказок. Если указаны файлы или каталоги, другие
части рабочего дерева не возвращаются.

Вы случайно вернули то, что хотели сохранить (например, набрав `darcs
rev -a` вместо `darcs rec -a`) вы можете сразу запустить` darcs unrevert`, чтобы
восстановить его. Это гарантированно работает только в том случае, если репозиторий не изменился с тех пор, как
`darcs revert` запустился.

дарки необратимый
Отменить возврат - это команда спасения на случай, если вы случайно вернули то, что хотели.
keep (например, набрав darcs rev -a вместо darcs rec -a).

Эта команда может завершиться ошибкой, если репозиторий изменился с момента возврата.
Darcs запросит подтверждение перед выполнением интерактивной команды, которая
ОПРЕДЕЛЕННО предотвратить необращение.

дарки какие новости [файл|каталог] ...
Команда `darcs whatsnew` выводит список незарегистрированных изменений в рабочем дереве. если ты
указать набор файлов и каталогов, только незаписанные изменения в этих файлах и
каталоги перечислены.

С параметром `--summary` изменения сводятся к одной строке на файл, с
мнемоника, указывающая на характер и степень изменения. `--Look-for-add`
опция заставляет кандидатов для `darcs add` быть включенными в итоговый вывод.
Сводная мнемоника выглядит следующим образом:

* `A f` и` A d / `соответственно означают добавленный файл или каталог. * `R f` и` R d / `
соответственно означает удаленный файл или каталог. * «M f -N + M rP» означает модифицированный
файл с удаленными строками `N`,` M`
добавленные строки и лексические замены `P`. * `f -> g` означает перемещенный файл или
каталог. * `af` и` ad / `соответственно означают новый, но не добавленный файл или
каталог при использовании `--look-for-add`.

Восклицательный знак (!), Как в `R! foo.c`, означает, что кусок известен
конфликт с ломом в другом патче. Фраза `дублированный`
означает, что известно, что блок идентичен блоку в другом патче.

По умолчанию darcs whatsnew использует внутренний формат Darcs для изменений. Чтобы увидеть некоторые
контекст (неизмененные строки) вокруг каждого изменения используйте параметр --unified. Смотреть
изменения в обычном формате `diff`, используйте команду` darcs diff`; но обратите внимание, что
darcs whatsnew работает быстрее.

Эта команда завершается неудачно (возвращает ненулевой статус выхода), если нет
незарегистрированные изменения.

Копирование изменения между работает копия и репозиторий:
дарки запись [файл|каталог] ...
Команда `darcs record` используется для создания патча из изменений в рабочем дереве.
Если вы укажете набор файлов и каталогов, изменения в других файлах будут пропущены.

У каждого патча есть название, необязательное описание, автор и дата.

Darcs запустит текстовый редактор (см. `Darcs help environment`) после интерактивного
выделение, чтобы вы могли ввести имя патча (первая строка) и описание патча
(последующие строки).

Название патча должно быть коротким предложением, кратко описывающим патч, например
«Добавить обработку ошибок в основной цикл событий». Вы можете указать его заранее с помощью `-m`
вариант, и в этом случае текстовый редактор не запускается, если вы не используете
Параметр --edit-long-comment.

Описание патча - это необязательный блок текста произвольной формы. Он используется для подачи
дополнительная информация, не вписывающаяся в название патча. Например, это могло бы
включить обоснование, ПОЧЕМУ изменение было необходимо.

Техническая разница между названием патча и описанием патча заключается в том, что соответствие с
флаг `-p` используется только для имен патчей.

Наконец, опция `--logfile` позволяет вам предоставить файл, который уже содержит
название патча и описание патча. Это полезно, если предыдущая запись не удалась и осталась
файл `darcs-record-0`.

Каждый патч приписывается его автору, обычно по адресу электронной почты (например, `Fred
Блоги[электронная почта защищена]> `). Darcs ищет эту авторскую строку в нескольких местах:
опция `--author`, файлы` _darcs / prefs / author` (в репозитории) и
`~ / .darcs / автор`(в вашем домашнем каталоге), а переменные среды
$ DARCS_EMAIL и $ EMAIL. Если ни один из них не существует, Darcs предложит вам
авторскую строку и напишите ее в `~ / .darcs / автор`. Обратите внимание: если у вас более одного
адрес электронной почты, вы можете поместить их все в `~ / .darcs / автор`, по одному автору в строке. Darcs
по-прежнему будет запрашивать имя автора, но позволяет выбрать его из списка или
введите альтернативу.

Если вы хотите вручную определить какие-либо дополнительные зависимости для вашего патча, вы можете использовать
Флаг --ask-deps, и darcs запросит у вас зависимости патча. Немного
зависимости могут быть автоматически выведены из содержимого патча и не могут быть
удаленный. Патч с конкретными зависимостями может быть пустым.

Дата патча генерируется автоматически. Его можно подделать только с помощью
параметр --pipe.

Если вы запустите запись с опцией `--pipe`, вам будет предложено указать дату патча,
автор, и длинный комментарий. Длинный комментарий продлится до конца файла или
stdin достигнут (ctrl-D в системах Unixy, ctrl-Z в системах под управлением ОС Microsoft).

Этот интерфейс предназначен для написания скриптовых дарков, в частности для написания репозитория.
скрипты конвертации. Подсказки предназначены в основном как полезное руководство (поскольку скрипты
они не понадобятся), чтобы помочь вам понять формат ввода.
Вот пример того, как выглядят подсказки `--pipe`:

Какая дата? 15 ноя, пн, 13:38:01 EST 2004
Кто автор? Дэвид Раунди
Что такое журнал? Одна или несколько строк комментария

Если тестовая команда была определена с помощью `darcs setpref`, попытка записи патча
вызовет выполнение тестовой команды в чистой копии рабочего дерева (то есть
включая только зарегистрированные изменения). Если тест не пройден, вам будет предложено прервать
запись операции.

Опция `--set-scripts-executable` заставляет скрипты быть исполняемыми в
чистую копию рабочего дерева перед запуском теста. См. "Darcs clone" для
объяснение эвристики скрипта.

Если ваша тестовая команда утомительно медленная (например, `make all`) и вы записываете несколько
патчей подряд, вы можете использовать `--no-test`, чтобы пропустить все, кроме последнего теста.

Чтобы увидеть некоторый контекст (неизмененные строки) вокруг каждого изменения, используйте параметр --unified.

дарки не записывать
Unrecord действует противоположно записи: он удаляет патчи из репозитория без
изменение рабочей копии. Удаление патчей из репозитория делает изменения активными
снова, который вы можете записать или отменить позже. Помните, что вы не должны использовать это
команда, если есть вероятность, что другой пользователь, возможно, уже вытащил патч.

дарки изменить [файл|каталог] ...
Amend обновляет «черновой» патч с дополнениями или улучшениями, в результате чего получается один
"готовый" патч.

По умолчанию «Edit» предлагает вам записать дополнительные изменения. Если вместо этого вы хотите
для удаления изменений используйте флаг --unrecord.

При записи черновика патча рекомендуется начинать имя с `DRAFT:`. Когда
готово, удалите его с помощью `darcsmend --edit-long-comment`. В качестве альтернативы, чтобы изменить
имя патча без запуска редактора, используйте флаг `--name` /` -m`:

darcs изменить --match 'name "DRAFT: foo"' --name 'foo2'

Как и в случае с `darcs record`, если вы вызываете команду Edit с файлами в качестве аргументов, вас спросят только
об изменениях в этих файлах. Итак, чтобы внести поправки в патч для foo.c с улучшениями в
bar.c, вы должны запустить:

darcs изменить --match 'touch foo.c' bar.c

Как правило, вносить поправки в патч другого разработчика - плохая идея. Чтобы внести изменения, только спросите
о ваших собственных патчах по умолчанию вы можете добавить что-то вроде `изменить матч Дэвида
Roundy` в `~ / .darcs / по умолчанию`, где` Дэвид Раунди` - ваше имя.

дарки Марк-конфликты
Для объединения изменений в одной и той же части исходного файла Darcs требуется руководство человека.
Когда конфликт возникает впервые, darcs добавит начальное состояние и оба варианта к
рабочее дерево, ограниченное маркерами `vvv`,` ===== `,` * * * `и` ^ ^ ^ `, как
следующим образом:

vvvvvvv
Начальное состояние.
=============
Первый выбор.
*************
Вторая возможность.
^ ^ ^ ^ ^ ^ ^

Однако вы можете отменить или вручную удалить эти маркеры без фактического разрешения
конфликт. В этом случае полезно использовать `darcs mark-columns`, чтобы показать, где находятся
неразрешенные конфликты. Также полезно, если darcs apply вызывается с
--apply-конфликты, где конфликты изначально не отмечены.

Если вы не используете флаг --dry-run, любые незарегистрированные изменения в рабочем дереве БУДУТ
потеряны навсегда, когда вы запустите эту команду! Вам будет предложено подтвердить
до того, как это произойдет.

Напрямую модификация of репозиторий:
дарки день [название тэга]
Команда `darcs tag` называет текущее состояние репозитория, чтобы его можно было легко
упоминается позже. Каждое * важное * состояние должно быть помечено; в частности это хорошо
Попрактикуйтесь отмечать каждый стабильный выпуск номером или кодовым именем. Консультации по выпуску
нумерацию можно найти наhttp://producingoss.com/en/development-cycle.html>.

Чтобы воспроизвести состояние репозитория `R` как в теге` t`, используйте команду `darcs clone
- тег t R`. Команда `darcs show tags` выводит список всех тегов в текущем репозитории.

Добавление тегов также дает значительные преимущества в производительности: когда Darcs достигает общей
тег, который зависит от всех предшествующих патчей, он может просто остановить обработку.

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

По умолчанию тег называет все состояние репозитория на момент создания тега. Если
используется опция --ask-deps, патчи, которые должны быть включены как часть тега, могут быть
явно выбран.

Команда `darcs tag` принимает параметр --pipe, который ведет себя, как описано в
`дарк запись`.

дарки setpref <преф>ценностное >
При работе над проектом с несколькими репозиториями и участниками иногда бывает
желательно, чтобы предпочтения устанавливались единообразно для всего проекта. Это достигается
обработка набора предпочтений с помощью `darcs setpref` как незарегистрированного изменения, которое затем может
быть записанным, а затем обрабатываться как любой другой патч.

Допустимые предпочтения:

* test - команда оболочки, запускающая регрессионные тесты * predist - команда оболочки для
запускать перед `darcs dist '* boringfile - путь к скучному файлу с контролем версий *
binariesfile - путь к двоичному файлу с контролем версий

Например, проект, использующий автоинструменты GNU, с целью `make test` для выполнения
регрессионные тесты, могут включить интегрированное регрессионное тестирование Darcs со следующими
команда:

darcs setpref test 'autoconf && ./configure && make && make test'

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

Запрос репозиторий:
дарки Разница [файл|каталог] ...
Команда `darcs diff` сравнивает две версии рабочего дерева текущего
репозиторий. Без опций нетронутые (записанные) и незарегистрированные рабочие деревья
в сравнении. Это более низкий уровень, чем команда `darcs whatsnew`, поскольку она выводит
построчное сравнение, и это также медленнее. Как и в случае с `darcs whatsnew`, если вы укажете
файлы или каталоги, изменения в других файлах не отображаются. Команда всегда использует
внешняя утилита сравнения.

С опцией `--patch` сравнение будет производиться между рабочими деревьями с и
без этого патча. Патчи * после * выбранного патча отсутствуют ни в одном из
сравниваемые рабочие деревья. Опции `--from-patch` и` --to-patch` позволяют установить
патчей в "старом" и "новом" рабочем дереве следует указывать отдельно.

Также понятны связанные параметры тега и соответствия, например, `darcs diff --from-tag
1.0 - to-tag 1.1`. Все эти параметры предполагают порядок набора патчей, поэтому результаты
может зависеть от таких операций, как `darcs optimize --reorder`.

Разница(1) вызывается с аргументами `-rN`. Опция `--unified` заставляет` -u` быть
перешел к Разница(1). Дополнительный аргумент можно передать с помощью --diff-opts, например
`--diff-opts = -ud` или` --diff-opts = -wU9`.

Опция `--diff-command` может использоваться для указания альтернативной утилиты, такой как
meld (GNOME) или opendiff (OS X). Аргументы могут быть включены через пробел.
Значение не интерпретируется оболочкой, поэтому конструкции оболочки использовать нельзя. В
аргументы% 1 и% 2 ДОЛЖНЫ быть включены, они заменяют два рабочих дерева
сравниваются. Если используется эта опция, --diff-opts игнорируется.

дарки журнал [файл|каталог] ...
Команда `darcs log` выводит список исправлений, составляющих текущий репозиторий, или,
с --repo, удаленным репозиторием. Без параметров или аргументов ВСЕ исправления будут
в списке.

Если в качестве аргументов указан один или несколько файлов или каталогов, только патчи, которые влияют на
перечисляются эти файлы или каталоги. Это включает исправления, которые произошли с файлами
до того, как они были перемещены или переименованы.

При задании --from-tag, --from-patch или --from-match, только патчи с этого момента
тег или патч. Аналогично, --to-tag, --to-patch и --to-match
параметры ограничивают список более старыми патчами.

Опции `--last` и` --max-count` ограничивают количество перечисленных патчей. В
первый применяется ДО других фильтров, тогда как последний применяется ПОСЛЕ других фильтров.
Например, `darcs log foo.c --max-count 3` напечатает последние три патча,
влияет на foo.c, тогда как `darcs log --last 3 foo.c` из последних трех патчей будет
печатать только те, которые влияют на foo.c.

Существуют три формата вывода. По умолчанию - `--human-readable`. Вы также можете выбрать
`--context`, который является внутренним форматом (как видно в пакетах исправлений), который может быть
перечитывается Darcs (например, `darcs clone --context`).

Наконец, есть `--xml-output`, который выдает действительный XML ... если только метаданные патча
(автор, имя или описание) содержит символ, отличный от ASCII, и был записан в
языковой стандарт, отличный от UTF8.

Обратите внимание, что хотя флаг `--context` может использоваться вместе с` --xml-output` или
`--human-readable`, ни в одном случае darcs clone не сможет прочитать вывод. На
с другой стороны, достаточно информации БУДЕТ выводиться для знающего человека, чтобы
воссоздать текущее состояние репозитория.

дарки аннотированный [файл|каталог] ...
Команда `darcs annotate` предоставляет две несвязанные между собой операции. При вызове
файл, он найдет патч, который последним изменил каждую строку в этом файле. При звонке
на патче (например, используя `--patch`), он напечатает внутреннее представление этого
патч.

Опция `--summary` приведет к сводной аннотации патча, подобной` darcs
чтоновое`. Это не влияет на аннотации файлов.

По умолчанию вывод находится в удобочитаемом формате. Параметр --machine-readable может
использоваться для генерации вывода для машинной постобработки.

дарки расстояние
darcs dist создает сжатый архив в корневом каталоге репозитория,
содержащий записанное состояние рабочего дерева (незарегистрированные изменения и `_darcs`
каталог исключены). Команда принимает сопоставители для создания архива некоторых
прошлое состояние репозитория, например --tag.

По умолчанию архив (и каталог верхнего уровня в архиве) имеют одинаковые
name в качестве репозитория, но это можно изменить с помощью параметра --dist-name.

Если установлена ​​команда predist (см. `Darcs setpref`), эта команда будет запущена на
записанное состояние до архивации. Например, в проектах autotools для него будет установлено значение
`autoconf && automake`.

Если используется `--zip`, сопоставители и команда predist игнорируются.

дарки тестXNUMX [[инициализация] команда]
Запустите тест на текущем записанном состоянии репозитория. Без аргументов он использует
тест репозитория по умолчанию (см. `darcs setpref`). Учитывая один аргумент, он лечит его.
как тестовая команда. Учитывая два аргумента, первый - это команда инициализации, а
второй - тест (это означает, что код выхода первой команды не принимается во внимание.
счет для определения успешности теста). Если задано --linear или --bisect
flags, он пытается найти в репозитории самую последнюю версию, прошедшую проверку.

`--linear` выполняет линейный поиск, начиная с головы и удаляясь от головы. Этот
стратегия лучше всего, когда тест запускается очень быстро или патч, который вы ищете, находится рядом
голова.

`--bisect` выполняет бинарный поиск. Эта стратегия лучше всего подходит, когда тест выполняется очень медленно.
или патч, который вы ищете, скорее всего, находится в далеком прошлом репозитория.

`--backoff` начинает поиск с головы, переходя все дальше и дальше в прошлое
пока тест не пройдет успешно. Затем он выполняет двоичный поиск на подмножестве пропущенных
патчи. Эта стратегия работает хорошо, если патч, который вы ищете, не находится в
далекое прошлое хранилища.

В предположении, что отказ является монотонным, `--linear` и` --bisect` производят
тот же результат. (Монотонность означает, что при удалении от головы результат теста
изменяется только один раз с «сбой» на «ОК».) Если сбой не является однообразным, любой из
патчи, нарушающие тест, обнаруживаются случайным образом.

дарки произошел фактов [файл] ...
Показать содержимое можно использовать для отображения более ранней версии некоторых файлов. Если вы дадите
не показывать содержимое без аргументов версии, отображается записанная версия файла (ов).

дарки произошел файлов [файл|каталог] ...
Команда `darcs show files` выводит список этих файлов и каталогов в рабочем дереве.
которые находятся под контролем версий. Эта команда предназначена в первую очередь для написания сценариев; конец
пользователям, вероятно, понадобится `darcs whatsnew --summary`.

Файл считается ожидающим, если он был добавлен, но не записан. По умолчанию ожидающие файлы
(и каталоги) перечислены; параметр --no-pending предотвращает это.

По умолчанию `darcs show files` перечисляет как файлы, так и каталоги, но псевдоним` darcs
show manifest` перечисляет только файлы. --Files, --directories, --no-files и
`--no-directoryies` изменяют это поведение.

По умолчанию записи размещаются по одной на строку (т. Е. Разделяются новой строкой). Это может вызвать проблемы
если сами файлы содержат символы новой строки или другие управляющие символы. Обойти
в этом случае опция --null использует вместо этого нулевой символ. Сценарий, интерпретирующий
вывод этой команды должен понимать эту идиому; xargs -0 - это такая команда.

Например, чтобы вывести список файлов с контролируемой версией по размеру:

darcs показать файлы -0 | xargs -0 лс -ldS

дарки произошел индекс
Команда `darcs show index` выводит список всех файлов и каталогов с контролем версий.
вместе со своими хэшами, хранящимися в `_darcs / index`. Для файлов поля соответствуют
к размеру файла, sha256 текущего содержимого файла и имени файла.
дарки произошел нетронутый
Команда `darcs show pristine` выводит список всех файлов и каталогов с контролем версий.
вместе с хешами их первозданных копий. Для файлов поля соответствуют
размер файла, sha256 исходного содержимого файла и имени файла.
дарки произошел РЕПО
Команда `darcs show repo` отображает статистику текущего репозитория,
разрешение сторонним скриптам получить доступ к этой информации без проверки _darcs
напрямую (и без прерывания при изменении формата `_darcs`).

По умолчанию отображается количество патчей. Если эти данные не нужны, используйте
`--no-files` для ускорения этой команды с O (n) до O(1).

По умолчанию вывод находится в удобочитаемом формате. Параметр --xml-output может быть
используется для генерации вывода для машинной постобработки.

дарки произошел Авторы
Команда `darcs show sources` выводит список авторов текущего репозитория, отсортированный
по количеству внесенных патчей. С параметром --verbose эта команда
просто перечисляет автора каждого патча (без агрегирования и сортировки).

Имя автора или адрес электронной почты могут со временем измениться. Чтобы сообщить Darcs, когда несколько
строки автора относятся к одному и тому же человеку, создайте файл `.authorspellings` в
корень рабочего дерева. Каждая строка в этом файле начинается с канонического имени автора.
имя и адрес, за которым может следовать список расширенных обычных
выражения. Пустые строки и строки, начинающиеся с двух дефисов, игнорируются. В
формат `.authorspelling` можно описать следующим шаблоном:

название [, регулярное выражение] *

Есть некоторые подводные камни, касающиеся специальных символов: Пробелы удаляются, если
вам нужно место в regexp use []. Поскольку запятая служит разделителем, вы должны
избегайте этого, если хотите в регулярном выражении. Обратите внимание, что `.authorspelling` использует расширенный обычный
выражения так +,? и так далее - это метасимволы, и вам нужно избегать их, чтобы
толкуется буквально.

Любой патч со строкой автора, которая соответствует каноническому адресу или любому из
связанные регулярные выражения считаются работой этого автора. Все совпадения
без учета регистра и частичное (может соответствовать подстроке). Используйте ^, $ для соответствия целому
строка в регулярном выражении

В настоящее время этот шаг канонизации выполняется только в `darcs show авторах`. Другой
команды, такие как `darcs log`, дословно используют строки автора.

Пример файла `.authorspelling`:

- Это комментарий.
Фред Нурк[электронная почта защищена]>
Джон Снагге[электронная почта защищена]>, Джон, snagge @, js @ (si | mit) .edu
Чак Джонс \ младший[электронная почта защищена]>, cj \ +[электронная почта защищена]

дарки произошел имеют теги
Команда tags выводит на стандартный вывод список всех тегов в репозитории.

Символы табуляции (символ ASCII 9) в именах тегов для удобства заменены на пробелы.
совместимость с инструментами оболочки. Если это произойдет, выводится предупреждение.

дарки произошел патч-индекс-все
Команда `darcs show patch-index all 'выводит всю информацию в указателе исправлений.
дарки произошел патч-индекс-файлы
Команда `darcs show patch-index files 'выводит список всех текущих файлов, зарегистрированных в
индекс патча
дарки произошел патч-индекс-статус
`Darcs show patch-index-status 'сообщает, если индекс исправления синхронизирован, вне
синхронизировать, или не существует
дарки произошел патч-индекс-тест
`Darcs show patch-index-test 'тестирует индекс патча

Копирование патчи между хранилища работает копия Обновление:
дарки тянуть [хранилище] ...
Pull используется для переноса исправлений, сделанных в другом репозитории, в текущий репозиторий.
(то есть либо тот, который находится в текущем каталоге, либо тот, который указан с
параметр --repodir). Pull позволяет перенести все или некоторые исправления, которые
в этом репозитории, но не в этом. Pull принимает аргументы, которые являются URL-адресами из
который вытащить, и при вызове без аргументов pull будет использовать репозиторий из
которые вы в последнее время либо толкали, либо тянули.

По умолчанию (`--union`) извлекаются любые патчи, которые находятся в любом из
указанные репозитории. Если вы укажете флаг --intersection, darcs будет только
вытащите те патчи, которые есть во всех исходных репозиториях. Если вы укажете
флаг `--complement`, darcs будет извлекать только те элементы в первом репозитории, которые не
существуют в любом из оставшихся репозиториев.

Если указан `--reorder`, набор патчей, которые существуют только в текущем
репозиторий помещен в начало текущей истории. Это будет работать, даже если есть
новых патчей нет.

См. «Darcs help apply» для подробного описания многих опций.

дарки получать [хранилище] ...
Fetch похож на `pull` за исключением того, что он не применяет никаких патчей к текущему
репозиторий. Вместо этого он генерирует пакет исправлений, который вы можете применить позже с помощью
`применить`.

Поведение Fetch по существу похоже на поведение pull, поэтому, пожалуйста, обратитесь к справке
`pull`, чтобы узнать больше.

дарки уничтожать
Obliterate полностью удаляет записанные патчи из вашего локального репозитория. Перемены
будут отменены в вашей рабочей копии, и исправления не будут отображаться в ваших изменениях
список больше. Помните, что вы можете потерять драгоценный код, уничтожив его!

Один из способов сохранить удаленные патчи - использовать флаг -O. Пакет патчей будет
созданный локально, который вы сможете позже применить к своему репозиторию с помощью `darcs
применить`.

дарки отмена [файл|каталог] ...
Откат используется для отмены некоторых изменений из патчей в репозитории.
Выбранные изменения отменяются в вашей рабочей копии, но репозиторий остается
без изменений. Сначала вам предлагается выбрать, какие патчи отменить, а затем какие изменения.
внутри патчей, которые нужно отменить.

Перед выполнением «отката» вы можете временно отменить изменения в вашей работе.
скопируйте (если есть) и сохраните для дальнейшего использования. Для этого вы можете запустить `revert`, затем
запустите `rollback`, запишите патч и запустите` unrevert`, чтобы восстановить сохраненные изменения в
ваша рабочая копия.

дарки протолкнуть. [хранилище]
Толчок противоположен притяжению. Push позволяет копировать патчи из текущего
репозиторий в другой репозиторий.

Если вы укажете флаг --apply-as, darcs будет использовать sudo для применения патчей как
другой пользователь. Это может быть полезно, если вы хотите настроить систему, в которой несколько пользователей
могут изменять один и тот же репозиторий, но вы не хотите предоставлять им полный доступ для записи.
Это небезопасно от опытных злоумышленников, но, по крайней мере, может защитить ваш
репозиторий от неповоротливых, неумелых или ленивых пользователей.

Darcs push по умолчанию сжимает данные патча перед их отправкой на удаленный компьютер.
местоположение через ssh. Это работает, пока удаленный darcs не старше версии
2.5. Если вы получаете ошибки, указывающие на поврежденный пакет исправлений, попробуйте еще раз с помощью
параметр --no-compress для отправки данных в несжатом виде (что очень много
медленнее для больших пятен, но всегда должно работать).

дарки Отправить [хранилище]
Отправить используется для подготовки пакета исправлений, которые можно применить к цели.
репозиторий. Send принимает URL-адрес репозитория в качестве аргумента. При звонке
без аргумента send будет использовать самый последний репозиторий, который был отправлен
в, извлечено из или отправлено в. По умолчанию пакет исправлений сохраняется в файл, хотя
Вы можете отправить его напрямую по почте.

Флаги `--output`,` --output-auto-name` и `--to` определяют, что darcs делает с
пакет исправлений после его создания. Если вы укажете аргумент --output, патч
пакет сохраняется в этот файл. Если вы укажете --output-auto-name, пакет исправлений
сохраняется в файл с автоматически сгенерированным именем. Если вы дадите один или несколько
`--to`, пакет исправлений отправляется в эти места. Места могут
либо адреса электронной почты, либо URL-адреса, на которые патч должен быть отправлен через HTTP.

Если вы укажете флаг --mail, darcs будет проверять содержимое
файл `_darcs / prefs / email` в целевом репозитории (если он существует) и отправьте патч.
по электронной почте на этот адрес. В этом случае вы можете использовать параметр --cc, чтобы указать
дополнительных получателей без переопределения адреса электронной почты репозитория по умолчанию.

Если в целевом репозитории существует `_darcs / prefs / post`, darcs будет загружать по URL-адресу
содержащийся в этом файле, который может быть URL-адресом mailto: или URL-адресом http: //. В
в последнем случае патч отправляется по этому URL-адресу.

Если с репозиторием не связан адрес электронной почты, darcs предложит вам ввести
адрес электронной почты.

Используйте флаг --subject, чтобы задать тему отправляемого электронного письма. Если вы этого не сделаете
укажите тему в командной строке, darcs создаст ее на основе имен
патчи в комплекте патчей.

Используйте флаг `--in-reply-to`, чтобы установить заголовки In-Reply-To и References в
электронное письмо для отправки. По умолчанию дополнительные заголовки не включаются, поэтому электронная почта не будет
рассматривается как ответ читателей почты.

Если вы хотите включить описание или объяснение вместе с пакетом исправлений,
вам нужно указать флаг `--edit-description`, который вызовет открытие darcs
редактор, с помощью которого вы можете составить сообщение, которое будет сопровождать ваши патчи.

Если вы хотите использовать команду, отличную от команды по умолчанию для отправки электронной почты, вы
необходимо указать командную строку с параметром --sendmail-command. Командная строка
может содержать некоторые спецификаторы формата, которые заменяются фактическими значениями. Принятый
спецификаторы формата: `% s` для темы,`% t` для того, `% c` для cc,`% b` для тела
почта, `% f` для from,`% a` для пакета исправлений и те же спецификаторы в
заглавные буквы для значений в кодировке URL. Кроме того, вы можете добавить `% <` в конец
командная строка, если команда ожидает полного сообщения электронной почты на стандартном вводе. Например
командные строки для evolution и msmtp выглядят так:

эволюция "mailto:% T? subject =% S & attach =% A & cc =% C & body =% B"
мсмтп -t%

Не путайте параметры `--author` с обратным адресом, который отправит` darcs send`.
установлен для вашего пакета патчей.

Например, если у вас два адреса электронной почты A и B:

* Если вы используете `--author A`, но ваш компьютер настроен на отправку почты от
адрес B по умолчанию, то обратным адресом в вашем сообщении будет B. * Если вы
используйте `--from A`, и ваш почтовый клиент поддерживает установку
От: адрес произвольно (некоторые не-Unix-подобные почтовые клиенты, особенно
может не поддерживать это), тогда обратным адресом будет A; если это так
не поддерживает это, тогда обратным адресом будет B. * Если вы не предоставите ни то, ни другое
`--from` или` --author`, затем возврат
адрес будет B.

Кроме того, если вы не укажете команду sendmail с помощью `--sendmail-command`, darcs
отправляет электронную почту, используя команду электронной почты по умолчанию на вашем компьютере. Эта команда по умолчанию:
определяется скриптом `configure`. Таким образом, в некоторых операционных системах, отличных от Unix, `--from` является
скорее всего, вообще не сработает.

дарки подать заявление <файл патча>
Команда `darcs apply` берет пакет исправлений и пытается вставить его в
текущий репозиторий. В дополнение к прямому вызову его в пакетах, созданных `darcs
send`, он используется внутри `darcs push` на удаленном конце SSH-соединения.

Если файл не указан, пакет считывается со стандартного ввода.

Если вместо пакета исправлений будет отправлено электронное письмо, Darcs будет искать пакет как MIME.
вложение к этому электронному письму. В настоящее время это не сработает, если переписать границу MIME,
например, в Courier и Mail.app.

Если `--reply [электронная почта защищена]`опция, и связка прикреплена к
электронной почты, Darcs отправит отчет (с указанием успеха или неудачи) отправителю
bundle (поле "Кому"). Аргументом для noreply является адрес, который будет представлен в отчете.
кажутся происходящими ОТ.

Параметр --cc приведет к тому, что отчет будет отправлен на другой адрес, например
`--cc [электронная почта защищена],[электронная почта защищена]`. Использование `--cc` без
`--reply` не определен.

Если вы хотите использовать команду, отличную от команды по умолчанию для отправки почты, вам необходимо
для указания командной строки с параметром --sendmail-command. Командная строка может
содержат спецификатор формата `% t` для to, и вы можете добавить`% <`в конец
командная строка, если команда ожидает получения полной почты на стандартный ввод. Например,
командная строка для msmtp выглядит так:

мсмтп -t%

If GPG(1) установлен, вы можете использовать `--verify pubring.gpg`, чтобы отклонять пакеты, которые
не подписаны ключом в pubring.gpg.

Если указан `--test` и определен тест (см.` Darcs setpref`), пакет будет
быть отклоненным, если тест не прошел после его применения. В этом случае электронное письмо с отказом
from `--reply` будет включать тестовый вывод.

Пакет исправлений может привести к неразрешенным конфликтам с существующими исправлениями или с
рабочее дерево. По умолчанию Darcs будет добавлять маркеры конфликтов (см. `Darcs
отметка-конфликты`).

Параметр --external-merge позволяет разрешить эти конфликты с помощью внешнего слияния.
инструмент. В опции, `% a` заменяется общим предком (база слияния),`% 1`
с первой версией, `% 2` со второй версией и`% o` с путем, где
ваш разрешенный контент должен уйти. Например, чтобы использовать инструмент визуального слияния xxdiff
вы должны указать: `--external-merge = 'xxdiff -m -O -M% o% 1% a% 2' '

Параметр --allow-конфликты пропускает маркировку конфликтов; это полезно, когда вы
хотите рассматривать репозиторий как набор исправлений, например, используя `darcs pull
--union`, чтобы загрузить патчи ваших коллег перед отключением от сети.

Это может испортить незарегистрированные изменения в рабочем дереве, вынудив вас разрешить
конфликт немедленно. Чтобы просто отклонить пакеты, которые вносят неразрешенные конфликты,
используя опцию `--dont-allow-sizes`. Сделав это значение по умолчанию для push-ориентированных
рабочие процессы настоятельно рекомендуется.

В отличие от большинства команд Darcs, для параметра darcs apply по умолчанию используется значение --all. Использовать
Параметр --interactive, чтобы выбрать, какие исправления применять из пакета.

дарки клонировать <хранилище> [каталог>]
Клонирование создает копию репозитория. Необязательный второй аргумент указывает
целевой каталог для новой копии; если опущено, это выводится из источника
место нахождения.

По умолчанию Darcs копирует каждый патч из исходного репозитория. Это означает
копия полностью независима от оригинала; вы можете работать с новым репозиторием
даже если оригинал недоступен. Если вы ожидаете, что исходный репозиторий
остаются доступными, вы можете использовать `--lazy`, чтобы избежать копирования патчей, пока они не понадобятся
("копия по запросу"). Это особенно полезно при копировании удаленного репозитория с помощью
долгая история, которая вам наплевать.

При локальном клонировании Darcs по возможности автоматически использует жесткую привязку. Также
для экономии времени и места это позволяет переместить или удалить исходный репозиторий
не затрагивая копию. Жесткая ссылка требует, чтобы копия была на том же
файловая система в качестве исходного репозитория и что файловая система поддерживает жесткое связывание.
Сюда входят NTFS, HFS + и все файловые системы Unix общего назначения (такие как ext, UFS
и ZFS). FAT не поддерживает жесткие ссылки.

При клонировании из удаленного места Darcs будет искать и пытаться использовать пакеты
созданный `darcs optimize http` в удаленном репозитории. Пакеты - это отдельные большие файлы
которые можно загрузить вместо множества маленьких файлов, что ускоряет клонирование
http.

Клон Darcs не будет копировать незарегистрированные изменения в рабочее дерево исходного репозитория.

Вы можете скопировать репозиторий по ssh url, и в этом случае новый репозиторий всегда будет
быть полным.

Часто бывает желательно сделать копию репозитория, исключающего некоторые исправления. За
Например, если выпуски помечены тегами, то `darcs clone --tag .` сделает копию
репозиторий как в последней версии.

Непомеченное состояние репозитория все еще можно однозначно идентифицировать с помощью файла контекста,
как сгенерировано `darcs log --context`. Учитывая имя такого файла, `--context`
опция создаст репозиторий, который включает только исправления из этого контекста.
Когда пользователь сообщает об ошибке в невыпущенной версии вашего проекта, рекомендуется
способ узнать, какую именно версию они используют, - это включить в них
контекстный файл в отчете об ошибке.

Вы также можете сделать копию непомеченного состояния, используя --to-patch или --to-match.
параметры, исключающие патчи * после * первого совпадающего патча. Потому что эти
опции обрабатывают набор патчей как упорядоченную последовательность, вы можете получить разные результаты
после переупорядочивания с помощью `darcs optimize`, поэтому тегирование предпочтительнее.

Опция `--set-scripts-executable` заставляет скрипты быть исполняемыми в
рабочее дерево. Сценарий - это любой файл, который начинается с символа shebang ("#!").

Администрация репозитории:
дарки инициализировать [<каталог>]
Команда `darcs initialize` превращает текущий каталог в репозиторий Darcs.
Любые существующие файлы и подкаталоги становятся НЕ СОХРАНЕННЫМИ изменениями: запишите их с помощью `darcs
запись --look-for-add`.

Эта команда создает каталог _darcs, в котором хранятся метаданные системы управления версиями.
Он также содержит настройки репозитория в `_darcs / prefs /`, о которых вы можете прочитать
в руководстве пользователя.

По умолчанию патчи нового репозитория находятся в семантике darcs-2. Однако это
возможно создание репозитория в семантике darcs-1 с флагом `--darcs-1`,
хотя это не рекомендуется, за исключением совместного использования патчей с проектом, который использует
патчи в семантике darcs-1.

Инициализация обычно сокращается до `init`.

дарки оптимизировать чистым
Эта команда удаляет устаревшие файлы в репозитории.
дарки оптимизировать HTTP
Использование этой опции создает «пакеты репозитория», которые могут значительно ускорить
производительность, когда пользователь выполняет «darcs clone» репозитория через HTTP. Чтобы использовать
пакетов, клиенты должны иметь дарки не ниже версии 2.10.

дарки оптимизировать Изменение порядка
Эта команда перемещает последние исправления (не включенные в последний тег) в папку
"front", уменьшая объем, необходимый для загрузки типичной удаленной команды. Это
также должно сократить время процессора, необходимое для некоторых операций.
дарки оптимизировать включить-патч-индекс
Создайте индекс исправлений, внутреннюю структуру данных, которая ускоряет выполнение команд, которые требуют
чтобы знать, какие патчи касаются данного файла. Такие как аннотирование и журнал.
дарки оптимизировать отключить индекс-патч
Удалите и прекратите поддержку индекса исправлений из репозитория.
дарки оптимизировать сжимать
По умолчанию исправления сжимаются с помощью zlib (RFC 1951), чтобы уменьшить объем хранилища (и
скачать) размер. В исключительных обстоятельствах может быть предпочтительнее избегать
сжатие. В этом случае можно использовать параметр --dont-compress (например, с помощью `darcs
record`), чтобы избежать сжатия.

Команды `darcs optimize uncompress` и` darcs optimize compress` могут использоваться для
убедитесь, что существующие исправления в текущем репозитории соответственно не сжаты или
сжатый.
дарки оптимизировать распаковывать
По умолчанию исправления сжимаются с помощью zlib (RFC 1951), чтобы уменьшить объем хранилища (и
скачать) размер. В исключительных обстоятельствах может быть предпочтительнее избегать
сжатие. В этом случае можно использовать параметр --dont-compress (например, с помощью `darcs
record`), чтобы избежать сжатия.

Команды `darcs optimize uncompress` и` darcs optimize compress` могут использоваться для
убедитесь, что существующие исправления в текущем репозитории соответственно не сжаты или
сжатый.
дарки оптимизировать повторно связать
Команда `darcs optimize relink` жестко связывает исправления, которые есть в текущем репозитории.
вместе со своими сверстниками. Пиры - это репозитории, перечисленные в
`_darcs / prefs / sources` или определенный с помощью опции` --sibling` (которая может использоваться
многократно).

Darcs автоматически использует жесткие ссылки, поэтому эта команда требуется редко. Это самый
полезно, если вы использовали `cp -r` вместо` darcs clone` для копирования репозитория, или если вы
вытащил один и тот же патч из удаленного репозитория в несколько локальных репозиториев.
дарки оптимизировать нетронутый
Эта команда обновляет формат _darcs / pristine.hashed /, который был другим
перед darcs 2.3.1.
дарки оптимизировать модернизация
Преобразуйте устаревшие репозитории в текущий хешированный формат по умолчанию.
дарки оптимизировать кэш <каталог> ...
Эта команда удаляет устаревшие файлы из глобального кеша. Требуется один или несколько
каталоги в качестве аргументов и рекурсивно ищет все репозитории в этих
каталоги. Затем он удаляет все файлы в глобальном кеше, не принадлежащие этим
репозитории. Если каталог не указан, он ищет репозитории в доме пользователя.
каталог.

Он также автоматически переводит глобальный кеш в формат (по умолчанию) с разделением на сегменты.

дарки ремонт
Команда `darcs repair` пытается исправить повреждение в текущем репозитории.
В настоящее время он может восстанавливать только повреждения нетронутого дерева, а именно там больше всего
происходит коррупция. Эта команда восстанавливает нетронутое дерево, последовательно применяя
патчи в репозитории на пустое дерево.

Флаг `--dry-run` делает эту операцию доступной только для чтения, что приводит к неудачному завершению darcs
(с ненулевым статусом выхода), если восстановленная изначальная версия отличается от текущей
первозданный.

дарки превращаются Даркс-2 <источник> [назначение>]
Эта команда преобразует репозиторий, который использует старую семантику патчей `darcs-1`, в репозиторий.
новый репозиторий с текущей семантикой darcs-2.

ВНИМАНИЕ: репозиторий, созданный этой командой, не распознается Darcs 1.x и
Патчами нельзя обмениваться между репозиториями в форматах darcs-1 и darcs-2.

Более того, репозитории, созданные различными вызовами этой команды, НЕ ДОЛЖНЫ
обменять патчи.

дарки превращаются экспорт
Эта команда позволяет экспортировать репозитории darcs в git.

Для разового вывоза можно воспользоваться рецептом:

$ cd репо
$ git init ../зеркало
$ darcs конвертировать экспорт | (cd ../mirror && git fast-import)

Для инкрементального экспорта с использованием файлов меток:

$ cd репо
$ git init ../зеркало
$ коснуться ../зеркало/git.marks
$ darcs convert export --read-mark darcs.marks --write-mark darcs.marks
| (cd ../mirror && git fast-import --import-mark = git.marks
--export-mark = git.marks)

В случае инкрементного экспорта будьте осторожны, никогда не изменяйте, не удаляйте и не переупорядочивайте
патчи в исходном репозитории darcs.

Кроме того, имейте в виду, что экспорт репозитория darcs в git не будет точно соответствовать
с точки зрения истории, если в репозитории darcs есть конфликты.

Ограничения:

* Пустые каталоги не поддерживаются протоколом быстрого экспорта. * Юникод
имена файлов в настоящее время обрабатываются неправильно.
Посмотреть http://bugs.darcs.net/issue2359 .

дарки превращаются Импортировать [<каталог>]
Эта команда импортирует репозитории git в новые репозитории darcs. Дополнительные возможности
принимаются (см. `darcs help init`).

Чтобы преобразовать репозиторий git в новый darcs, вы можете запустить:
$ (cd gitrepo && git fast-export --all) | darcs convert import darcsmirror

ВНИМАНИЕ: репозитории git с ветками будут давать странные результаты,
используйте на свой страх и риск.

Инкрементный импорт с файлами меток в настоящее время не поддерживается.

дарки перебазировать тянуть [хранилище] ...
Скопируйте и примените исправления из другого репозитория, приостановив любые локальные исправления, которые
конфликт.
дарки перебазировать подать заявление <файл патча>
Примените пакет исправлений, приостановив все конфликтующие локальные исправления.
дарки перебазировать приостановить
Выберите патчи для перехода в приостановленное состояние по окончании репо.

дарки перебазировать откладывать
Выбранные патчи для восстановления из приостановленного состояния до конца репо.

дарки перебазировать уничтожать
Удалите патч, работа которого приостановлена.

дарки перебазировать журнал
Перечислите временно приостановленные изменения.

ОКРУЖАЮЩАЯ СРЕДА

ГЛАВНАЯ и ДАННЫЕ ПРИЛОЖЕНИЯ
Предпочтения для каждого пользователя устанавливаются в $ HOME / .darcs (в Unix) или% APPDATA% / darcs (в Windows).
Это также расположение кеша по умолчанию.

ДАРКС_РЕДИКАТОР, ДАРКСЕДИТОР, VISUAL и РЕДАКТОР
Чтобы отредактировать описание патча комментария электронной почты, Darcs вызовет внешний редактор. Ваш
предпочтительный редактор может быть установлен как любая из переменных окружения $ DARCS_EDITOR,
$ DARCSEDITOR, $ VISUAL или $ EDITOR. Если ничего из этого не установлено, редактор(1) используется.

ДАРКС_ПАГЕР и ПЕЙДЖЕРА
Darcs иногда вызывает пейджер, если считает, что вывод слишком длинный и не помещается на экране.
Darcs будет использовать пейджер, указанный в $ DARCS_PAGER или $ PAGER. Если ни один из них не установлен,
пейджер(1) будет использоваться.

DARCS_DONT_COLOR, DARCS_ALWAYS_COLOR, DARCS_ALTERNATIVE_COLOR и DARCS_DO_COLOR_LINES
Если терминал понимает escape-последовательности цветов ANSI, darcs выделит определенные
ключевые слова и разделители при печати патчей. Это можно отключить, установив
переменная среды DARCS_DONT_COLOR равняется 1. Если вы используете пейджер, который понимает
Цвета ANSI, такие как `less -R`, darcs всегда могут быть принудительно выделены для выделения вывода, установив
DARCS_ALWAYS_COLOR равным 1. Если вы не видите цвета, вы можете установить DARCS_ALTERNATIVE_COLOR равным 1,
и darcs будут использовать коды ANSI для жирного и обратного видео вместо цветов. Кроме того,
есть особо красочный режим, который по умолчанию не включен, который можно активировать
с DARCS_DO_COLOR_LINES

DARCS_DONT_ESCAPE_TRAILING_SPACES и DARCS_DONT_ESCAPE_TRAILING_CR
По умолчанию darcs экранирует (по возможности выделяя) любые пробелы в конце
строк при отображении содержимого патча. Если вы этого не хотите, вы можете выключить его с помощью
установка DARCS_DONT_ESCAPE_TRAILING_SPACES в 1. Особый случай существует только для перевозки
возвращает: DARCS_DONT_ESCAPE_TRAILING_CR

DARCS_DONT_ESCAPE_ANYTHING, DARCS_DONT_ESCAPE_ISPRINT, DARCS_DONT_ESCAPE_8BIT,
DARCS_DONT_ESCAPE_EXTRA и DARCS_ESCAPE_EXTRA
Darcs необходимо экранировать определенные символы при выводе содержимого патча на терминал.
Такие символы, как backspace, в противном случае могут скрыть содержимое патча от пользователя и другие
последовательности символов могут даже в некоторых случаях перенаправлять команды в оболочку, если терминал
позволяет это.

По умолчанию darcs разрешает печатать только 7-битные символы ASCII (включая пробелы) и
вкладка с двумя управляющими символами и новая строка. Все остальные октеты печатаются в кавычках.
(как `^ `или` \ `).

Darcs имеет ограниченную поддержку локалей. Если языковой стандарт системы однобайтовый
кодировка символов, как и в латинских кодировках, вы можете установить переменную окружения
DARCS_DONT_ESCAPE_ISPRINT до 1, и darcs отобразит все печатные формы в текущем
системная локаль, а не только ASCII. ПРИМЕЧАНИЕ. В настоящее время это не работает на некоторых
архитектуры, если darcs скомпилирован с GHC 6.4 или новее. Некоторые элементы управления, отличные от ASCII
символы могут быть напечатаны и могут подделать терминал.

Для многобайтовых кодировок все менее гладко. UTF-8 будет работать, если вы установите
DARCS_DONT_ESCAPE_8BIT в 1, но непечатаемые за пределами 7-битного диапазона ASCII нет
дольше сбежал. Например, лишние управляющие символы из Latin-1 могут покинуть ваш терминал.
во власти содержимого патча. Пробелы вне 7-битного диапазона ASCII не допускаются.
больше распознается и не будет должным образом экранирован в конце строки.

В крайнем случае вы можете установить для DARCS_DONT_ESCAPE_ANYTHING значение 1. Тогда все, что не
Наборы флип-кодов должны работать, как и все навороты в вашем терминале. Этот
переменная окружения также может быть полезна, если вы передаете вывод на пейджер или внешний
фильтр, который лучше darcs знает, как обрабатывать вашу кодировку. Обратите внимание, что все убегающие,
включая специальное экранирование любых пробелов в конце строки, будет отключено этим
установка.

Есть две переменные среды, которые вы можете установить, чтобы явно указать darcs, чтобы они не выходили из строя или
escape-октеты. Это DARCS_DONT_ESCAPE_EXTRA и DARCS_ESCAPE_EXTRA. Их ценности
должны быть строками, состоящими из рассматриваемых дословных октетов. Побеги берут
приоритет над запретом на побег. Пробелы по-прежнему экранируются в конце строки
хотя. Специальная переменная среды DARCS_DONT_ESCAPE_TRAILING_CR отключает экранирование
последнего символа возврата каретки в строке (стиль DOS).

DARCS_TMPDIR и TMPDIR
Darcs часто создает временные каталоги. Например, команда `darcs diff` создает
два для разных рабочих деревьев. По умолчанию временные каталоги создаются в
/ Tmp, или, если его не существует, в _darcs (в текущем репо). Это может быть
переопределить, указав другой каталог в файле _darcs / prefs / tmpdir или
переменная окружения $ DARCS_TMPDIR или $ TMPDIR.

DARCS_KEEP_TMPDIR
Если переменная среды DARCS_KEEP_TMPDIR определена, darcs не удалит
временные каталоги, которые он создает. Это предназначено в первую очередь для отладки самого Darcs,
но это также может быть полезно, например, для определения того, почему ваши предпочтения в тестировании (см. `darcs
setpref`) не работает при запуске `darcs record`, но работает при запуске вручную.

DARCS_EMAIL и ЭЛ. АДРЕС
Каждый патч приписывается его автору, обычно по адресу электронной почты (например, `Fred
Блоги[электронная почта защищена]> `). Darcs ищет эту авторскую строку в нескольких местах:
опция `--author`, файлы` _darcs / prefs / author` (в репозитории) и
`~ / .darcs / автор`(в вашем домашнем каталоге) и переменные среды` $ DARCS_EMAIL`
и `$ EMAIL`. Если ни один из них не существует, Darcs предложит вам ввести строку автора и
напишите это в `~ / .darcs / автор`. Обратите внимание: если у вас несколько адресов электронной почты, вы можете
поместите их все в `~ / .darcs / автор`, по одному автору в строке. Darcs по-прежнему будет предлагать вам
автора, но это позволяет вам выбрать из списка или ввести альтернативный вариант.

ОТПРАВИТЬ ПИСЬМО
В Unix команда `darcs send` полагается на Отправить письмо(8). `--Sendmail-command` или
Переменная среды $ SENDMAIL может использоваться для указания явного пути к этой программе;
в противном случае стандартные локации / usr / sbin / sendmail и / usr / lib / sendmail будут пробовать.

DARCS_SLOPPY_LOCKS
Если в некоторых файловых системах вы получите ошибку следующего вида:

darcs: takeLock [...]: atomic_create [...]: неподдерживаемая операция

вы можете попробовать экспортировать DARCS_SLOPPY_LOCKS = True.

ДАРКС_SSH
Репозитории вида [user @] host: [dir] считаются удаленными репозиториями, которые
Доступы Darcs с внешней программой SSH(1).

Переменная среды $ DARCS_SSH может использоваться для указания альтернативного клиента SSH.
Аргументы могут быть включены через пробел. Значение не интерпретируется
оболочка, поэтому конструкции оболочки использовать нельзя; в частности, это невозможно для
имя программы должно содержать пробелы в кавычках или экранировании.

DARCS_SCP и DARCS_SFTP
При чтении из удаленного репозитория Darcs попытается запустить `darcs transfer-mode` на
удаленный хост. Это не удастся, если на удаленном хосте установлен только Darcs 1, не
у вас вообще установлен Darcs, или разрешен только SFTP.

Если режим передачи не удастся, Darcs вернется к УПП(1) и SFTP(1). Вызванные команды
можно настроить с помощью переменных среды $ DARCS_SCP и $ DARCS_SFTP соответственно,
которые ведут себя как $ DARCS_SSH. Если удаленный конец разрешает только sftp, попробуйте установить
DARCS_SCP = SFTP.

SSH_PORT
Если эта переменная среды установлена, она будет использоваться в качестве номера порта для всех вызовов SSH.
сделано Darcs (при доступе к удаленным репозиториям по SSH). Это полезно, если ваш SSH
сервер не работает на порту по умолчанию, и ваш SSH-клиент не поддерживает
ssh_config(5). Пользователи OpenSSH, вероятно, предпочтут указать что-то вроде `Host
* .example.net Порт 443` в свои ~ / .ssh / конфигурации .

HTTP_ПРОКСИ, HTTPS_ПРОКСИ, FTP_ПРОКСИ, ВСЕ_ПРОКСИ и NO_PROXY
Если Darcs был собран с libcurl, переменные среды HTTP_PROXY, HTTPS_PROXY и
FTP_PROXY может быть установлен на URL-адрес прокси в форме

[протокол: //] [: порт]

В этом случае libcurl будет использовать прокси для связанного протокола (HTTP, HTTPS и
FTP). Переменная окружения ALL_PROXY может использоваться для установки одного прокси для всех libcurl.
запросы.

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

NO_PROXY = локальный хост, *. Локальный домен

Для совместимости с lynx et al., Строчные эквиваленты этих переменных среды
(например, $ http_proxy) также понимаются и используются вместо прописных
версий.

Если Darcs не был собран с libcurl, все эти переменные среды игнорируются,
и нет возможности использовать веб-прокси.

DARCS_PROXYUSERPWD
Если Darcs был создан с использованием libcurl, и вы используете веб-прокси, для которого требуется
аутентификации, вы можете установить в переменной среды $ DARCS_PROXYUSERPWD имя пользователя
и пароль, ожидаемый прокси, разделенные двоеточием. Эта переменная среды
молча игнорируется, если Darcs не был собран с libcurl.

DARCS_GET_FOO и DARCS_APPLY_FOO
При попытке получить доступ к репозиторию с URL-адресом, начинающимся с foo: //, darcs вызовет
программа, указанная в переменной среды DARCS_GET_FOO (если определена) для загрузки каждого
файл и команда, указанная в переменной среды DARCS_APPLY_FOO (если определено)
при нажатии на URL-адрес foo: //.

Этот метод отменяет все другие способы получения URL-адресов `foo: // xxx`.

Обратите внимание, что каждая команда должна быть построена так, чтобы она отправляла загруженный контент в
STDOUT, и следующим аргументом для него должен быть URL. Вот несколько примеров, которые следует
работать для DARCS_GET_HTTP:

получить -q -o -
завиток -s -f
рысь -источник
wget -q -O -

Помимо таких игрушечных примеров, вам, вероятно, придется манипулировать аргументом
перед передачей в фактическую программу-сборщик. Например, рассмотрим проблему
получение доступа на чтение к репозиторию на общем ресурсе CIFS (SMB) без прав монтирования:

экспорт DARCS_GET_SMB ​​= 'smbclient -c get'
darcs получить smb: // fs / twb / Desktop / hello-world

Вышеупомянутая команда не будет работать по нескольким причинам. Во-первых, Darcs передаст его
аргумент, начинающийся с `smb:`, который smbclient не понимает. Во-вторых, хозяин
и share `// fs / twb` должен быть представлен как отдельный аргумент пути
`Рабочий стол / привет-мир`. В-третьих, smbclient требует, чтобы `get` и путь были единым
аргумент (включая пробел), а не два отдельных аргумента. Наконец, smbclient's
Команда `get` записывает файл на диск, в то время как Darcs ожидает, что он будет напечатан в стандартном формате.
вывод.

В принципе, мы могли бы обойти такие проблемы, если бы переменная содержала оболочку
скрипт, к сожалению, Darcs разбивает команду на пробелы и не понимает
цитата или побег. Поэтому вместо этого нам нужно поместить команды в отдельный исполняемый файл.
скриптов.

Продолжая наш пример smbclient, мы создаем исполняемый скрипт
`~ / .darcs / libexec / get_smb`со следующим содержанием:

#!/ bin / bash -e
IFS = / читать файл общего доступа к хосту <<< '$ {1 # smb: //}'
smbclient // $ host / $ share -c 'получить $ файл -'

И наконец мы можем сказать

экспорт DARCS_GET_SMB ​​=~ / .darcs / libexec / get_smb
darcs получить smb: // fs / twb / Desktop / hello-world

Команда APPLY будет вызываться с файлом патча darcs, переданным на стандартный ввод.

DARCS_CONNECTION_TIMEOUT
Установите максимальное время в секундах, которое позволяет darcs и соединение. Если переменная
не указано, по умолчанию - 30 секунд. Этот вариант работает только с завитком.

Используйте darcs онлайн с помощью сервисов onworks.net