Opțiuni generale¶

-C fișier, --config-file=fișier

Utilizează acest fișier de configurare al utilizatorului, mai degrabă decât cel implicit din ~/.manpath.

-d, --debug

Imprimă informațiile de depanare.

-D, --default

Această opțiune este în general folosită ca primă opțiune, și restaurează comportamentul lui man cu configurările implicite. Utilizarea sa este de a reconfigura acele opțiuni care ar fi putut fi configurate în $MANOPT. Orice opțiuni care urmează după -D, vor avea efectul obișnuit.

--warnings[=avertismente]

Activează avertismentele de la groff. Aceasta poate fi folosită pentru a efectua verificări de corectitudine asupra textului sursă al paginilor de manual. warnings este o listă de nume de avertismente separate prin virgulă; dacă niciunul nu este furnizat, se folosește valoarea implicită „mac”. Pentru a dezactiva un avertisment groff, prefixați-l cu „!”; de exemplu: --warnings=mac,!break activează avertismentele din categoria „mac” și dezactivează avertismentele din categoria „break”. Consultați nodul “Avertismente” din info groff) pentru o listă a numelor de avertismente disponibile.

Principalele moduri de operare¶

-f, --whatis

Aproximativ echivalent cu whatis. Dacă pagina de manual este disponibilă, este afișată o scurtă descriere a paginii de manual dorite. Consultați whatis(1), pentru a obține mai multe detalii.

-k, --apropos

Aproximativ echivalent cu apropos. Caută în descrierile scurte ale paginilor de manual pentru cuvintele cheie date, și afișează orice potrivire. Consultați apropos(1), pentru a obține mai multe detalii.

-K, --global-apropos

Caută textul în toate paginile de manual. Aceasta este o căutare de forță brută, și care poate să dureze ceva timp; dacă puteți, ar trebui să specificați o secțiune pentru a reduce numărul de pagini care trebuie luate în considerare. Termenii de căutare pot fi șiruri simple (opțiunea implicită), sau expresii regulate dacă este utilizată opțiunea --regex.

Rețineți că aceasta caută în sursele paginilor de manual(neformatate), nu în textul ce este afișat, așa că poate include falsuri pozitive din cauza comentariilor din fișierele sursă, sau falsuri negative din cauza unor lucruri precum cratimele care sunt scrise ca „\-” în fișierele sursă. Căutarea textului formatat ar fi mult mai lentă.

-l, --local-file

Activează modul „local”. Formatează și afișează fișierele de manual locale în loc să caute prin colecția de manuale a sistemului. Fiecare argument de pagină de manual va fi interpretat ca un fișier sursă «nroff» în formatul corect. Nu este produs niciun fișier «cat». Dacă „-” este listat ca unul dintre argumente, intrarea va fi preluată de la intrarea standard.

Dacă această opțiune nu este utilizată, atunci man va interpreta argumentele paginii de manual ca nume de fișiere locale dacă argumentul conține un caracter „/”, deoarece acesta este un bun indiciu că argumentul se referă la o rută din sistemul de fișiere.

-w, --where, --path, --location

Nu afișează de fapt pagina de manual, dar imprimă locația fișierului «nroff» sursă care ar fi formatat. Dacă se folosește și opțiunea -a, atunci imprimă locațiile tuturor fișierelor sursă care corespund criteriilor de căutare.

-W, --where-cat, --location-cat

Nu afișează de fapt pagina de manual, dar imprimă locația fișierului «cat» preformatat care ar fi afișat. Dacă se folosește și opțiunea -a, atunci imprimă locațiile tuturor fișierelor «cat» preformatate care corespund criteriilor de căutare.

Dacă atât -w, cît și -W sunt utilizate, atunci imprimă atât fișierul sursă cât și fișierul «cat» separate printr-un spațiu. Dacă -w, -W și -a sunt date împreună, atunci acest lucru se face pentru fiecare potrivire posibilă.

-c, --catman

Această opțiune nu este pentru uz general și ar trebui să fie utilizată doar de programul catman.

-R codificarea, --recode=codificarea

În loc să formateze pagina de manual în modul obișnuit, produce sursa convertită la codificarea specificată. Dacă știți deja codificarea fișierului sursă, puteți utiliza și manconv(1) direct. Cu toate acestea, această opțiune vă permite să convertiți mai multe pagini de manual într-o singură codificare fără a fi nevoie să declarați în mod explicit codificarea pentru fiecare dintre ele, cu condiția ca acestea să fi fost deja instalate într-o structură similară cu o ierarhie a paginii de manual.

