ozmake - Online w chmurze

PROGRAM:

IMIĘ

Ozmake – Make for Oz

STRESZCZENIE

ozmake --help
ozmake [--budować] [CELE...]
ozmake --zainstalować [CELE...]
ozmake --zainstalować [--pakiet=PKG]
ozmake --odinstaluj [--pakiet=PKG]
ozmake --czysty
ozmake --bardzo czysto
ozmake --Stwórz [--pakiet=PLIK]
ozmake --publikować
ozmake --wyciąg [--pakiet=PKG]
ozmake --lista [--pakiet=MOGUL]
ozmake --config=(umieść|usuń|listę) ...
ozmake --mogul=(umieść|usuń|listę|eksportuj) ...

OPIS
ozmake OPCJE CELE

ozmake to narzędzie do tworzenia projektów opartych na Mozarta oraz do tworzenia i instalowania Mozarta
pakiety. Inspiracją były narzędzia uniksowe robić i rpm,ale jest o wiele, wiele prostsze
specjalizuje się w tworzeniu i wdrażaniu oprogramowania opartego na Mozarta, a także w sposób przejrzysty
obsługuje wszystkie platformy, na które przeniesiono Mozarta. ozmake należy obecnie powołać
z powłoki, ale docelowo zyska dodatkowo opcjonalną, przyjazną dla użytkownika
interfejs graficzny.

OPCJE

Poniżej zapiszemy metazmienne w nawiasach ostrych, np or <URI as
Pamięć podręczna ścieżka>

Ogólne Opcje
-v --pełne
wydrukuj więcej informacji o śledzeniu niż domyślnie. Dostarczając tę ​​opcję
dwa razy, czasami otrzymasz jeszcze więcej informacji.

-q --cichy
ukryć wszelkie informacje dotyczące śledzenia i informacji zwrotnych

-n --po prostu wydrukuj
wykonaj próbę próbną, tj. po prostu wydrukuj, co by się stało, gdyby faktycznie nie wykonano działania
akcje

--lokalny
nie wracaj do podkatalogów

--(nie)samodzielność
domyślna: prawdziwy
automatycznie określa zależności czasu kompilacji i czasu instalacji (czasu wykonywania).
Obecnie jest to obsługiwane tylko w przypadku źródeł Oz, sprawdzając import i wymaganie
działy.

--(nie)wymaga
domyślna: prawdziwy
automatycznie pobierze i zainstaluje inne pakiety wymagane przez bieżący. Ten
Opcja ta jest istotna zarówno w przypadku budowy, jak i instalacji.

To o czym powinieneś pamiętać to to -wn jest twoim przyjacielem. Dodać -wn na końcu dowolnego
ozmake wywołanie i powie ci bardzo szczegółowo, co polecenie by zrobiło bez
faktycznie to robię.

Katalogi i Używać
--prefiks=
domyślna: ~/.oz
katalog główny prywatnego obszaru instalacji

--katalog=
domyślna: aktualny katalog
domyślny katalog dla innych opcji poniżej

--katalog budowy=
domyślna:
katalog, w którym należy budować

--srcdir=
domyślna:
katalog, w którym znajdują się pliki źródłowe

--bindir=
domyślna: /kosz
katalog, w którym umieszczane są cele bin

--libroot=
domyślna: /Pamięć podręczna
Katalog główny pamięci podręcznej, w której instalowane są cele bibliotek

--libdir=
domyślna: /<URI as Pamięć podręczna ścieżka>
katalog, w którym zainstalowane są cele bibliotek

--docroot=
domyślna: / dok
katalog główny, w którym instalowane są obiekty docelowe dokumentów

--docdir=
domyślna: /<MOGUL as nazwa pliku>
katalog, w którym instalowane są obiekty docelowe dokumentów

--wyodrębnij katalog=
domyślna:
katalog, do którego chcesz wyodrębnić pakiet

--archiwum=
domyślna: http://www.mozart-oz.org/mogul/pkg
Adres URL archiwum potentata, z którego można pobrać pakiety

