1.4. Wie kann ich auf das CVS der FAQ zugreifen?

1.4.1

Anonymous-Zugang

Wenn Du nur mal reinschnuppern willst, kannst Du das CVS als "anonymous" auschecken. Das geht folgendermaßen:

user@host:~ $ cvs -d :pserver:anonymous@koehntopp.de:/faq login
Logging in to :pserver:anonymous@koehntopp.de:2401/faq
CVS password: <return>
user@host:~ $ cvs -d :pserver:anonymous@koehntopp.de:/faq 
    co suse-linux-faq
U suse-linux-faq/README
U suse-linux-faq/autoren.xml
U suse-linux-faq/reclist.xml
U [...]

Danach führst Du nur noch jeweils ein Update durch:

cd ~/suse-linux-faq
cvs update

Der Anonymous-Zugang ist nur lesend möglich. Wenn Du an der FAQ mitarbeiten möchtest, brauchst Du einen Zugang per SSH, wie er im Folgenden beschrieben ist.

1.4.2

CVS-Zugriff mit Schreibrecht

Sende Deinen SSH Public Key (~/.ssh/id_dsa.pub oder ~/.ssh/id_rsa.pub) an <kris@koehntopp.de> mit der Bitte um Aufnahme. Kristian richtet Dir dann einen CVS-Zugang ein. Falls Du noch keinen SSH-Key hast, kannst Du in der Frage Wie erstellt man einen SSH-Key? Wie kommt der Key auf den Zielrechner? nachlesen, wie Du einen erstellst. Sobald der User eingerichtet ist, kannst Du aufs CVS zugreifen und Deine Texte einarbeiten.

Der Zugriff auf das CVS erfolgt per SSH. Dazu ist es nötig, die Umgebungsvariable CVS_RSH richtig zu setzen. Das geht mit

export CVS_RSH=ssh

und am Besten trägst Du das auch gleich in Deine ~/.profile ein, da es für jeden CVS-Zugriff gebraucht wird.

Jetzt kannst Du das CVS auschecken (keine Angst: diesen doch etwas länglichen Befehl brauchst Du nur einmal auszuführen ;-)

user@host:~ $ export CVS_RSH=ssh
user@host:~ $ cvs -d :ext:username@koehntopp.de:/home/cvsroot/faq 
    co suse-linux-faq   # ^^^^^^^^ bitte ersetzen
[ggf. Abfrage der Passphrase für Deinen SSH-Key]
U suse-linux-faq/README
U suse-linux-faq/autoren.xml
U suse-linux-faq/reclist.xml
U [...]

Um den aktuellen Stand und die Änderungen der anderen Mitarbeiter zu erhalten, aktualisierst Du Deine Kopie des CVS:

user@host:~/suse-linux-faq $ cvs update

So, genug zugesehen. Nehmen wir einfach mal an, Du hast eine Datei geändert. Um Deine Änderungen ins CVS zu packen, führst Du

user@host:~/suse-linux-faq $ cvs commit

aus. Gebe dann im Editor bitte eine kurze Zusammenfassung Deiner Änderungen als Logeintrag an.

Bei einem commit werden die Umgebungsvariablen $CVSEDITOR, $VISUAL und $EDITOR (in dieser Reihenfolge) untersucht, um einen Editor zu finden. Du solltest also eine der Variablen mit deinem Lieblingseditor (der auch auf der Konsole funktioniert) definieren. Falls alle drei Variablen leer sind wird als default vi aufgerufen. Wer vi nicht mag sollte also besser ein

export CVSEDITOR='xemacs' ### oder 'joe', 'jed', 'pico' oder...

in seine ~/.${SHELL}rc, für die bash also in die ~/.bashrc. Für andere "Muscheln" gilt analoges. Nebenbei sollte man 'VISUAL' und 'EDITOR' wohl sowieso mit dem Lieblings-Konsolen-Editor "füllen" :-)

Um eine neue Datei zum CVS hinzuzufügen, verwende die folgenden Befehle:

user@host:~/suse-linux-faq $ cvs add neuedatei
user@host:~/suse-linux-faq $ cvs commit

Auch wenn Du weißt, daß Dein Text noch nicht perfekt oder nicht einmal gut ist, "commite" ihn ins CVS - besser ein fehlerhafter Text als gar keiner ;-) Lege den Text aber erstmal in das Verzeichnis incoming/ und nicht gleich nach chapters/. Für die meisten Leute ist es einfacher, einen bestehenden Text zu verbessern als einen neuen zu schreiben.

Bei Fragen oder Problemen mit CVS kannst Du Dich an die FAQ-Mailingliste wenden - wir helfen gern weiter.