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

ПРОГРАММА:

ИМЯ

gbp-dch - генерирует журнал изменений Debian из сообщений коммита git.

СИНТАКСИС

Фунт стерлингов DCH [ --версия ] [ --Помогите ] [ --подробный ] [ --color =[авто | вкл | выкл] ] [ --цвет-
схема =ЦВЕТОВАЯ СХЕМА ] [ --debian-branch =Branch_name ] [ --debian-tag =формат тега ] [
--upstream-branch =Branch_name ] [ --upstream-tag =формат тега ] [ --игнорировать-ветвь ] [
- снимок | --выпускать ] [ --авто | --since =совершать ] [ --new-version =версия ] [ --bpo
| --нму | --ка | --команда ] [ --distribution =имя ] [ --force-распределение ] [
--urgency =уровень ] [ - [нет-] полный ] [ - [нет-] мета ] [ --meta-closes = теги закрытия ошибок ] [
--meta-closes-bugnum = формат номера ошибки ] [ --snapshot-number =выражение ] [ --я бы-
длина =номер ] [ --git-log =git-log-параметры ] [ - [no-] git-author ] [ - [нет-] мультимайн ]
[ - [no-] multimaint-merge ] [ --spawn-editor = [всегда | снимок | выпуск] ] [ --совершить-
сообщ =msg-формат ] [ --совершить ] [ --customizations =файл настройки ] [путь1 путь2]

ОПИСАНИЕ

Фунт стерлингов DCH читает сообщения коммита git и генерирует на их основе журнал изменений Debian. Если нет
приводятся аргументы, Фунт стерлингов DCH начинается с последней помеченной версии пакета Debian до
текущая вершина текущей ветки. Если раздача самого верхнего раздела в
debian / журнал изменений is UNRELEASED, записи журнала изменений будут вставлены в этот раздел.
В противном случае будет создан новый раздел.

If --авто дано Фунт стерлингов DCH, пытается угадать последний коммит Git, задокументированный в журнале изменений
- это работает только в режиме моментального снимка. Иначе, --поскольку можно использовать, чтобы сказать Фунт стерлингов DCH at
в какой момент он должен начинаться в истории Git.

Дополнительные аргументы пути могут использоваться для ограничения путей репозитория Фунт стерлингов DCH внешность
в. Параметр путь в debian / - хороший выбор, если апстрим использует Git и все пакеты Debian.
изменения ограничиваются debian / subdir. В более сложных случаях (например,
backports), вы можете использовать --git-журнал чтобы дополнительно ограничить сгенерированные записи журнала изменений,
например, используя --git-log ="--author = Foo Бар".

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--версия
Версия для печати программы, т.е. версия пакета git-buildpackage

-v

--подробный
Подробное исполнение

-h

--Помогите Распечатать справку и выйти

--color =[авто | вкл | выкл]
Использовать ли цветной вывод.

--color-scheme =ЦВЕТОВАЯ СХЕМА
Цвета для использования при выводе (когда цвет включен). Формат COLOR_SCHEME:
' : : : '. Принимаются числовые значения и названия цветов,
пустые поля подразумевают цвет по умолчанию. Например, --git-color-scheme ='голубой: 34 ::'
будет отображать отладочные сообщения голубым, информационные сообщения синим цветом и другие сообщения в
по умолчанию (т.е. предупреждения и сообщения об ошибках отображаются красным цветом).

--debian-branch =Branch_name
Ветка в репозитории Git, в которой разрабатывается пакет Debian, по умолчанию
is мастер.

--upstream-branch =Branch_name
Ветвь для определения исходной версии. По умолчанию вверх по течению.

--git-upstream-tag =ТАГ-ФОРМАТ
используйте этот формат тегов при поиске тегов исходных версий, по умолчанию
upstream /% (версия) s.

--игнорировать-ветвь
Не проверять, совпадает ли текущая ветка ветка debian.

--debian-tag =формат тега
используется формат тега, при тегировании версий debian по умолчанию используется debian /% (версия) s

--since =совершать
Начните читать сообщения о фиксации на совершать.

--авто, -a
Угадайте последнюю фиксацию, задокументированную в журнале изменений, из баннера снимка (или из
последний тег, если баннера снимка не существует).

- [нет-] мета
Разбирайте метатеги вроде Закрывает:, Благодаря: и GBP-Dch:. См. МЕТА-ТЕГИ ниже.

--meta-closes =теги закрытия ошибок
Какие метатеги искать для создания записей журнала изменений, закрывающих ошибки. По умолчанию
'Closes | LP' для поддержки Debian и Launchpad.

--meta-closes-bugnum =формат номера ошибки
Какое регулярное выражение следует использовать для анализа номера ошибки. По умолчанию
'(?: ошибка | проблема)? \ #? \ s? \ d +'. Примечание: регулярное выражение должно подавлять все части ошибки
число, которое не нужно использовать с помощью "(? :)", подробности см. в руководстве по регулярным выражениям Python.

Пример: --meta-closes-bugnum ="(?: bug)? \ s * ex- \ d +" будет соответствовать всему следующему:

Возможное совпадение Txt? Результат
------------ ------ ------
ошибка EX-12345 Y EX-12345
экс-01273 Да экс-01273
ошибка ex-1ab Y ex-1
EX - 12345 N

- [нет-] полный
Включите полное сообщение о фиксации в вывод журнала изменений.

- снимок, -S
Создайте запись о выпуске снимка. Это добавляет номер выпуска снимка и предупреждение
баннер к записи журнала изменений. Номер версии выпуска увеличивается автоматически
с каждым новым выпуском моментального снимка, чтобы избежать отката пакетов во время снэпшота
тестирование.

--snapshot-number =выражение
Выражение Python, которое преобразует eval () в новый номер снимка.

--выпускать, -R
Удалите все баннеры выпуска снимков и суффиксы версий, установите текущий
распространение в неустойчивыйи откройте журнал изменений для окончательной настройки.

--new-version =версия, -N версия
Добавить новый раздел журнала изменений с версией новая версия, Вместе с - снимок,
номер снимка будет добавлен к новая версия.

--команда Создайте запись в журнале изменений для загрузки команды.

--bpo Увеличьте номер выпуска Debian для загрузки в резервные порты и добавьте резервный порт
загрузить комментарий журнала изменений.

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

--ка Увеличьте номер выпуска Debian для загрузки Debian QA Team и добавьте QA
загрузить комментарий журнала изменений.

--distribution =имя
Установите для поля распространения значение имя.

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

--urgency =уровень
Установите в поле срочность значение уровень.

--git-log =git-log-параметры
Варианты дословно переданы git-журнал(1).

--id-length =N
Включают N цифры идентификатора фиксации в записи журнала изменений. По умолчанию не включать
любые идентификаторы фиксации вообще.

--ignore-regex =регулярное выражение
Игнорировать соответствие строк фиксации регулярное выражение при создании журнала изменений.

--git-автор
Используйте user.name и user.email из git-конфигурация(1) для трейлера журнала изменений.

- [no-] multimaint-merge
Слияние коммитов, выполненных сопровождающим.

--spawn-editor =[всегда | снимок | выпуск]
Создавать ли редактор: всегда, при создании снимков или при выпуске.

--commit-msg =msg-формат
используйте эту строку формата для сообщения фиксации при фиксации сгенерированного
файл журнала изменений (когда --совершить дано). По умолчанию Обновление ПО изменений для
% (версия) s освободить

--совершить
Зафиксируйте созданный журнал изменений.

--customizations =файл настройки
Загрузить код Python из файл настройки. На данный момент единственная полезная вещь -
код может сделать, это определить пользовательскую функцию format_changelog_entry ().

СНАПШОТ РЕЖИМ

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

Когда используешь - снимок or -S, Фунт стерлингов DCH использует псевдозаголовок в журнале изменений Debian, чтобы
помните последний коммит git, для которого он добавил запись в журнал изменений. Он также устанавливает номер версии
кончающийся на ~ .Фунт стерлингов. Он автоматически увеличивает снимок
число при последующих вызовах Фунт стерлингов DCH -S так что более поздние снимки автоматически
более высокий номер версии. Чтобы выйти из режима моментального снимка, вызовите Фунт стерлингов DCH с --выпускать опцию.
Это удаляет псевдозаголовок и освобождает номер версии, поэтому выпущенная версия
имеет более высокий номер версии, чем у снимков.

ЦЕЛЬ Тэги

В дополнение к указанным выше параметрам форматирование сообщения фиксации в debian / журнал изменений
могут быть изменены специальными тегами (называемыми метатегами), указанными в сообщении коммита git. Мета
Обработку тегов можно активировать через --мета вариант. Теги должны начинаться с первого
столбец сообщения фиксации, но может отображаться в любой строке. Они имеют вид Название тэга:
ценностное . Допустимые мета-теги:

GBP-Dch: действие
Поддерживаемые действия: Игнорировать который проигнорирует эту фиксацию при генерации
debian / журнал изменений, Короткое который будет использовать только описание (первая строка)
сообщение фиксации при создании записи журнала изменений (полезно, когда --полный дано),
и В полностью который будет использовать полное сообщение фиксации при создании записи журнала изменений
(полезно, когда --полный не дано).

В дополнение к GBP-Dch, устаревшие Гит-Дч все еще поддерживается.

Благодаря: MSG
Добавьте сообщение с благодарностью после сообщения фиксации.

Закрывает: номер телефона
Укажите в debian / журнал изменений что ошибка была закрыта этим коммитом. Увидеть
--мета-закрывает о том, как распространить это на другие багтрекеры.

Следующее сообщение коммита git:

Мета-теги документа

поэтому не нужно обращаться к руководству

Gbp-Dch: короткий
Закрывает: # 636088
Благодарность: Рафаэль Герцог за предложение

Результаты в этом debian / журнал изменений запись:

* Метатеги документа.
Спасибо Raphaël Hertzog за предложение (закрытие: # 636088)

КОНФИГУРАЦИЯ FILES

Несколько gbp.conf файлы анализируются, чтобы установить значения по умолчанию для указанных выше аргументов командной строки.
Смотрите пост в gbp.conf(5)> подробности на странице руководства.

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