gbp-dch - Online în cloud

PROGRAM:

NUME

gbp-dch - Generați jurnalul de modificări Debian din mesajele git commit

REZUMAT

lira sterlină dch [ --versiune ] [ --Ajutor ] [ --verbos ] [ --culoare=[auto|pornit|oprit] ] [ --culoare-
schema=SCHEMA DE CULORI ] [ --debian-branch=nume_ramă ] [ --debian-tag=etichetă-format ] [
--ramură-amonte=nume_ramă ] [ --upstream-tag=etichetă-format ] [ --ignora-ramură ] [
--instantaneu | --eliberare ] [ --auto | --din moment ce=comite ] [ --new-version=versiune ] [ --bpo
| --nmu | --qa | --echipă ] [ --distributie=nume ] [ --distributie-forta ] [
--urgency=nivel ] [ --[nu-]plin ] [ --[no-]meta ] [ --meta-closes=bug-close-tags ] [
--meta-closes-bugnum=format-număr-bug ] [ --snapshot-number=expresie ] [ --id-
lungime=număr ] [ --git-log=git-log-options ] [ --[no-]git-author ] [ --[no-]multimaint ]
[ --[no-]multimaint-merge ] [ --spawn-editor=[intotdeauna|instantaneu|lansare] ] [ --comita-
msg =format msg ] [ --comite ] [ --personalizări=fisier-personalizare ] [calea 1 calea 2]

DESCRIERE

lira sterlină dch citește mesajele git commit și generează jurnalul de modificări Debian din acesta. Daca nu
se dau argumente, lira sterlină dch începe de la ultima versiune a pachetului Debian etichetat până la
vârful curent al ramurii curente. Dacă distribuția secțiunii de sus în
debian/changelog is ELIBERAT, intrările din jurnalul de modificări vor fi inserate în această secțiune.
În caz contrar, va fi creată o nouă secțiune.

If --auto este dată lira sterlină dch, încearcă să ghicească ultima comitere Git documentată în jurnalul de modificări
- aceasta funcționează numai în modul instantaneu. In caz contrar, --de cand poate fi folosit pentru a spune lira sterlină dch at
care punct ar trebui să înceapă în istoria Git.

Argumentele de cale suplimentare pot fi folosite pentru a restricționa căile de depozit lira sterlină dch arată
la. Setare cale la debian/ este o alegere bună dacă în amonte utilizează Git și toate pachetele Debian
modificările sunt limitate la debian/ subdir. În cazuri mai sofisticate (cum ar fi
backports), puteți utiliza --git-log pentru a restricționa în continuare intrările din jurnalul de modificări generate,
de exemplu prin utilizarea --git-log="--author=Foo Bar".

OPŢIUNI

--versiune
Versiunea tipărită a programului, adică versiunea suitei git-buildpackage

-v

--verbos
Execuție verbală

-h

--Ajutor Imprimați ajutorul și ieșiți

--culoare=[auto|pornit|oprit]
Dacă să utilizați o ieșire colorată.

--color-scheme=SCHEMA DE CULORI
Culori de utilizat în ieșire (când culoarea este activată). Formatul pentru COLOR_SCHEME este
' : : : '. Sunt acceptate valorile numerice și numele culorilor,
câmpurile goale implică culoarea implicită. De exemplu, --git-color-scheme=„cian:34::”
ar afișa mesajele de depanare în cyan, mesajele informative în albastru și alte mesaje în
implicit (adică mesajele de avertizare și eroare în roșu).

--debian-branch=nume_ramă
Ramura din depozitul Git în care este dezvoltat pachetul Debian, implicit
is maestru.

--ramură-amonte=nume_ramă
Branch pentru a determina versiunea din amonte. Implicit este amonte.

--git-upstream-tag=TAG-FORMAT
utilizați acest format de etichetă atunci când căutați etichete ale versiunilor din amonte, implicit este
în amonte/%(versiunea)s.

--ignora-ramură
Nu verificați dacă ramura curentă se potrivește debian-ramură.

--debian-tag=etichetă-format
formatul de etichetă utilizat, când etichetați versiunile debian, implicit este debian/%(version)s

--din moment ce=comite
Începeți să citiți mesajele de confirmare la comite.

--auto, -a
Ghiciți ultima comitere documentată în jurnalul de modificări din bannerul instantaneu (sau din
ultima etichetă dacă nu există niciun banner instantaneu).

--[no-]meta
Analizați metaetichetele cum ar fi Închideri:, Mulțumiri: și Gbp-Dch:. Vezi METATAG-urile de mai jos.

--meta-închide=bug-close-tag-uri
Ce metaetichete să căutați pentru a genera intrări în jurnalul de modificări care închid erori. Implicit
este „Închide|LP” pentru a suporta Debian și Launchpad.

--meta-closes-bugnum=bug-număr-format
Ce expresie regulată ar trebui folosită pentru a analiza numărul erorii. Valoarea implicită este
„(?:bug|problemă)?\#?\s?\d+”. Notă: expresia regex ar trebui să suprime toate porțiunile erorii
numere care nu sunt dorite folosind „(?:)”, consultați manualul regex Python pentru detalii.

Exemplu: --meta-closes-bugnum=„(?:bug)?\s*ex-\d+” s-ar potrivi cu toate următoarele:

Posibilă potrivire Txt? Rezultat
------------ ------ ------
bug EX-12345 Y EX-12345
ex-01273 Y ex-01273
bug ex-1ab și ex-1
EX--12345 N

--[nu-]plin
Includeți mesajul de confirmare complet în ieșirea jurnalului de modificări.

