Edycja w systemie Linux

Z UMP

---

Wersja z dnia 12:13, 30 sie 2008

Edycja UMP w systemie Linux

Narzędzia

Czego będziemy potrzebowali:

• Kompletnych źródeł UMP, a przynajmniej narzędzi, pliku Makefile.common oraz obszarów, które nas interesują
• MapEdit - edytor map
• netgen - program przydatny do sprawdzania routingu
• cvs, perl, awk, make - podstawowe wyposażenie wielu dystrybucji Linuksa
• wine - by uruchomić program MapEdit

Przygotowania

Pierwszym krokiem jest ściągnięcie źródeł projektu do przygotowanego uprzednio katalogu. Tu dla przykładu jest to UMP-src

cd
mkdir UMP-src
cd UMP-src
cvs -z5 -d:pserver:guest@ump.waw.pl/home/cvsroot checkout .

Następnie tworzymy katalog roboczy i tworzymy w nim link do pliku Makefile.common znajdującego się piętro wyżej:

mkdir tmp
cd tmp
ln -s ../Makefile.common Makefile

Kolejny krok to przygotowanie środowiska - plik Makefile.common wymaga dwóch zmiennych:

• DIR - wskazującej, które fragmenty UMPa nas interesują
• CVS - wskazującej, gdzie znajduje się katalog główny repozytorium

Możemy utworzyć sobie plik (u mnie env.sh) który pomoże pamiętać o zainicjawaniu zmiennych środowiskowych. Jego zawartość (lub dla osób nie używających pliku - polecenia do wykonania):

export DIR=UMP-Wroclaw
export CVS=/home/user/UMP-src

Użytkownicy tcsh muszą tu odwołać się do swojego interpretera poleceń:

setenv DIR "UMP-Opole UMP-Katowice"
setenv CVS /home/user/UMP-src

Jeśli chcemy montować więcej niż jeden kawałek mapy - w cudzysłowie umieszczamy listę montowanych elementów.

W tej chwili jesteśmy gotowi do pracy :)

Przebieg sesji

Zakładam, zę znajdujemy się już w naszym katalogu roboczym, czyli UMP-src/tmp

Zaczynamy od przygotowania środowiska, a więc:

. env.sh

Lub alternatywnie - wklepujemy odpowiednie polecenia export lub setenv. Sprzątamy po ostatniej edycji

make clean

Następnie należy uaktualnić źródła

make update

Ważne: nie należy uaktualniać źródeł od momentu rozpoczęcia edycji do momentu odesłania poprawek na serwer! W bardzo prosty sposób prowadzi to to "znikania" zmian wprowadzonych przez innych mapperów.

Mając aktualne źródła montujemy je:

make mont

I od tego momentu możemy rozpoczynać pracę.

W trakcie edycji można sobie wygenerować listy niestyków i innych błędów na mapie - polecam opis Makefile.common

Po zakończeniu edycji wykonujemy

make demont

I w naszym katalogu roboczym pojawia się zestaw plików ze zmianami.

Po sprawdzeniu, czy wszystko jest w porządku i mając prawo zapisu do repozytorium możemy zrobić

make commit

albo spakować pliki diff i wysłać poprzez system zgłaszania poprawek flyspray

tar -zcvf wrzutka.tgz *.diff

-- Wheart 12:12, 30 sie 2008 (UTC)