--moguldir=
katalog, w którym umieszczone są podkatalogi zawierające wpisy użytkownika: a
katalog na pakiety, jeden na dokumentację, drugi na wpisy do bazy danych potentata.

--mogulurl=
url odpowiadający katalogowi MOGULDIR

Akta
-m --makefile=
domyślna: /makefile.oz
lokalizacja pliku makefile

-p --pakiet=
plik lub adres URL pakietu. podczas tworzenia pakietu powinna to być lokalna nazwa pliku.
podczas rozpakowywania lub instalowania może to być również adres URL lub identyfikator potentata; w tym ostatnim
w takim przypadku pakiet zostanie automatycznie pobrany z archiwum potentata

-V --wersja pakietu=
ta opcja jest przestrzegana przez --wyciąg i --zainstalować .Gdy --wyciąg jest podawany
identyfikator MOGUL i pobierze odpowiedni pakiet z archiwum MOGUL, tak się stanie
poszukaj dokładnie danej WERSJI pakietu. --zainstalować po prostu sprawdzę
że pakiet do zainstalowania naprawdę ma tę WERSJĘ.

--baza danych=
domyślna: /BAZA DANYCH
ścieżka podstawowa bazy danych zainstalowanych pakietów. Baza danych zapisana jest zarówno w wersji marynowanej jak i marynowanej
formacie tekstowym odpowiednio w plikach DB.ozf i DB.txt

Pomoc
ozmake --help

-h --pomoc
wydrukuj tę wiadomość informacyjną

Buduj
ozmake [--budować]
zbuduj wszystkie cele

ozmake [--budować] PLIKI...
zbuduj te cele

-b --kompilacja
jest to ustawienie domyślne. buduje cele pakietu

--optlevel=(brak | debugowanie | optymalizacja)
domyślna: optymalizacji
wybierz poziom optymalizacji kompilacji

-g --debug --optlevel=debugowanie
skompiluj z debugowaniem

-O --optimize --optlevel=optymalizuj
skompiluj z pełną optymalizacją. jest to ustawienie domyślne

--(nie)gnu
jest kompilatorem C++ kompilatorem GNU. jest to ustalane automatycznie i umożliwia a
większy poziom optymalizacji, czyli mijanie -O3 a nie tylko -O do
kompilator

--(nie)pełna wersja
domyślna: fałszywy
zbuduj także cele src

--includedir DIR -I DIR
powiedz kompilatorowi C++, aby dodatkowo przeszukał DIR w poszukiwaniu plików dołączanych

--(nie)sysincludedirs
domyślna: prawdziwy
powiedz kompilatorowi C++, aby dodatkowo przeszukał (lub nie, jeśli używasz --nosysincludedirs
)specyficzne dla Mozarta obejmują katalogi znajdujące się w instalacji globalnej
katalogu i w prywatnym katalogu użytkownika ~/.oz powierzchnia.

--librarydir KATALOG -L KIER
powiedz linkerowi C++, aby dodatkowo przeszukał katalog DIR w poszukiwaniu bibliotek

--(nie)syslibrarydirs
domyślna: prawdziwy
powiedz linkerowi C++, aby dodatkowo przeszukał (lub nie, jeśli używasz --nosyslibrarydirs
)katalogi bibliotek specyficzne dla Mozarta, znajdujące się w instalacji globalnej
katalogu i w prywatnym katalogu użytkownika ~/.oz powierzchnia.

Zainstalować
ozmake --zainstalować
zainstaluj za pomocą pliku makefile

ozmake --zainstalować PLIKI...
zainstaluj te cele przy użyciu pliku makefile

ozmake --zainstalować --pakiet=PKG
zainstaluj pakiet PKG

-i -zainstaluj
zainstaluj elementy docelowe pakietu i aktualizuje bazę danych pakietu

