NOM

       debcommit - Soumettre les changements à un paquet

SYNOPSIS

       debcommit [options] [--all | fichiers à commiter]

DESCRIPTION

       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.

OPTIONS

       -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 par OpenPGP. Ce
           n’est actuellement pris en charge que pour git, hg et bzr.

       --sign-tags, --no-sign-tags
           Si cette option est activée, alors les étiquettes créées par debcommit seront signées par OpenPGP. Ce
           n’est actuellement pris en charge que pour git.

       --signoff, --no-signoff
           Si cette option est spécifiée, ajouter une ligne "Signed-off-by:" au message de commission.

       --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.

VARIABLES DE CONFIGURATION

       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_SIGNOFF
           Lui attribuer la valeur yes équivaut à utiliser l’option --signoff. 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.

FONCTIONNALITÉS SPÉCIFIQUES AUX 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.

LICENCE

       Ce code est copyright Joey Hess <joeyh@debian.org>, 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.

AUTEUR

       Joey Hess <joeyh@debian.org>

VOIR AUSSI

       debchange(1), svnpath(1)

TRADUCTION

       Cyril Brulebois <cyril.brulebois@enst-bretagne.fr>, 2006

       Thomas Huriaux <thomas.huriaux@gmail.com>, 2006

       David Prévot <david@tilapin.org>, 2010-2013

       Xavier Guimard <yadd@debian.org>, 2018-2024

Utilitaires Debian                                 2025-06-16                                    DEBCOMMIT.FR(1)