Linux Certif

Toute la documentation sur la certification Linux LPI

install-info

NAZWA

install-info - tworzy lub aktualizuje wpis w katalogu Info

SK£ADNIA

install-info [--version] [--help] [--debug] [--maxwidth=nnn] [--section wyra¿_regularne tytu³] [--infodir=xxx] [--align=nnn] [--quiet] [--menuentry=xxx] [--description=xxx] [--remove|--remove-exactly] [--] nazwa_pliku

OPIS

install-info tworzy, aktualizuje i usuwa wpisy w katalogu Info, czyli pliku dir. Podczas aktualizowania lub tworzenia wpisów, je¿eli nie podano opisu ani w linii poleceñ, ani w pliku Info, podejmowana jest próba zgadniêcia opisu na podstawie zawarto¶ci pliku.

W opisie opcji --section mo¿na znaleŒæ szczegó³y dotycz±ce miejsca, w którym zostanie umieszczony wpis oraz opis oczekiwanego formatu pliku dir.

OPCJE

[--] nazwa pliku

Okre¶la nazwê pliku Info, dla którego ma zostaæ utworzony, zaktualizowany lub usuniêty wpis w menu. Je¶li podano --remove-exactly, wtedy nazwa_pliku powinna zawieraæ dok³adn± nazwê wpisu w menu do usuniêcia (jak np. "emacs-20/emacs" lub "gcc"). W przeciwnym wypadku bazowa nazwa tego pliku jest u¿ywana jako odniesienie do wpisu w menu, który bêdzie tworzony, chyba ¿e w podanym pliku znajduje siê nadpisuj±cy wpis START-INFO-DIR. Taki plik musi wtedy istnieæ (lub powinien byæ instalowany, lub powinien ju¿ istnieæ podczas usuwania wpisu) w tym samym katalogu co plik dir (proszê sprawdziæ opcjê --infodir).

Je¿eli nazwa_pliku koñczy siê rozszerzeniem .gz, to jest traktowana jako odwo³anie do pliku spakowanego programem gzip. Je¶li plik nazwa_pliku nie istnieje, to u¿ywany jest plik nazwa_pliku.gz, o ile takowy istnieje.

Podczas dodawania lub aktualizowania wpisów plik ten musi istnieæ w podanej ¶cie¿ce (byæ mo¿e z dodatkowym rozszerzeniem .gz).

--remove

Okre¶la, ¿e wpis dla pliku nazwa_pliku bêdzie usuniêty; domy¶lnie wpisy s± tworzone lub aktualizowane.

Je¶li usuniêcie prowadzi do tego, ¿e sekcja zosta³aby pusta, nag³ówek sekcji (oraz zapasowa pusta linia) tak¿e bêd± usuniête, chyba ¿e jest to ostatnia sekcja w pliku lub podano opcjê --keep-old. Proszê sprawdziæ opcjê --section w celu uzyskania informacji na temat spodziewanego formatu pliku dir.

Je¶li w pliku dir znajduje siê kilka odpowiednich wpisów, bêd± usuniête tylko wpisy z pierwszej ci±g³ej pasuj±cej grupy, za¶ pozosta³e zostan± zignorowane bez ¿adnego ostrze¿enia.

Nie odnalezienie odpowiedniego wpisu nie jest b³êdem, jednak install-info wy¶le ostrze¿enie, chyba ¿e podano opcjê --quiet.

Je¿eli podano --remove, to opcje formatowania --maxwidth, --align oraz --calign zostan± zignorowane bez ¿adnego ostrze¿enia.

--remove-exactly

Ta opcja jest praktycznie taka sama jak --remove z t± ró¿nic±, ¿e wtedy nazwa_pliku powinna zawieraæ dok³adn± nazwê wpisu w menu do usuniêcia, zamiast nazwy istniej±cego pliku. Mo¿e byæ to istotne podczas próby usuniêcia wpisów odnosz±cych siê do plików w podkatalogach (np. "emacs-20/emacs"), poniewa¿ --remove bêdzie korzystaæ z bazowej nazwy podanej nazwy_pliku zamiast dok³adnej nazwy. (np. --remove "emacs-20/emacs" spowodowa³by, ¿e install-info szuka³oby "emacs", a nie "emacs-20/emacs").