--grade=(brak | taki sam | w górę | w dół | dowolny | odśwież )
domyślna: Żaden
co zrobić, jeśli ten pakiet jest już zainstalowany? ozmake porówna wersję i
daty, gdzie wersja jest bardziej znacząca. --ocena=brak sygnalizuje błąd
--klasa=taka sama wymaga, aby wersje i daty były takie same --klasa=wyżej wymaga
pakiet z nowszą wersją lub tą samą wersją i nowszą datą wydania niż poprzednia
zainstalowany --ocena=w dół wymaga pakietu ze starszą wersją lub tą samą wersją i
starsza data wydania niż ta zainstalowana --klasa=dowolna żadnych warunków --grade=odśwież
zainstaluj, jeśli pakiet jest nowszy, w przeciwnym razie nie rób nic

-U --aktualizacja
równoważny --zainstalować --klasa=wyżej

--nachylenie
równoważny --zainstalować --ocena=w dół

-A - dowolny stopień
równoważny --zainstalować --klasa=dowolna

-F –odśwież
równoważny --zainstalować --grade=odśwież

--(nie)zamieniapliki
domyślna: fałszywy
zezwolić instalacji na nadpisanie plików z innych pakietów

-R --zamień
równoważny --zainstalować --klasa=dowolna --zamień pliki

--(nie)rozszerz pakiet
domyślna: fałszywy
czy zastąpić lub przedłużyć bieżącą instalację tego pakietu, jeśli istnieje

-X --rozszerz
równoważny --zainstalować --klasa=dowolna --przedłuż pakiet

--(nie)zapisanob
domyślna: prawdziwy
zapisz zaktualizowaną bazę danych po instalacji

--includedocs --excludedocs
domyślna: --włącz dokumenty
czy zainstalować obiekty docelowe dokumentów

--includelibs --excludelibs
domyślna: --uwzględnij biblioteki
czy zainstalować cele bibliotek

--includebins --excludebins
domyślna: --zawiera pojemniki
czy zainstalować cele bin

--(nie)trzymaj zombie
domyślna: fałszywy
czy usunąć pliki pozostałe po poprzedniej instalacji tego pakietu

--exe=(domyślnie | tak | nie | oba | wiele)
domyślna: domyślnym
konwencja w systemie Windows jest taka, że ​​pliki wykonywalne mają plik .exe, podczas gdy w systemie Unix mają
bez przedłużenia. The --exe Opcja pozwala kontrolować konwencje stosowane przez
ozmake podczas instalowania plików wykonywalnych. --exe=domyślny użyj konwencji platformy
--exe=tak użyj rozszerzenia .exe --exe=nie nie używaj rozszerzenia --exe=oba zainstaluj wszystko
pliki wykonywalne z rozszerzeniem .exe i bez --exe=wiele zainstaluj funktory wykonywalne
zarówno dla Uniksa, jak i Windowsa. Wersje uniksowe są instalowane bez rozszerzenia i
wersje systemu Windows są instalowane z rozszerzeniem .exe

Odinstaluj
ozmake --odinstaluj
odinstaluj pakiet opisany przez makefile

ozmake --odinstaluj --pakiet=PKG
odinstaluj pakiet nazwany według identyfikatora potentata PKG

-e --odinstaluj
odinstaluj pakiet

Czyszczenie
ozmake --czysty
ozmake --bardzo czysto
usuń pliki zgodnie z funkcjami clean i Veryclean pliku makefile.
--bardzo czysto sugeruje --czysty .

Stwórz
ozmake --Stwórz [--pakiet=]
utwórz pakiet i zapisz go w PLIKU. Pliki potrzebne do pakietu to
automatycznie obliczane z pliku makefile. Jeśli --pakiet= nie jest dostarczany, a
wartość domyślna jest obliczana przy użyciu identyfikatora potentata (i ewentualnie numeru wersji) znalezionego w pliku
plik makefile.

--include(bins|libs|docs) --exclude(bins|libs|docs)
kontroluj, jakie typy celów znajdują się w pakiecie

