BESCHREIBUNG¶
debcommit - übergibt Änderungen an ein Paket
ÜBERSICHT¶
debcommit [
--release] [
--release-use-changelog] [
--message= Text] [
--noact] [
--diff]
[
--confirm] [
--edit] [
--changelog=Pfad]
[
--all |
zu übergebende Dateien]
BESCHREIBUNG¶
debcommit erzeugt, basierend auf neuem Text in
debian/changelog,
eine Übertragungsnachricht 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 kennzeichnen.
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 Übertragungsnachricht, falls es nicht übertragene
Änderungen am Changelog gibt, aus diesen Änderungen abgeleitet,
statt die Standardnachricht zu verwenden.
- -m Text, --message Text
- gibt die Übertragungsnachricht an, die verwendet
werden soll; nützlich, falls das Programm von allein keine auf
debian/changelog basierende Übertragungsnachricht 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 anstelle der Übergabe 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 Zugriffsrechte für die Übergabe haben).
- -C, --confirm
- zeigt die erzeugte Übertragungsnachricht an und
erbittet vor der Übergabe 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 Übertragungsnachricht in Ihrem
Lieblingseditor, bevor sie übergeben wird.
- -a, --all
- übergibt alle Dateien. Dies ist die
Standardtransaktion, wenn ein anderes Versionskontrollsystem als Git
verwendet wird.
- zu übergebende Dateien
- gibt an, welche Dateien übergeben werden sollen
(debian/changelog wird der Liste automatisch hinzugefügt.)
- -s, --strip-message,
--no-strip-message
- Falls diese Option gesetzt ist und die
Übertragungsnachricht 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-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.
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_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.
VCS-SPEZIFISCHE FUNKTIONALITÄTEN¶
- tla / baz
- Falls die Übertragungsnachricht 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 oben beschriebenen Funktionalitäten ist nur anwendbar, falls die
Übertragungsnachricht automatisch aus dem Changelog bestimmt wurde.
- git
- Falls nur eine einzelne Zeichenkette 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 verkürzt, um
eine Zusammenfassungszeile und damit eine Übertragungsnachricht,
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 der Übergabe 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 Übertragungsnachricht 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 neuer, weitergeben.
AUTOR¶
Joey Hess <joeyh@debian.org>
SIEHE AUCH¶
svnpath(1)