gbp-dch - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

gbp-dch - Створення журналу змін Debian з повідомлень про фіксацію git

СИНТАКСИС

gbp дч [ -- версія ] [ --допомога ] [ -багатослівний ] [ --колір=[авто|увімкнено|вимкнено] ] [ --колір-
схема=КОЛЬОРОВА СХЕМА ] [ --debian-branch=назва гілки ] [ --debian-tag=тег-формат ] [
--upstream-branch=назва гілки ] [ --upstream-tag=тег-формат ] [ --ignore-гілка ] [
--знімок | --звільнення ] [ --авто | -- оскільки=commitish ] [ --нова-версія=версія ] [ --bpo
| --nmu | --qa | -- команда ] [ --розподіл=ім'я ] [ --розподіл сили ] [
--терміновість=рівень ] [ --[ні-]повний ] [ --[no-]мета ] [ --meta-closes=bug-close-tags ] [
--meta-closes-bugnum=format-числа помилки ] [ --номер знімка=вираз ] [ --id-
довжина=номер ] [ --git-log=git-log-options ] [ --[no-]git-author ] [ --[ні-]багатозначне ]
[ --[no-]multiimaint-merge ] [ --spawn-editor=[завжди|знімок|випуск] ] [ --здійснити-
повідомлення=msg-формат ] [ --здійснити ] [ --налаштування=файл налаштування ] [шлях 1 шлях2]

ОПИС

gbp дч читає повідомлення git commit і створює з нього журнал змін Debian. Якщо ні
наводяться аргументи, gbp дч починається з останньої позначеної версії пакета Debian до
поточна вершина поточної гілки. Якщо розподіл найвищої секції в
debian/changelog is НЕВИПУЩЕНИЙ, записи журналу змін будуть вставлені в цей розділ.
В іншому випадку буде створено новий розділ.

If --авто дається gbp дч, намагається вгадати останній коміт Git, задокументований у журналі змін
- це працює лише в режимі знімків. інакше --з тих пір можна використовувати, щоб розповісти gbp дч at
з якого пункту в історії Git має початися.

Додаткові аргументи шляху можна використовувати для обмеження шляхів до сховища gbp дч виглядає
на Налаштування шлях до debian/ є хорошим вибором, якщо upstream використовує Git і всю упаковку Debian
зміни обмежуються debian/ піддир. У більш складних випадках (наприклад
backports), ви можете використовувати --git-log щоб додатково обмежити згенеровані записи журналу змін,
наприклад, використовуючи --git-log="--author=Foo бар".

ВАРІАНТИ

-- версія
Друкована версія програми, тобто версія набору git-buildpackage

-v

-багатослівний
Дослівне виконання

-h

--допомога Роздрукувати довідку та вийти

--колір=[авто|увімкнено|вимкнено]
Чи використовувати кольоровий вихід.

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

--debian-branch=назва гілки
Гілка в репозиторії Git, на якій розробляється пакет Debian, за замовчуванням
is майстер.

--upstream-branch=назва гілки
Відгалуження для визначення вихідної версії. За замовчуванням є вгору за течією.

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

--ignore-гілка
Не перевіряйте, чи відповідає поточна гілка debian-гілка.

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

-- оскільки=committish
Почніть читати повідомлення про фіксацію за адресою committish.

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

--[no-]мета
Проаналізуйте мета-теги, як Закривається:, Дякую: та GBP-Dch:. Дивіться МЕТАТЕГИ нижче.

--meta-close=bug-close-tags
Які мета-теги шукати для створення записів журналу змін, що закривають помилки. За замовчуванням
є 'Closes|LP' для підтримки Debian та Launchpad.

--meta-close-bugnum=помилка-число-формат
Який регулярний вираз слід використовувати для розбору номера помилки. За замовчуванням є
'(?:bug|issue)?\#?\s?\d+'. Примітка: регулярний вираз має придушити всі частини помилки
числа, які не потрібні за допомогою "(?:)", дивіться інструкцію з регулярних виразів Python, щоб дізнатися більше.

приклад: --meta-close-bugnum="(?:bug)?\s*ex-\d+" відповідатиме всім наступним:

Можливий збіг Txt? Результат
------------ ------ ------
помилка EX-12345 Y EX-12345
ex-01273 Y ex-01273
помилка ex-1ab Y ex-1
EX--12345 N

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

