gbp-dch - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

gbp-dch - Generiere das Debian-Changelog aus Git-Commit-Nachrichten

ZUSAMMENFASSUNG

gbp dch [ --Version ] [ --help ] [ - ausführlich ] [ --farbe=[automatisch|ein|aus] ] [ --Farbe-
Schema=FARBSCHEMA ] [ --debian-branch=Zweigname ] [ --debian-tag=Tag-Format ] [
--upstream-branch=Zweigname ] [ --upstream-tag=Tag-Format ] [ --ignore-branch ] [
--Schnappschuss | --Veröffentlichung ] [ --Auto | --seit=begehen ] [ --neue-version=Version ] [ --bpo
| --nmu | --qa | --Mannschaft ] [ --verteilung=Name ] [ --Kraftverteilung ] [
--dringlichkeit=Grad des ] [ --[no-]voll ] [ --[no-]meta ] [ --meta-closes=bug-close-tags ] [
--meta-closes-bugnum=Fehlernummer-Format ] [ --snapshot-number=Ausdruck ] [ --Ich würde-
Länge=Anzahl ] [ --git-log=git-log-Optionen ] [ --[no-]git-Autor ] [ --[no-]multimaint ]
[ --[no-]multimaint-merge ] [ --spawn-editor=[immer|Schnappschuss|Freigabe] ] [ --verpflichten-
Nachricht=msg-Format ] [ --verpflichten ] [ --Anpassungen=Anpassungsdatei ] [Pfad1 Pfad2]

BESCHREIBUNG

gbp dch liest Git-Commit-Nachrichten und generiert daraus das Debian-Changelog. Wenn nein
Argumente werden gegeben, gbp dch beginnt mit der letzten markierten Debian-Paketversion bis zum
aktuelle Spitze des aktuellen Zweigs. Wenn die Verteilung des obersten Abschnitts in
Debian/Änderungsprotokoll is UNVERÖFFENTLICHT, werden die Changelog-Einträge in diesen Abschnitt eingefügt.
Andernfalls wird ein neuer Abschnitt erstellt.

If --Auto ist gegeben gbp dch, versucht den letzten im Changelog dokumentierten Git-Commit zu erraten
- dies funktioniert nur im Snapshot-Modus. Andernfalls, --schon seit kann verwendet werden, um zu erzählen gbp dch at
an welchem ​​Punkt es in der Git-Historie beginnen soll.

Die zusätzlichen Pfadargumente können verwendet werden, um die Repository-Pfade einzuschränken gbp dch Aussehen
bei. Einstellung Weg zu debian/ ist eine gute Wahl, wenn der Upstream Git und alle Debian-Pakete verwendet
Änderungen beschränken sich auf die debian/ Unterverz. In anspruchsvolleren Fällen (wie
Backports), können Sie verwenden --git-log um die generierten Changelog-Einträge weiter einzuschränken,
zB mit --git-log="--author=Foo Bar".

OPTIONAL

--Version
Druckversion des Programms, dh Version der git-buildpackage-Suite

-v

- ausführlich
Ausführliche Ausführung

-h

--help Hilfe ausdrucken und beenden

--farbe=[automatisch|ein|aus]
Ob farbige Ausgabe verwendet werden soll.

--color-schema=FARBSCHEMA
In der Ausgabe zu verwendende Farben (wenn Farbe aktiviert ist). Das Format für COLOR_SCHEME ist
' : : : '. Zahlenwerte und Farbnamen werden akzeptiert,
leere Felder implizieren die Standardfarbe. Zum Beispiel, --git-color-schema='cyan:34::'
würde Debug-Nachrichten in Cyan anzeigen, Info-Nachrichten in Blau und andere Nachrichten in
default (dh Warn- und Fehlermeldungen in Rot).

--debian-branch=Zweigname
Der Zweig im Git-Repository, auf dem das Debian-Paket entwickelt wird, Standard
is Master.

--upstream-branch=Zweigname
Verzweigen, um die Upstream-Version zu bestimmen. Standard ist flussaufwärts.

--git-upstream-tag=TAG-FORMAT
Verwenden Sie dieses Tag-Format, wenn Sie nach Tags von Upstream-Versionen suchen, Standard ist
Upstream/%(Version)s.

--ignore-branch
Überprüfen Sie nicht, ob der aktuelle Zweig übereinstimmt Debian-Zweig.