Publikować
ozmake --publikować
automatycznie wykonuje wszystkie kroki niezbędne do utworzenia/aktualizacji pakietu
wniesione przez użytkownika i udostępnienie MOGUL-owi wszystkich niezbędnych danych
bibliotekarz. Zobacz dokumentację dla --potentat poniżej.

Wyciąg
ozmake --wyciąg --pakiet=
wyodrębnij pliki z pliku lub adresu URL PKG. Jeśli PKG jest identyfikatorem potentata, to pakiet jest
automatycznie pobrany z archiwum potentata

Lista
ozmake --lista
wyświetla informacje o wszystkich pakietach w zainstalowanej bazie danych pakietów

ozmake --lista --pakiet=
lista informacji o zainstalowanym pakiecie, identyfikowana przez identyfikator potentata MOGUL

--szerokość linii=N
domyślna: 70
przyjąć linię z N znaków

Config
ozmake --config=umieść
zapisz podane OPCJE w bazie danych konfiguracyjnych ozmake i użyj ich jako
domyślnie przy kolejnych wywołaniach ozmake, chyba że zostanie to wyraźnie zastąpione w pliku
wiersz poleceń. Na przykład: ozmake --config=umieść --prefix=/usr/local/oz oszczędza
/usr/local/oz jako domyślna wartość opcji prefix

ozmake --config=usuń ...
usuwa część wpisów z bazy konfiguracyjnej. Na przykład: ozmake
--config=usuń prefiks usuwa ustawienie domyślne dla prefix z konfiguracji
baza danych

ozmake --config=lista
wyświetla zawartość bazy danych konfiguracyjnych ozmake

argument za… --konfig można skrócić do dowolnego niejednoznacznego przedrostka

mogoł
Jeśli zdecydujesz się na dostarczanie pakietów do archiwum MOGUL, ozmake --mogul=
upraszcza Twoje zadanie. Dzięki niemu możesz łatwo zarządzać bazą danych
wkładów i wyeksportować je, aby bibliotekarz MOGUL mógł je automatycznie znaleźć.
W rzeczywistości najprostszym sposobem jest użycie ozmake --publikować który o wszystko się zatroszczy
szczegóły dla Ciebie.

ozmake --mogul=umieścić
zaktualizować bazę danych użytkownika dotyczącą wkładów własnych potentatów o odpowiednie dane
wkład (w katalogu lokalnym)

ozmake --mogul=umieścić --pakiet=
tak samo jak powyżej, ale przy użyciu wyraźnie podanego pakietu PKG

ozmake --mogul=usuń ...
usuń wpisy o identyfikatorach potentatów od MOG1 do MOGn z własnej bazy danych użytkownika
wkład

ozmake --mogul=usuń
usuń wpis dotyczący bieżącego wkładu

ozmake --mogul=lista
pokaż zapisane dane dla wszystkich wpisów w bazie użytkownika własnego potentata
składki

ozmake --mogul=lista ...
wyświetlić zapisane dane dla wpisów od MOG1 do MOGn we własnej bazie danych użytkownika
wkłady potentatów

ozmake --mogul=eksport
napisz wszystkie niezbędne wpisy o potentatach dotyczące własnego wkładu potentata użytkownika. To są
wpisy, które zostaną odczytane przez bibliotekarza MOGUL-u w celu automatycznego złożenia
pełna baza danych MOGUL.

Dane dotyczące Twoich wpisów należy udostępnić bibliotekarzowi MOGUL na stronie
SIEĆ. Chcesz po prostu zaktualizować katalog lokalny o swoje wpisy, ale w celu
bibliotekarz MOGUL, aby je znaleźć, katalogi te muszą być również dostępne poprzez adresy URL na
sieć. Oto kilka opcji, które pozwalają kontrolować tę korespondencję i dla
które powinieneś ustawić jako domyślne, używając ozmake --config=umieść

--moguldir=