--section wyra¿_regularne tytu³

Okre¶la, ¿e je¶li ma byæ stworzony nowy wpis, powinien byæ umieszczony w sekcji w pliku dir, której tytu³ pasuje do wyra¿_regularnego. Je¶li taka sekcja nie istnieje, zostanie utworzona jako przedostatnia sekcja w pliku (patrz ni¿ej) z tytu³em tytu³. Sekcja jest czê¶ci± menu dir otoczon± pustymi liniami; pierwsza linia sekcji uwa¿ana jest za jej tytu³.

Je¶li ma byæ utworzony nowy wpis, install-info bêdzie staraæ siê wstawiæ go w ramach sekcji w porz±dku alfabetycznym. Je¶li wpisy w sekcji nie s± wstêpnie posortowane, po³o¿enie wpisu w sekcji bêdzie nie do przewidzenia. Kolejno¶æ istniej±cych wpisów nie bêdzie zmieniana.

Je¶li nie zostanie podana opcja --section, install-info bêdzie szukaæ tytu³u w samym pliku Info, poszukuj±c wpisu postaci

INFO-DIR-SECTION tytu³

Je¶li tytu³ sekcji nie zostanie znaleziony, domy¶lnym zachowaniem jest dodanie nowych wpisów na koñcu pliku. Ostatnia sekcja (nawet je¶li sk³ada siê tylko z linii z tytu³em) powinna zawsze istnieæ aby zapewniæ, ¿e nowe sekcje bêd± tworzone we w³a¶ciwym miejscu. Ostatnia sekcja powinna byæ zatytu³owana w sposób odzwierciedlaj±cy fakt, ¿e bêd± do niej do³±czane pliki Info, które nie maj± okre¶lonego lepszego po³o¿enia.

Je¶li wpis dla instalowanego pliku Info ju¿ istnieje, jest zastêpowany w miejscu przez nowy wpis.

Je¶li podczas usuwania wpisu podano sekcjê, to bêdzie ona zignorowana oraz zostanie wypisane odpowiednie ostrze¿enie.

Je¶li okre¶lono sekcjê podczas dodawania wpisu, ale plik nie zawiera wcale nag³ówków sekcji, install-info utworzy zarówno ¿±dan± sekcjê jak i sekcjê Miscellaneous na koñcu pliku.

--infodir=katalog_info

Okre¶la, ¿e plik dir jest, a zainstalowana kopia nowego pliku Info by³a, jest lub bêdzie zlokalizowana w katalogu_info. Domy¶lnie jest to /usr/share/info/.

--align=nnn [przestarza³e]

Okre¶la, ¿e wciêcie pierwszej linii opisu powinno wynosiæ co najmniej nnn znaków; je¶li bêdzie to potrzebne, to zostan± dodane dodatkowe spacje. Je¶li bêdzie to potrzebne z powodu d³ugo¶ci szczegó³ów wpisu dir w menu, mo¿e byæ ich dodanych nawet wiêcej. Domy¶ln± warto¶ci± jest 27.

--calign=nnn [przestarza³e]

Okre¶la, ¿e wciêcie drugiej i kolejnych linii opisu powinno wynosiæ co najmniej nnn znaków. Domy¶lnie jest to 29.

--maxwidth=nnn [przestarza³e]

Okre¶la, ¿e maksymalna szeroko¶æ pliku Info to nnn. Jest to u¿ywane podczas zawijania s³ów tekstu opisu. Domy¶lnie jest to 79.

--quiet

Zapobiega typowemu wy¶wietlaniu nowego wpisu w menu tu¿ przed jego wstawieniem, komunikatom og³aszaj±cym zast±pienie i usuniêcie istniej±cych wpisów oraz tworzenie i usuwanie sekcji.

--help

Powoduje, ¿e install-info wy¶wietli informacje o u¿yciu i zakoñczy dzia³anie.

