APROPOS
Section: Utilitare ale paginatorului de manual (1)
Updated: 2023-01-08
Index
Return to Main Contents
NUME
apropos - caută numele și descrierile paginii manualului
REZUMAT
apropos [-dalv?V] [-e|-w|-r] [-s
listă] [-m sistem[,...]] [-M cale]
[-L identificator_localizare] [-C fișier]
cuvânt_cheie ...
DESCRIERE
Fiecare pagină de manual are o descriere scurtă disponibilă înăuntrul
acesteia. apropos caută descrierile pentru instanțe ale
cuvânt_cheie.
cuvânt(ul)_cheie este de obicei o expresie regulată, ca și cum ar fi fost
utilizat (-r) , sau poate să conțină metacaractere (-w), sau să se
potrivească exact cu cuvântul cheie (-e). Utilizând aceste opțiuni,
poate fi necesar să citați cuvânt(ul)_cheie sau să eludați (\)
caracterele speciale, pentru a prevenii interpretarea lor, de către «shell».
Regulile standard de potrivire, permit ca potrivirile să fie făcute cu
numele paginii și limitele cuvintelor din descriere.
Baza de date căutată de apropos este actualizată de programul
mandb. În funcție de instalarea dvs., acesta poate fi executat
printr-o lucrare periodică «cron», sau poate fi necesar să fie executat
manual ,după ce au fost instalate noi pagini de manual.
OPȚIUNI
- -d, --debug
-
Imprimă informațiile de depanare.
- -v, --verbose
-
Imprimă mesaje de avertisment detaliate.
- -r, --regex
-
Interpretează fiecare cuvânt cheie ca o expresie regulată. Acesta este
comportamentul implicit. Fiecare cuvânt cheie va fi corelat cu numele
paginilor și descrierilor în mod independent. Se poate potrivi cu orice
parte dintre ele. Potrivirea nu este limitată la limitele de cuvinte.
- -w, --wildcard
-
Interpretează fiecare cuvânt cheie ca un model care conține metacaractere în
stilul «shell». Fiecare cuvânt cheie va fi corelat cu numele paginilor și
descrierilor în mod independent. Dacă --exact este, de asemenea,
utilizat, o potrivire va fi găsită doar dacă un cuvânt cheie expandat se
potrivește cu numele complet al paginii sau cu întreaga descriere. În caz
contrar, cuvântul cheie poate să se potrivească și în limitele cuvintelor
din descriere.
- -e, --exact
-
Fiecare cuvânt cheie va fi corelat exact cu numele paginilor și
descrierilor.
- -a, --and
-
Afișează doar elemente care se potrivesc cu cuvintele cheie specificate. În
mod implicit, sunt afișate elementele care se potrivesc oricărui cuvânt
cheie.
- -l, --long
-
Nu reduce ieșirea la lățimea terminalului. În mod normal, ieșirea va fi
trunchiată la lățimea terminalului pentru a evita rezultate nedorite din
secțiunile NUME scrise greșit.
- -s listă/, --sections=listă/, --section=listă
-
Caută doar secțiunile de manual specificate. listă, este o listă de
secțiuni separate prin două puncte sau virgulă. Dacă o intrare din listă
este o secțiune simplă, de exemplu „3”, atunci lista de descrieri afișată va
include pagini din secțiunile „3”, „3perl”, „3x”, și așa mai departe; în
timp ce, dacă o intrare din listă are o extensie, de exemplu „3perl”,
atunci lista va include doar paginile din acea parte exactă a secțiunii de
manual.
- -m sistem[,...], --systems=sistem[,...]
-
Dacă acest sistem are acces la descrierile paginilor de manual ale altor
sisteme de operare, acestea pot fi căutate utilizând această opțiune.
Pentru a căuta în descrierile paginilor de manual ale «Noului_SO», utilizați
opțiunea -m «Nou_SO».
sistem(ul) specificat poate fi o combinație de nume de sisteme de operare
delimitate de virgule. Pentru a include o căutare a descrierilor whatis
ale sistemului de operare nativ, includeți numele sistemului man în șirul
de argumente. Această opțiune va suprascrie variabila de mediu $SYSTEM.
- -M calea, --manpath=calea
-
Specificați un set alternativ de ierarhii de pagini de manual, delimitate de
două puncte, pentru căutare. În mod implicit, apropos utilizează
variabila de mediu $MANPATH, cu excepția cazului în care aceasta este
goală sau nestabilită, caz în care va determina o cale adecvată către
paginile de manual, pe baza variabilei de mediu $PATH. Această opțiune
suprascrie conținutul lui $MANPATH.
- -L identificator_localizare, --locale=identificator_localizare
-
apropos va determina în mod normal localizarea curentă printr-un apel
la funcția C setlocale(3) care interoghează diverse variabile de mediu,
inclusiv $LC_MESSAGES și $LANG. Pentru a suprascrie temporar valoarea
determinată, utilizați această opțiune pentru a furniza un șir
identificator_localizare direct către apropos. Rețineți că aceasta
nu va avea efect până când căutarea paginilor nu începe efectiv. Ieșirea
precum mesajul de ajutor va fi întotdeauna afișată în localizarea
determinată inițial.
- -C fișier, --config-file=fișier
-
Utilizează acest fișier de configurare al utilizatorului, mai degrabă decât
cel implicit din ~/.manpath.
- -?, --help
-
Imprimă un mesaj de ajutor și iese.
- --usage
-
Imprimă un mesaj scurt de utilizare și iese.
- -V, --version
-
Afișează informații despre versiune.
STARE DE IEȘIRE
- 0
-
Executarea programului s-a încheiat fără erori.
- 1
-
Eroare de utilizare, de sintaxă sau de fișier de configurare.
- 2
-
Eroare operațională.
- 16
-
Nu s-a găsit nimic care să se potrivească cu criteriile specificate.
MEDIU
- SYSTEM
-
Dacă $SYSTEM este stabilit, acesta va avea același efect ca și cum ar fi
fost specificat ca argument la opțiunea -m.
- MANPATH
-
Dacă $MANPATH este stabilită, valoarea acesteia va fi interpretată ca,
calea delimitată de două puncte pentru ierarhiile de pagini de manual care
urmează să fie utilizate.
Consultați secțiunea CALEA DE CĂUTARE din manpath(5) pentru
comportamentul implicit și detalii despre modul în care este gestionată
această variabilă de mediu.
- MANWIDTH
-
Dacă $MANWIDTH este stabilită, valoarea acesteia este utilizată ca
lățimea terminalului (consultați opțiunea --long). Dacă nu este
stabilită, lățimea terminalului va fi calculată utilizând valoarea de
$COLUMNS, și ioctl(2) dacă este disponibilă, sau se revine la 80 de
caractere dacă orice altceva eșuează.
- POSIXLY_CORRECT
-
Dacă $POSIXLY_CORRECT este stabilită, chiar la o valoare null, căutarea
implicită apropos va fi ca o expresie regulată extinsă (-r). În
prezent, acesta este oricum comportamentul implicit.
FIȘIERE
- /usr/share/man/index.(bt|db|dir|pag)
-
Memorie tampon a bazei de date index globală tradițională.
- /var/cache/man/index.(bt|db|dir|pag)
-
Memorie tampon a bazei de date index globală conform cu FHS.
- /usr/share/man/.../whatis
-
O bază de date text whatis tradițională.
CONSULTAȚI ȘI
man(1),
whatis(1),
mandb(8)
AUTOR
Wilf. (G.Wilford@ee.surrey.ac.uk).Fabrizio Polacco (fpolacco@debian.org).Colin Watson (cjwatson@debian.org).
DEFECȚIUNI
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db
Index
- NUME
-
- REZUMAT
-
- DESCRIERE
-
- OPȚIUNI
-
- STARE DE IEȘIRE
-
- MEDIU
-
- FIȘIERE
-
- CONSULTAȚI ȘI
-
- AUTOR
-
- DEFECȚIUNI
-
This document was created by
man2html,
using the manual pages.
Time: 09:58:43 GMT, May 18, 2024