debchange - En ligne dans le Cloud

PROGRAMME:

Nom

debchange - Outil de maintenance du fichier debian/changelog dans un paquet source

SYNOPSIS

débloquer [Options] [texte ...]
dch [Options] [texte ...]

DESCRIPTION

débloquer ou son pseudo dch ajoutera une nouvelle ligne de commentaire au journal des modifications Debian dans le
arborescence des sources actuelles. Cette commande doit être exécutée à partir de cette arborescence. Si le texte du
le changement est donné sur la ligne de commande, débloquer fonctionnera en mode batch et ajoutera simplement le
texte, avec des sauts de ligne si nécessaire, à l'endroit approprié dans debian/journal des modifications (Ou l'
changelog spécifié par les options, comme décrit ci-dessous). Si aucun texte n'est spécifié alors
débloquer exécutera l'éditeur tel que déterminé par éditeur-sensible pour que vous puissiez modifier le fichier.
(Les variables d'environnement VISUEL et EDITEUR sont utilisés dans cet ordre pour déterminer quels
éditeur à utiliser.) Les éditeurs qui comprennent le +n option pour démarrer l'édition sur un
La ligne spécifiée l'utilisera pour passer à la ligne correcte du fichier à éditer. Si la
l'éditeur se ferme sans modifier le fichier temporaire, débloquer sortira sans toucher
le journal des modifications existant. Notez qui le changelog is assumé à be codée avec le UTF-8
codage. If it is ne pas, d'ouvrabilité Au cours de cette réunion, Matthew a obtenu de précieux conseils et Linda lui a demandé de la tenir au courant de ses progrès. se produire. S'il vous plaît voir le iconv(1) page de manuel pour le découvrir
comment convertir les changelogs à partir d'encodages hérités. Enfin, un changelog or NOUVELLES le fichier peut être
créé à partir de zéro en utilisant le --créer option décrite ci-dessous.

