debcommit - Soumettre les changements à un paquet
debcommit [
options] [
--all |
fichiers à
commiter]
debcommit génère un message de commit basé sur le
nouveau texte dans le fichier debian/changelog, et envoie la modification dans
un dépôt du paquet. Il doit être lancé dans une
copie de travail du paquet. Les systèmes de contrôle de versions
pris en charge sont
cvs,
git,
hg (mercurial),
svk,
svn (Subversion),
baz,
bzr,
tla (arch),
darcs.
-
-c, --changelog chemin
- Indiquer un autre emplacement pour le journal des
modifications. Par défaut debian/changelog est utilisé.
-
-r, --release
- Commiter une distribution ("release") du paquet.
Le numéro de version est déterminé à partir du
fichier debian/changelog et est utilisé pour étiqueter le
paquet dans le dépôt.
Veuillez noter que les conventions de nommage des étiquettes varient
pour Subversion et svk, donc debcommit utilise svnpath(1) pour
déterminer où l'étiquette doit être
placée dans le dépôt.
-
-R, --release-use-changelog
- Quand elle est utilisée avec l'option
--release, s'il y a des modifications non envoyées dans le
journal des modifications, alors utiliser ces modifications pour le
message d'envoi (commit) plutôt que le message par
défaut.
-
-m texte, --message texte
- Indiquer un message de commit à utiliser. Utile si
le programme ne peut pas déterminer tout seul un message de commit
à partir du fichier debian/changelog ou si vous voulez remplacer le
message par défaut.
-
-n, --noact
- Ne rien faire, mais afficher les commandes qui seraient
exécutées.
-
-d, --diff
- Au lieu de faire un envoi (commit), afficher la
différence qui correspond à ce qui serait envoyé si
cette option n'avait pas été fournie. C'est utile pour
créer un patch correspondant aux modifications dans un espace de
travail (par exemple quand vous n'avez pas les droits d'accès pour
effectuer l'envoi).
-
-C, --confirm
- Afficher le message d'envoi créé et demander
une confirmation avant l'envoi. Il est aussi possible d'éditer le
message à ce moment ; dans ce cas, la demande de
confirmation sera affichée de nouveau après que le message a
été édité.
-
-e, --edit
- Éditer le message d'envoi créé dans
votre éditeur préféré avant l'envoi.
-
-a, --all
- Envoyer tous les fichiers. C'est l'opération par
défaut pour les systèmes de contrôle de versions
autres que Git.
-
-s, --strip-message,
--no-strip-message
- Si cette option est utilisée et que le message
d'envoi est défini à l'aide du journal des modifications,
les caractères "*" (espace comprise) seront
enlevés au début du message.
Cette option est activée par défaut et est ignorée si
plus d'une ligne du message commence par "[*+-]" (espace
comprise).
-
--sign-commit, --no-sign-commit
- Si cette option est activée, alors les messages
créés par debcommit seront signés avec GnuPG. Ce
n'est actuellement géré que par Git, mercurial et
Bazaar.
-
--sign-tags, --no-sign-tags
- Si cette option est activée, alors les
étiquettes créées par debcommit seront signées
avec GnuPG. Ce n'est actuellement géré que par Git.
- --changelog-info
- Si cette option est définie, l'auteur et la date de
commit seront déterminés à partir des champs
Maintainer et Date du premier paragraphe de debian/changelog. C'est
surtout pratique en utilisant debchange(1) avec l'option
--no-mainttrailer.
Les deux fichiers de configuration
/etc/devscripts.conf et
~/.devscripts sont chargés dans cet ordre par un
interpréteur de commandes pour définir les variables de
configuration. Des options de ligne de commande peuvent être
utilisées pour écraser les paramètres des fichiers de
configuration. Les paramètres des variables d'environnement sont
ignorés à cette fin. Les variables actuellement reconnues
sont :
- DEBCOMMIT_STRIP_MESSAGE
- Lui attribuer la valeur no équivaut à
utiliser l'option --no-strip-message. La valeur par défaut
est yes.
- DEBCOMMIT_SIGN_TAGS
- Lui attribuer la valeur yes équivaut à
utiliser l'option --sign-tags. La valeur par défaut est
no.
- DEBCOMMIT_SIGN_COMMITS
- Lui attribuer la valeur yes équivaut à
utiliser l'option --sign-commit. La valeur par défaut est
no.
- DEBCOMMIT_RELEASE_USE_CHANGELOG
- Lui attribuer la valeur yes équivaut à
utiliser l'option --release-use-changelog. La valeur par
défaut est no.
- DEBSIGN_KEYID
- L'identifiant de la clef à utiliser pour les
signatures. Si cette variable n'est pas configurée, une valeur par
défaut sera utilisée par les systèmes de
contrôle de versions.
-
tla / baz
- Si le message d'envoi contient plus de 72
caractères, un résumé sera créé,
contenant autant de mots entiers que possible dans la limite des 72
caractères, suivi de points de suspension.
Chacune des fonctionnalités décrites ci-dessous ne s'applique que
si le message d'envoi a été créé automatiquement
à partir du journal des modifications.
- git
- Si une seule modification est détectée dans
le journal des modifications, debcommit rassemblera le message sur
une unique ligne et se comportera comme si l'option --strip-message
était utilisée.
Sinon, la première modification sera rassemblée sur une ligne
et nettoyée pour former la ligne de résumé et un
message d'envoi sera créé avec la ligne de
résumé, suivi d'une ligne vide puis des modifications du
journal des modifications. debcommit lancera ensuite un
éditeur de telle sorte que le message puisse être
retouché avant l'envoi.
-
hg / darcs
- La première modification détectée dans
le journal des modifications sera rassemblée sur une ligne de
résumé. Si plusieurs modifications sont
détectées alors un éditeur sera lancé pour
permettre de retoucher le message.
- bzr
- Si l'entrée du journal des modifications
utilisée pour le message de commit ferme des bogues, des options
--fixes pour "bzr commit" seront produits pour associer
la révision aux bogues.
Ce code est copyright Joey Hess <
[email protected]>, tous droits
réservés. Ce programme est fourni SANS AUCUNE GARANTIE. Vous
êtes libre de redistribuer ce code sous les termes de la licence
publique générale GNU (GNU General Public Licence),
version 2 ou ultérieure.
Joey Hess <
[email protected]>
debchange(1),
svnpath(1)
Cyril Brulebois <
[email protected]>, 2006
Thomas Huriaux <
[email protected]>, 2006
David Prévot <
[email protected]>, 2010-2013
Xavier Guimard <
[email protected]>, 2018-2021