gbp-dch - En ligne dans le Cloud

PROGRAMME:

Nom

gbp-dch - Génère le journal des modifications Debian à partir des messages de commit git

SYNOPSIS

gbp dch [ --version ] [ --Aidez-moi ] [ --verbeux ] [ --couleur=[auto|activé|désactivé] ] [ --Couleur-
schéma=SCHÉMA DE COULEUR ] [ --debian-branche=Nom de la filiale ] [ --debian-tag=format de balise ] [
--amont-branche=Nom de la filiale ] [ --upstream-tag=format de balise ] [ --ignore-branche ] [
--instantané | --Libération ] [ --auto | --depuis=commettre ] [ --nouvelle-version=version ] [ --bpo
| --nmu | --qa | --équipe ] [ --distribution=prénom ] [ --force-distribution ] [
--urgent=niveau ] [ --[non-]plein ] [ --[non-]méta ] [ --meta-closes=bug-close-tags ] [
--meta-closes-bugnum=format-numéro de bogue ] [ --numéro-instantané=expression ] [ --identifiant-
longueur=nombre ] [ --git-log=options-git-log ] [ --[no-]git-auteur ] [ --[no-]multimaint ]
[ --[no-]multimaint-fusion ] [ --spawn-editor=[toujours|instantané|libérer] ] [ --s'engager-
msg =format-msg ] [ --s'engager ] [ --personnalisations=fichier-de-personnalisation ] [chemin1 chemin2]

DESCRIPTION

gbp dch lit les messages de commit git et génère le changelog Debian à partir de celui-ci. Sinon
des arguments sont donnés, gbp dch commence à partir de la dernière version du paquet Debian balisée jusqu'à la
pointe actuelle de la branche actuelle. Si la distribution de la section la plus haute dans
debian/journal des modifications is NON LIBÉRÉ, les entrées du journal des modifications seront insérées dans cette section.
Sinon, une nouvelle section sera créée.

If --auto est donné gbp dch, essaie de deviner le dernier commit Git documenté dans le changelog
- cela ne fonctionne qu'en mode instantané. Autrement, --puisque peut être utilisé pour dire gbp dch at
à quel point il doit commencer dans l'historique Git.

Les arguments de chemin supplémentaires peuvent être utilisés pour restreindre les chemins du référentiel gbp dch regards
à. Réglage chemin à debian/ est un bon choix si l'amont utilise Git et tous les emballages Debian
les changements sont limités au debian/ sous-répertoire Dans des cas plus sophistiqués (comme
rétroportages), vous pouvez utiliser --git-log pour restreindre davantage les entrées du journal des modifications générées,
par exemple en utilisant --git-log="--author=Fou Bar".

OPTIONS

--version
Version imprimable du programme, c'est-à-dire la version de la suite git-buildpackage

-v

--verbeux
Exécution verbeuse

-h

--Aidez-moi Imprimer l'aide et quitter

--couleur=[auto|activé|désactivé]
S'il faut utiliser la sortie couleur.

--schéma-couleur=SCHÉMA DE COULEUR
Couleurs à utiliser en sortie (lorsque la couleur est activée). Le format de COLOR_SCHEME est
' : : : '. Les valeurs numériques et les noms de couleurs sont acceptés,
les champs vides impliquent la couleur par défaut. Par exemple, --git-color-scheme='cyan:34::'
afficherait les messages de débogage en cyan, les messages d'information en bleu et d'autres messages en
par défaut (c'est-à-dire les messages d'avertissement et d'erreur en rouge).

--debian-branche=Nom de la filiale
La branche du référentiel Git sur laquelle le paquet Debian est développé, par défaut
is maître.

--amont-branche=Nom de la filiale
Branche à partir de laquelle déterminer la version amont. La valeur par défaut est en amont.

--git-upstream-tag=FORMAT DE BALISE
utilisez ce format de balise lors de la recherche de balises de versions en amont, la valeur par défaut est
en amont/%(version)s.

--ignore-branche
Ne pas vérifier si la branche actuelle correspond branche-debian.

--debian-tag=format de balise
format de balise utilisé, lors du balisage des versions de Debian, la valeur par défaut est debian/%(version)s

--depuis=commis
Commencez à lire les messages de commit sur commis.

--auto, -a
Devinez le dernier commit documenté dans le changelog à partir de la bannière d'instantané (ou à partir de
la dernière balise si aucune bannière d'instantané n'existe).

--[non-]méta
Analyser les balises méta comme Se ferme:, Merci: et le Gbp-Dch :. Voir les balises META ci-dessous.

--meta-ferme=bug-fermeture-tags
Quelles balises META rechercher pour générer des entrées de journal des modifications de fermeture de bogues. Le défaut
est 'Ferme|LP' pour prendre en charge Debian et Launchpad.

--meta-closes-bugnum=bogue-numéro-format
Quelle expression régulière doit être utilisée pour analyser le numéro de bogue. La valeur par défaut est
'(?:bug|problème)?\#?\s?\d+'. Remarque : l'expression régulière devrait supprimer toutes les parties du bogue
nombre qui ne sont pas souhaités en utilisant "(?:)", voir le manuel Python regex pour plus de détails.

Mise en situation : --meta-closes-bugnum="(?:bug)?\s*ex-\d+" correspondrait à tous les éléments suivants :

Correspondance de texte possible ? Résultat
------------ ------ ------
bogue EX-12345 Y EX-12345
ex-01273 et ex-01273
bogue ex-1ab et ex-1
EX-12345 N

--[non-]plein
Incluez le message de validation complet dans la sortie du journal des modifications.

--instantané, -S
Créez une entrée de version d'instantané. Cela ajoute un numéro de version d'instantané et un avertissement
bannière à l'entrée du journal des modifications. Le numéro de version de la version est incrémenté automatiquement
avec chaque nouvelle version d'instantané pour éviter les rétrogradations de packages pendant l'instantané
test.

--numéro-instantané=expression
Expression Python qui est évaluée () au nouveau numéro d'instantané.

--Libération, -R
Supprimez toutes les bannières de version d'instantané et les suffixes de version, définissez le
distribution à instable, et ouvrez le journal des modifications pour le réglage final.

--nouvelle-version=version, -N version
Ajouter une nouvelle section changelog avec la version nouvelle version. Ensemble avec --instantané,
le numéro de l'instantané sera ajouté à nouvelle version.

--équipe Créez une entrée de journal des modifications de téléchargement d'équipe.

--bpo Incrémentez le numéro de version Debian pour un téléchargement vers les rétroportages et ajoutez un rétroportage
télécharger le commentaire du journal des modifications.

--nmu Incrémentez le numéro de version Debian pour un téléchargement non-mainteneur.

--qa Incrémentez le numéro de version Debian pour un téléchargement Debian QA Team et ajoutez un QA
télécharger le commentaire du journal des modifications.

--distribution=prénom
Définissez le champ de distribution sur prénom.

--force-distribution
Forcer la distribution spécifiée avec --Distribution à utiliser, même si ce n'est pas le cas
correspondent à la liste des distributions connues.

--urgent=niveau
Définissez le champ d'urgence sur niveau.

--git-log=options-git-log
Options transmises textuellement à journal git (1).

--id-longueur=N
Inclure N chiffres de l'ID de validation dans l'entrée du journal des modifications. La valeur par défaut est de ne pas inclure
tous les identifiants de validation.

--ignorer-regex=regex
Ignorer les lignes de commit correspondant regex lors de la génération du journal des modifications.

--git-auteur
Utilisez user.name et user.email de git-config(1) pour la remorque changelog.

--[no-]multimaint-fusion
Fusionner les commits par le mainteneur.

--spawn-éditeur=[toujours|instantané|publier]
Que ce soit pour générer un éditeur : toujours, lors de la création d'instantanés ou lors d'une publication.

--commit-msg=format-msg
utilisez cette chaîne de format pour le message de validation lors de la validation du fichier généré
fichier changelog (quand --s'engager est donné). La valeur par défaut est Mises à jour changelog pour
%(version)s libérer

--s'engager
Validez le journal des modifications généré.

--personnalisations=fichier-de-personnalisation
Charger le code Python à partir de fichier-de-personnalisation. Pour le moment, la seule chose utile que
le code peut faire est de définir une fonction personnalisée format_changelog_entry().

INSTANTANÉ MODE

Le mode instantané peut être utilisé pour des cycles de test et d'installation rapides sans avoir à se soucier de
les numéros de version ou les entrées du journal des modifications.

Lors de l'utilisation --instantané or -S, gbp dch utilise un pseudo-en-tête dans le journal des modifications Debian pour
souvenez-vous du dernier commit git pour lequel il a ajouté une entrée dans le journal des modifications. Il définit également un numéro de version
se terminant en ~ .GBP. Il incrémente automatiquement l'instantané
numéro sur les appels ultérieurs de gbp dch -S afin que les instantanés ultérieurs aient automatiquement
un numéro de version supérieur. Pour quitter le mode instantané, appelez gbp dch couplé à --Libération option.
Cela supprime le pseudo-en-tête et démêle le numéro de version afin que la version publiée
a un numéro de version plus élevé que les instantanés.

BUT MOTS CLÉS

En plus des options ci-dessus, le formatage du message de validation dans debian/journal des modifications
peut être modifié par des balises spéciales (appelées Meta Tags) fournies dans le message de commit git. Méta
Le traitement des balises peut être activé via le --méta option. Les balises doivent commencer au premier
colonne d'un message de validation mais peut apparaître sur n'importe quelle ligne. Ils sont de la forme Nom de balise:
Plus-value. Les balises méta valides sont :

Gbp-Dch : action
Les actions prises en charge sont : ignorer qui ignorera ce commit lors de la génération
debian/journal des modifications, Court qui n'utilisera que la description (la première ligne) du
message de validation lors de la génération de l'entrée du journal des modifications (utile lorsque --complet est donné),
et le Full qui utilisera le message de validation complet lors de la génération de l'entrée du journal des modifications
(utile quand --complet n'est pas donné).

En plus des Gbp-Dch, le déconseillé Git-Dch est toujours pris en charge.

Merci: msg
Ajoutez un message de remerciement après le message de validation.

Se ferme: numéro de bogue
Indiquer dans le debian/journal des modifications que le bogue a été fermé par ce commit. Voir le
--meta-ferme sur la façon d'étendre cela pour d'autres bugtrackers.

Le message de validation git suivant :

Balises META du document

donc pas besoin de consulter le manuel

Gbp-Dch : court
Fermeture : #636088
Merci : Raphaël Hertzog pour la suggestion

Résultats dans ce debian/journal des modifications entrée:

* Documenter les balises méta.
Merci à Raphaël Hertzog pour la suggestion (Fermeture : #636088)

CONFIGURATION DES DOSSIERS

Plusieurs gbp.conf les fichiers sont analysés pour définir les valeurs par défaut des arguments de ligne de commande ci-dessus.
Voir le gbp.conf(5)> page de manuel pour plus de détails.

Utiliser gbp-dch en ligne en utilisant les services onworks.net