Considerați utilizarea lui man-recode(1) în locul convertirii de pagini de manual multiple, de vreme ce are o interfață proiectată pentru conversia în vrac și deci poate fi mult mai rapidă.

Găsirea paginilor de manual¶

-L identificator_localizare, --locale=identificator_localizare

man 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 man. 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.

-m sistem[,...], --systems=sistem[,...]

Dacă acest sistem are acces la paginile de manual ale altor sisteme de operare, acestea pot fi căutate utilizând această opțiune. Pentru a căuta o pagină de manual din colecția de pagini de manual a «Noului_SO», utilizați opțiunea -m «Nou_SO».

sistem(ul) specificat poate fi o combinație de nume de sisteme de operare delimitate prin virgule. Pentru a include o căutare a paginilor de manual ale sistemului de operare nativ, includeți numele sistemului man în șirul argumentului. Această opțiune va suprascrie variabila de mediu $SYSTEM.

-M ruta, --manpath=ruta

Specifică o rută de manual alternativă de utilizat. În mod implicit, man utilizează cod derivat manpath pentru a determina ruta de căutat. Această opțiune suprascrie variabila de mediu $MANPATH și face ca opțiunea -m să fie ignorată.

O rută specificată drept o rută de manual trebuie să fie rădăcina unei ierarhii a paginilor de manual, structurată în secțiuni, așa cum este descris în manualul man-db (sub „Sistemul paginilor de manual”). Pentru a vizualiza paginile de manual în afara acestor ierarhii, consultați opțiunea -l.

-S listă, -s listă, --sections=listă

lista dată este o listă de secțiuni separată prin virgulă sau două puncte, utilizată pentru a determina ce secțiuni de manual să se caute și în ce ordine. Această opțiune suprascrie variabila de mediu $MANSECT. (Ortografia -s este pentru compatibilitate cu System V.)

-e sub-extensie, --extension=sub-extensie

Unele sisteme încorporează pachete mari de pagini de manual, precum acelea care însoțesc pachetul Tcl, în ierarhia principală a paginilor de manual. Pentru a evita problema de a avea două pagini de manual cu același nume, cum ar fi exit(3), paginile Tcl au fost de obicei toate atribuite secțiunii l. Deoarece acest lucru este regretabil, acum este posibil să puneți paginile în secțiunea corectă, și să le atribuiți o „extensie” specifică, în acest caz, exit(3tcl). În condiții normale de funcționare, man va afișa exit(3) în detrimentul a exit(3tcl). Pentru a negocia această situație și pentru a evita să știți în ce secțiune se află pagina de care aveți nevoie, acum este posibil să dați lui man un șir sub-extensie care indică pachetul căruia trebuie să aparțină pagina. Utilizând exemplul de mai sus, furnizarea opțiunii -e tcl la man va restricționa căutarea la paginile care au extensia *tcl.

-i, --ignore-case

Nu face distincție între majuscule și minuscule atunci când caută paginile de manual. Acesta este modul implicit de căutare.

-I, --match-case

Caută paginile de manual făcând .

--regex

Afișează toate paginile cu orice parte a numelui sau descrierilor lor care se potrivesc cu fiecare argument pagină ca expresie regulată, ca și în cazul apropos(1). Deoarece de obicei nu există o modalitate rezonabilă de a alege pagina „cea mai bună” atunci când se caută pentru o expresie regulată, această opțiune implică -a.

--wildcard

Afișează toate paginile cu orice parte a numelui sau a descrierilor lor care se potrivesc cu fiecare argument pagină utilizând metacaractere în stil shell, ca și în cazul apropos(1) --wildcard. Argumentul pagină trebuie să se potrivească cu numele întreg sau cu întreaga descrierea sau să se potrivească în limitele cuvintelor din descriere. Deoarece de obicei nu există o modalitate rezonabilă de a alege pagina „cea mai bună” atunci când se caută pentru un metacaracter, această opțiune implică -a.

--names-only

Dacă se utilizează opțiunea --regex sau --wildcard, aceasta caută coincidențe doar cu numele paginilor, nu cu descrierile paginilor, cum ar fi cu whatis(1). Altfel, nu are niciun efect.

-a, --all

În mod implicit, man va ieși după afișarea celei mai potrivite pagini de manual pe care o găsește. Folosirea acestei opțiuni forțează man să afișeze toate paginile de manual cu nume care corespund criteriilor de căutare.

