gbp-dch - Online in de cloud

PROGRAMMA:

NAAM

gbp-dch - Genereer de Debian changelog uit git commit-berichten

KORTE INHOUD

gbp dch [ --versie ] [ --help ] [ --uitgebreid ] [ --kleur=[auto|aan|uit] ] [ --kleur-
schema=KLEURENSCHEMA ] [ --debian-branch=branch_naam ] [ --debian-tag=tag-formaat ] [
--upstream-tak=branch_naam ] [ --upstream-tag=tag-formaat ] [ --ignore-tak ] [
--momentopname | --uitgave ] [ --auto | --sinds=plegen ] [ --nieuwe-versie=versie ] [ --bpo
| --nmu | --qa | --team ] [ --distributie=naam ] [ --kracht-verdeling ] [
--urgentie=niveau ] [ --[geen-]vol ] [ --[geen-]meta ] [ --meta-closes=bug-close-tags ] [
--meta-closes-bugnum=bug-nummerformaat ] [ --snapshot-nummer=uitdrukking ] [ --ID kaart-
lengte=aantal ] [ --git-log=git-log-opties ] [ --[no-]git-auteur ] [ --[geen-]multionderhoud ]
[ --[no-]multimaint-samenvoeging ] [ --spawn-editor=[altijd|momentopname|vrijgave] ] [ --verbinden-
bericht=msg-formaat ] [ --verbinden ] [ --aanpassingen=maatwerk-bestand ] [pad1 pad2]

PRODUCTBESCHRIJVING

gbp dch leest git commit-berichten en genereert daaruit de Debian changelog. Als Nee
argumenten worden gegeven, gbp dch begint vanaf de laatst getagde versie van het Debian-pakket tot en met de
huidige punt van de huidige tak. Als de verdeling van de bovenste sectie in
debian/changelog is UITGEBRACHT, worden de changelog-items in deze sectie ingevoegd.
Anders wordt er een nieuwe sectie gemaakt.

If --auto is gegeven gbp dch, probeert de laatste Git-commit te raden die in de changelog is gedocumenteerd
- dit werkt alleen in de snapshot-modus. Anders, --sinds kan worden gebruikt om te vertellen gbp dch at
op welk punt het zou moeten beginnen in de Git-geschiedenis.

De extra padargumenten kunnen worden gebruikt om de repositorypaden te beperken gbp dch er gezonder uitzien
bij. Instelling pad naar debian/ is een goede keuze als upstream Git en alle Debian-pakketten gebruikt
wijzigingen zijn beperkt tot de debian/ submap In meer geavanceerde gevallen (zoals
backports), die u kunt gebruiken --git-log om de gegenereerde changelog-items verder te beperken,
bijvoorbeeld door te gebruiken --git-log="--auteur=Foe Bar".

OPTIES

--versie
Afdrukversie van het programma, dwz de versie van de git-buildpackage suite

-v

--uitgebreid
Uitgebreide uitvoering

-h

--help Help afdrukken en afsluiten

--kleur=[auto|aan|uit]
Of u gekleurde uitvoer wilt gebruiken.

--kleurenschema=KLEURENSCHEMA
Kleuren voor gebruik in uitvoer (wanneer kleur is ingeschakeld). Het formaat voor COLOR_SCHEME is
' : : : '. Numerieke waarden en kleurnamen worden geaccepteerd,
lege velden geven de standaardkleur aan. Bijvoorbeeld, --git-kleurenschema='cyaan:34::'
zou foutopsporingsberichten in cyaan tonen, infoberichten in blauw en andere berichten in
standaard (dwz waarschuwings- en foutmeldingen in rood).

--debian-branch=branch_naam
Standaard de branch in de Git-repository waarop het Debian-pakket wordt ontwikkeld
is meester.

--upstream-tak=branch_naam
Vertakking om de upstream-versie van te bepalen. Standaard is stroomopwaarts.

--git-upstream-tag=TAG-FORMAAT
gebruik dit tagformaat bij het zoeken naar tags van upstream-versies; de standaardwaarde is
stroomopwaarts/%(versie)s.

--ignore-tak
Controleer niet of de huidige tak overeenkomt debian-branch.

--debian-tag=tag-formaat
tag-formaat gebruikt, bij het taggen van debian-versies is de standaardwaarde debian/%(versie)s

--sinds=toegewijd
Begin met het lezen van commit-berichten op toegewijd.

--auto, -a
Raad de laatste commit gedocumenteerd in de changelog vanaf de snapshotbanner (of vanaf
de laatste tag als er geen snapshotbanner bestaat).

--[geen-]meta
Parseer metatags zoals sluit:, Bedankt: en Gbp-Dch:. Zie METATAGS hieronder.

--meta-sluit=bug-close-tags
Op welke metatags moet worden gelet om bug-afsluitende changelog-items te genereren. De standaard
is 'Closes|LP' ter ondersteuning van Debian en Launchpad.

--meta-closes-bugnum=bug-nummer-formaat
Welke reguliere expressie moet worden gebruikt om het bugnummer te ontleden. De standaardwaarde is
'(?:bug|probleem)?\#?\s?\d+'. Opmerking: de regex zou alle delen van de bug moeten onderdrukken
nummer dat niet gewenst is met "(?:)", zie de Python regex-handleiding voor details.

Voorbeeld: --meta-closes-bugnum="(?:bug)?\s*ex-\d+" komt overeen met al het volgende:

Mogelijke Txt-match? Resultaat
------------ ------ ------
bug EX-12345 en EX-12345
ex-01273 en ex-01273
bug ex-1ab Y ex-1
EX--12345 N

--[geen-]vol
Neem het volledige commit-bericht op in de changelog-uitvoer.