débloquer prend également en charge la production automatique d'entrées de journal des modifications de fermeture de bogues, en utilisant le
--se ferme option. Cela interrogera généralement le BTS, le système de suivi des bogues Debian (voir
https://bugs.debian.org/) to determine the title of the bug and the package in which it
se produit. Ce comportement peut être arrêté en donnant un --noquery option ou en définissant le
variable de configuration DEBCHANGE_QUERY_BTS à aucune, comme décrit ci-dessous. Dans les deux cas, le
l'éditeur (comme décrit ci-dessus) sera toujours invoqué pour donner la possibilité de modifier le
entrées, et le journal des modifications sera accepté, que des modifications soient apportées ou non. Un
une entrée supplémentaire du journal des modifications peut être donnée sur la ligne de commande en plus des entrées de fermeture.

Au plus un des --append, --incrément, --modifier, --Libération et --nouvelle version peut être spécifié
comme indiqué ci-dessous. Si aucune option n'est spécifiée, débloquer utilisera des heuristiques pour deviner
si le paquet a été libéré avec succès, et se comporter comme si --incrément
avait été spécifié si le colis a été libéré, ou autrement comme si --append a été
spécifié.

Deux ensembles différents d'heuristiques peuvent être utilisés, contrôlés par le --release-heuristique
option ou le DEBCHANGE_RELEASE_HEURISTIC variable de configuration. Le défaut changelog
heuristique suppose que le paquet a été publié à moins que son journal des modifications ne contienne NON LIBÉRÉ
dans le domaine de la diffusion. Si cette heuristique est activée, la distribution sera par défaut
à NON LIBÉRÉ dans les nouvelles entrées du journal des modifications, et le --maintrailer l'option décrite ci-dessous
être automatiquement activé. Cela peut être utile si un paquet peut être publié par différents
responsables, ou si vous ne conservez pas les journaux de téléchargement. Le suppléant enregistrer l'heuristique détermine
si un paquet a été publié en recherchant un télécharger(1) ou sortie(1) journal
fichier dans le répertoire parent. Un avertissement sera émis si le fichier journal est trouvé mais un
le téléchargement réussi n'est pas enregistré. Cela peut être dû au fait que le téléchargement précédent a été effectué
avec une version de télécharger avant 2.1 ou parce que le téléchargement a échoué.

Si soit --incrément or --nouvelle version est utilisé, le nom et l'adresse e-mail de la nouvelle version seront
être déterminé comme suit. Si la variable d'environnement DEBFNOMCOMPLET est réglé, ce sera
utilisé pour le nom complet du responsable ; sinon, alors Nom sera vérifié. Si l'environnement
variable DÉBÉMAIL est défini, il sera utilisé pour l'adresse e-mail. Si cette variable a
la forme "nom ", alors le nom du responsable sera également pris ici si ni l'un ni l'autre
DEBFNOMCOMPLET ni Nom est réglé. Si cette variable n'est pas définie, le même test est effectué sur
la variable d'environnement E-MAIL. Ensuite, si le nom complet n'a toujours pas été déterminé,
puis utilisez obtenirpwuid(3) pour déterminer le nom à partir du fichier de mot de passe. Si cela échoue, utilisez le
entrée précédente du journal des modifications. Pour l'adresse e-mail, si elle n'a pas été définie à partir de DÉBÉMAIL or
E-MAIL, puis regarde dans /etc/nom de messagerie, puis essayez de le créer à partir du nom d'utilisateur et du nom de domaine complet,
sinon, utilisez l'adresse e-mail dans l'entrée précédente du journal des modifications. En d'autres termes, c'est un
bonne idée de mettre DÉBÉMAIL et DEBFNOMCOMPLET lors de l'utilisation de ce script.

La prise en charge est incluse pour les journaux des modifications qui enregistrent les modifications apportées par plusieurs co-mainteneurs d'un
emballer. Si une entrée est ajoutée aux entrées de la version actuelle et que le mainteneur est
différent du mainteneur qui est répertorié comme ayant fait les entrées précédentes, alors
des lignes seront ajoutées au journal des modifications pour indiquer quels responsables ont effectué quelles modifications.
Actuellement, un seul des nombreux styles d'enregistrement de ces informations est pris en charge,
dans laquelle le nom du mainteneur qui a effectué un ensemble de modifications apparaît sur une ligne avant le
changements, entre crochets. Celui-ci peut être activé et désactivé à l'aide de la
--[aucune]multimaintenance option ou le DEBCHANGE_MULTIMAINT option de fichier de configuration ; le défaut
est de l'activer. Notez que si une entrée a déjà été marquée de cette manière, alors cette
L'option sera ignorée en silence.

Si le nom du répertoire de l'arborescence source a la forme paquet-version, puis débloquer sera
essayez également de le renommer si le numéro de version (en amont) change. Cela peut être évité
En utilisant le --préserver ligne de commande ou option de fichier de configuration comme décrit ci-dessous.

If --force-mauvaise-version or --allow-version-inférieure est utilisé, débloquer ne s'arrêtera pas si le
la nouvelle version est inférieure à la version actuelle. Ceci est particulièrement utile en faisant
rétroportages.

Annuaire prénom vérification

En commun avec plusieurs autres scripts dans le scripts de développement paquet, débloquer montera le
arborescence de répertoires jusqu'à ce qu'il trouve un debian/journal des modifications déposer. Comme protection contre les fichiers errants
causant des problèmes potentiels, il examinera le nom du répertoire parent une fois qu'il aura trouvé
le debian/journal des modifications fichier, et vérifiez que le nom du répertoire correspond au package
Nom. La manière précise dont il procède est contrôlée par deux variables de fichier de configuration
DEVSCRIPTS_CHECK_DIRNAME_LEVEL et DEVSCRIPTS_CHECK_DIRNAME_REGEX, et leur correspondant
options de ligne de commande --check-répertoire-niveau et --check-répertoire-regex.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL peut prendre les valeurs suivantes :

0 Ne jamais vérifier le nom du répertoire.

1 Ne vérifiez le nom du répertoire que si nous avons dû changer de répertoire dans notre recherche de
debian/journal des modifications. C'est le comportement par défaut.

2 Vérifiez toujours le nom du répertoire.

Le nom du répertoire est vérifié en testant si le nom du répertoire actuel (tel que déterminé
by pwd(1)) correspond à l'expression régulière donnée par l'option du fichier de configuration
DEVSCRIPTS_CHECK_DIRNAME_REGEX ou par l'option de ligne de commande --check-répertoire-regex regex.
Ici regex est une regex Perl (voir perler(3perl)), qui sera ancré au début
et la fin. Si regex contient un '/', alors il doit correspondre au chemin complet du répertoire. Si
pas, alors il doit correspondre au nom complet du répertoire. Si regex contient la chaîne ´RANGEMENT',
celui-ci sera remplacé par le nom du package source, tel que déterminé à partir du journal des modifications. Les
la valeur par défaut de l'expression régulière est : FORFAIT(-.+) ?', correspondant ainsi aux noms de répertoires tels que
RANGEMENT et PAQUET-version.

Le changelog par défaut à éditer est debian/journal des modifications; cependant, cela peut être modifié en utilisant
le --changelog or --nouvelles options ou les CHANGELOG variable d'environnement, comme décrit
ci-dessous.

OPTIONS

--append, -a
Ajoutez une nouvelle entrée du journal des modifications à la fin des entrées de la version actuelle.

--incrément, -i
Incrémentez soit le composant final du numéro de version Debian ou, s'il s'agit d'un
paquet Debian natif, le numéro de version. Sur Ubuntu ou Tanglu, ce sera aussi
changez le suffixe de buildX en ubuntu1/tanglu1. Utilisation -R, --reconstruire pour un non
changer l'incrément de reconstruction. Cela crée une nouvelle section au début du
changelog avec les en-têtes et les pieds de page appropriés. De plus, s'il s'agit d'une nouvelle version de
un paquet Debian natif, le nom du répertoire est modifié pour refléter cela. Si
DEBCHANGE_RELEASE_HEURISTIC is changelog (par défaut) et la version actuelle est
NON LIBÉRÉ, cela ne changera que la version de la strophe actuelle du journal des modifications.
Sinon, cela créera une nouvelle strophe du journal des modifications avec la nouvelle version.

--nouvelle version version, -v version
Cela spécifie explicitement le numéro de version (y compris la partie de publication Debian)
et se comporte comme le --incrément option à d'autres égards. Cela changera également le
nom du répertoire si le numéro de version amont a changé. Si
DEBCHANGE_RELEASE_HEURISTIC is changelog (par défaut) et la version actuelle est
NON LIBÉRÉ, cela ne changera que la version de la strophe actuelle du journal des modifications.
Sinon, cela créera une nouvelle strophe du journal des modifications avec la nouvelle version.

--modifier, -e
Editez le changelog dans un éditeur.

--Libération, -r
Finaliser le journal des modifications pour une version. Mettez à jour l'horodatage du journal des modifications. Si la
la distribution est réglée sur NON LIBÉRÉ, remplacez-la par la distribution de la précédente
entrée du journal des modifications (ou une autre distribution comme spécifié par --Distribution). S'il y a
il n'y a pas d'entrées précédentes dans le journal des modifications et une distribution explicite n'a pas été
spécifié, instable sera utilisé.

--force-save-on-release
Lorsque --Libération est utilisé, un éditeur s'ouvre pour permettre l'inspection du journal des modifications.
L'utilisateur doit enregistrer le fichier pour accepter le changelog modifié, sinon
l'original sera conservé (par défaut).

--pas de sauvegarde forcée à la sortie
Ne le faites pas. Notez qu'une entrée factice du journal des modifications peut être fournie afin d'obtenir
le même effet - par exemple débloquer --Libération "". L'entrée ne sera pas ajoutée au
changelog mais sa présence supprimera l'éditeur.

--créer
Cela créera un nouveau debian/journal des modifications fichier (ou NOUVELLES si le --nouvelles option est
utilisé). Vous devez être dans le répertoire de niveau supérieur pour l'utiliser ; pas de nom de répertoire
une vérification sera effectuée. Le nom et la version du package peuvent être spécifiés
en utilisant l' --emballer et --nouvelle version options, déterminées à partir du nom du répertoire
en utilisant l' --fromdirname option ou saisie manuellement dans le fichier généré changelog
déposer. Le nom du mainteneur est déterminé à partir de l'environnement si cela est possible,
et la distribution est spécifiée soit à l'aide de la --Distribution option ou dans le
généré changelog fichier.

--vide
Lorsqu'il est utilisé en combinaison avec --créer, supprimer l'ajout automatique d'un
"initiale libérer" entrée du journal des modifications (afin que la prochaine invocation de débloquer ajoute
la première entrée). Notez que cela provoquera un dpkg-parsechangelog avertissement sur le
prochain appel en raison de l'absence de changements.

--emballer paquet
Cela spécifie le nom du package à utiliser dans le nouveau journal des modifications ; ce n'est peut-être que
utilisé en conjonction avec le --créer, --incrément et --nouvelle version options.

--nmu, -n
Incrémentez le numéro de version Debian pour un téléchargement non-mainteneur en ajoutant soit
une ".1" à un numéro de version non NMU (sauf si le paquet est natif Debian, dans lequel
Cas "+nmu1" est ajouté) ou en incrémentant un numéro de version NMU, et ajoutez un NMU
commentaire du journal des modifications. Cela se produit automatiquement si le conditionneur n'est ni dans le
Mainteneur ni l' Téléchargeurs champ dans debian / contrôle, sauf si DEBCHANGE_AUTO_NMU is
ajuster à aucune ou l' --no-auto-nmu option est utilisée.

--bin-nmu
Incrémentez le numéro de version Debian pour un téléchargement binaire non-mainteneur soit par
en ajoutant un "+b1" vers un numéro de version non binNMU ou en incrémentant un binNMU
numéro de version et ajoutez un commentaire du journal des modifications binNMU.

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

--reconstruire, -R
Incrémentez le numéro de version Debian pour une reconstruction sans changement en ajoutant un "build1"
ou en incrémentant un numéro de version de reconstruction.

--Sécurité, -s
Incrémenter le numéro de version Debian pour un non-mainteneur de l'équipe de sécurité Debian
télécharger et ajouter un Sécurité Équipe télécharger commentaire du journal des modifications.

--équipe Incrémentez le numéro de version Debian pour un téléchargement d'équipe et ajoutez un Équipe télécharger
commentaire du journal des modifications.

--en amont, -U
Ne pas ajouter nom-distro1 à la version sur une distribution dérivée. Incrémenter le
Version Debian.

--bpo Incrémentez le numéro de version Debian pour un téléchargement vers jessie-backports et ajoutez un
backport télécharger le commentaire du journal des modifications.

--locale, -lsuffixe
Ajoutez un suffixe au numéro de version Debian pour une version locale.

--force-mauvaise-version, -b
Forcer un numéro de version à être inférieur au numéro actuel (par exemple, lors d'un rétroportage).

--allow-version-inférieure modèle
Permettre à un numéro de version d'être inférieur à l'actuel si la nouvelle version correspond
le modèle spécifié.

--force-distribution
Forcer l'utilisation de la distribution fournie, même si elle ne correspond pas à la liste des
distributions connues (par exemple pour les distributions non officielles).

--auto-nmu
Tenter de déterminer automatiquement si une modification apportée au journal des modifications représente un
Téléchargement de non-mainteneur. C'est la valeur par défaut.

--no-auto-nmu
Désactivez la détection automatique de NMU. Équivalent au réglage DEBCHANGE_AUTO_NMU à aucune.

--fromdirname, -d
Cela prendra le numéro de version en amont du nom du répertoire, qui devrait être
de la forme paquet-version. Si le numéro de version en amont a augmenté depuis le
entrée du journal des modifications la plus récente, une nouvelle entrée sera créée avec le numéro de version
version-1 (ou version si le paquet est natif Debian), avec la même époque que le
version précédente du package. Si le numéro de version amont est le même, cette option
se comportera de la même manière que -i.

--se ferme Nnnnn[,Nnnnn ...]
Ajoutez des entrées de journal des modifications pour fermer les numéros de bogues spécifiés. Appelez également l'éditeur
après avoir ajouté ces entrées. Génèrera des avertissements si le BTS ne peut pas être contacté
(Et --noquery n'a pas été spécifié), ou s'il y a des problèmes avec le bogue
rapport localisé.

--[aucune]question
Devrions-nous essayer d'interroger le BTS lors de la génération d'entrées fermées ?

--préserver, -p
Conserver le nom du répertoire de l'arborescence source si le numéro de version amont (ou le
numéro de version d'un paquet natif Debian) change. Voir aussi la configuration
section des variables ci-dessous.

--pas de conservation, --nopreserve
Ne conservez pas le nom du répertoire de l'arborescence source (par défaut).

--vendeur vendeur
Remplacez l'ID du distributeur par la valeur par défaut renvoyée par dpkg-vendor. Ce nom est
utilisé pour l'heuristique appliquée aux nouvelles versions de package et pour la vérification de l'intégrité du
répartition cible.

--Distribution dist, -D dist
Utilisez la distribution spécifiée dans l'entrée du journal des modifications en cours d'édition, au lieu de
en utilisant la distribution de l'entrée du journal des modifications précédente pour les nouvelles entrées ou l'existant
valeur pour les entrées existantes.

--urgence urgence, -u urgence
Utilisez l'urgence spécifiée dans l'entrée du journal des modifications en cours d'édition, au lieu d'utiliser le
défaut "moyenne" pour les nouvelles entrées ou la valeur existante pour les entrées existantes.

--changelog filet, -c filet
Cela modifiera le changelog filet au lieu de la norme debian/journal des modifications. Ce
l'option remplace tout CHANGELOG réglage de la variable d'environnement. De plus, pas de répertoire
le déplacement ou la vérification sera effectué lorsque cette option est utilisée.

--nouvelles [fichier de nouvelles]
Cela modifiera fichier de nouvelles (par défaut, debian/ACTUALITÉS) au lieu du journal des modifications habituel.
Une recherche dans le répertoire sera effectuée. Le changelog sera examiné afin de
déterminer la version actuelle du package.

--[aucune]multimaintenance
Devrions-nous indiquer que des parties d'une entrée de journal des modifications ont été faites par différents
les mainteneurs ? La valeur par défaut est oui ; voir la discussion ci-dessus et aussi le
DEBCHANGE_MULTIMAINT option du fichier de configuration ci-dessous.

--[aucune]multimaint-fusion
Si toutes les modifications apportées par le même auteur doivent être fusionnées dans le même journal des modifications
section? La valeur par défaut est non ; voir la discussion ci-dessus et aussi le
DEBCHANGE_MULTIMAINT_MERGE option du fichier de configuration ci-dessous.

--maintenance, -m
Ne modifiez pas les détails du responsable précédemment répertoriés dans le journal des modifications. C'est
utile notamment pour les sponsors souhaitant ajouter automatiquement un message de parrainage
sans perturber les autres détails du journal des modifications. Notez qu'il peut y avoir des
interactions intéressantes si le mode multi-mainteneur est utilisé ; vous souhaiterez probablement
pour vérifier le journal des modifications manuellement avant de le télécharger dans de tels cas.

--controlmaint, -M
Utilisez les détails du responsable de la debian / contrôle Mainteneur terrain plutôt que
variables d'environnement pertinentes (DEBFNOMCOMPLET, DÉBÉMAIL, etc.). Cette option peut être
utile pour restaurer les détails du mainteneur principal dans la bande-annonce du journal des modifications après un
fausse modification (par exemple quand -m était prévu mais oublié) ou lors de la sortie d'un package dans
le nom du mainteneur principal (par exemple l'équipe).

--[aucune]remorque, -t
If remorque est défini, cela évitera de modifier la ligne de remorque existante du journal des modifications
(c'est-à-dire les détails du responsable et de l'horodatage), à ​​moins qu'il ne soit utilisé avec des options qui nécessitent
la remorque à modifier (par ex. --créer, --Libération, -i, --qa, etc.) Cette option
diffère de --maintenance en ce qu'il utilisera le cas échéant le mode multi-mainteneur,
à l'exception du montage de la bande-annonce. Voir aussi le DEBCHANGE_MAINTTRAILER
option du fichier de configuration ci-dessous.

--check-répertoire-niveau N
Voir la section ci-dessus "Annuaire prénom vérification" pour une explication de cette option.

--check-répertoire-regex regex
Voir la section ci-dessus "Annuaire prénom vérification" pour une explication de cette option.

--no-conf, --noconf
Ne lisez aucun fichier de configuration. Cela ne peut être utilisé que comme première option
donné sur la ligne de commande.

--release-heuristique enregistrer|changelog
Contrôle comment débloquer détermine si un paquet a été libéré, au moment de décider
s'il faut créer une nouvelle entrée dans le journal des modifications ou l'ajouter à une entrée existante dans le journal des modifications.

--Aidez-moi, -h
Affichez un message d'aide et quittez avec succès.

--version
Affichez les informations de version et de copyright et quittez avec succès.

CONFIGURATION VARIABLES

Les deux fichiers de configuration /etc/devscripts.conf et ~/.devscript sont originaires de ce
afin de définir les variables de configuration. Les options de ligne de commande peuvent être utilisées pour remplacer
paramètres du fichier de configuration. Les paramètres des variables d'environnement sont ignorés à cette fin.
Les variables actuellement reconnues sont :

DEBCHANGE_PRÉSERVE
S'il est défini sur oui, alors c'est la même chose que --préserver paramètre de ligne de commande
utilisé.

DEBCHANGE_QUERY_BTS
S'il est défini sur aucune, alors c'est la même chose que --noquery paramètre de ligne de commande
utilisé.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL, DEVSCRIPTS_CHECK_DIRNAME_REGEX
Voir la section ci-dessus "Annuaire prénom vérification" pour une explication de ces
variables. Notez qu'il s'agit de variables de configuration à l'échelle du package et qu'elles
affectent donc tous scripts de développement scripts qui vérifient leur valeur, comme décrit dans
leurs pages de manuel respectives et dans devscripts.conf (5).

DEBCHANGE_RELEASE_HEURISTIC
Contrôle comment débloquer détermine si un paquet a été libéré, au moment de décider
s'il faut créer une nouvelle entrée dans le journal des modifications ou l'ajouter à une entrée existante dans le journal des modifications.
Peut être soit enregistrer or changelog.

DEBCHANGE_MULTIMAINT
Si la valeur aucune, débloquer n'introduira pas de distinctions à mainteneurs multiples lorsqu'un
un autre mainteneur ajoute une entrée à un journal des modifications existant. Voir le débat
dessus. La valeur par défaut est oui.

DEBCHANGE_MULTIMAINT_MERGE
Si la valeur oui, lors de l'ajout de modifications en mode multi-mainteneur débloquer vérifierai
si les modifications précédentes du mainteneur actuel existent et ajoutez les nouvelles modifications à
le bloc existant plutôt que de créer un nouveau bloc. La valeur par défaut est aucune.

DEBCHANGE_MAINTTRAILER
S'il est défini sur aucune, alors c'est la même chose que --nommainttrailer ligne de commande
paramètre utilisé.

DEBCHANGE_TZ
Utilisez ce fuseau horaire pour les entrées du journal des modifications. La valeur par défaut est le fuseau horaire de l'utilisateur/système tel que
indiqué par `données -R` et affecté par la variable d'environnement TZ.

DEBCHANGE_LOWER_VERSION_PATTERN
Si cela est défini, alors c'est le même que le --allow-version-inférieure ligne de commande
paramètre utilisé.

DEBCHANGE_AUTO_NMU
S'il est défini sur aucune puis débloquer n'essaiera pas de déterminer automatiquement
si la strophe actuelle du journal des modifications représente une NMU. La valeur par défaut est oui. Voir
la discussion de la --nmu option ci-dessus.

DEBCHANGE_FORCE_SAVE_ON_RELEASE
S'il est défini sur aucune, alors c'est la même chose que --pas de sauvegarde forcée à la sortie commander
paramètre de ligne utilisé.

DEBCHANGE_VENDOR
Utilisez ce fournisseur au lieu de la valeur par défaut (sortie dpkg-vendor). Voir --vendeur pour
détails.

ENVIRONNEMENT

DÉBÉMAIL, E-MAIL, DEBFNOMCOMPLET, Nom
Voir la description ci-dessus de l'utilisation de ces variables d'environnement.

CHANGELOG
Cette variable spécifie le changelog à éditer à la place de debian/journal des modifications. Non
la traversée ou la vérification du répertoire est effectuée lorsque cette variable est définie. Cette
la variable est remplacée par la --changelog paramètre de ligne de commande.

VISUEL, EDITEUR
Ces variables d'environnement (dans cet ordre) déterminent l'éditeur utilisé par sensible-
éditeur.

Utilisez debchange en ligne en utilisant les services onworks.net