--debian-tag=Tag-Format
verwendetes Tag-Format, wenn Debian-Versionen mit Tags versehen werden, ist die Standardeinstellung debian/%(version)s

--seit=begehen
Beginnen Sie mit dem Lesen von Commit-Nachrichten bei begehen.

--Auto, -a
Erraten Sie den letzten im Changelog dokumentierten Commit aus dem Snapshot-Banner (oder aus
das letzte Tag, wenn kein Snapshot-Banner vorhanden ist).

--[no-]meta
Analysieren Sie Meta-Tags wie Schließt:, Vielen Dank: und Gbp-Dch:. Siehe META-TAGS unten.

--meta-closes=Bug-Close-Tags
Nach welchen Meta-Tags Sie suchen müssen, um Änderungsprotokolleinträge zu generieren, die Fehler schließen. Der Standard
ist 'Closes|LP' um Debian und Launchpad zu unterstützen.

--meta-closes-bugnum=Fehlernummer-Format
Welcher reguläre Ausdruck sollte verwendet werden, um die Fehlernummer zu analysieren. Die Standardeinstellung ist
'(?:Fehler|Problem)?\#?\s?\d+'. Hinweis: Die Regex sollte alle Teile des Fehlers unterdrücken
Nummern, die nicht mit "(?:)" gewünscht werden, finden Sie im Python Regex-Handbuch für Details.

Beispiel: --meta-closes-bugnum="(?:bug)?\s*ex-\d+" würde mit allen folgenden übereinstimmen:

Mögliches Txt-Match? Ergebnis
------ ------ ------
Fehler EX-12345 Y EX-12345
ex-01273 und ex-01273
Fehler ex-1ab Y ex-1
EX--12345 N

--[no-]voll
Fügen Sie die vollständige Commit-Nachricht in die Ausgabe des Änderungsprotokolls ein.

--Schnappschuss, -S
Erstellen Sie einen Snapshot-Release-Eintrag. Dies fügt eine Snapshot-Releasenummer und eine Warnung hinzu
Banner zum Changelog-Eintrag. Die Versionsnummer der Version wird automatisch erhöht
mit jeder neuen Snapshot-Version, um Paket-Downgrades während des Snapshots zu vermeiden
Testen.

--snapshot-number=Ausdruck
Python-Ausdruck, der mit eval() auf die neue Snapshot-Nummer umgestellt wird.

--Veröffentlichung, -R
Entfernen Sie alle Snapshot-Release-Banner und Versionssuffixe, legen Sie den aktuellen . fest
Verteilung an instabil, und öffnen Sie das Änderungsprotokoll für die letzten Anpassungen.

--neue-version=Version, -N Version
Fügen Sie einen neuen Änderungsprotokollabschnitt mit Version hinzu neue Version. Zusammen mit --Schnappschuss, der
Snapshot-Nummer wird angehängt neue Version.

--Mannschaft Erstellen Sie einen Änderungsprotokolleintrag für den Team-Upload.

--bpo Erhöhen Sie die Debian-Release-Nummer für einen Upload auf Backports und fügen Sie einen Backport hinzu
Changelog-Kommentar hochladen.

--nmu Erhöhen Sie die Debian-Release-Nummer für einen Upload ohne Administrator.

--qa Erhöhen Sie die Debian-Release-Nummer für einen Debian-QA-Team-Upload und fügen Sie eine QA hinzu
Changelog-Kommentar hochladen.

--verteilung=Name
Setzen Sie das Verteilungsfeld auf Name.

--Kraftverteilung
Erzwinge die mit . angegebene Verteilung --Verteilung verwendet werden, auch wenn nicht
mit der Liste der bekannten Verteilungen übereinstimmen.

--dringlichkeit=Grad des
Setzen Sie das Dringlichkeitsfeld auf Grad des .

--git-log=git-log-Optionen
Optionen wörtlich weitergegeben an Git-Log(1).

--id-länge=N
Include N Ziffern der Commit-ID im Changelog-Eintrag. Standard ist nicht enthalten
überhaupt keine Commit-IDs.

--ignore-regex=Regex
Übereinstimmende Commit-Zeilen ignorieren Regex beim Generieren des Changelogs.

--git-autor
Verwenden Sie user.name und user.email von git-config(1) für Changelog-Trailer.

