From c63134e1ac0522b643dffd4c71bcff2b27eab30d Mon Sep 17 00:00:00 2001 From: martin_r Date: Mon, 18 Aug 2008 19:25:20 +0000 Subject: Modularisierung des AHK konsequent weitergeführt. neo20.txt: Ebenen 7 und 8 ergänzt, Ebenen 2 und 4 des Numpads vertauscht. Methods-Layers.ahk: Mod3-Lock abgeschafft, CapsLock neu geschrieben. + Viele kleine Änderungen. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit git-svn-id: https://svn.neo-layout.org@776 b9310e46-f624-0410-8ea1-cfbb3a30dc96 --- Subversion-Anleitung.txt | 68 ++++++++++++++++++++++++------------------------ 1 file changed, 34 insertions(+), 34 deletions(-) (limited to 'Subversion-Anleitung.txt') diff --git a/Subversion-Anleitung.txt b/Subversion-Anleitung.txt index 97b8584..15f4663 100644 --- a/Subversion-Anleitung.txt +++ b/Subversion-Anleitung.txt @@ -1,51 +1,51 @@ ------------------------------------------------------------------------------- +------------------------------------------------------------------------------ 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.2 Dateien im SVN ändern 1.3 Terminologie -2. Verschiedene Arbeitsabläufe (Was will ich machen?) +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.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« +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: +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: +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. +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 +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 vorrausÅ¿ichtlich bei einer einzigen Änderung bleiben wird, kann alternativ auch auf der Mailingliste Unterstützung für ein einmaliges »Einchecken« erbeten werden. +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 +$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: +Angenommen ich möchte Neo in das Verzeichnis „$VERZEICHNIS/$NEO“ runterladen: cd $VERZEICHNIS svn checkout https://neo.eigenheimstrasse.de/svn $NEO @@ -59,12 +59,12 @@ $REPOSITORY_HOME ist dann $VERZEICHNIS/$NEO svn update ------------------------------------------------------------------------------ -2.3 Dateien im Repository ändern +2.3 Dateien im Repository ändern -Einfach die Datei ändern und weiter gehts mit Abschnitt 2.7. +Einfach die Datei ändern und weiter geht’s mit Abschnitt 2.7. ------------------------------------------------------------------------------ -2.4 Dem Repository neue Dateien hinzufügen +2.4 Dem Repository neue Dateien hinzufügen Nachdem man die Datei in der lokalen Repositorykopie erstellt hat: svn add $DATEI @@ -77,35 +77,35 @@ weiter mit Abschnitt 2.7 weiter mit Abschnitt 2.7 ------------------------------------------------------------------------------ -2.6 Dateien aus dem Repository löschen +2.6 Dateien aus dem Repository löschen svn rm $DATEI weiter mit Abschnitt 2.7 ------------------------------------------------------------------------------ -2.7 Änderungen ins Repository hochladen +2.7 Änderungen ins Repository hochladen cd $REPOSITORY_HOME - svn commit -m "$ÄNDERUNGSBESCHREIBUNG" --username $USER + svn commit -m "$ÄNDERUNGSBESCHREIBUNG" --username $USER Wenn man das Repository mit seinem Nutzernamen ausgecheckt hat, -kann „--username $USER“ weggelassen werden. +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« +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: +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 Auschecken 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. -• Längere Änderungsbeschreibungen sollten mit einer kurzen Zusammmenfassung 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 korregiert: Leere Zeiten entfernt, Einrückung angeglichen (r698)« -• Grössere 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 halt einen Branch für den Zeitraum der Änderungen eröffnen. -• … +• Bevor man beginnt, die eigene SVN-Kopie zu bearbeiten, sollte immer erst ein Update durchgeführt werden (insbesondere, wenn das letzte Auschecken 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. +• 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. +• … ------------------------------------------------------------------------------ -- cgit v1.2.3