-u, --update

Această opțiune determină man să-și actualizeze memoria tampon a bazei de date a paginilor de manual instalate. Acest lucru este necesar doar în situații rare și, în mod normal, este mai bine să rulați mandb(8).

--no-subpages

În mod implicit, man va încerca să interpreteze perechile de nume de pagini manual date în linia de comandă, ca echivalent cu un singur nume de pagină de manual care conține o cratimă sau un caracter de subliniere. Aceasta suportă modelul comun al programelor care implementează o serie de subcomenzi, permițându-le să furnizeze pagini de manual pentru fiecare dintre ele, și care pot fi accesate folosind o sintaxă similară cu cea care ar fi folosită pentru a invoca subcomenzile în sine. De exemplu:

  $ man -aw git diff
  /usr/share/man/man1/git-diff.1.gz

Pentru a dezactiva acest comportament, utilizați opțiunea --no-subpages.

  $ man -aw --no-subpages git diff
  /usr/share/man/man1/git.1.gz
  /usr/share/man/man3/Git.3pm.gz
  /usr/share/man/man1/diff.1.gz

Controlarea ieșirii formatate¶

-P paginator, --pager=paginator

Specifică ce paginator de ieșire să fie utilizat. În mod implicit, man folosește pager, revenind la cat dacă pager nu este găsit sau nu este executabil. Această opțiune suprascrie variabila de mediu $MANPAGER, care la rândul său suprascrie variabila de mediu $PAGER. Nu este utilizată împreună cu -f sau -k.

Valoarea poate fi un nume de comandă simplă sau o comandă cu argumente, și poate utiliza ghilimele de tip shell (bară oblică inversă, ghilimele simple sau ghilimele duble). Aceasta nu poate să folosească linii de conectare pentru a conecta mai multe comenzi; dacă aveți nevoie de asta, utilizați un script care preia fișierul pentru a fi afișat dintr-un argument sau de la intrarea standard.

-r prompt, --prompt=prompt

Dacă o versiune recentă a less este utilizată ca paginator,, man va încerca să -și stabilească prompterul și unele opțiuni sensibile. În mod implicit, prompterul arată ca

Pagina de manual nume(secțiune) linia x

unde nume denotă numele paginii de manual, secțiune denotă secțiunea sub care a fost găsit și x numărul de linie curent. Acest lucru se realizează prin utilizarea variabilei de mediu $LESS.

Furnizarea lui -r cu un șir va suprascrie acest mod implicit. Șirul poate conține textul $MAN_PN care va fi extins la numele paginii curente de manual și numele secțiunii acesteia înconjurat de „(” și „)”. Șirul utilizat pentru a produce modul implicit ar putea fi exprimat ca

\ Pagina\ de\ manual\ \$MAN_PN\ ?ltlinia\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (FINAL):?pB\ %pB\\%..
(apăsați h pentru ajutor sau q pentru a ieși)

Aici este împărțit în trei rânduri, doar pentru o mai bună claritate. Pentru semnificația și explicația acestuia, consultați pagina de manual less(1). Șirul de prompter este mai întâi evaluat de shell. Toate ghilimele duble, ghilimele inverse și barele oblice inverse din prompt trebuie să fie eludate de o bară oblică inversă anterioară. Șirul prompter-ului se poate termina cu un „$” eludat, care poate fi urmat de alte opțiuni pentru «less». În mod implicit, man stabilește opțiunile -ix8.

Variabila de mediu $MANLESS descrisă mai jos poate fi utilizată pentru a stabili un șir de prompter implicit, dacă nu este furnizat niciunul în linia de comandă.

-7, --ascii

Când se vizualizează o pagină de manual, pur ascii(7) pe un terminal de 7 biți sau un emulator de terminal, este posibil ca unele caractere să nu se afișeze corect când se utilizează descrierea dispozitivului latin1(7) cu GNU nroff. Această opțiune permite ca paginile de manual, pur ascii să fie afișate în ascii cu dispozitivul latin1. Nu va traduce niciun text latin1. Următorul tabel arată traducerile efectuate: unele părți ale acestuia pot fi afișate corect numai când se utilizează dispozitivul latin1(7) al lui GNU nroff.

Descriere	Octal	latin1	ascii
cratimă de continuare	255	‐	-
bulină (punct, picățea din mijloc)	267	•	o
accent acut	264	´	'
semn de înmulțire	327	×	x

