.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" ======================================================================== .\" .IX Title "DEBCOMMIT.DE 1" .TH DEBCOMMIT.DE 1 "2013-12-23" "Debian-Hilfswerkzeuge" " " .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "BESCHREIBUNG" .IX Header "BESCHREIBUNG" debcommit \- übergibt Änderungen an ein Paket .SH "ÜBERSICHT" .IX Header "ÜBERSICHT" \&\fBdebcommit\fR [\fB\-\-release\fR] [\fB\-\-release\-use\-changelog\fR] [\fB\-\-message=\fR\fIText\fR] [\fB\-\-noact\fR] [\fB\-\-diff\fR] [\fB\-\-confirm\fR] [\fB\-\-edit\fR] [\fB\-\-changelog=\fR\fIPfad\fR] [\fB\-\-all\fR | \fIzu übergebende Dateien\fR] .SH "BESCHREIBUNG" .IX Header "BESCHREIBUNG" \&\fBdebcommit\fR erzeugt, basierend auf neuem Text in \fBdebian/changelog\fR, 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: \fBcvs\fR, \fBgit\fR, \&\fBhg\fR (Mercurial), \fBsvk\fR, \fBsvn\fR (Subversion), \fBbaz\fR, \fBbzr\fR, \fBtla\fR (Arch), \fBdarcs\fR. .SH "OPTIONEN" .IX Header "OPTIONEN" .IP "\fB\-c\fR, \fB\-\-changelog\fR \fIPfad\fR" 4 .IX Item "-c, --changelog Pfad" gibt einen alternativen Speicherplatz für das Changelog an. Standardmäßig wird debian/changelog benutzt. .IP "\fB\-r\fR, \fB\-\-release\fR" 4 .IX Item "-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. .Sp Beachten Sie, das svn\-/svk\-Markierungskonventionen variieren, weswegen Debcommit \fIsvnpath\fR\|(1) verwendet, um zu bestimmen, wo die Markierung im Depot platziert werden soll. .IP "\fB\-R\fR, \fB\-\-release\-use\-changelog\fR" 4 .IX Item "-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. .IP "\fB\-m\fR \fIText\fR, \fB\-\-message\fR \fIText\fR" 4 .IX Item "-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 .IP "\fB\-n\fR, \fB\-\-noact\fR" 4 .IX Item "-n, --noact" tut tatsächlich nichts, gibt aber die Befehle aus, die ausgeführt würden. .IP "\fB\-d\fR, \fB\-\-diff\fR" 4 .IX Item "-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). .IP "\fB\-C\fR, \fB\-\-confirm\fR" 4 .IX Item "-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. .IP "\fB\-e\fR, \fB\-\-edit\fR" 4 .IX Item "-e, --edit" bearbeitet die erzeugte Übertragungsnachricht in Ihrem Lieblingseditor, bevor sie übergeben wird. .IP "\fB\-a\fR, \fB\-\-all\fR" 4 .IX Item "-a, --all" übergibt alle Dateien. Dies ist die Standardtransaktion, wenn ein anderes Versionskontrollsystem als Git verwendet wird. .IP "\fIzu übergebende Dateien\fR" 4 .IX Item "zu übergebende Dateien" gibt an, welche Dateien übergeben werden sollen (debian/changelog wird der Liste automatisch hinzugefügt.) .IP "\fB\-s\fR, \fB\-\-strip\-message\fR, \fB\-\-no\-strip\-message\fR" 4 .IX Item "-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. .Sp Diese Option ist standardmäßig gesetzt und wird ignoriert, falls mehr als eine Zeile der Nachricht mit »[*+\-] « beginnt. .IP "\fB\-\-sign\-tags\fR, \fB\-\-no\-sign\-tags\fR" 4 .IX Item "--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. .SH "KONFIGURATIONSVARIABLEN" .IX Header "KONFIGURATIONSVARIABLEN" Die beiden Konfigurationsdateien \fI/etc/devscripts.conf\fR und \&\fI~/.devscripts\fR 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: .IP "\fB\s-1DEBCOMMIT_STRIP_MESSAGE\s0\fR" 4 .IX Item "DEBCOMMIT_STRIP_MESSAGE" Falls dies auf \fIno\fR gesetzt ist, dann entspricht das der Verwendung des Befehlszeilenparameters \-\-no\-strip\-message. Die Vorgabe ist \fIyes\fR. .IP "\fB\s-1DEBCOMMIT_SIGN_TAGS\s0\fR" 4 .IX Item "DEBCOMMIT_SIGN_TAGS" Falls dies auf \fIyes\fR gesetzt ist, ist es so, als ob der Befehlszeilenparameter \-\-sign\-tags benutzt würde. Die Vorgabe ist \fIno\fR. .IP "\fB\s-1DEBCOMMIT_RELEASE_USE_CHANGELOG\s0\fR" 4 .IX Item "DEBCOMMIT_RELEASE_USE_CHANGELOG" Falls dies auf \fIyes\fR gesetzt ist, ist es so, als ob der Befehlszeilenparameter \-\-release\-use\-changelog benutzt würde. Die Vorgabe ist \fIno\fR. .IP "\fB\s-1DEBSIGN_KEYID\s0\fR" 4 .IX Item "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. .SH "VCS-SPEZIFISCHE FUNKTIONALITÄTEN" .IX Header "VCS-SPEZIFISCHE FUNKTIONALITÄTEN" .IP "\fBtla\fR / \fBbaz\fR" 4 .IX Item "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. .PP Jede der oben beschriebenen Funktionalitäten ist nur anwendbar, falls die Übertragungsnachricht automatisch aus dem Changelog bestimmt wurde. .IP "\fBgit\fR" 4 .IX Item "git" Falls nur eine einzelne Zeichenkette im Changelog entdeckt wird, wird \&\fBdebcommit\fR sie in eine einzelne Zeile entfalten und sich so verhalten, als ob \-\-strip\-message benutzt worden wäre. .Sp 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. \fBdebcommit\fR wird dann einen Editor öffnen, so dass die Nachricht vor der Übergabe abgestimmt werden kann. .IP "\fBhg\fR / \fBdarcs\fR" 4 .IX Item "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. .IP "\fBbzr\fR" 4 .IX Item "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. .SH "LIZENZ" .IX Header "LIZENZ" Dieser Code unterliegt dem Copyright von Joey Hess , alle Rechte vorbehalten. Für dieses Programm besteht \s-1KEINERLEI\s0 \s-1GARANTIE\s0. Es ist Ihnen erlaubt, diesen Code unter den Bedingungen der \s-1GNU\s0 General Public License, Version 2 oder neuer, weitergeben. .SH "AUTOR" .IX Header "AUTOR" Joey Hess .SH "SIEHE AUCH" .IX Header "SIEHE AUCH" \&\fIsvnpath\fR\|(1)