Korzystanie z CVS

CVS jest programem, który pomaga w zarządzaniu pracą ekipy osób pracujących równocześnie nad tym samym materiałem. Każdy z użytkowników tworzy lokalną kopię repozytorium dokumentów. Kopie mogą być tworzone na tej samej maszynie, albo rozsiane po całym świecie. Użytkownicy mogą modyfikować lokalne kopie plików, a gdy zmiany są gotowe, wysłać je z powrotem na serwer.

Dostęp tylko do odczytu jest możliwy przez stronę www. Istnieje również wiele graficznych klientów CVS, takich jak cervisia, pochodząca z KDE. Ten dokument opisuje sposób pracy poleceniem wiersza poleceń cvs, inne programy funkcjonują analogicznie.

CVS nie pozwoli Ci wysłać pliku, jeśli kopia w głównym repozytorium została zmodyfikowana od czasu Twojej ostatniej aktualizacji (update). Przeważnie nie jest to problem i możesz nadal aktualizować swoją lokalną kopię. Jeśli zmiany dotyczą innej części pliku niż ta, nad którą pracowałeś, zmiany są po cichu łączone. Jeżeli zaś zmiany dotyczą tego samego obszaru, zostaniesz ostrzeżony o konflikcie. W takim przypadku musisz przeedytować plik, aby naprawić problem przed wysyłką.

W poniższym przypadku konto anonymous będzie użyte dla przykładu. Jeśli masz dostęp do innego konta, które Ci daje prawo do zapisu, to powinieneś korzystać z tamtego konta. Jeżeli planujesz coś zmieniać, powinieneś zdobyć konto z prawami do zapisu. Korzystając z konta anonymous użytkownicy nie mogą wysyłać zmian. Zobacz rozdział o dostępie z prawem do zapisu, aby uzyskać więcej informacji.

Aby rozpocząć pracę z CVS, musisz najpierw się zalogować do serwera CVS

   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml login

(naciśnij Enter, gdy zapyta o hasło)

Aby sprawdzić kopię plików na Twoim komputerze, użyj polecenia

   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout webwml

Możesz sprawdzić jedynie część stron poleceniem:

   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout -l \
          webwml webwml/<kod języka>
   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout \
          webwml/Perl webwml/english/template webwml/<kod języka>/Pics
   cvs -d :pserver:anonymous@cvs.debian.org:/cvs/webwml checkout \
          webwml/<język>/<ścieżka do plików>

Polecenia powtarzaj dla wszystkich katalogów lub plików, które chcesz sprawdzić. Druga linia zawiera wszystkie pliki, które będziesz potrzebował, aby stworzyć pliki HTML z WML. Częściowe sprawdzanie, takie jak powyższe nie jest wspierane przez serwer. Dlatego powyższe komendy mogą niezawsze działać.

Jeśli posiadasz konto ze swoją nazwą użytkownika i z własnym hasłem, wpisz je zamiast konta anonymous w ten sposób:

   cvs -d :pserver:użytkownik@cvs.debian.org:/cvs/webwml checkout webwml/english/doc

Wówczas nie będziesz musiał dopisywać za każdym razem do polecenia części '-d :pserver:...'. Co kilka dni powinieneś wykonać aktualizację

   cvs update -d

aby pobrać zmienione pliki z serwera. Opcja -d sprawdza również, czy na serwerze nie zostały utworzone nowe katalogi; jeśli zostały utworzone - tworzy je również w lokalnej kopii. Można również utworzyć plik ~/.cvsrc , który zawiera opcje dla programu CVS. Wtedy nie będzie trzeba wypisywać opcji za każdym razem. Przykładowo plik ten może zawierać:

cvs -z9
update -d -P
diff -u

Powyższe opcje są dla osób, które mają prawo zapisu do głónego magazynu. Gdy skończyłeś zmieniać stronę, możesz wysłać swoje zmiany na serwer korzystając z polecenia:

   cvs commit <plik>.wml

lub

   cvs commit <katalog>    (aby wysłać wszystkie zmiany z katalogu <katalog>)

lub

   cvs commit          (aby wysłać wszystkie zmiany z katalogu, w którym aktualnie jesteś)

Jeśli jesteś pierwszą osobą tłumaczącą stronę, powinieneś wykonać polecenie

   cvs add <plik>.wml

przed jego wysłaniem. Zauważ, że polecenie cvs add nie działa rekursywnie. Myszisz najpierw dodać katalog, a dopiero potem jego zawartość.

Aby uzyskać więcej informacji na temat programu CVS, skorzystaj z polecenia info cvs.

Dostęp do CVS z prawem do zapisu

Aby uzyskać informacje, w jaki sposób otrzymać dostep do CVS z prawem do zapisu, zajrzyj na stronę http://people.debian.org/~joey/misc/webwml.html.