BEZEICHNUNG

       debcommit - übergibt Änderungen an einem Paket

ÜBERSICHT

       debcommit [Optionen] [--all | zu übergebende Dateien]

BESCHREIBUNG

       debcommit erzeugt, basierend auf neuem Text in debian/changelog, eine Commit-Nachricht und übergibt die
       Änderungen an das Depot eines Pakets. Es muss in einer Arbeitskopie für das Paket ausgeführt werden.
       Folgende Versionskontrollsysteme werden unterstützt: cvs, git, hg (Mercurial), svk, svn (Subversion),
       baz, bzr, tla (Arch), darcs.

OPTIONEN

       -c, --changelog Pfad
           gibt  einen  alternativen  Speicherplatz  für  das  Changelog an. Standardmäßig wird debian/changelog
           benutzt.

       -r, --release
           übergibt eine Veröffentlichung des  Pakets.  Die  Versionsnummer  wird  anhand  von  debian/changelog
           bestimmt und benutzt, um das Paket im Depot zu markieren.

           Beachten   Sie,   das   svn-/svk-Markierungskonventionen  variieren,  weswegen  Debcommit  svnpath(1)
           verwendet, um zu bestimmen, wo die Markierung im Depot platziert werden soll.

       -R, --release-use-changelog
           Wenn dies in Verbindung mit --release benutzt wird, dann wird die Commit-Nachricht,  falls  es  nicht
           übertragene   Änderungen   am   Changelog   gibt,   aus   diesen  Änderungen  abgeleitet,  statt  die
           Standardnachricht zu verwenden.

       -m Text, --message Text
           gibt die Commit-Nachricht an, die verwendet werden soll; nützlich,  falls  das  Programm  von  allein
           keine   auf   debian/changelog   basierende  Commit-Nachricht  festlegen  kann  oder  falls  Sie  die
           Standardnachricht außer Kraft setzen möchten.

       -n, --noact
           tut tatsächlich nichts, gibt aber die Befehle aus, die ausgeführt würden.

       -d, --diff
           druckt statt ein Commit durchzuführen das Diff, das übergeben worden wäre, falls diese  Option  nicht
           angegeben gewesen wäre. Eine typisches Verwendungsszenario dieser Option ist das Erzeugen von Patches
           für die aktuelle Arbeitskopie (z.B. wenn Sie keine Commit-Rechte haben).

       -C, --confirm
           zeigt  die  erzeugte  Commit-Nachricht  an  und erbittet vor dem Commit eine Bestätigung. Es ist auch
           möglich, die Nachricht an dieser Stelle zu bearbeiten; in diesem Fall  wird  die  Bestätigungsanfrage
           erneut angezeigt, nachdem die Bearbeitung durchgeführt wurde.

       -e, --edit
           bearbeitet   die   erzeugte  Commit-Nachricht  in  Ihrem  Lieblingseditor,  bevor  ein  Commit  davon
           durchgeführt wird.

       -a, --all
           führt  ein  Commit  aller  Dateien  durch.  Dies  ist  die  Standardtransaktion,  wenn  ein   anderes
           Versionskontrollsystem als Git verwendet wird.

       -s, --strip-message, --no-strip-message
           Falls  diese  Option  gesetzt ist und die Commit-Nachricht aus dem Changelog abgeleitet wurde, werden
           die »*«-Zeichen vom Anfang der Nachricht entfernt.

           Diese Option ist standardmäßig gesetzt und wird ignoriert, falls mehr als eine  Zeile  der  Nachricht
           mit »[*+-] « beginnt.

       --sign-commit, --no-sign-commit
           Falls  diese Option gesetzt ist, dann werden Commits, die Debcommit erstellt, mittels GnuPG signiert.
           Derzeit wird dies nur von Git, Hg und Bzr unterstützt.

       --sign-tags, --no-sign-tags
           Falls diese Option gesetzt ist, dann werden  Markierungen,  die  Debcommit  erstellt,  mittels  GnuPG
           signiert. Derzeit wird dies nur von Git unterstützt.

       --changelog-info
           Falls  diese  Option  gesetzt  ist, werden der Autor und das Datum, die übertragen werden, anhand der
           Felder  »Maintainer«  und  »Date«  des  ersten  Absatzes  in  debian/changelog  bestimmt.  Dies   ist
           hauptsächlich dann nützlich, wenn debchange(1) mit der Option --no-mainttrailer verwendet wird.

