Che cos'è il formato di file 1?
I file .1 memorizzano pagine di manuale Unix in formato testo semplice, specificamente per la sezione 1 - programmi eseguibili e comandi utente. Sono comunemente chiamate man pages e sono scritte in markup .roff utilizzando il pacchetto macro man (groff), con direttive prefissate dal punto come .TH, .SH, .B e .TP che controllano il layout durante il rendering.
Le man pages vengono visualizzate eseguendo man nome_dell_applicazione in un terminale Unix. Il suffisso numerico indica la sezione del manuale: .1 copre i comandi utente, mentre da .2 a .8 coprono rispettivamente chiamate di sistema, funzioni di libreria, formati di file, giochi e comandi di amministrazione. Tutte le sezioni condividono lo stesso formato sorgente roff sottostante.
I file delle pagine di manuale possono essere memorizzati compressi - sulla maggior parte dei sistemi Linux e macOS si trovano in percorsi come /usr/share/man/man1/ls.1.gz e vengono decompressi su richiesta dal comando man. La compressione .gz è invisibile dal punto di vista dell'utente.
Windows utilizza un sistema di aiuto diverso: in modalità grafica, si accede alla guida premendo F1, e da PowerShell aggiungendo /? o -? a un comando. Per le man pages in stile Unix su Windows, il Windows Subsystem for Linux (WSL) fornisce un ambiente man e groff completo. Naturalmente, i file delle pagine di manuale devono essere installati per una determinata applicazione prima di poter essere visualizzati su qualsiasi piattaforma.
Sicurezza e incolumità
RISCHIO: LOWUn sorgente di una pagina man è testo semplice e non viene eseguito durante la visualizzazione. L'unica cautela teorica è che roff è un linguaggio macro Turing-completo e groff ha storicamente avuto bug di parsing, quindi il rendering di un .1 da una fonte totalmente non attendibile è meglio farlo con il più sicuro e isolato mandoc piuttosto che con il groff completo. Nell'uso normale (leggendo documenti da pacchetti e progetti) un file .1 è innocuo; aprirlo in un editor di testo è completamente sicuro.
Dettagli del formato
in sintesiProgrammi che aprono file 1
Windows2 apps
WSL (man + groff)
Integrato In Windows Subsystem for Linux esegui «man ./nome.1»; oppure installa groff tramite MSYS2 per renderizzare la pagina.
Notepad / any text editor
Gratuito Apri il sorgente .1 come testo semplice per leggere il markup roff grezzo su Windows (senza formattazione applicata). 
macOS2 apps
man / groff (built-in)
Integrato macOS include man e groff: «man ./nome.1» per leggerlo; groff per convertirlo in testo/PS/PDF.
Terminal text editor / BBEdit
Freemium Apri il sorgente .1 in qualsiasi editor per visualizzare/modificare il markup roff. 
Linux3 apps
man (man-db)
Open-source Esegui «man ./nome.1» per visualizzarlo formattato nel terminale; man chiama groff per renderizzare grassetto/corsivo.
groff
Open-source Renderizza direttamente: «groff -man -Tascii nome.1 | less» per il testo, «-Thtml» per HTML, «-Tpdf» per PDF.
Text editor (Vi/Vim, GNU Emacs, nano, Notepad++)
Open-source Apri il sorgente .1 grezzo per leggere/modificare il markup roff (vedrai le macro .TH, .SH, non una pagina formattata). Dettagli tecnici
specifiche approfondite| Tipo di formato | Sorgente roff/groff in testo semplice che utilizza il pacchetto macro man |
| Codifica | Testo semplice ASCII o UTF-8; nessun header binario o BOM richiesto |
| Tipo MIME | text/troff (accettato anche come application/x-troff-man) |
| Firma del file | Nessun magic byte binario; i sorgenti man iniziano convenzionalmente con una riga di titolo .TH, ad es. .TH LS 1 |
| Sezione del manuale coperta | Sezione 1 - programmi eseguibili e comandi utente generali |
| Macro di markup | .TH (titolo/intestazione), .SH (intestazione di sezione), .B (grassetto), .I (corsivo), .TP (paragrafo con etichetta), .PP (interruzione di paragrafo) |
| Archiviazione su disco | Frequentemente compresso con gzip come nome.1.gz, memorizzato in /usr/share/man/man1/ su Linux |
| Dimensione tipica non compressa | 1 KB - 100 KB |
| Renderer / visualizzatore | Elaborato da groff o nroff; visualizzato tramite il comando man in un terminale |
| Struttura standard della pagina | Sezioni obbligatorie: NAME, SYNOPSIS, DESCRIPTION; aggiunte comuni: OPTIONS, FILES, SEE ALSO, AUTHOR, BUGS |
| Estensioni delle sezioni correlate | .2 (chiamate di sistema), .3 (funzioni di libreria), .5 (formati di file), .8 (amministrazione di sistema) |
| Sistemi operativi associati | Linux, macOS, varianti BSD; disponibile su Windows tramite WSL (Windows Subsystem for Linux) |
| Sviluppatore / manutentore | Originato presso i Bell Labs (1971); l'implementazione groff è mantenuta dal Progetto GNU |
| Variante pre-formattata | Alcuni file .1 sono cat pages - testo pre-renderizzato con grassetto ottenuto tramite sovrascrittura backspace, non sorgente roff |
| Rilasciato | 1971 (Unix Programmer's Manual, V1); man macros standardized over the 1970s-80s |
| Ultima versione | N/A (roff/man-macro convention; groff is the active implementation) |
| Standard aperto | Sì · royalty-free |
| Specifica | man7.org |
Conversioni 1
Domande e risposte della community
chiesto dagli utentiAncora nessuna domanda - sii il primo a chiedere informazioni sui file 1.