--[no-]multimaint-merge
Commits vom Betreuer zusammenführen.

--spawn-editor=[immer|Schnappschuss|freigeben]
Ob man einen Editor hervorbringt: immer, wenn man Snapshots macht oder wenn man ein Release macht.

--commit-msg=msg-Format
Verwenden Sie diese Formatzeichenfolge für die Commit-Nachricht, wenn Sie das generierte festschreiben
changelog-Datei (wenn --verpflichten gegeben ist). Standard ist Aktualisierung Changelog für
%(Version)s Release

--verpflichten
Bestätigen Sie das generierte Änderungsprotokoll.

--Anpassungen=Anpassungsdatei
Python-Code laden von Anpassungsdatei. Im Moment ist das einzig sinnvolle die
Code kann eine benutzerdefinierte format_changelog_entry()-Funktion definieren.

SCHNAPPSCHUSS MODE

Der Snapshot-Modus kann für schnelle Test- und Installationszyklen verwendet werden, ohne sich darum kümmern zu müssen
Versionsnummern oder Changelog-Einträge.

Beim Benutzen --Schnappschuss or -S, gbp dch verwendet einen Pseudo-Header im Debian-Changelog, um
Erinnern Sie sich an den letzten Git-Commit, für den ein Changelog-Eintrag hinzugefügt wurde. Es legt auch eine Versionsnummer fest
endet in ~ .Britisches Pfund. Es erhöht automatisch den Snapshot
Nummer bei nachfolgenden Aufrufen von gbp dch -S damit spätere Schnappschüsse automatisch
eine höhere Versionsnummer. Um den Snapshot-Modus zu verlassen, rufen Sie . auf gbp dch an. Nach der Installation können Sie HEIC-Dateien mit der --Veröffentlichung .
Dies entfernt den Pseudo-Header und entwirrt die Versionsnummer, sodass die freigegebene Version
hat eine höhere Versionsnummer als die Snapshots.

META STICHWORTE

Zusätzlich zu den oben genannten Optionen ist die Formatierung der Commit-Nachricht in Debian/Änderungsprotokoll
kann durch spezielle Tags (so genannte Meta-Tags) geändert werden, die in der Git-Commit-Nachricht angegeben sind. Meta
Die Tag-Verarbeitung kann über das --Meta Möglichkeit. Die Tags müssen mit dem ersten beginnen
Spalte einer Commit-Nachricht, kann aber in jeder Zeile erscheinen. Sie sind von der Form Verlinke den Namen:
Wert. Gültige Meta-Tags sind:

Gbp-Dch: Aktion
Unterstützte Aktionen sind: Ignore was diesen Commit beim Generieren ignoriert
Debian/Änderungsprotokoll, Short die nur die Beschreibung (die erste Zeile) der
Commit-Meldung beim Generieren des Changelog-Eintrags (nützlich, wenn --voll gegeben ist),
und Vollständiger die die vollständige Commit-Nachricht verwendet, wenn der Changelog-Eintrag generiert wird
(nützlich, wenn --voll ist nicht gegeben).

Zusätzlich zu den Modi Gbp-Dch, die veraltete Git-Dch wird noch unterstützt.

Vielen Dank: msg
Fügen Sie nach der Commit-Nachricht eine Dankesnachricht hinzu.

Schließt: Fehlernummer
Geben Sie im Debian/Änderungsprotokoll dass der Fehler durch diesen Commit geschlossen wurde. Siehe die
--meta-schließt wie Sie dies für andere Bugtracker erweitern können.

Die folgende Git-Commit-Nachricht:

Dokument-Meta-Tags

man muss also nicht im handbuch nachlesen

Gbp-Dch: Kurz
Schließt: #636088
Danke: Raphaël Hertzog für den Vorschlag

Ergebnisse in diesem Debian/Änderungsprotokoll Eintrag:

* Dokumentieren Sie Meta-Tags.
Danke an Raphaël Hertzog für den Vorschlag (Schließt: #636088)

CONFIGURATION DATEIEN

. gbp.conf Dateien werden geparst, um Standardwerte für die obigen Befehlszeilenargumente festzulegen.
Siehe die gbp.conf(5)> Hilfeseite für Details.

Verwenden Sie gbp-dch online mit den onworks.net-Diensten