Dacă coloana latin1 se afișează corect, terminalul poate să fie configurat pentru caractere latin1 și această opțiune nu este necesară. Dacă coloanele latin1 și ascii sunt identice, citiți această pagină utilizând această opțiune sau man nu a formatat această pagină utilizând descrierea de dispozitiv latin1. Dacă coloana latin1 lipsește sau este coruptă, poate că aveți nevoie să vizualizați paginile de manual cu această opțiune.

Această opțiune este ignorată când se utilizează opțiunile -t, -H, -T sau -Z și poate fi inutilă pentru nroff, altul decât GNU.

-E codificarea, --encoding=codificarea

Generează ieșirea pentru o codificare de caractere, alta decât cea implicită. Pentru compatibilitate inversă, codificarea poate fi un dispozitiv nroff, cum ar fi ascii, latin1 sau utf8, precum și o codificare de caractere adevărate, cum ar fi UTF-8.

--no-hyphenation, --nh

În mod normal, nroff împarte automat textul cu cratime la întreruperile de linie chiar și în cuvintele care nu conțin cratime, dacă este necesar să faceți acest lucru pentru a așeza cuvintele pe o linie fără spațiere excesivă. Această opțiune dezactivează separarea automată în silabe, astfel încât cuvintele vor fi separate cu cratime numai dacă conțin deja cratime.

Dacă scrieți o pagină de manual și doriți pur și simplu să împiedicați nroff să împartă cu cratimă un cuvânt într-un punct nepotrivit, nu utilizați această opțiune, ci consultați documentația nroff; de exemplu, puteți pune „\%” în interiorul unui cuvânt pentru a indica faptul că acesta poate fi întrerupt în acel punct, sau puteți pune „\%” la începutul unui cuvânt pentru a preveni împărțirea în silabe.

--no-justification, --nj

În mod normal, nroff va alinia automat textul la ambele margini. Această opțiune dezactivează alinierea completă, lăsând aliniată doar marginea din stânga, numită uneori text „zdrențuit la dreapta”.

Dacă scrieți o pagină de manual și doriți pur și simplu să împiedicați ca nroff să alinieze anumite paragrafe, nu utilizați această opțiune, ci consultați documentația nroff; de exemplu, puteți folosi solicitările „.na”, „.nf”, „.fi” și „.ad” pentru a dezactiva temporar ajustarea și completarea.

-p șir, --preprocessor=șir

Specificați secvența de preprocesoare de rulat înainte de nroff sau troff/groff. Nu toate instalațiile vor avea un set complet de preprocesoare. Câteva dintre preprocesoare și literele folosite pentru a le desemna sunt: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Această opțiune suprascrie variabila de mediu $MANROFFSEQ. zsoelim este întotdeauna rulat ca primul preprocesor.

-t, --troff

Utilizează groff -mandoc pentru a formata pagina de manual la ieșirea standard(stdout). Această opțiune nu este necesară în conjuncție cu -H, -T, sau -Z.

-T[dispozitiv], --troff-device[=dispozitiv]

Această opțiune este utilizată pentru a modifica ieșirea lui groff (sau eventual a lui troff) ca să fie mai potrivită pentru un dispozitiv, altul decât cel implicit. Acest lucru implică -t. Exemplele (furnizate cu Groff-1.17) includ dvi, latin1, ps, utf8, X75 și X100.

-H[navigator], --html[=navigator]

Această opțiune va determina ca groff să producă o ieșire HTML și va afișa acea ieșire într-un navigator web. Alegerea navigatorului este determinată de argumentul opțional navigator, dacă este furnizat unul, de variabila de mediu $BROWSER sau de o valoare implicită în timpul compilării dacă aceasta nu este configurată (de obicei lynx). Această opțiune implică -t și va funcționa numai cu GNU troff.

-X[ppi], --gxditview[=ppi]

Această opțiune afișează ieșirea lui groff într-o fereastră grafică utilizând programul gxditview. ppi (puncte per inci) poate fi 75, 75-12, 100, sau 100-12, valoarea implicită fiind 75; variantele *-12 utilizează un font cu baza de 12-puncte. Această opțiune implică -T cu dispozitivul X75, X75-12, X100, sau X100-12 respectiv.

-Z, --ditroff

groff va rula troff și mai apoi va utiliza un post-procesor adecvat pentru a produce o ieșire corespunzătoare pentru dispozitivul ales. Dacă groff -mandoc este groff, această opțiune este trecută la groff și va suprima utilizarea unui post-procesor. Acest lucru implică -t.

Obținere ajutor¶

-?, --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.