1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
------------------------------------------------------------------------------
Diese Datei beschreibt den Umgang mit dem Subversion Kommandozeilenclient.
------------------------------------------------------------------------------
Gliederung
1. Voraussetzung
1.1 Welche Software brauche ich?
1.2 Dateien im SVN �ndern
1.3 Terminologie
2. Verschiedene Arbeitsabl�ufe (Was will ich machen?)
2.1 Das Repository lokal auf meinem Rechner haben
2.2 Das Repository auf meinem Rechner auf den neuesten Stand bringen
2.3 Dateien im Repository �ndern
2.4 Dem Repository neue Dateien hinzuf�gen
2.5 Dateien im Repository umbenennen
2.6 Dateien aus dem Repository l�schen
2.7 �nderungen ins Repository hochladen
3. Ratschl�ge / �best practice SVN usage�
------------------------------------------------------------------------------
1. Voraussetzung
------------------------------------------------------------------------------
1.1 Welche Software brauche ich?
Ben�tigt wird das Programm subversion f�r die Kommandozeile:
Download: http://svn.tigris.org
Alternativ liegt f�r Windows auch ein komfortabler SVN-Client vor, der sich in die normale Dateiverwaltung integriert:
http://www.tortoisesvn.net/
Die weiteren Erl�uterung beziehen sich auf den Kommandozeilen-Client, k�nnen aber sinngem�� auf einen graphischen Client �bertragen werden.
------------------------------------------------------------------------------
1.2 Dateien im SVN �ndern
Will man auch Dateien im Repostiory �ndern, braucht man einen Schreibzugang mit Namen und Passwort.
? Ben fragen!
Wenn es voraussichtlich bei einer einzigen �nderung bleiben wird, kann alternativ auch auf der Mailingliste Unterst�tzung f�r ein einmaliges �Einchecken� erbeten werden.
------------------------------------------------------------------------------
1.3 Terminologie
$REPOSITORY_HOME � Das Verzeichnis in dem das ausgecheckte Repository liegt
------------------------------------------------------------------------------
2. Was will ich machen?
------------------------------------------------------------------------------
2.1 Das Repository lokal auf meinem Rechner haben
Angenommen ich m�chte Neo in das Verzeichnis �$VERZEICHNIS/$NEO� runterladen:
cd $VERZEICHNIS
svn checkout https://neo.eigenheimstrasse.de/svn $NEO
$REPOSITORY_HOME ist dann $VERZEICHNIS/$NEO
------------------------------------------------------------------------------
2.2 Das Repository auf meinem Rechner auf den neuesten Stand bringen
cd $REPOSITORY_HOME
svn update
------------------------------------------------------------------------------
2.3 Dateien im Repository �ndern
Einfach die Datei �ndern und weiter geht�s mit Abschnitt 2.7.
------------------------------------------------------------------------------
2.4 Dem Repository neue Dateien hinzuf�gen
Nachdem man die Datei in der lokalen Repositorykopie erstellt hat:
svn add $DATEI
weiter mit Abschnitt 2.7
------------------------------------------------------------------------------
2.5 Dateien im Repository umbenennen
svn mv $DATEI_ALT $DATEI_NEU
weiter mit Abschnitt 2.7
------------------------------------------------------------------------------
2.6 Dateien aus dem Repository l�schen
svn rm $DATEI
weiter mit Abschnitt 2.7
------------------------------------------------------------------------------
2.7 �nderungen ins Repository hochladen
cd $REPOSITORY_HOME
svn commit -m "$�NDERUNGSBESCHREIBUNG" --username $USER
Wenn man das Repository mit seinem Nutzernamen ausgecheckt hat,
kann �--username $USER� weggelassen werden.
Statt auschecken wie in Abschnitt 2.1 beschrieben:
cd $VERZEICHNIS_WO_NEO_REIN_SOLL
svn checkout https://$USER@neo.eigenheimstrasse.de/svn neo
------------------------------------------------------------------------------
3. Ratschl�ge / �best practice�
------------------------------------------------------------------------------
In diesem Abschnitt geht es weniger um technische Fragen, sondern eher darum, wie man sinnvoll/empfohlenerweise mit einem SVN arbeiten sollte. Diese Ratschl�ge haben sich in der Praxis als sinnvoll erwiesen:
� Bevor man beginnt, die eigene SVN-Kopie zu bearbeiten, sollte immer erst ein Update durchgef�hrt werden (insbesondere, wenn das letzte Aus-checken schon l�nger her liegt). Dies vermeidet m�gliche Konflikte.
� Es ist vorteilhaft, inhaltlich Zusammengeh�rendes auch gemeinsam zu committen, und Dinge, die voneinander unabh�ngig sind, auch einzeln einzuchecken.
� Die �nderungsbeschreibung sollte immer eingegeben werden und m�glichst genau sein.
� L�ngere �nderungsbeschreibungen sollten mit einer kurzen Zusammenfassung der Form �[Adjektiv] Subjekt Pr�dikat: �� begonnen werden, etwa �Neues Feature: ��, �Caps-Lock-Fehler behoben: ��, �Dokumentation erg�nzt: ��
� Inhaltliche (bzw. �programmiertechnische�) �nderungen (oder Fehlerkorrekturen) sollten unabh�ngig von �sthetischen Korrekturen (wie Einr�ckungen oder der Korrektur von Rechtschreibfehlern) eingecheckt werden. M�gliche �nderungsbeschreibungen w�ren etwa: [Revision 698:] �Doku erweitert: Wie man NEO auf dem C64 installieren kann�, [Revision 699:] �Formatierung korrigiert: Leere Zeilen entfernt, Einr�ckung angeglichen (r698)�
� Gr��ere Commits k�nnen auch aufgeteilt werden, wenn die Intention dazu aus den �nderungsbeschreibungen hervor geht.
� Wenn man Angst um kostbare �nderungen durch einen Headcrash w�hrend einer intensiven Change-Session hat, muss man einen Branch f�r den Zeitraum der �nderungen er�ffnen.
� �nderungen an der Referenz sollten unbedingt vorher auf der Mailingliste besprochen bzw. ausdiskutiert werden. Unwesentliche �nderungen sollten zumindestens auf der Liste erw�hnt werden.
------------------------------------------------------------------------------
|
