300px|Comanda man într-un terminal sub Linux|thumb
Paginile de manual (în engleză man pages) sunt documentația detaliată care vine preinstalată cu toate sistemele de operare de tip UNIX. man este comanda care afișează această documentație. Fiecare pagină este un document de sine stătător.
Sintaxă Pentru a accesa o pagină de manual se folosește comanda man <numele_comenzii>
Paginile sunt menționate în mod tradițional folosind notația nume(secțiune): de exemplu, FTP(1). Numele aceeași pagini poate să apară în mai multe secțiuni ale manualului, în special când același nume este un apel de sistem, o comandă, sau un pachet macro: man(1) și man(7), sau exit(2) și exit(3). Sintaxa pentru accesarea unei secțiuni specifice diferă de la sistem la sistem. De exemplu, sub Linux și BSD pentru accesarea fprintf(3) se folosește
man 3 printf
Istorie Ghidul The UNIX Programmer's Manual a fost publicat în 3 noiembrei 1971. Prima pagină de manual a fost scrisă de Dennis Ritchie și Ken Thompson la insistență lui Doug McIlroy în 1971. Pachetul macro troff folosit pentru paginile de manual a fost scris de Ted Dolotta (care a devenit mai târziu primul manager al USG și principalul autor al System III manual). La momentul respectiv, accesul online la informație folosind paginile de manual a fost un avans mare. Până în ziua de astăzi, orice aplicație UNIX vine cu pagina corespunzătoare de manual. Mulți utilizatori UNIX percep lipsa unei pagini de manual ca un semn de calitate scăzută. În decursul timpului, puține alternative pentru paginile de manual au câștigat popularitate, una din ele este proiectul Gnu info care este un sistem hypertext simplu.
Majoritatea aplicațiilor Unix din mediile grafice (cum ar fi cele din Gnome și KDE) au și documentație în format HTML. Această documentație este accesibilă direct din aplicație.
Formatul implicit pentru paginile de manual este troff. Acesta oferă posibilitatea ca pagina de manual să fie trecută într-unul din formatele de tipărire precum PostScript sau PDF. Majoritatea distribuțiilor Linux includ și o comandă man2html care trece pagina în format HTML, astfel încât poate fi accesată dintr-un browser.
În anul 2010, OpenBSD a înlocuit troff cu mandoc. mandoc este un compilator specializat care permite formatarea informației în PostScript, HTML, XHTML sau tipărirea ei într-un terminal.
Secțiunile manualului Manualul este împărțit în opt secțiuni organizate după cum urmează:
SecțiuneDescriere1Comenzi generale2Apeluri de sistem (System calls)3Funcții din biblioteca C4Fișiere speciale (în mod uzual driverele din /dev)5Formate de fișiere și alte convenții6Jocuri pe calculator și programe screensaver7Miscellanea8Comenzi de administrare și programe daemon
Unix System V folosește o numerotare similară, și ordinea este puțin diferită.
SecțiuneDescriere1Comenzi generale2Apeluri de sistem (System calls)3Funcții din biblioteca C4[Formate de fișiere și alte convenții5Miscellanea6Jocuri pe calculator și programe screensaver7Fișiere speciale (în mod uzual driverele din /dev)8Comenzi de administrare și programe daemon
Adițional, pe unele sisteme pot fi găsite și următoarele secțiuni:
SecțiuneDescriere0[Fișiere header (.h) din biblioteca C9funcții kernelncuvinte cheie Tcl/TkxSistemul X Windox
Secțiunile sunt subdivizate în continuare cu un sufix, de exemplu secțiunea 3C cuprinde funcțiile bibliotecii C (library calls), 3M este biblioteca matematică, s.a.m.d.
Opțiunile comenzii man pot fi accesate cu comanda man man.
Formatul paginii Toate paginile de manual au un format comun, optimizat pentru tipărirea textului pe un display în mod ASCII. Secțiunile standard includ:
NAME Numele comenzii sau funcției, urmată de o scurtă descriere. SYNOPSIS O descriere formală a comenzii sau funcției. DESCRIPTION Descriere pe larg a comenzii sau funcției. EXAMPLES Exemple de utilizare. SEE ALSO O listă de comenzi și funcții similare.
Alte secțiuni pot fi prezente, precum OPTIONS, EXIT STATUS, ENVIRONMENT, KNOWN BUGS, FILES, AUTHOR, REPORTING BUGS, HISTORY și COPYRIGHT.
Editarea paginilor de manual Sub Linux și Mac OS X două pachete macro groff sunt disponibile pentru editarea paginilor de manul, man și mdoc. Pachetul man este mai vechi, mdoc este o variantă nouă și oferă un suport îmbunătățit pentru structurarea semantică a documentelor. Documentația acestor pachete macro se obține cu ajutorul comenzilor man groff_man și man groff_mdoc.
Paginile pot fi inspectate și direct, de obicei fișierele se află în directorul /usr/share/man. Locul exact variază de la sistem la sistem, și poate fi aflat folosind opțiunea -w: $ man -w /usr/local/share/man:/usr/share/man/ro:/usr/share/man
Paginile pot fi convertite și în format PDF astfel: man -t ping | ps2pdf - > ping.pdf
Legături externe Pagina de manual Unix Programmer's Manual of 3 noiembrie 1971 (see also the original scans in PS and PDF format ). man : One open-source implementation of man; used on Red Hat, Mac OS X and others. man-db : Alternative implementation of man; used in Debian/Ubuntu, Suse and others. UNIX Manual Pages: Resource for the mdoc UNIX manual page language.
Paginile de manual pentru sisteme de operare specifice Debian GNU/Linux man pages DragonFlyBSD manual pages FreeBSD Hypertext Man Pages including man pages for other Unix operating systems, current and historical. Gobuntu Manual Pages Inferno Manual — Volume 1 Linux and Solaris 10 Man Pages Linux man pages at die.net Linux/FreeBSD Man Pages with user comments Mac OS X Manual Pages Man-Wiki: Linux / Solaris / UNIX / BSD in MediaWiki format NetBSD manual pages On-line UNIX manual pages OpenBSD manual pages OS X command An A-Z Index of the Apple OS X command line Plan 9 Manual — Volume 1 Storage Foundation Man Pages The UNIX and Linux Forums Man Page Repository with recursive search for multiple OS. Ubuntu Manpage Repository
Categorie:UNIX Categorie:Comenzi UNIX Categorie:Linux