Opisy są przenoszone na wiki.

TortoiseCVS

[...]

Pierwsze pobranie repozytorium na dysk.

Mapa w projekcie UMP-pcPL pomimo faktu, iż jest tworzona w ogromnym stopniu przy użyciu programu MapEdit, nie korzysta z zapisywania danych w formie jego domyślnego formatu mp. Dane są przechowywane w formie zwykłych plików tekstowych. Mapedit nie potrafi stworzyć mapy bezpośrednio z tych plików i wymaga pomocy skryptów. Zatem na początek musimy ściągnąć sobie owe narzędzia.
Na początek w lewym górnym panelu wybieramy folder, który wybraliśmy na lokalną kopie UMPa (w tym przypadku jest to c:\Mapy)

Z menu Remote wybieramy Checkout module

Otwiera się okienko, które będziemy oglądali za każdym razem podczas aktualizacji dowolnego modułu. Tym razem w polu opisanym jako "Module name" wpisujemy nazwę modułu, który chcemy ściągnąć z serwera czyli "narzedzia". Robimy to tylko raz, za każdym następnym razem w polu tym będzie się automatycznie wyświetlała nazwa ostatnio sprawdzanego modułu a wybór innego, który choć raz był ściągnięty będzie się odbywał za pomocą rozwijanego menu.
Upewniamy się czy w linii Lokale folder to checkout to jest podana ścieżka do właściwego folderu, zaznaczamy opcję CVSROOT gdzie przy wykonanej wcześniej konfiguracji zawartość pojawi się sama i naciskamy OK.

Po chwili w dolnym panelu ukaże się wyglądająca w następujący sposób informacja. Z informacji zawartych w tym panelu interesuje nas najpierw ostatnia linijka. Takie brzmienie jak widzimy obok oznacza, że wszystko przebiegło prawidłowo. Kolor zielony oznacza, że dany plik został ściągnięty gdyż serwer posiadał bądź jego nowszą wersję niż my, bądź my jej wcale nie posiadaliśmy.

Teraz pozostał nam ostatni (no prawie) etap konfiguracji naszego lokalnego CVSa. Otwieramy folder c:\Mapy\UMP-pcPL\narzedzia (lub inny jeśli zdecydowaliśmy się na inną lokalizację), znajdujemy w nim plik setenv.bat. Kopiujemy ten plik do katalogu c:\Mapy\UMP-pcPL (czyli poziom wyżej), i otwieramy Notatnikiem. Niestety to jest trochę nie okienkowa praca ;-) - Jeśli wybraliśmy sobie inną lokalizację naszego lokalnego repozytorium UMP niż c:\Mapy musimy zmodyfikować linię 18 tego pliku zastępując wpis set mapy=c:\Mapy takim który wskaże wybrany przez nas folder. Jeżeli jednak nie zmienialiśmy domyślnej lokalizacji nic nie zmieniamy - Linię 28 która brzmi: set cvsexe=%mapy% zmieniamy na rem set cvsexe=%mapy% - w linii 43 tekst set cvsuser=guest zamieniamy na rem set cvsuser=guest - podobnie w linii 52 tekst set CVSROOT=:pserver:%cvsuser%@ump.waw.pl:/home/cvsroot zamieniamy na rem set CVSROOT=:pserver:%cvsuser%@ump.waw.pl:/home/cvsroot - i ostatnia zmiana to linia 74 tekst set cvs=%ump% zamieniamy na rem set cvs=%ump% I w ten oto sposób mamy kompletne środowisko do pracy ze źródłami UMP-pcPL. A zatem na koniec:

Jak korzystać z WinCVS na co dzień

Jak ściągnąć wybrany moduł już wiemy, przecież skoro tutaj jesteśmy to znaczy, że udało nam się ściągnąć moduł narzedzia. Każdy inny moduł (wybrany arkusz mapy) ściągamy w dokładnie taki sam sposób: wybieramy "Remote -> checkout module" i w polu "Module name" wpisujemy nazwę modułu lub jeśli już kiedyś ten moduł ściągaliśmy wybieramy z rozwijanego menu

Rozwijamy w lewym górnym panelu drzewko katalogów i wchodzimy do naszego ściągniętego modułu. Po prawej stronie widzimy pliki i podkatalogi w naszym module. Najeżdżamy na mont-demont.bat i uruchamiamy poprzez podwójne kliknięcie. Przy pierwszym wykonaniu tej czynności pojawi nam się kolejne okienko.

