Týndur/Entwicklung — Änderungen 5609 → 5614

Zeile 75: Zeile 75:
  
 
=== Commit erstellen ===
 
=== Commit erstellen ===
−
Nun muss erstmal ein Commit erstellt werden. Dazu nutzt man git add:
+
Nun muss erstmal ein Commit erstellt werden.Dazu nutzt man git add:
  
 
<code>
 
<code>
Zeile 91: Zeile 91:
 
* 1. Zeile ist der E-Mail-Betreff
 
* 1. Zeile ist der E-Mail-Betreff
 
* 2. Zeile leer lassen
 
* 2. Zeile leer lassen
−
* 3. Zeile Kurze Erläuterung zum Patch
+
* Änderungen angeben
−
* Neuer Absatz
 
−
* Änderung angeben
 
  
 
Die Änderung wird nach folgendem Schema angegeben:
 
Die Änderung wird nach folgendem Schema angegeben:
Zeile 102: Zeile 100:
  
 
Nun eine neue Zeile einfügen und speichern. Der Commit wurde jetzt erstellt.
 
Nun eine neue Zeile einfügen und speichern. Der Commit wurde jetzt erstellt.
 +
 +
Beim Committen bitte darauf achten, dass aus einer logischen Änderung genau ein Commit (und damit später genau ein Patch) wird. Wenn Du also an zwei verschiedenen Baustellen gearbeitet hast, füg zunächst alle Änderungen, die zur ersten gehören, mit git add hinzu, mache einen Commit und wiederhole das ganze für den zweiten Teil.
  
  
Zeile 111: Zeile 111:
 
</code>
 
</code>
  
−
Das -1 gibt an, der wie vielte Patch einer Patch-Reihe das ist, also in dem Fall 1.
+
Das -1 gibt an, wie viele Patches zu der Patchserie gehören sollten, die exportiert werden soll. Das ist also in diesem Fall genau einer. Wenn es mehrere sind, kann man noch --cover-letter angeben, die einen [PATCH 0/n] erstellt, in dem üblicherweise der grobe Überblick über die ganze Serie gegeben wird.
  
 
Jetzt wird der Patch an die Mailingliste gesendet:
 
Jetzt wird der Patch an die Mailingliste gesendet:
Zeile 121: Zeile 121:
 
Zur Erläuterung:
 
Zur Erläuterung:
  
−
* 000x-name-des-patches.patch ist der per git format-patch erstelle Patch. x steht dabei für den wievielten Patch, in unserem Fall 1, name-des-patches ist bei git commit angegebene Betreffzeile (Leerstellen wurden durch Bindestriche ersetzt)
+
* 000x-name-des-patches.patch ist der per git format-patch erstelle Patch. x steht dabei für den wievielten Patch, in unserem Fall 1, name-des-patches ist bei git commit angegebene Betreffzeile (Leerstellen wurden durch Bindestriche ersetzt). Bei einer Patchserie werden alle Patches auf einmal angegeben, am einfachsten über 00*.patch.
 
* Bei --smtp-server musst der SMTP-Server des E-Mail-Providers angegeben werden
 
* Bei --smtp-server musst der SMTP-Server des E-Mail-Providers angegeben werden
 
* Bei --smtp-user der Username
 
* Bei --smtp-user der Username
 
* Bei --smtp-pass das Passwort
 
* Bei --smtp-pass das Passwort
 +
* Die Einstellungen können auch in der git-Konfigurationsdatei gemacht werden, siehe git-send-email --help
  
 
Sollte dies nicht funktionieren, dann kann man den Mailserver auch weglassen. Git versendet die E-Mail dann über einen eigenen Mailserver und trägt nur die Adresse des Entwicklers als Absender ein:
 
Sollte dies nicht funktionieren, dann kann man den Mailserver auch weglassen. Git versendet die E-Mail dann über einen eigenen Mailserver und trägt nur die Adresse des Entwicklers als Absender ein:
Zeile 134: Zeile 135:
 
Im nun folgendem Dialog wird gefragt, von woher die E-Mail kommen soll, sofern keine Änderung gewünscht ist einfach Enter drücken, dann wird nach der ID der Mail gefragt, auf die geantwortet werden soll - im Normalfall auch hier einfach Enter drücken. Wenn alles geklappt hat ist der Patch nun auf der Mailingliste angekommen (sofern man nicht die Anmeldung auf selbiger vergessen hat).
 
Im nun folgendem Dialog wird gefragt, von woher die E-Mail kommen soll, sofern keine Änderung gewünscht ist einfach Enter drücken, dann wird nach der ID der Mail gefragt, auf die geantwortet werden soll - im Normalfall auch hier einfach Enter drücken. Wenn alles geklappt hat ist der Patch nun auf der Mailingliste angekommen (sofern man nicht die Anmeldung auf selbiger vergessen hat).
  
−
Wenn nun von [[Benutzer:taljeth|taljeth]] oder [[Benutzer:FreakyPenguin|FreakyPenguin]] ein sogenanntes "Acked-by" an die Mailingliste gesendet wird, wurde der Patch akzeptiert und landet im Repository.
+
Der Patch muss dann zunächst auf der Mailingliste korrekturgelesen ("gereviewt") werden, bevor er von Leuten mit Commitrechten in das Repository eingepflegt wird. Wenn Du beim Korrekturlesen helfen willst, kann Du auf einen Patch entweder mit einer Zeile wie <i>Acked-by: Max Mustermann <max@mustermann.de></i> als korrekt bestätigen oder aber Deine Kritikpunkte zitieren und kommentieren.
  
 
== Siehe auch ==
 
== Siehe auch ==