--momentopname, -S
Maak een momentopname-release-item. Dit voegt een snapshot-releasenummer en een waarschuwing toe
banner naar het changelog-item. Het releaseversienummer wordt automatisch verhoogd
bij elke nieuwe snapshot-release om downgrades van pakketten tijdens snapshot te voorkomen
testen.

--snapshot-nummer=uitdrukking
Python-expressie die wordt geëvalueerd() naar het nieuwe momentopnamenummer.

--uitgave, -R
Verwijder eventuele banners voor de release van snapshots en versieachtervoegsels, stel de current
distributie naar onstabieleen open de changelog voor de laatste aanpassingen.

--nieuwe-versie=versie, -N versie
Voeg een nieuwe changelog-sectie toe met versie nieuwe versie. Samen met --momentopname
momentopnamenummer wordt toegevoegd nieuwe versie.

--team Maak een wijzigingslogboek voor teamuploads.

--bpo Verhoog het releasenummer van Debian voor een upload naar backports en voeg een backport toe
commentaar in de changelog uploaden.

--nmu Verhoog het releasenummer van Debian voor een upload zonder onderhoud.

--qa Verhoog het releasenummer van Debian voor een upload van het Debian QA-team en voeg een QA toe
commentaar in de changelog uploaden.

--distributie=naam
Stel het distributieveld in op naam.

--kracht-verdeling
Forceer de verdeling die is opgegeven met --verdeling te gebruiken, zelfs als dat niet het geval is
overeenkomen met de lijst met bekende distributies.

--urgentie=niveau
Stel het urgentieveld in op niveau.

--git-log=git-log-opties
Opties letterlijk doorgegeven aan git-log(1).

--id-lengte=N
omvatten N cijfers van de commit-ID in de changelog-invoer. Standaard is het niet opnemen
eventuele commit-ID's.

--negeer-regex=regex
Negeer overeenkomende commitregels regex bij het genereren van de changelog.

--git-auteur
Gebruik user.name en user.email van git-config(1) voor changelog-trailer.

--[no-]multimaint-samenvoeging
Voeg commits per onderhouder samen.

--spawn-editor=[altijd|momentopname|vrijgeven]
Of je nu een editor moet spawnen: altijd, bij het maken van snapshots of bij het doen van een release.

--commit-bericht=msg-formaat
gebruik deze formatstring voor het commit-bericht bij het committen van het gegenereerde
changelog-bestand (wanneer --verbinden is gegeven). Standaard is bijwerken changelog voor
%(versie)s los

--verbinden
Leg de gegenereerde changelog vast.

--aanpassingen=maatwerk-bestand
Laad Python-code van maatwerk-bestand. Op dit moment is het enige nuttige ding de
code kan doen is een aangepaste format_changelog_entry() functie definiëren.

MOMENTOPNAME MODE

De Snapshot-modus kan worden gebruikt voor snelle test- en installatiecycli zonder dat u zich daar zorgen over hoeft te maken
versienummers of changelog-vermeldingen.

Tijdens gebruik --momentopname or -S, gbp dch gebruikt een pseudo-header in de Debian changelog om
onthoud de laatste git commit waarvoor het een changelog-item heeft toegevoegd. Er wordt ook een versienummer ingesteld
eindigend in ~ .GBP. Het verhoogt automatisch de momentopname
nummer bij volgende aanroepen van gbp dch -S zodat latere snapshots dat automatisch hebben
een hoger versienummer. Om de momentopnamemodus te verlaten, roept u aan gbp dch met de --uitgave optie.
Dit verwijdert de pseudo-header en ontwart het versienummer, zodat de vrijgegeven versie ontstaat
heeft een hoger versienummer dan de snapshots.

META TAGS

Als aanvulling op de bovenstaande opties kan de opmaak van het commit-bericht in debian/changelog
kan worden gewijzigd door speciale tags (genaamd Meta Tags) die in het git commit bericht worden gegeven. Meta
Tagverwerking kan worden geactiveerd via de --meta keuze. De tags moeten bij de eerste beginnen
kolom van een commit-bericht, maar kan op elke regel verschijnen. Ze zijn van de vorm Tagnaam:
waarde. Geldige metatags zijn:

Gbp-Dch: actie
Ondersteunde acties zijn: negeren die deze commit negeert bij het genereren
debian/changelog, Bermuda's die alleen de beschrijving (de eerste regel) van de
commit-bericht bij het genereren van de changelog-invoer (handig wanneer --vol is gegeven),
en Vol die het volledige commit-bericht zal gebruiken bij het genereren van de changelog-invoer
(handig wanneer --vol wordt niet gegeven).

Naast Gbp-Dch, de verouderde Git-Dch wordt nog steeds ondersteund.

Bedankt: msg
Voeg een bedankbericht toe na het commit-bericht.

sluit: bugnummer
Geef aan in de debian/changelog dat de bug door deze commit is gesloten. Zie de
--meta-sluit over hoe u dit kunt uitbreiden voor andere bugtrackers.

Het volgende git commit-bericht:

Metatags voor documenten

je hoeft dus de handleiding niet te raadplegen

Gbp-Dch: Kort
Sluit: #636088
Bedankt: Raphaël Hertzog voor de suggestie

Resultaten hierin debian/changelog entry:

* Documentmetatags.
Met dank aan Raphaël Hertzog voor de suggestie (sluit: #636088)

CONFIGURATIE FILES

Verscheidene GBP.conf bestanden worden geparseerd om standaardwaarden in te stellen voor de bovenstaande opdrachtregelargumenten.
Zie de GBP.conf(5)> manpagina voor details.

Gebruik gbp-dch online met behulp van onworks.net-services