Makefile.common

Z UMP

Wersja z dnia 07:00, 1 kwi 2009

Narzędzie dla użytkowników systemów Unix i Linux służące do operowania na źródłach UMP.

Podstawowa funkcjonalność

Poniższy opis przytaczam za Tomaszem Surmaczem, jego autorem.

Do działania Makefile wymaga ustawienia 2 zmiennych środowiskowych:

CVS	- katalog ze źródłami (czyli ten właśnie z Makefile.common)
DIR	- jeden lub kilka umpów

np:

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

Po czym najlepiej zrobić sobie:

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

czyli utworzyć katalog roboczy "tmp" i tam pracować za pomocą:

make mont	- montuje źródła. Na końcu dokleja plik
		  "attach", jeśli taki istnieje
make x		- generuje listę niestyków (zmontowanego wynik.mp)

- uruchomić mapedita, poprawiać

make demont	- rozmontowuje, każe uaktualnić źródła (copy&paste myszką)
make commit	- commituje poprawki

i tak w kółko, jak długo starcza chęci i materiału do poprawiania. Dodatkowo:

make clean	- czyści pliki tymczasowe (diffy z rozmontowywania, itp.)
make close	- generuje listę za bliskich węzłów
make dead	- generuje listę ślepych
make wpt	- generuje listę węzłów (odwrotnie niż "make x")
make update	- uaktualnia źródła edytowanego ump-a

Cele "x", "wpt", "close", "dead" generują listę punktów zawsze do pliku wynik-x.wpt, warto więc utworzyć plik "attach" z zawartością:

;@FILE,"Z:\home\USER\ump\tmp\wynik-x.wpt"

wtedy po zmontowaniu i wczytaniu zawsze będzie dołączony i nie trzeba będzie samemu za każdym razem wczytywać. Cele ponadto można łączyć, czyli np. wykonać:

make clean mont x	(wyczyści, zmontuje, wygeneruje niestyki)
# edycja mapeditem
make demont
# kopiowanie plików, ponowna edycja
make demont
# skopiowanie reszty plików
make clean mont close
# ponowna edycja (nie zapomnieć ponownie wczytać wynik.mp w mapedicie!)
make demont
# skopiowanie poprawek
make clean commit

Dostępne cele

Podstawowe operacje

 mont     - montowanie mapy
 demont   - rozmontowanie mapy, wykonanie diffów, pliki różniące się
            względem oryginału tworzone są w katalogu bieżącym
 clean    - usuwa pozostałości po rozmontowanej mapie, pliki *.plt i wynik* zostawiane są w spokoju
 mrproper - pełne czyszczenie katalogu roboczego, kasuje to co clean oraz pliki tymczasowe, wynik* i *.plt

Interakcja z CVS

 update   - aktualizacja źródeł
 commit   - wysłanie poprawek - wymaga uprawnień do zapisu w CVS

Sprawdzanie mapy (wymagany netgen)

 sprawdz  - sprawdzenie poprawności mapy
 dead     - wykryj ślepe końce, przy okazji oflagowuje węzły "dociągane"
 deadnm   - j.w., ale odfiltrowuje część węzłów skrajnych mapy
 x        - wykryj skrzyżowania bez węzłów
 close    - wykryj zbyt blisko położone węzły

Testy związane z routingiem

Poniższe cele służą do wygenerowania informacji o routingu przydatnych np. do sprawdzenia ciągłości routingu w danym obszarze.

 test     - wygeneruj dane potrzebne do routingu
 test-j   - wygeneruj dane potrzebne do routingu - z włączoną opcją j netgena
 test-k   - wygeneruj dane potrzebne do routingu - z włączoną opcja k netgena
 test-jk  - wygeneruj dane potrzebne do routingu - z włączonymi opcjami j i k netgena
 class    - wygeneruj informacje o klasach routingu do osobnych plików (domyślnie bazuje na make test)

Inne

 visual   - na podstawie plików diff tworzy listę zmian dokonanych na mapie. Mapa musi być wcześniej rozmontowana!
 cum      - wykonuje kolejno clean, update, mount

Zmienne środowiskowe

Wymagane do poprawnej pracy

 CVS       - położenie lokalnej kopii źródeł mapy (katalog główny)
 DIR       - UMP który chcemy montować

Opcjonalne

 MONTEXTRA - dodatkowe opcje dla mont-demont-multi2.pl

Dodatkowe informacje

Opiekunem narzędzia jest Tomasz Surmacz, wspomagany przez Tomasza Babczyńskiego.