--mogulurl=
MOGULDIR to katalog dostępny także w sieci WWW pod adresem URL MOGULURL.
MOGULDIR ma być katalogiem głównym, w którym znajdują się podkatalogi dla pakietów,
dokumentacja i wpisy o potentatach zostaną znalezione.

Dla tych, którzy naprawdę lubią ból, ozmake ma oczywiście wiele opcji, w których można się zastrzelić
stopa. W opcjach poniżej oznacza wersję nazwy pliku potentata pakietu
id (w zasadzie zamień ukośniki na myślniki). Możesz kontrolować, gdzie pakiety, ich
dokumentację i wpisy do bazy danych potentatów oraz przechowywane i udostępniane za pomocą opcji
poniżej:

--mogulpkgdir=
domyślna: /opakowanie//

--mogulpkgurl=
domyślna: /opakowanie//

--moguldocdir=
domyślna: /doc//

--moguldocurl=
domyślna: /doc//

--moguldbdir=
domyślna: /db//

--moguldburl=
domyślna: /db//

Wszystkie Twoje wpisy powinny mieć identyfikatory potentatów, którymi są poniżej identyfikator potentata, gdzie jesteś
przyznane dla twojej sekcji bazy danych potentata. Dla wygody, ozmake spróbuje
zgadnij identyfikator głównego potentata swojej sekcji, gdy tylko w Twojej bazie danych pojawią się wpisy
własne składki. Jednak o wiele lepiej jest powiedzieć ozmake o tym za pomocą:

--mogulrootid=

i ustawić go za pomocą ozmake --config=umieść --mogulrootid=

PLIK MAKE

Plik makefile zawiera pojedynczy rekord Oz, który opisuje projekt i normalnie powinien
umieścić w pliku o nazwie makefile.ozPlik makefile zazwyczaj wygląda następująco:

plik makefile(
biblioteka: ['Foo.ozf']
uri: 'x-ozlib://mylib'
potentat: 'mogul:/denys/lib-foo')

stwierdzając wyraźnie, że istnieje jeden cel biblioteki, a mianowicie funktor Foo.ozf,i to
powinien zostać zainstalowany pod adresem URI:

x-ozlib://mylib/Foo.ozf

i domyślnie, że powinien być skompilowany z pliku źródłowego Oz Foo.oz.Kiedy wzywasz
ozmake --zainstalować, mogoł Funkcja służy do jednoznacznej identyfikacji tego pakietu i plików
przyczynia się do ozmake baza zainstalowanych pakietów.

Istnieje wiele innych funkcji, które mogą wystąpić w pliku makefile i wszystkie są opcjonalne. Jeśli
pomijasz wszystkie funkcje, otrzymujesz tylko wartości domyślne i nawet nie potrzebujesz pliku makefile.
Wszystkie wartości, np pliki, należy podać jako ciąg wirtualny; atomy są zalecane z wyjątkiem
dla funkcji nota wydawnicza, info_tekst i info_html, gdzie zalecane są ciągi znaków.

plik makefile(
bin: [PLIKI...]
biblioteka: [PLIKI...]
dokument: [PLIKI...]
źródło: [PLIKI...]
zależy :
o( PLIK : [ PLIKI... ]
...
)
zasady :
o( PLIK : NARZĘDZIE(PLIK)
...
)
czysty: [GLOB...]
bardzoczysty: [GLOB...]
URI: URI
potentat: MOGUL
autor: [ AUTORZY... ]
Data wypuszczenia
notka: TEKST
info_text: TEKST
info_html: TEKST
podkatalogi: [ KATALOGI... ]
wymaga: [ MOGUL... ]
kategorie: [ KATEGORIA... ]
wersja: WERSJA
zapewnia: [PLIKI...]
)

Zawiera obiekty docelowe bin, lib i doc list, w których można zainstalować , i
odpowiednio. kosz cele powinny być wykonywalnymi funktorami, tj. powinny kończyć się na
rozbudowa .exe. lib obiekty docelowe to zazwyczaj skompilowane funktory, tj. zakończone rozszerzeniem
.ozf,ale mogą też być funktorami natywnymi, tj. kończącymi się rozszerzeniem .solub po prostu dane
akta. doc obiektami docelowymi są pliki dokumentacji.