KONFIGURATIONSVARIABLEN

       Die  beiden  Konfigurationsdateien  /etc/devscripts.conf  und  ~/.devscripts werden in dieser Reihenfolge
       durch eine Shell eingelesen, um Konfigurationsvariablen zu setzen. Befehlszeilenoptionen  können  benutzt
       werden,   um   Einstellungen   aus   Konfigurationsdateien  außer  Kraft  zu  setzen.  Einstellungen  aus
       Umgebungsvariablen werden zu diesem Zweck ignoriert. Die derzeit bekannten Variablen sind:

       DEBCOMMIT_STRIP_MESSAGE
           Falls dies auf no gesetzt  ist,  dann  entspricht  das  der  Verwendung  des  Befehlszeilenparameters
           --no-strip-message. Die Vorgabe ist yes.

       DEBCOMMIT_SIGN_TAGS
           Falls  dies  auf  yes  gesetzt  ist, ist es so, als ob der Befehlszeilenparameter --sign-tags benutzt
           würde. Die Vorgabe ist no.

       DEBCOMMIT_SIGN_COMMITS
           Falls dies auf yes gesetzt ist, ist es so, als ob der  Befehlszeilenparameter  --sign-commit  benutzt
           würde. Die Vorgabe ist no.

       DEBCOMMIT_RELEASE_USE_CHANGELOG
           Falls  dies auf yes gesetzt ist, ist es so, als ob der Befehlszeilenparameter --release-use-changelog
           benutzt würde. Die Vorgabe ist no.

       DEBSIGN_KEYID
           Dies ist die Schlüsselkennung, die zum Signieren von Markierungen benutzt wird. Falls nicht  gesetzt,
           wird eine Vorgabe durch das Versionskontrollsystem ausgewählt.

VERSIONSKONTROLLSYSTEMSPEZIFISCHE FUNKTIONALITÄTEN

       tla / baz
           Falls  die  Commit-Nachricht  mehr als 72 Zeichen enthält, wird eine Zusammenfassung erstellt, die so
           viele vollständige Worte aus der Nachricht enthält, wie  in  72  Zeichen  hineinpassen,  gefolgt  von
           Auslassungspunkten.

       Jede  der  unten beschriebenen Funktionalitäten ist nur anwendbar, falls die Commit-Nachricht automatisch
       aus dem Changelog bestimmt wurde.

       git Falls nur eine einzelne Änderung im Changelog entdeckt wird, wird  debcommit  sie  in  eine  einzelne
           Zeile entfalten und sich so verhalten, als ob --strip-message benutzt worden wäre.

           Andernfalls  wird die erste Änderung entfaltet und bereinigt, um eine Zusammenfassungszeile und damit
           eine Commit-Nachricht, gefolgt von einer leeren Zeile und den Änderungen, wie sie aus  dem  Changelog
           extrahiert  wurden, zu bilden. debcommit wird dann einen Editor öffnen, so dass die Nachricht vor dem
           Commit abgestimmt werden kann.

       hg / darcs
           Die erste im Changelog entdeckte Änderung wird entfaltet, um eine einzelne  Zusammenfassungszeile  zu
           bilden,  Falls  mehrere Änderungen entdeckt wurden, wird ein Editor geöffnet, der eine Feinabstimmung
           der Nachricht ermöglicht.

       bzr Falls der für die Commit-Nachricht benutzte Changelog-Eintrag irgendwelche  Fehler  schließt,  werden
           --fixes-Optionen für »bzr commit« generiert, um die Revision und die Fehler zu verknüpfen.

LIZENZ

       Dieser  Code  unterliegt  dem  Copyright  von  Joey Hess <joeyh@debian.org>, alle Rechte vorbehalten. Für
       dieses Programm besteht KEINERLEI GARANTIE. Es ist Ihnen erlaubt, diesen Code unter den  Bedingungen  der
       GNU General Public License, Version 2 oder später, weiterzugeben.

AUTOR

       Joey Hess <joeyh@debian.org>

SIEHE AUCH

       debchange(1), svnpath(1)

Debian-Hilfswerkzeuge                              2024-09-18                                    DEBCOMMIT.DE(1)