Ubuntu Manpage: apropos - caută numele și descrierile paginii manualului

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/cjwatson/man-db/-/issues
       https://savannah.nongnu.org/bugs/?group=man-db