-- знімок, -S
Створіть запис випуску моментального знімка. Це додає номер випуску знімка та попередження
банер до запису в журналі змін. Номер версії випуску автоматично збільшується
з кожним новим випуском знімків, щоб уникнути зниження версії пакетів під час знімка
тестування.

--номер знімка=вираз
Вираз Python, який отримує eval() до нового номера знімка.

--звільнення, -R
Видаліть усі банери випуску знімків і суфікси версій, установіть поточну
розподіл до нестійкий, і відкрийте журнал змін для остаточного налаштування.

--нова-версія=версія, -N версія
Додайте новий розділ журналу змін із версією Нова версія. Разом з --знімок,
номер знімка буде додано до Нова версія.

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

--bpo Збільште номер випуску Debian для завантаження в backports і додайте backport
завантажити коментар журналу змін.

--nmu Збільште номер випуску Debian для завантаження без підтримки.

--qa Збільште номер випуску Debian для завантаження команди QA Debian та додайте QA
завантажити коментар журналу змін.

--розподіл=ім'я
Встановіть для поля розподілу значення ім'я.

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

--терміновість=рівень
Встановіть для поля терміновості значення рівень.

--git-log=git-log-options
Варіанти передані дослівно git-log(1).

--id-length=N
Include N цифри ідентифікатора фіксації в записі журналу змін. За замовчуванням не включати
будь-які ідентифікатори комітів взагалі.

--ignore-regex=regex
Ігнорувати збіг рядків фіксації regex під час створення журналу змін.

--git-автор
Використовуйте user.name та user.email from git-config(1) для трейлера журналу змін.

--[no-]multiimaint-merge
Об’єднання комітів супроводжувачем.

--spawn-editor=[завжди|знімок|випуск]
Чи створювати редактор: завжди, під час створення знімків чи випуску.

--commit-msg=msg-формат
використовуйте цей форматний рядок для повідомлення про фіксацію під час фіксації згенерованого
файл журналу змін (коли --здійснити надається). За замовчуванням є Оновити змін та цінності
%(версія)s звільнити

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

--налаштування=файл налаштування
Завантажте код Python з файл налаштування. На даний момент єдина корисна річ
код, який може зробити, це визначити користувацьку функцію format_changelog_entry().

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

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

При використанні --знімок or -S, gbp дч використовує псевдозаголовок у журналі змін Debian до
пам’ятайте, що останній комміт git додав запис у журналі змін. Він також встановлює номер версії
що закінчується ~ .gbp. Він автоматично збільшує знімок
номер при наступних викликах gbp дч -S так що пізніші знімки автоматично мають
вищий номер версії. Щоб вийти з режиму знімка, викличте gbp дч з --звільнення варіант.
Це видаляє псевдозаголовок і розкриває номер версії так, щоб випущена версія
має вищий номер версії, ніж знімки.

META На тему

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

GBP-Dch: дію
Підтримувані дії: Ігнорувати який ігноруватиме цю фіксацію під час генерації
debian/changelog, Короткий який використовуватиме лише опис (перший рядок).
повідомлення про фіксацію під час створення запису в журналі змін (корисно, коли --повний дається),
та Повний який використовуватиме повне повідомлення про фіксацію під час створення запису в журналі змін
(корисно, коли --повний не дається).

На додаток до GBP-Dch, застарілий Git-Dch як і раніше підтримується.

Дякую: MSG
Додайте повідомлення подяки після повідомлення про фіксацію.

Закривається: номер помилки
Вкажіть у debian/changelog що помилка була закрита цим комітом. Див
--мета-закриває про те, як розширити це для інших багтрекерів.

Наступне повідомлення git commit:

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

тому не потрібно звертатися до посібника

Gbp-Dch: короткий
Закриття: #636088
Дякую: Рафаель Герцог за пропозицію

Результати в цьому debian/changelog запис:

* Мета-теги документа.
Дякую Рафаелю Герцогу за пропозицію (Закриття: #636088)

КОНФІГУРАЦІЯ ФАЙЛИ

Кілька gbp.conf файли аналізуються для встановлення значень за замовчуванням для наведених вище аргументів командного рядка.
Див gbp.conf(5)> man-сторінка для деталей.

Використовуйте gbp-dch онлайн за допомогою служб onworks.net