Rozszerzenia
ozmake wie, jak budować cele, patrząc na rozszerzenie celu:

Foo.exe

jest wykonywalnym funktorem i jest tworzony z Foo.ozf

Foo.ozf

jest skompilowanym funktorem i jest tworzony z Foo.oz

Foo.o

jest skompilowanym plikiem C++ i jest tworzony z Foo.cc

Foo.so

jest rodzimym funktorem i jest tworzony z Foo.o

Foo.cc

jest plikiem źródłowym C++

Foo.hh

jest plikiem nagłówkowym C++

Zauważ, że takie są abstrakcyjny cele. W szczególności, Foo.so naprawdę oznacza plik
Foo.so- gdzie identyfikuje architekturę i system operacyjny, w którym
pakiet jest zbudowany; Na przykład: Linux-i486.Również, gdy jest to cel bin Foo.exe is
zainstalowany, jest instalowany zarówno jako /Foo.exe i /Foo żeby tak było
wywołany jako Foo na platformach Windows i Unix.

Koniecznie przestrzegaj konwencjonalnego użycia rozszerzeń opisanych tutaj:
ozmake nie pozwala na żadne zmiany i nie obsługuje żadnych innych rozszerzeń.

Zasady
ozmake posiada wbudowane reguły budowania plików. Czasami możesz chcieć zastąpić
domyślna reguła dla jednego lub większej liczby celów. Odbywa się to za pomocą funkcji rządzić który zawiera
rekord mapowania celu do reguły:

PLIK_TARGETOWY: NARZĘDZIE(PLIK_ŹRÓDŁOWY)

reguła może również zawierać listę opcji:

PLIK TARGET: NARZĘDZIE(OPCJE PLIKU ŹRÓDŁOWEGO)

Narzędzia obsługiwane przez ozmake jest oc (kompilator Oz), uncja (łącznik Oz), cc (Kompilator C++),
ld (Linker C++). Domyślne zasady to:

„Foo.exe”: ozl(„Foo.ozf” [plik wykonywalny])
'Foo.ozf' : ozc('Foo.ozf')
„Foo.o” : cc(„Foo.cc”)
„Foo.so” : ld( „Foo.o”)

Narzędzia obsługują następujące opcje:

oc

plik wykonywalny

spraw, aby wynik był wykonywalny

„zdefiniuj” (S)

zdefiniuj makro S.Tak samo jak -DS w wierszu poleceń

uncja

plik wykonywalny

spraw, aby wynik był wykonywalny

cc

uwzględnij (DIR)

Podobna do zwykłej opcji kompilatora C++ -IDIR. DIR jest ciągiem wirtualnym

„zdefiniuj” (MAC)

Podobna do zwykłej opcji kompilatora C++ -DMAC. PROCHOWIEC jest ciągiem wirtualnym

ld

biblioteka (DIR)

Podobna do zwykłej opcji linkera C++ -lDIR. DIR jest ciągiem wirtualnym

Możesz określić regułę tworzenia wstępnie połączonej biblioteki:

„Utils.ozf” : ozl(„Foo.ozf”)

lub aby utworzyć nieprelinkowany plik wykonywalny:

„Foo.exe”: ozc („Foo.oz” [plik wykonywalny])

Zależności
ozmake automatycznie określa, czy cele wymagały odbudowy, np. dlatego, że
brakuje lub jeśli jakiś plik źródłowy potrzebny do ich utworzenia został zmodyfikowany. Zasady są
służy do określania zależności między plikami. Czasami jest to niewystarczające, np. dlatego, że
używasz narzędzia uncja (zależności od importu), lub wstawić w pliku Oz lub #include w C++
plik. W takim przypadku możesz określić dodatkowe zależności za pomocą funkcji zależy który jest
rekord mapujący cele na listę zależności:

CEL: [ PLIKI... ]

Na przykład:

„Foo.o”: [ „Foo.hh” „Baz.hh” ]

or

„Foo.exe”: [ „Lib1.ozf” „Lib2.ozf” ]

Sprzątanie
Podczas programowania często wygodnie jest mieć możliwość łatwego usunięcia wszystkich śmieci i plików
skompilowane pliki, aby ponownie uzyskać czysty katalog projektu. Jest to wspierane przez ozmake
--czysty i ozmake --bardzo czysto;to drugie implikuje również pierwsze. Pliki do usunięcia to
określone przez kula wzory gdzie ? dopasowuje dowolny 1 znak i * pasuje do sekwencji 0
lub więcej znaków. Wszystkie pliki w BUILDDIR pasujące do jednego takiego wzorca zostaną usunięte. Tam są
wbudowane wzorce, ale można je zastąpić funkcjami kleń i bardzo czysto który
powinny być listami wzorców globalnych. Na przykład domyślne wzorce czystej globu to:

wyczyść: [ "*~" "*.ozf" "*.o" "*.so-*" "*.exe" ]

Pakiet Związane z Zakładka Charakterystyka
Linki

cecha Linki wskazuje URI, gdzie zainstalować cele bibliotek. Na przykład:

uri: 'x-ozlib://mylib/XML'

stwierdza, że ​​wszystko lib cele (np Foo.ozf) zostaną zainstalowane pod tym URI, tak aby
można z niego także zaimportować, czyli:

zaimportuj MyFoo pod adresem „x-ozlib://mylib/XML/Foo.ozf”

mogoł

cecha mogoł to identyfikator potentata jednoznacznie identyfikujący ten pakiet. Służy do identyfikacji
pakiet w bazie danych zainstalowanych pakietów, aby utworzyć/opublikować pakiet i aby
zainstaluj jego pliki dokumentacji.

autor

cecha autor jest ciągiem wirtualnym lub listą ciągów wirtualnych odpowiednio. identyfikacji autora
lub autorów pakietu. Zaleca się identyfikację autorów na podstawie ich identyfikatora potentata,
można jednak także po prostu podać ich nazwy. Na przykład zalecany sposób
jest:

autor: 'mogul:/duchier'

ale możliwe jest również:

autor: „Denys Duchier”

wydany

cecha wydany to wirtualny ciąg znaków określający datę i godzinę wydania w pliku
następujący format:

wydany: „RRRR-MM-DD-GG:MM:SS”

czas jest opcjonalny. Właściwą datą wydania przy użyciu bieżącej daty i godziny jest
automatycznie wstawiane podczas wywoływania ozmake --Stwórz or ozmake --publikować..

nota wydawnicza

cecha nota wydawnicza zawiera bardzo krótki fragment tekstu opisujący pakiet. Ten tekst powinien
być tylko jedną linią i ma być używany jako tytuł, gdy pakiet jest publikowany w
archiwum potentata.

info_tekst

cecha info_tekst zawiera zwykły tekstowy opis pakietu. To ma być
użyte jako streszczenie na stronie prezentacji pakietu w archiwum potentata. To
powinien być krótki i informacyjny, ale nie powinien stanowić dokumentu dokumentującego paczkę.

info_html

cecha info_html jest podobne do info_tekst ale zawiera HTML, a nie zwykły tekst.

src

cecha src wskazuje, które cele należy uznać za źródłowe, czyli w szczególności nie-
do zbudowania. Wszystkie cele wymienione w src należy wspomnieć w kosz, libAlbo doc także.
punkt src jest wspieranie dystrybucji pakietów z gotowymi celami i bez dawania
z odpowiednich źródeł. Nie powinieneś tego robić z rodzimymi funktorami, ponieważ takie są
zależny od platformy i nie przenośny, ale może być wygodnym sposobem dystrybucji pre-
zbudował biblioteki Oz. Na przykład:

