Man (Unix): differenze tra le versioni
Contenuto cancellato Contenuto aggiunto
Dominio http://www.linux-man-pages.org scaduto. |
Funzionalità collegamenti suggeriti: 2 collegamenti inseriti. |
||
| (48 versioni intermedie di 34 utenti non mostrate) | |||
Riga 1:
▲[[Immagine:Unix manual.png|thumb|La pagina man del comando man]]
▲La maggior parte dei [[sistema operativo|sistemi operativi]] [[Unix|UNIX]] e [[Unix-like]] dispone di un'ampia documentazione in linea nota come '''man pages''' (abbreviazione di "manual pages" ovvero pagine di manuale) o '''pagine man''' che sono consultabili tramite il comando '''man'''.
== Storia ==▼
Lo ''UNIX Programmer's Manual'' ("Manuale Unix per Programmatori") fu pubblicato per la prima volta il
|titolo = Unix Programmer's Manual▼
|accesso = 22-05-2008▼
|coautori = Ken Thompson; Dennis M. Ritchie▼
|lingua = en▼
|data = 3-11-1971▼
|urlmorto = sì
|urlarchivio = https://web.archive.org/web/20080518013206/http://cm.bell-labs.com/cm/cs/who/dmr/1stEdman.html
|dataarchivio = 18 maggio 2008
}}</ref>. Comunque, le pagine di manuale non furono disponibili in linea fino alla [[Unix|settima edizione di UNIX]] nel [[1979]].▼
A quel tempo, la disponibilità della documentazione in linea attraverso il sistema delle ''pagine man'' fu considerato come un grande passo avanti. Oggigiorno, virtualmente ogni applicazione Unix
== Caratteristiche ==
Ogni ''pagina man'' è un documento esplicativo di un comando, di una funzione o di un formato di file, o altro ancora, che descrive in maniera sintetica l'argomento e può contenere riferimenti ad altre pagine.
Le varie ''pagine man'' sono raggruppate in sezioni omogenee per tipo di argomento trattato (ad esempio vi è una sezione per i comandi utente, una per le [[Chiamata di sistema|chiamate di sistema]], una per i formati dei [[file]] di configurazione, ed altre ancora).
== Localizzazione ==
Le ''pagine man'' sono tipicamente disponibili in [[lingua inglese]], anche se per alcuni sistemi sono disponibili delle traduzioni.
▲==Storia==
▲Lo ''UNIX Programmer's Manual'' ("Manuale Unix per Programmatori") fu pubblicato per la prima volta il [[3 novembre]] [[1971]]<ref>{{cita web
▲|url=http://cm.bell-labs.com/cm/cs/who/dmr/1stEdman.html
▲|titolo=Unix Programmer's Manual
▲|accesso=22-05-2008
▲|coautori=Ken Thompson; Dennis M. Ritchie
▲|lingua=en
▲|data=3-11-1971
▲}}</ref>. Comunque, le pagine di manuale non furono disponibili in linea fino alla [[Unix|settima edizione di UNIX]] nel [[1979]].
▲A quel tempo, la disponibilità della documentazione in linea attraverso il sistema delle ''pagine man'' fu considerato come un grande passo avanti. Oggigiorno, virtualmente ogni applicazione Unix da linea di comando è corredata dalla propria ''pagina di man'', e la loro assenza è generalmente percepita come indice di bassa qualità del software. Alcuni progetti, come [[Debian]], si preoccupano anche di scrivere ''pagine man'' per quei programmi e comandi che ne sono privi.
==
Per accedere ad una pagina del manuale si può utilizzare in una [[Shell (informatica)|shell testuale]] il comando
man ''nome_pagina''
ad
Tradizionalmente il riferimento ad una ''pagina man'' è espresso usando la notazione "<
Lo stesso nome di ''pagina man'' può apparire in più di una sezione del manuale: questo succede quando il nome di una [[chiamata di sistema]], un [[comando (informatica)|comando]] utente o un [[macro package]] hanno lo stesso nome e sono dunque in conflitto tra loro. Due esempi sono <
La sintassi per accedere alle ''pagine man'' di una sezione del manuale che non sia quella predefinita varia tra le differenti implementazioni di ''man'': nella gran parte dei sistemi [[Unix]] e [[Unix-like]], inclusi [[Linux]] ed i vari sistemi [[BSD]], si usa indicare la sezione prima del nome della pagina. Ad esempio la sintassi per leggere la pagina relativa a <
man 3 printf
Esiste anche una pagina relativa al comando <
== Le sezioni del manuale ==
L'insieme delle ''pagine man'' è solitamente organizzato in otto sezioni numerate da 1 a 8. Ad esempio, su Unix [[BSD]] e [[Linux]]:
Riga 48 ⟶ 52:
|-
|3
| Funzioni della [[libreria standard del C]]
|-
|4
| File speciali (tipicamente i [[Dispositivo a blocchi|dispositivi a blocchi]] ed i [[Dispositivo a caratteri|dispositivi a caratteri]] che si trovano nella directory <
|-
|5
Riga 75 ⟶ 79:
|-
|0
| [[Header file]] della [[libreria standard del C]]
|-
|9
Riga 87 ⟶ 91:
|}
Le sezioni sono ulteriormente suddivise in sottosezioni usando un suffisso di una lettera, come ad esempio la sottosezione <
Altri suffissi assumono un significato generale tra le sezioni:
Riga 95 ⟶ 99:
! Descrizione
|-
| p || specifiche [[POSIX]]
|-
| x || documentazione per il [[X Window System|sistema X Window]]
|}
== Layout ==
Tutte le pagine di manuale seguono un layout comune, che è ottimizzato per la presentazione su semplice testo in [[ASCII]] - possibilmente senza alcuna forma di evidenziazione o controllo dei font. Le seguenti intestazioni delle sezioni sono quasi sempre presenti e sono sempre in questo ordine:
* NAME - Il nome del comando o della funzione, seguito da una breve descrizione su una
* SYNOPSIS - Nel caso di un comando fornisce una descrizione di come eseguirlo e di quali opzioni si possono specificare. Per le funzioni di programmazione vi è una lista dei parametri richiesti e in quale [[header file]] esse sono definite. Per gli utenti esperti ciò può costituire tutta la documentazione
* DESCRIPTION - Una descrizione testuale del funzionamento del comando o della funzione.
* EXAMPLES - Qualche esempio di uso più comune
* SEE ALSO - Una lista di comandi o funzioni simili o ad essi correlati.
Possono essere presenti anche altre sezioni, ma non sono ben standardizzate. Esempi comuni sono: OPTIONS, EXIT STATUS, ENVIRONMENT, KNOWN BUGS, FILES, AUTHOR, REPORTING BUGS
== Formato ==
Il formato usato per scrivere una ''pagina man'' è quello del sistema [[troff]], con una struttura di tipo [[troff macros|macro package]] (orientata all'apparenza) oppure alternativamente [[mdoc]] (orientata alla semantica). Ciò rende possibile ottenere da una pagina delle versioni [[PostScript]] o [[portable document format|PDF]], o vari altri formati ancora, sia per la visualizzazione che per la stampa (sebbene la maggior parte degli utenti preferisca ancora l'interfaccia testuale per la rapidità di consultazione).
== Alternative ==
Pur essendo state realizzate nel tempo delle alternative al sistema delle ''pagine man'', poche di esse hanno riscosso una popolarità comparabile, con la possibile eccezione del sistema [[Texinfo|info]] del progetto [[GNU]], che è un primo sistema di [[ipertesto]] con il quale è realizzata la documentazione ufficiale del progetto.
Riga 119 ⟶ 123:
Ad oggi la maggior parte delle applicazioni Unix dotate di [[interfaccia grafica|GUI]], ed in particolare quelle realizzate per le [[Shell (informatica)|shell grafiche]] [[GNOME]] e [[KDE]], prevedono una documentazione per l'utente finale in [[HTML]] o altri sistemi ipertestuali, e possono avviare automaticamente i visualizzatori necessari per poterla consultare.
== Note ==
<references/>
== Voci correlate ==
* [[nroff]]
* [[groff (software)]]
* [[
* [[
* [[RTFM]]
== Altri progetti ==
==Collegamenti esterni==▼
{{interprogetto}}
* [http://www.die.net/doc/linux/man/man1/man.1.html ''Linux '''man page''' ]▼
▲== Collegamenti esterni ==
* [http://www.pluto.it/ildp/man/ Archivi di pagine di manuale in italiano], traduzione ad opera del progetto ILDP, coordinato da [[PLUTO]]
=== Collezioni di pagine man ===
* {{
* {{
* {{
* {{en}} [http://manpages.debian.net/cgi-bin/man.cgi Debian Hypertext Man pages], visualizzatore delle pagine man di [[Debian]], molte delle quali disponibili anche in lingua italiana
* {{en}} [http://manpages.unixforum.co.uk/ ''Unix Man Pages / Linux Man Pages''] {{Webarchive|url=https://web.archive.org/web/20070715022130/http://manpages.unixforum.co.uk/ |data=15 luglio 2007 }}, contiene migliaia di pagine man di molte versioni di Unix e di Linux
* {{
* {{
* {{
* {{
{{Comandi Unix}}
{{portale|informatica}}
[[Categoria:Unix]]
[[Categoria:Comandi Unix
| |||