Changeset 894
- Timestamp:
- 09/16/08 13:02:52 (5 years ago)
- Files:
-
- 1 modified
-
Subversion-Anleitung.txt (modified) (8 diffs)
Legend:
- Unmodified
- Added
- Removed
-
Subversion-Anleitung.txt
r882 r894 1 ------------------------------------------------------------------------------1 ------------------------------------------------------------------------------ 2 2 Diese Datei beschreibt den Umgang mit dem Subversion Kommandozeilenclient. 3 3 ------------------------------------------------------------------------------ … … 5 5 1. Voraussetzung 6 6 1.1 Welche Software brauche ich? 7 1.2 Dateien im SVN �ndern7 1.2 Dateien im SVN ändern 8 8 1.3 Terminologie 9 2. Verschiedene Arbeitsabl �ufe (Was will ich machen?)9 2. Verschiedene Arbeitsabläufe (Was will ich machen?) 10 10 2.1 Das Repository lokal auf meinem Rechner haben 11 11 2.2 Das Repository auf meinem Rechner auf den neuesten Stand bringen 12 2.3 Dateien im Repository �ndern13 2.4 Dem Repository neue Dateien hinzuf �gen12 2.3 Dateien im Repository ändern 13 2.4 Dem Repository neue Dateien hinzufügen 14 14 2.5 Dateien im Repository umbenennen 15 2.6 Dateien aus dem Repository l �schen16 2.7 �nderungen ins Repository hochladen17 3. Ratschl �ge / �best practice SVN usage�15 2.6 Dateien aus dem Repository löschen 16 2.7 Änderungen ins Repository hochladen 17 3. Ratschläge / »best practice SVN usage« 18 18 ------------------------------------------------------------------------------ 19 19 1. Voraussetzung … … 21 21 1.1 Welche Software brauche ich? 22 22 23 Ben �tigt wird das Programm subversion f�r die Kommandozeile:23 Benötigt wird das Programm subversion für die Kommandozeile: 24 24 Download: http://svn.tigris.org 25 25 26 Alternativ liegt f �r Windows auch ein komfortabler SVN-Client vor, der sich in die normale Dateiverwaltung integriert:26 Alternativ liegt für Windows auch ein komfortabler SVN-Client vor, der sich in die normale Dateiverwaltung integriert: 27 27 http://www.tortoisesvn.net/ 28 28 29 Die weiteren Erl �uterung beziehen sich auf den Kommandozeilen-Client, k�nnen aber sinngem�� auf einen graphischen Client �bertragen werden.29 Die weiteren Erläuterung beziehen sich auf den Kommandozeilen-Client, können aber sinngemäß auf einen graphischen Client übertragen werden. 30 30 31 31 ------------------------------------------------------------------------------ 32 1.2 Dateien im SVN �ndern32 1.2 Dateien im SVN ändern 33 33 34 Will man auch Dateien im Repostiory �ndern, braucht man einen Schreibzugang mit Namen und Passwort.34 Will man auch Dateien im Repostiory ändern, braucht man einen Schreibzugang mit Namen und Passwort. 35 35 ? Ben fragen! 36 Wenn es voraussichtlich bei einer einzigen �nderung bleiben wird, kann alternativ auch auf der Mailingliste Unterst�tzung f�r ein einmaliges �Einchecken�erbeten werden.36 Wenn es voraussichtlich bei einer einzigen Änderung bleiben wird, kann alternativ auch auf der Mailingliste Unterstützung für ein einmaliges »Einchecken« erbeten werden. 37 37 38 38 ------------------------------------------------------------------------------ 39 39 1.3 Terminologie 40 40 41 $REPOSITORY_HOME � Das Verzeichnis in dem das ausgecheckte Repository liegt 41 $REPOSITORY_HOME 42 Das Verzeichnis in dem das ausgecheckte Repository liegt 42 43 43 44 ------------------------------------------------------------------------------ … … 46 47 2.1 Das Repository lokal auf meinem Rechner haben 47 48 48 Angenommen ich m �chte Neo in das Verzeichnis �$VERZEICHNIS/$NEO�runterladen:49 Angenommen ich möchte Neo in das Verzeichnis $VERZEICHNIS/$NEO runterladen: 49 50 50 51 cd $VERZEICHNIS … … 60 61 61 62 ------------------------------------------------------------------------------ 62 2.3 Dateien im Repository �ndern63 2.3 Dateien im Repository ändern 63 64 64 Einfach die Datei �ndern und weiter geht�s mit Abschnitt 2.7.65 Einfach die Datei ändern und weiter gehts mit Abschnitt 2.7. 65 66 66 67 ------------------------------------------------------------------------------ 67 2.4 Dem Repository neue Dateien hinzuf �gen68 2.4 Dem Repository neue Dateien hinzufügen 68 69 69 70 Nachdem man die Datei in der lokalen Repositorykopie erstellt hat: … … 78 79 79 80 ------------------------------------------------------------------------------ 80 2.6 Dateien aus dem Repository l �schen81 2.6 Dateien aus dem Repository löschen 81 82 82 83 svn rm $DATEI … … 84 85 85 86 ------------------------------------------------------------------------------ 86 2.7 �nderungen ins Repository hochladen87 2.7 Änderungen ins Repository hochladen 87 88 88 89 cd $REPOSITORY_HOME 89 svn commit -m "$ �NDERUNGSBESCHREIBUNG" --username $USER90 svn commit -m "$ÄNDERUNGSBESCHREIBUNG" --username $USER 90 91 91 92 Wenn man das Repository mit seinem Nutzernamen ausgecheckt hat, 92 kann �--username $USER�weggelassen werden.93 kann --username $USER weggelassen werden. 93 94 Statt auschecken wie in Abschnitt 2.1 beschrieben: 94 95 cd $VERZEICHNIS_WO_NEO_REIN_SOLL … … 96 97 97 98 ------------------------------------------------------------------------------ 98 3. Ratschl �ge / �best practice�99 3. Ratschläge / »best practice« 99 100 ------------------------------------------------------------------------------ 100 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:101 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: 101 102 102 � 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.103 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. 103 104 104 � Es ist vorteilhaft, inhaltlich Zusammengeh�rendes auch gemeinsam zu committen, und Dinge, die voneinander unabh�ngig sind, auch einzeln einzuchecken.105 Es ist vorteilhaft, inhaltlich Zusammengehörendes auch gemeinsam zu committen, und Dinge, die voneinander unabhängig sind, auch einzeln einzuchecken. 105 106 106 � Die �nderungsbeschreibung sollte immer eingegeben werden und m�glichst genau sein.107 Die Änderungsbeschreibung sollte immer eingegeben werden und möglichst genau sein. 107 108 108 � 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: �� 109 Längere Änderungsbeschreibungen sollten mit einer kurzen Zusammenfassung der Form »[Adjektiv] Subjekt Prädikat: 110 « begonnen werden, etwa »Neues Feature: 111 «, »Caps-Lock-Fehler behoben: 112 «, »Dokumentation ergänzt: 113 « 109 114 110 � 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)� 115 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)« 111 116 112 � Gr��ere Commits k�nnen auch aufgeteilt werden, wenn die Intention dazu aus den �nderungsbeschreibungen hervor geht.117 Größere Commits können auch aufgeteilt werden, wenn die Intention dazu aus den Änderungsbeschreibungen hervor geht. 113 118 114 � 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.119 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. 115 120 116 � �nderungen an der Referenz sollten unbedingt vorher auf der Mailingliste besprochen bzw. ausdiskutiert werden. Unwesentliche �nderungen sollten zumindestens auf der Liste erw�hnt werden.121 Änderungen an der Referenz sollten unbedingt vorher auf der Mailingliste besprochen bzw. ausdiskutiert werden. Unwesentliche Änderungen sollten zumindestens auf der Liste erwähnt werden. 117 122 ------------------------------------------------------------------------------ 118 123
