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 ruta] [-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».

Sistemul 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 ruta, --manpath=ruta
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 rută 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 fiind ruta de căutare a
              ierarhiei paginilor de manual delimitată prin două puncte care trebuie utilizată.

              Consultați secțiunea RUTA 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

2.12.1                                             2024-04-05                                         APROPOS(1)