Git:git send-email - Versionsgeschichte

Tijuca: /* statische Einträge in der Konfigdatei von Git */ TLS für SMTP ist besser als Plain :)

2012-12-22T20:54:12Z

statische Einträge in der Konfigdatei von Git: TLS für SMTP ist besser als Plain :)

← Nächstältere Version		Version vom 22. Dezember 2012, 22:54 Uhr
Zeile 65:		Zeile 65:
	to = ml_neutron@projekt.com		to = ml_neutron@projekt.com
	from = "<Euer Name>"		from = "<Euer Name>"
	smtpserver = ~~smtpmail~~.t-online.de		smtpencryption = tls
	smtpserverport = 25		smtpserver = securesmtp.t-online.de
			smtpserverport = 587
	smtpuser = <Benutzer> # alles vor @t-online.de , nicht die komplette E-Mailadresse!!!		smtpuser = <Benutzer> # alles vor @t-online.de , nicht die komplette E-Mailadresse!!!
	smtppass = <Passwort>		smtppass = <Passwort>

Tijuca: /* Quellen */ Link aktualisiert

2012-06-11T06:58:22Z

Quellen: Link aktualisiert

← Nächstältere Version		Version vom 11. Juni 2012, 08:58 Uhr
Zeile 129:		Zeile 129:
	* [http://www.kernel.org/pub/software/scm/git/docs/git-send-email.html git-send-email Doku auf kernel.org]		* [http://www.kernel.org/pub/software/scm/git/docs/git-send-email.html git-send-email Doku auf kernel.org]
	* [http://linux.yyz.us/patch-format.html Mail-/Patchformat für das Übersenden eines Patches an die Kernel Mailingliste]		* [http://linux.yyz.us/patch-format.html Mail-/Patchformat für das Übersenden eines Patches an die Kernel Mailingliste]
	* [http://~~appletree~~.or.kr/~~quick_reference_cards~~/~~cvs-subversion-git~~/git-cheat-sheet~~-large~~.~~png~~ Git Cheat-Sheet ~~(groß)~~]		* [http://zrusin.blogspot.de/2007/09/git-cheat-sheet.html Git Cheat-Sheet]

Tijuca: /* Tips */ Hinzufügen Hinweis für weitere Patchversionen

2012-03-20T12:34:21Z

Tips: Hinzufügen Hinweis für weitere Patchversionen

← Nächstältere Version		Version vom 20. März 2012, 14:34 Uhr
Zeile 121:		Zeile 121:
	15 <span style="background-color:lightgreen"> </span>		15 <span style="background-color:lightgreen"> </span>
	16 <span style="background-color:lightgreen"><gerne auch mit mehreren Absätzen></span>		16 <span style="background-color:lightgreen"><gerne auch mit mehreren Absätzen></span>
			* Macht neuere Versionen eines/mehrerer Patches kenntlich!
			*: Es ist keine Schande neuere Versionen eines Patches zu schicken. Schlieslich kann ja noch nachträglich etwas aufgefallen sein was eine weitere Version eines Patches nötig machte. Allerdings sollten die Teammitglieder sofort erkennen das es sich um eine neuere Version handelt. Beim Erstellen des Patches kann dies mit <code>git format-patch --subject-prefix="PATCH v[x]"</code> erreicht werden.
			*: In der Mail sollte ein "Changelog" zu finden sein worin steht was sich gegenüber der Vorgängerversion des Patches geändert hat. Weitere Hinweise sind unter [http://www.denx.de/wiki/view/U-Boot/Patches#Sending_updated_patch_versions] zu finden.

	==Quellen==		==Quellen==

Tijuca: /* Quellen */ Git Cheat Sheet hinzugefügt

2011-09-10T08:34:02Z

Quellen: Git Cheat Sheet hinzugefügt

← Nächstältere Version		Version vom 10. September 2011, 10:34 Uhr
Zeile 126:		Zeile 126:
	* [http://www.kernel.org/pub/software/scm/git/docs/git-send-email.html git-send-email Doku auf kernel.org]		* [http://www.kernel.org/pub/software/scm/git/docs/git-send-email.html git-send-email Doku auf kernel.org]
	* [http://linux.yyz.us/patch-format.html Mail-/Patchformat für das Übersenden eines Patches an die Kernel Mailingliste]		* [http://linux.yyz.us/patch-format.html Mail-/Patchformat für das Übersenden eines Patches an die Kernel Mailingliste]
			* [http://appletree.or.kr/quick_reference_cards/cvs-subversion-git/git-cheat-sheet-large.png Git Cheat-Sheet (groß)]

Tijuca: alternativer Editor verlinkt

2011-08-21T18:16:33Z

alternativer Editor verlinkt

← Nächstältere Version		Version vom 21. August 2011, 20:16 Uhr
Zeile 104:		Zeile 104:
	*: Ein Beispiel:		*: Ein Beispiel:
	$ git send-email 000*.patch --compose		$ git send-email 000*.patch --compose
	:: Es öffnet sich der verknüpfte Editor zum Arbeiten mit git. Zu sehen sind ein paar Erläuterungen und Hilfestellungen und das Grundgerüst für die erste Mail. (Hinweis: <span style="background-color:lightgreen"><Hier müsst Ihr was eintragen></span> <span style="background-color:lightblue"><Hier hat Git schon etwas eingetragen></span>)		:: Es öffnet sich der verknüpfte Editor (siehe auch [[Git:git_alternativer_Editor\|alternativer Editor]]) zum Arbeiten mit git. Zu sehen sind ein paar Erläuterungen und Hilfestellungen und das Grundgerüst für die erste Mail. (Hinweis: <span style="background-color:lightgreen"><Hier müsst Ihr was eintragen></span> <span style="background-color:lightblue"><Hier hat Git schon etwas eingetragen></span>)
	1 From <span style="background-color:lightblue"><Euer Name></span> # This line is ignored.		1 From <span style="background-color:lightblue"><Euer Name></span> # This line is ignored.
	2 GIT: Lines beginning in "GIT:" will be removed.		2 GIT: Lines beginning in "GIT:" will be removed.

Tijuca: git send-email als eigenständiger Artikel

2011-08-21T18:10:28Z

git send-email als eigenständiger Artikel

Neue Seite

[[Category:Git]]
__TOC__

==Patch(es) mit Git versenden==
Git kann ohne extra Aufruf eines Mailprogrammes Patches versenden. Dazu dient der Befehl <code>git send-email [Parameter]</code>. Dies ist sehr praktisch da man nicht extra einen Mailclient öffnen muss oder kann (z.B. wenn man Remote auf einem PC/Server arbeitet). Voraussetzung ist natürlich das der PC einen Zugang zum Internet hat. In größeren Projekten ist das der übliche Weg und einzig akzeptierte Weg um seine Veränderungsvorschläge zu publizieren.

===Paketabhängigkeiten===
<code>git send-email</code> benötigt zusätzliche Software die eventuell nicht automatisch durch die Paketverwaltungssoftware aufgelöst wird. Benötigt wird ein MTA ([http://de.wikipedia.org/wiki/Mail_Transfer_Agent Mail Transfer Agent]). Da stehen dann mehrere zur Auswahl (Postfix, Sendmail, Exim, ...). Benutzt den mit dem Ihr gegebenenfalls schon arbeitet oder installiert den favorisierten MTA nach.
 
<div style="padding:0.5em; margin-bottom:1em; border: 2px solid #a00;">[[Bild:Stop hand.png]] '''Debian:'''
Optional nachinstallieren falls nicht schon ein MTA installiert ist
<source lang="bash">
$ sudo apt-get install <Euer favorisierter MTA> # nur einen dieser installieren! sendmail, postfix oder exim
</source>
Zusätzlich müssen folgende Pakete nachinstalliert werden:
<source lang="bash">
$ sudo apt-get install git-email libnet-smtp-ssl-perl libauthen-sasl-perl\
libnet-perl libio-socket-ssl-perl libmime-tools-perl
</source>
</div>
 
<div style="padding:0.5em; margin-bottom:1em; border: 2px solid #a00;">[[Bild:Stop hand.png]] '''Suse:'''
<source lang="bash">
wenn jemand weiß was hier anzugeben ist ...
</source>
</div>

===manuelle Vorgehensweise===
Zum Testen oder gezielten Übergehen von Einstellungen kann man alle Parameter des Git Befehls von Hand angeben. Damit git einen oder mehrere Patches versenden kann müssen die Parameter für den E-Mail Versand angebenden werden. 
<code>git send-email</code>
# <code><Patch></code>
# <code>--from <Name></code> am besten mir Realname, Nickname ist nicht überall gerne gesehen (optional)
# <code>--to <E-Mail Adresse></code> Zieladresse, z.B. eine Mailingliste
# <code>--smtp-server <Server Adresse></code> die SMTP Serveradresse deines Providers
# <code>--smtp-server-port <Portadresse></code> der Zielport vom SMTP Server
# <code>--smtp-user <Benutzer></code> ohne @TLD!
# <code>--smpt-pass <Passwort></code> Dein Passwort bei Deinem Emailprovider
# <code>--smtp-encyption=<Encryption></code> in Kleinbuchstaben
Beispiel für GMail:
<source lang="bash">
$ git send-email 0001-ChangeLog-adding-entry.patch --to ml_neutron@projekt.com --from "Karl Klammer" \
--smtp-server smtp.gmail.com --smtp-server-port 587 --smtp-user karl.klammer \
--smtp-pass super_geheim --smtp-encryption=tls
</source>

===statische Einträge in der Konfigdatei von Git===
Man kann alles diese Angaben in die Konfigdatei <code>.git/config</code> eintragen. Damit minimiert sich der Aufruf des Git Befehls auf <code>git send-email <Patch></code>.
Wenn man Patche z.B. immer an die selbe Adresse verschickt (z.B. an eine Mailingliste) dann empfiehlt es sich die nötigen Parameter in die Konfigdatei des Projektes einzutragen.

z.B. für GMail:
<source lang="bash">
[sendemail]
to = ml_neutron@projekt.com
from = "<Euer Name>"
smtpencryption = tls
smtpserver = smtp.gmail.com
smtpserverport = 587
smtpuser = <Benutzer> # alles vor @gmail.com , nicht die komplette E-Mailadresse!!!
smtppass = <Passwort>
confirm = never
</source>
und für T-Online:
<source lang="bash">
[sendemail]
to = ml_neutron@projekt.com
from = "<Euer Name>"
smtpserver = smtpmail.t-online.de
smtpserverport = 25
smtpuser = <Benutzer> # alles vor @t-online.de , nicht die komplette E-Mailadresse!!!
smtppass = <Passwort>
confirm = never
</source>

===Probleme===
Sollten Ihr beim Versenden per <code>git send-email</code> folgende Fehlermeldung erhalten:
<source lang="bash">
...
X-Mailer: git-send-email 1.7.2.5

Result: 250 2.0.0 Message accepted.

In git 1.7.0, the default has changed to --no-chain-reply-to
Set sendemail.chainreplyto configuration variable to true if
you want to keep --chain-reply-to as your default.
</source>
Dann könnt Ihr mit <code>git config sendemail.chainreplyto false</code> folgenden Eintrag zu <code>.git/config</code> hinzufügen.
<source lang="bash">
[sendemail]
...
chainreplyto = false
...
</source>
Damit weiß Git bei jedem Benutzen von <code>git send-email</code> das nicht "in Reply to" erfolgt. Dies ist immer dann der Fall wenn man einen Patch das erste Mal an einen Empfänger sendet. Das Gegenteil tritt natürlich dann ein wenn Ihr auf einen Patch mit einer anderen Version antwortet. Dies dürfte aber relativ selten vorkommen und kann dann wieder explizit beim Aufruf von <code>git send-email</code> mit <code>--chain-reply-to <ID/Betreff der Mail></code> angegeben werden.

===Tips===
* Bevor Ihr Patches an eine Mailingliste verschicken wollt prüft zuvor ob alles "perfekt" ist.
*: Je nach Größe der Teilnehmer auf einer Mailingliste kann es etwas anstrengend sein, allen begreiflich zu machen das der oder die Patche doch nicht richtig waren. Dies könnt Ihr recht einfach prüfen indem Ihr eben nicht an die ML verschickt sondern an Euch selbst. (Mit der Option <code>--to adresse@provider.tld</code> könnt Ihr den Eintrag in der .git/config übergehen oder man richtet sich einen Alias ein der einem die viele Tipparbeit abnimmt.)
* Jeder Patch sollte ein "signed-off" besitzen!
*: Damit kann man später immer noch herausfinden von wem der ursprüngliche Patch/Code/Gedanke war. Bedenkt das Git ein dezentrales Versionsverwaltungssystem ist und nicht jeder der etwas zu einem Projekt beitragen will muss automatisch CheckIn Berechtigungen zu einem Repository besitzen.
* Jeder weitergeleitete und schon geprüfte Patch kann zusätzlich ein "signed-off-by-cc" beinhalten.
*: Wenn der Ersteller des Patches diesen nicht mit Git erstellt hat oder kann kann man auch noch ein "reported-by" hinzufügen. Damit wissen die Developer das dieser Patch schon geprüft ist und können diesen in der Regel direkt ins Repo commiten.
* Nur ein Patch pro Mail!
*: Sendet pro Mail nur einen Patch, dies erleichtert die Arbeit derer die diese Patche commiten. Wollt Ihr mehrere Patche versenden benutzt z.B. ein Shellscript was pro Patch <code>git send-email</code> aufruft. Einfacher ist jedoch der Parameter <code>--compose</code>. Mit diesem kann man eine "einleitende" Mail verfassen (dies ist aber auf der Kernelmailingliste z.B. verpönt, also vorher prüfen ob das erwünscht ist). Wenn Ihr mehrere Patche habt die thematisch zusammen gehören dann solltet Ihr diese dann damit kombinieren.
*: Ein Beispiel:
$ git send-email 000*.patch --compose
:: Es öffnet sich der verknüpfte Editor zum Arbeiten mit git. Zu sehen sind ein paar Erläuterungen und Hilfestellungen und das Grundgerüst für die erste Mail. (Hinweis: <Hier müsst Ihr was eintragen> <Hier hat Git schon etwas eingetragen>)
1 From <Euer Name> # This line is ignored.
2 GIT: Lines beginning in "GIT:" will be removed.
3 GIT: Consider including an overall diffstat or table of contents
4 GIT: for the patch you are writing.
5 GIT:
6 GIT: Clear the body content if you don't wish to send a summary.
7 From: <Euer Name>
8 Subject: <Hier kommt der Betreff für die "einleitende" Mail hin>
9 In-Reply-To:
10
11 GIT: [PATCH 1/2] libcoolstream-mt: Modified BS to use the libcoolstream-mt
12 GIT: [PATCH 2/2] beta-2.6.26.8-nevis: new drivers required by libcoolstream-mt
13 <hier kommt der Text der Mail hin>
14 <es darf ruhig etwas ausführlicher erklärt werden um was es geht>
15 
16 <gerne auch mit mehreren Absätzen>

==Quellen==
* [https://git.wiki.kernel.org/index.php/GitTips#Using_gmail_to_send_your_patches GMail Einstellung für git-send-patch]
* [http://www.kernel.org/pub/software/scm/git/docs/git-send-email.html git-send-email Doku auf kernel.org]
* [http://linux.yyz.us/patch-format.html Mail-/Patchformat für das Übersenden eines Patches an die Kernel Mailingliste]