--version

Powoduje, ¿e install-info wy¶wietli informacje o wersji i prawach autorskich i zakoñczy dzia³anie.

--description=xxx

Okre¶la, ¿e opisem u¿ywanym za wpisem w menu dla nowych lub aktualizowanych wpisów ma byæ xxx. Domy¶lnie u¿ywana jest warto¶æ okre¶lona w samym pliku Info, jest ona wyszukiwana poszukuj±c sekcji postaci
START-INFO-DIR-ENTRY
* Auto-PGP: (auto-pgp). PGP w GNU Emacsie.
END-INFO-DIR-ENTRY

Je¶li wpis znaleziony w samym pliku Info rozci±ga siê na kilka linii, z których ka¿da tworzy wpis w menu, tekst znaleziony w pliku jest u¿ywany dos³ownie. Sortowanie alfabetyczne jest wtedy wy³±czane, a wpisy s± wstawiane na pocz±tku wskazanej sekcji. W takim przypadku opcje --menuentry, --maxwidth, --align, --calign i --menuentry s± ignorowane.

Je¶li w pliku nie ma wpisu dir, program bêdzie stara³ siê znaleŒæ paragraf na pocz±tku pliku rozpoczynaj±cy siê od this file documents. Pierwszy znak pozosta³ej czê¶ci zostanie zamieniony na wielk± literê i to zostanie u¿yte.

B³êdem jest je¶li ¿adna z tych metod nie zwróci opisu.

Je¶li podczas usuwania (--remove) podano argument zawieraj±cy opis, to jest on ignorowany i odpowiednie ostrze¿enie jest wypisywane.

--menuentry=xxx

Okre¶la, ¿e wpisem w menu powinno byæ xxx. Domy¶lnie u¿ywana jest warto¶æ okre¶lona w samym pliku Info. Je¶li jej nie ma, u¿ywana jest bazowa nazwa pliku Info (ponadto czê¶æ .info jest usuwana, jest te¿ zmieniany odpowiednio rozmiar liter pozosta³ego wpisu). Szczegó³owe informacje na temat oczekiwanego formatu wpisu w menu zawartego w pliku Info mo¿na znaleŒæ powy¿ej.

Podczas usuwania wpisów, warto¶æ opcji --menuentry musi odpowiadaæ bie¿±cej warto¶ci wpisu pola menu w usuwanej pozycji menu (wielko¶æ znaków nie ma znaczenia). Je¶li nie podano --menuentry, to wpis menu nie jest sprawdzany.

--keep-old

Zabrania zastêpowania istniej±cych wpisów i usuwania pustych sekcji.

Je¶li instalowany plik ma ju¿ wpis w pliku dir, stary wpis bêdzie pozostawiony zamiast zamieniania go. Domy¶lnie stare wpisy s± nadpisywane przez nowo wygenerowane.

Je¿eli podano opcjê --remove, to --keep-old zapobiegnie usuniêciu nag³ówka sekcji, co by siê zdarzy³o, gdyby po usuniêciu nag³ówka sekcja sta³a siê pusta.

--test

W³±cza tryb testowy, który powstrzymuje aktualizacjê pliku katalogu Info dir.

--debug

W³±cza tryb debugowania, w którym pokazywane s± wyniki wewnêtrznych kroków przetwarzania.

ZOBACZ TAK¯E

emacs(1), info(1), gzip(1).

AUTOR

Copyright 1994 Ian Jackson

Niniejszy program jest oprogramowaniem wolnym, sprawdŒ Powszechn± Licencjê Publiczn± GNU w wersji drugiej lub póŒniejszej, by dowiedzieæ siê o warunkach dystrybucji. Brak JAKIEJKOLWIEK gwarancji.

T£UMACZE

Piotr Roszatycki <dexter@debian.org>, 1999
Bartosz Feñski <fenio@debian.org>, 2004-2005
Robert Luberda <robert@debian.org>, 2006-2008
Wiktor Wandachowicz <siryes@gmail.com>, 2008