--instantaneu, -S
Creați o intrare de lansare instantanee. Aceasta adaugă un număr de lansare instantaneu și un avertisment
banner la intrarea din jurnalul de modificări. Numărul versiunii de lansare este incrementat automat
cu fiecare lansare nouă de instantanee pentru a evita retrogradarea pachetelor în timpul instantaneului
de testare.

--snapshot-number=expresie
Expresie Python care devine eval()ed la noul număr de instantaneu.

--eliberare, -R
Eliminați toate bannerele de lansare instantanee și sufixele versiunii, setați cea curentă
distributie catre instabilși deschideți jurnalul de modificări pentru modificarea finală.

--new-version=versiune, -N versiune
Adăugați o nouă secțiune de jurnal de modificări cu versiunea versiune noua. Impreuna cu --instantaneu,
numărul instantaneului va fi adăugat la versiune noua.

--echipă Creați o intrare în jurnalul de modificări pentru încărcarea echipei.

--bpo Creșteți numărul de lansare Debian pentru o încărcare în backport-uri și adăugați un backport
încărcați un comentariu de jurnal de modificări.

--nmu Creșteți numărul de lansare Debian pentru o încărcare non-maintainer.

--qa Creșteți numărul de lansare Debian pentru o încărcare a echipei Debian QA și adăugați un QA
încărcați un comentariu de jurnal de modificări.

--distributie=nume
Setați câmpul de distribuție la nume.

--distributie-forta
Forțați distribuția specificată cu --distributie pentru a fi folosit, chiar dacă nu este
se potrivesc cu lista de distribuții cunoscute.

--urgency=nivel
Setați câmpul de urgență la nivel.

--git-log=git-log-options
Opțiunile transmise literal către git-log(1).

--id-length=N
Include N cifre ale ID-ului de comitere din intrarea din jurnalul de modificări. Implicit este de a nu include
orice ID-uri de comitere.

--ignore-regex=regex
Ignorați potrivirea liniilor de comitere regex la generarea jurnalului de modificări.

--git-author
Utilizați user.name și user.email from git-config(1) pentru remorca de jurnal de modificări.

--[no-]multimaint-merge
Merge comite de către întreținător.

--spawn-editor=[intotdeauna|instantaneu|lansare]
Indiferent dacă se generează un editor: întotdeauna, când faceți instantanee sau când faceți o lansare.

--commit-msg=format msg
utilizați acest șir de format pentru mesajul de comitere când comiteți mesajul generat
fișier jurnal de modificări (când --comite este dată). Implicit este Actualizează changelog pentru
%(version)s eliberaţi

--comite
Commiteți jurnalul de modificări generat.

--personalizări=fisier-personalizare
Încărcați codul Python de la fisier-personalizare. Momentan, singurul lucru util este
codul pe care îl poate face este să definească o funcție personalizată format_changelog_entry().

INSTANTANEU MODE

Modul Snapshot poate fi folosit pentru teste rapide și cicluri de instalare fără a fi nevoie să vă faceți griji
numerele de versiune sau intrările din jurnalul de modificări.

Atunci când se utilizează --instantaneu or -S, lira sterlină dch folosește un pseudo antet în jurnalul de modificări Debian pentru
amintiți-vă că ultimul git commit pentru care a adăugat o intrare de jurnal de modificări. De asemenea, stabilește un număr de versiune
se termina in ~ .GBP. Incrementează automat instantaneul
număr la invocările ulterioare ale lira sterlină dch -S astfel încât instantaneele ulterioare să aibă automat
un număr de versiune mai mare. Pentru a părăsi modul instantaneu, invocați lira sterlină dch cu --eliberare opțiune.
Acest lucru elimină pseudo-antetul și desface numărul versiunii, astfel încât versiunea lansată
are un număr de versiune mai mare decât instantaneele.

META ETICHETE

În plus față de opțiunile de mai sus, formatarea mesajului de confirmare în debian/changelog
poate fi modificat prin etichete speciale (numite Meta Tags) date în mesajul git commit. Meta
Procesarea etichetelor poate fi activată prin intermediul --meta opțiune. Etichetele trebuie să înceapă de la prima
coloana unui mesaj de confirmare, dar poate apărea pe orice linie. Sunt de forma Nume eticheta:
valoare. Meta-etichetele valide sunt:

Gbp-Dch: acțiune
Acțiunile susținute sunt: Ignora care va ignora acest commit la generare
debian/changelog, Pantaloni scurți care va folosi doar descrierea (prima linie) a
mesaj commit la generarea intrării în jurnalul de modificări (util când --deplin este dată),
și Complet care va folosi mesajul complet de confirmare la generarea intrării din jurnalul de modificări
(util când --deplin nu este dat).

În plus față de Gbp-Dch, depreciat Git-Dch este încă susținută.

Mulțumiri: msg
Adăugați un mesaj de mulțumire după mesajul de confirmare.

Închideri: număr de eroare
Indicați în debian/changelog că bug-ul a fost închis de acest commit. Vezi
--meta-închide despre cum să extindeți acest lucru pentru alte aplicații de urmărire a erorilor.

Următorul mesaj git commit:

Meta-etichete pentru documente

deci nu trebuie să consulți manualul

Gbp-Dch: scurt
Închide: #636088
Mulțumesc: Raphaël Hertzog pentru sugestie

Rezultate în asta debian/changelog intrare:

* Meta-etichete pentru documente.
Mulțumim lui Raphaël Hertzog pentru sugestie (Închide: #636088)

CONFIGURARE DOSARE

Câteva gbp.conf fișierele sunt analizate pentru a seta valorile implicite pentru argumentele liniei de comandă de mai sus.
A se vedea gbp.conf(5)> pagina de manual pentru detalii.

Utilizați gbp-dch online folosind serviciile onworks.net