Okno to pozwala nam zdefiniować co będzie się działo po podwójnym kliknięciu na plik z rozszerzeniem .bat Wybieramy akcję Default aby plik się uruchomił. Aby ustawić taką akcję na stałe zaznaczamy pole Use same action next time, jednak aby móc łatwo zmienić decyzję w przyszłości zaznaczamy opcję Display only if Shift key is down. Pozwoli nam to uzyskać dostęp do tego okna jeśli na pliku .bat klikniemy dwukrotnie trzymając wciśnięty klawisz Shift

Po uruchomieniu pliku mont-demont.bat otworzy się okienko o mniej więcej takim wyglądzie

Na szczęście nic z tym nie musimy robić a po chwili widzimy... mapę :-)
Ponieważ nie jest to kurs obsługi Mapedit, ten element pomijamy ;-)
Jeśli zakończymy naszą twórczość radosną, zapisujemy pracę i zamykamy Mapedit. W naszym czarnym okienku szybciej lub wolniej w zależności od szybkości procesora i dysku zaczną pojawiać się komunikaty, np. takie:

Naciskamy więc dowolny klawisz (zresztą alternatywnej propozycji nie ma ;-) ) Zaglądamy do katalogu, z którego uruchomiliśmy mont-demont.bat w górnym prawym panelu. Znajdujemy w nim wszystkie pliki wymienione w poprzednim .czarnym okienku. w dwóch wersjach. Np.: BUK.ulice.txt i BUK.ulice.txt.diff.txt. Pierwszy z nich zawiera już naniesione przez nas poprawki a drugi jest opisem zmian jakich dokonaliśmy. Jeśli pojawił się plik !nowosci.txt to znaczy, że dodaliśmy do edytowanej mapy nowe elementy. Elementy te są w ramach pliki pogrupowane w zależności od typu. Obróbka tych plików, co z nimi zrobić, co oznaczają poszczególne wpisy, jak to zebrać w jedną całość to odrębny temat. Jednak jeżeli podsyłamy wynik naszej pracy komuś z grupy UMP.a to najprościej jest wysłać wszystkie otrzymane pliki .diff oraz plik !nowości.txt do osoby z którą współpracujemy i jest to koniec pracy Jeżeli mamy uprawnienia do zapisania naszych zmian na serwer to zakładam, że wiemy co i jak obrobić. Po naniesieniu zmian do plików w katalogu \src możemy przystąpić do zapisania zmian na serwer. Jednak zanim to zrobimy musimy sprawdzić czy ktoś inny nie zmodyfikował źródeł znajdujących się na serwerze W tym celu wykonujemy kolejno Remote -> checkout module Wybieramy moduł który chcemy sprawdzić i wciskamy OK. Jeżeli nikt nie zmodyfikował w międzyczasie źródeł to otrzymamy w dolnym panelu informację analogiczną do zamieszczonej obok. Kolor fioletowy w nazwach plików oznacza, że WinCVS znalazł różnicę pomiędzy wersją na serwerze a tą którą mamy na naszym komputerze i że nasza wersja jest nowsza.

Przy takim komunikacie możemy bezpiecznie zapisać zmiany na serwer a robimy to następująco: Wybieramy Amin -> Command Line i pojawia się następujące okienko. Na dole zaznaczamy opcję Execute for directory i wskazujemy katalog który chcemy wysłać na serwer. W górnym okienku zatytułowanym Enter the command line ... wpisujemy czynność do wykonania. W tym przypadku polecenie brzmi svs commit i wciskamy OK. Przy kolejnych wysyłkach nie będziemy musieli już wpisywać komendy tylko możemy ją wybrać z rozwijanego menu Previous.

Po zatwierdzeniu komendy system poprosi na o skomentowanie zmian, które wykonaliśmy. Pojawi się okienko Notatnika, w którym system informuje nas jakie pliki zostaną zmienione, i po ustawieniu kursora na końcu dopisujemy nasz komentarz. Następnie zamykamy okno Notatnika.

