.\" Man page for man (and the former manpath) .\" .\" Copyright (c) 1990, 1991, John W. Eaton. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the README file that comes with the man 1.0 .\" distribution. .\" .\" John W. Eaton .\" jwe@che.utexas.edu .\" Department of Chemical Engineering .\" The University of Texas at Austin .\" Austin, Texas 78712 .\" .\" Many changes - aeb .\" .\" Traducere de Ovidiu Constantin .TH man 1 "2 Septembrie 1995" .LO 1 .SH NUME man \- formatează și afișează paginile de manual .br manpath \- determină calea de căutare a utilizatorului pentru paginile de manual .SH SUMAR .B man .RB [ \-acdfFhkKtwW ] .RB [ --path ] .RB [ \-m .IR sistem ] .RB [ \-p .IR șir ] .RB [ \-C .IR fișier_configurare ] .RB [ \-M .IR listă_căi ] .RB [ \-P .IR paginator ] .RB [ \-S .IR listă_secțiuni ] .RI [ secțiune ] .I "nume ..." .SH DESCRIERE .B man formatează și afișează paginile de manual. Dacă specificați .IR secțiune , .B man caută doar în acea secțiune a manualului. .I nume este în mod normal numele paginii de manual, care este de obicei numele unei comenzi, funcții, sau fișier. Totuși, dacă .I nume conține un slash .RB ( / ) atunci .B man îl interpretează ca o specificare de fișier, astfel încât puteți executa .B "man ./foo.5" sau chiar .B "man /cd/foo/bar.1.gz\fR.\fP" .PP Vedeți mai jos pentru o descriere a locurilor unde caută .B man fișierele cu paginile de manual. .SH OPȚIUNI .TP .B \-\^C " fiișier_configurare" Specifică fișierul de configurare care se va folosi; inplicit este .BR @man_config_file@ . (Vezi .BR man.conf (5).) .TP .B \-\^M " cale" Specifică lista de directoare unde se caută paginile man. Separați directoarele cu două puncte (:). O listă goală este echivalent cu a nu specifica .B \-M de loc. Vezi și .BR "CALEA DE CĂUTARE A PAGINILOR MAN" . .TP .B \-\^P " paginator" Specifică ce paginator de va folosi. Această opțiune ignoră variabila de mediu .B MANPAGER , care în schimb ignoră variabila .BR PAGER . Implicit, .B man folosește .BR @pager@ . .TP .B \-\^S " listă_secțiuni" Lista este un șir de secțiuni de manual care vor fi căutate, despărțite prin două puncte (:). Această opțiune ignoră variabila de mediu .BR MANSECT . .TP .B \-\^a Implicit, executia .B man se va termina după afișarea primei pagini de manual pe care o găsește. Folosirea acestei opțiuni forțează .B man să afișeze toate paginila de manual care verifică .B nume, nu doar prima. .TP .B \-\^c Reformatează pagina man sursă, chiar dacă există o pagină cat actualizată. Acest lucru poate fi important dacă pagina cat a fost formatată pentru un ecran cu un număr diferit de coloane, sau dacă pagina preformatată este alterată. .TP .B \-\^d Nu afișează efectiv paginile man, ci tipărește multe informații de depanare. .TP .B \-\^D Afișează atât paginile man, cât și informații de depanare. .TP .B \-\^f Echivalent cu .BR whatis . .TP .BR \-\^F " sau " \-\-preformat Doar formatează - nu afișează. .TP .B \-\^h Tipărește un mesaj de ajutor și termină execuția. .TP .B \-\^k Echivalent cu .BR apropos . .TP .B \-\^K Caută șirul de caractere specificat în *toate* paginile man. Avertisment: aceasta este probabil o operație foarte lentă! Ajută specificarea unei secțiuni. (Pentru a da o idee generală, pe mașina mea aceasta durează aproape un minut pentru 500 pagini man.) .TP .B \-\^m " sistem" Specifică un set alternativ de pagini man de căutat, bazat pe numele de sistem dat. .TP .B \-\^p " șir" Specifică secvența de preprocesoare ce vor fi rulate înainte de .B nroff sau .BR troff . Nu toate instalările vor avea un set complet de preprocesoare. Unele din preprocesoare și literele folosite pentru a le desemna sunt: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Această opțiune duce la ignorarea variabilei de mediu .BR MANROFFSEQ . .TP .B \-\^t Folosește .B @troff@ pentru a formata pegina man, trimițând rezultatul la ieșirea standard .BR (stdout) . Rezultatul comenzii .B @troff@ ar putea necesita să fie trecut printr-un filtru înante de a fi tipărit. .TP .B \-\^w \fRsau\fP \-\-path Nu afișează efectiv paginile man, ci tipărește locația(ile) fișierelor care ar fi formatate sau afișate. Dacă nici un argument nu este dat: afișează (la ieșirea standard (stdout)) lista directoarelor în care sunt căutate de .B man paginile man. Dacă .B manpath este o legătură la man, atunci "manpath" este echivalent cu "man --path". .TP .B \-\^W Ca \-\^w, dar afișează numele de fișiere unul pe linie, fără informații adiționale. Această opțiune este utilă în comenzi shell ca .ft CW .B "man -aW man | xargs ls -l" .ft .SH "PAGINILE CAT" Man va încerca să salveze paginile man formatate, pentru a reduce timpul de formatare data viitoare când aceste pagini sunt necesare. Tradițional, versiunile formatate ale paginilor din DIR/manX sunt salvate în DIR/catX, dar alte mapări de la directorul man la directorul cat pot fi specificate în .BR @man_config_file@ . Nici o pagină cat nu este salvată dacă directorul cat necesar nu există. .PP Este posibil să faceți .B man suid la un utilizator man. Atunci, dacă un director cat are proprietar man și modul 0755 (scriere doar de către man), și fișierele cat au proprietarul man și modul 0644 sau 0444 (scriere doar de către man, sau nici o permisiune de scriere), nici un utilizator normal nu poate modifica paginile cat sau să pună alte fișiere în directorul cat. Dacă .B man nu este făcut suid, atunci un director cat ar trebui să aibă modul 0777 dacă toți utilizatorii trebuie să poată lăsa pagini cat acolo. .PP Opțiunea .B \-c forțează reformatarea unei pagini, chiar dacă există o pagină cat recentă. .SH "CALEA DE CĂUTARE A PAGINILOR MAN" .B man folosește o metodă sofisticată pentru a găsi paginile de manual, bazată pe opțiuni de apelare și variabile de mediu, fișierul de configurare .B @man_config_file@ și anumite convenții și euristici. .PP Înainte de toate, când argumentul .I nume al .B man conține un slash .RB ( / ), .B man consideră că este un specificator de fișier și nu se efectuează nici o căutare. .PP Dar în cazul normal în care .I nume nu conține un slash, .B man caută în o mulțime de directoare un fișier care a putea fi o pagină de manual pentru subiectul numit. .PP Dacă specificați opțiunea .BI "-M " listă_căi\fR, .I listă_căi este o listă de directoare despărțite prin două puncte (:) în care caută .BR man . .PP Dacă nu specificați .B -M dar setați variabila de mediu .BR MANPATH , valoarea acestei variabile este lista de directoare în care caută .BR man . .PP Dacă nu specificați explicit o listă de căi cu .B -M sau .BR MANPATH , .B man își creează propria listă de căi bazată pe conținutul fișierului de configurare .BR @man_config_file@ . Declarațiile .B MANPATH din fișierul de configurare definesc anumite directoare care să fie incluse în calea de căutare. .PP Mai mult, declarațiile .B MANPATH_MAP se adaugă la calea de căutare depinzând de calea de căutare a comenzilor (de ex. variabila de mediu .BR PATH ). Pentru fiecare director care este în calea de căutare a comenzilor, o declarație .B MANPATH_MAP specifică un director care trebuie că fie adăugat la calea de căutare a fișierelor cu paginile de manual. .B man analizează variabila .B PATH și adaugă directoarele corespunzătoare la calea de căutare a fișierelor cu paginile de manual. Astfel, prin folosirea corectă a .BR MANPATH_MAP , când executați comanda .BR "man xyz" , obțineți o pagină de manual pentru programul care ar rula dacă ați executa comanda .BR xyz . .PP În plus, pentru fiecare director în calea de căutare a comenzilor (o vom denumi "director de comenzi") pentru care .I nu aveți o declarație .BR MANPATH_MAP , .B man caută în mod automat un director cu pagini de manual "învecinat", respectiv ca un subdirector al directorului de comenzi sau în directorul părinte al directorului de comenzi. .PP Puteți dezactiva căutarea "învecinată" automată incluzând o declarație .B NOAUTOPATH în .BR @man_config_file@ . .PP În fiecare director din calea de căutare descris mai sus, .B man caută un fișier numit .IB topic . section\fR, cu un sufix opțional la numărul secțiunii și posibil un sufix de compresie. Dacă nu găsește un astfel de fișier, caută în orice subdirectoare numite .BI man N sau .BI cat N unde .I N este numărul secțiunii de manual. Dacă fișierul este într-ul subdirector .BI cat N\fR, .B man consideră că este o pagină de manual formatată (pagină cat). Altfel, .B man consideră că este neformatată. În oricare caz, dacă numele fișierului are un sufix cunoscut de compresie (ca .BR .gz ), .B man consideră că este comprimat cu gzip. .PP Dacă doriție să vedeți unde (sau dacă) .B man ar găsi pagina de manual pentru un anumit subiect, folosiți opțiunea .BR "--path " ( -w ). .SH "VARIABILE DE MEDIU" .TP .B MANPATH Dacă .B MANPATH este setată, .B man o folosește drept cale de căutare a fișierelor cu paginile de manual. Ignoră fișierul de configurare și calea de căutare automată, dar este ignorată de opțiunea de apelare .BR -M . Vezi și .BR "CALEA DE CĂUTARE A PAGINILOR MAN" . .TP .B MANPL Dacă .B MANPL este setată, valoarea ei este folosită ca lungimea paginii afișate. Altfel, întreaga pagină man va ocupa o singură pagină (lungă). .TP .B MANROFFSEQ Dacă .B MANROFFSEQ este setată, valoarea ei este folosită pentru determinarea setului de preprocesoare rulate înainte de a rula .B nroff sau .BR troff . Implicit, paginile sunt trecute prin preprocesorul tbl înainte de .BR nroff . .TP .B MANSECT Dacă .B MANSECT este setată, valoare ei este folosită pentru a determina în ce secțiune de manual să se caute. .TP .B MANWIDTH Dacă .B MANWIDTH este setată, valoare ei este folosită ca lățimea pe care paginile de manual ar trebui să fie afișate. Altfel paginile ar putea fi afișate peste lățimea ecranului. .TP .B MANPAGER Dacă .B MANPAGER este setată, valoarea ei este folosită ca numele programului ce va fi folosit pentru a afișa pagina man. Dacă nu, atunci .B PAGER este folosită. Dacă nici aceasta nu are o valoare, .B @pager@ este folosit. .TP .B LANG Dacă .B LANG este setată, valoarea ei definește numele subdirectorului unde man caută prima dată paginile man. Astfel, comanda `LANG=dk man 1 foo' va determina man să caute pagina man foo în .../dk/man1/foo.1 și dacă nu poate găsi un astfel de fișier, în .../man1/foo.1, unde ... este un director în calea de căutare. .TP .B "NLSPATH, LC_MESSAGES, LANG" Variabilele de mediu .B NLSPATH și .B LC_MESSAGES (sau .B LANG când ultima nu există) joacă un rol în localizarea catalogului de mesaje. (Dar mesajele în engleză sunt incluse la compilare și pentru engleză nu este necesar nici un catalog.) Notați că programe apelate de man ca .BR col(1) folosesc și ele de ex. LC_CTYPE. .TP .B PATH .B PATH ajută la determinarea căii de căutare a fișierelor cu paginile de manual. Vezi și .BR "CALEA DE CĂUTARE A PAGINILOR MAN" . .TP .B SYSTEM .B SYSTEM este folosită pentru a obține numele implicit al sistemului alternativ (pentru a fi utilizat cu opțiunea .BR \-m ). .SH "VEZI ȘI" apropos(1), whatis(1), less(1), groff(1), man.conf(5). .SH ERORI Opțiunea .B \-t funcționează doar dacă un program gen troff este instalat. .br Dacă vedeți \e255 sau clipind în loc de liniuțe, setați `LESSCHARSET=latin1' în mediu. .SH SFATURI Dacă adăugați linia (global-set-key [(f1)] (lambda () (interactive) (manual-entry (current-word)))) în fișierul dumneavoastră .IR .emacs\fR, apăsând F1 veți obține pagina man pentru apelul de librărie la poziția curentă a cursorului. .LP Pentru a obține o versiune doar text a paginii man, fără backspace și liniuțe de subliniere (underscore), încercați # man foo | col -b > foo.mantxt