plik makefile(
lib: [ 'Foo.ozf' ]
src: [ 'Foo.ozf' ]
uri: 'x-ozlib://mylib'
potentat: 'mogul:/myname/foolib')

to plik makefile dla pakietu, który dystrybuuje wstępnie skompilowane Foo.ozf,ale też nie
rozpowszechniaj jego źródło Foo.oz.Normalnie, kiedy budujesz pakiet, po prostu sprawdza, czy
src pliki są obecne, ale nie zostaną podjęte próby ich zbudowania. Jeżeli masz źródła to możesz
wymusić budowanie src cele, jeśli to konieczne, za pomocą --pełna budowa..

podkatalogi

cecha podkatalogi to lista samych nazw plików reprezentujących podkatalogi projektu. Przez
domyślnie, jeśli to konieczne, ozmake będzie powracał do tych podkatalogów. Jest to oczekiwane
że każdy podkatalog powinien udostępniać swój własny plik makefile. Identyfikator potentata jest automatycznie
dziedziczony do podkatalogów, a identyfikator uri jest automatycznie rozszerzany poprzez dodanie nazwy
podkatalog: w ten sposób podpliki makefile mogą być prostsze, ponieważ nie trzeba się nimi przejmować
z funkcjami na poziomie pakietu.

Wymaga

cecha Wymaga to lista identyfikatorów URI modułów lub identyfikatorów pakietów MOGUL. Reprezentują one
zewnętrzny zależności pakietu. Nie są jeszcze używane, ale w końcu ozmake będzie
można ich używać do automatyzacji rekursywnej instalacji innych pakietów wymaganych przez
taki, który Cię interesuje.

kategorie

cecha kategorie to lista kategorii MOGUL, która pomaga kategoryzować ten pakiet w
Archiwum MOGUL-a.

wersja

cecha wersja służy do podania ciągu wersji. Jest to ciąg składający się z
liczby całkowite oddzielone pojedynczymi kropkami, np "2" or "3.1.7"..

zapewnia

cecha zapewnia służy do zastąpienia domyślnych informacji o tym, czym jest pakiet
zapewnia, zwykle obliczane automatycznie z kosz i lib cele: powinno być
lista zawierająca podzbiór tych celów. The zapewnia funkcja pliku makefile nie
zastąpić lub w inny sposób wpłynąć na jego podpliki make: każdy plik makefile powinien osobno zastąpić
jeśli tego pragnie. Stwierdzenie, że plik makefile oficjalnie nie udostępnia żadnych funktorów lub
wykonywalną aplikację, dodałbyś:

zapewnia: zero

Powinieneś użyć zapewnia funkcja, gdy Twój pakiet zawiera zarówno oficjalne pliki publiczne
funktory, jak również funktory czysto implementacyjne, które nie są częścią oficjalną
interfejs publiczny i nie należy o nim wspominać pod warunkiem, przez paczkę.

KONTAKT

Autorzy powinni naprawdę być określani za pomocą identyfikatorów potentatów oznaczających wpisy potentatów, które opisują
ich. Aby to ułatwić, a makefile.oz może również zawierać A skontaktuj się cecha, która
jest albo zapisem opisującym osobę, albo listą takich zapisów.

Nie powinieneś mieć skontaktuj się funkcja w każdym pliku makefile. Raczej, skontaktuj się funkcja jest
zwykle przeznaczone dla plików makefile, które mają tylko plik skontaktuj się cecha, tj. którego jedyny cel
polega na utworzeniu wpisów potentatów dla odpowiednich osób. Oto przykład takiego
plik makefile:

plik makefile(
kontakt :
o(
potentat: 'mogul:/duchier/denys'
imię: „Denys Duchier”
e-mail : '[email chroniony]'
www: 'http://www.ps.uni-sb.de/~duchier/'))

Możesz się przywołać ozmake --publikować na takim pliku makefile, aby wnieść odpowiedni potentat
wpisy do bazy danych

Korzystaj z ozmake online, korzystając z usług onworks.net