Po jej zakończeniu w dolnym panelu zobaczymy raport z wykonanych czynności. Kolejno zostaną wymienione pliki, które zmodyfikowaliśmy, będzie podana dotychczasowa wersja każdego pliku (numer) oraz nowa wersja. Najbardziej interesuje nas zobaczenie na końcu komunikatu linijki o treści: CVS exited normalny with code 0 Jeśli tak to wygląda to znaczy, że wszystko się udało (no może nie do końca, czy wszytsko to się dowiemy oglądajac najbliższą kompilację)
Podczas zamknięcia otrzymamy pytanie czy zapisać zmiany w pliku .tmp i odpowiadamy twierdząco. W tym momencie zaczyna się wysyłka na serwer.

TortoiseCVS (autor: Piotr Krysztofiak)

TortoiseCVS jest kolejnym klientem repozytorium CVS pracującym w klikanych okienkach.
Słowem wprowdzenia, repozytorium to taki system, który umożliwia wielu ludziom jednoczesną pracę nad tymi samymi plikami. Opis Tortoise CVS można znaleźć na jego stronie (po angielsku).

Instalacja

Klienta tortoise pobierzesz stamtąd (jeśli coś nie tak, to szukaj na głównej). Następnie należy zainstalować program. W pierwszym oknie wybrałem język polski. Należy zaznaczyć opcję restartu windows:

Teraz należy wybrać miejsce gdzie zwykle się instaluje programy:

Najprościej jest wybrać instalację pełną, można też wybrać opcję użytkownika i poodznaczać niepotrzebne opcje (np. tłumaczenia z których nie będzie się korzystać):

Komputer powinien się sam zrestartować, jeżeli wybrałeś inaczej - zrób to teraz ręcznie.

W tym momencie program tortoisecvs jest już gotowy do pracy. Należy jeszcze skonfigurować program, poszukać w menu Start zakładki związanej z Tortoise i wybrać opcje ustawienia:

Ja zmieniłem język na angielski,aby zachować kompatybilność opisów komend z opisami opcji w programie. Na zakładce Policy należy zaznaczyć ostatnią opcję Issue warning if no comment provided in commit:

Na zakładce Advanced należy wybrać na zakładce network compression 6-Good

I należy kliknąć OK.

Pierwsze pobranie repozytorium na dysk.

W dowolnym miejscu należy stworzyć katlog, w którym będą przechowywane źródła UMP-pcPL. Ja nazwałem ten katalog "UMP-pcpl-TortoiseCVS". Należy kliknąć prawym klawiszem na tym katalogu i wybrać opcję "CVS Checkout ..." Otworzy się nowe okno, w które należy wpisać dane dotyczące serwera z repozytorium. W pole CVSROOT: należy wpisać: "CVSROOT: :pserver:guest@ump.waw.pl/home/cvsroot", pozostałe pola wypełnią się same:

Jeżeli posiada się nazwę użytkownika i hasło, to zamiast "guest" należy wpisać "użytkownik:hasło". Następnie należy kliknąć przycisk "Fetch list", otwory się dodatkowe okno i pobrany zostanie "spis treści" repozytorium. Następnie z listy Module należy wybrać narzedzia


i kliknąć przycisk OK. Otworzy się nowe okno, a pliki i katalogi zostaną pobrane na dysk

Gdy pojawi się napis SUCCES na końcu, to znaczy, że wszystko poszło dobrze, i pliki są już na dysku

W moim katalogu UMP-pcpl-TortoiseCVS pojawił się nowy folder o nazwie "narzedzia". W ten sam sposób należy ściągnąć wybrany obszar UMP, który będzie edytowany. Np UMP-Warszawa: czyli na katalogu UMP-pcpl-TortoiseCVS prawym klawiszem, CVS Checkout, Fetch list, wybrać z listy Module UMP-Warszawa i nacisnąć przycisk OK na dole okna. Po pomyślnym zakończeniu operacji na dysku w katalogach narzędzia i UMP-Warszawa znajdują się aktualne źródła projektu UMP-pcPL.

Ponowne uaktualnianie źródeł do najnowszej wersji.

Jeżeli na dysku mamy już źródła, to wystarczy je uaktualnić przed rozpoczęciem pracy. W tym celu na katalogu zawierającym źródła, np. UMP-Warszawa, klikamy prawym klawiszem i wybieramy opcję "CVS Update". Można również w Windows w konkretnym folderze "UMP-coś" kliknąć programik "cvs_update".