Qu'est-ce que le format de fichier 1 ?
Les fichiers .1 stockent des pages de manuel Unix au format texte brut, spécifiquement pour la section 1 - programmes exécutables et commandes utilisateur. Elles sont communément appelées « man pages » et sont écrites en balisage .roff à l'aide du paquet de macros man (groff), avec des directives préfixées par un point telles que .TH, .SH, .B et .TP contrôlant la mise en page lors du rendu.
Les pages de manuel sont consultées en exécutant man nom_de_l_application dans un terminal Unix. Le suffixe numérique indique la section du manuel : .1 couvre les commandes utilisateur, tandis que .2 à .8 couvrent respectivement les appels système, les fonctions de bibliothèque, les formats de fichiers, les jeux et les commandes d'administration. Toutes les sections partagent le même format source roff sous-jacent.
Les fichiers de pages de manuel peuvent être stockés compressés - sur la plupart des systèmes Linux et macOS, ils se trouvent dans des répertoires tels que /usr/share/man/man1/ls.1.gz et sont décompressés à la demande par la commande man. La compression .gz est invisible du point de vue de l'utilisateur.
Windows utilise un système d'aide différent : en mode graphique, l'aide est accessible en appuyant sur F1, et depuis PowerShell en ajoutant /? ou -? à une commande. Pour les pages de manuel de style Unix sur Windows, le Windows Subsystem for Linux (WSL) fournit un environnement man et groff complet. Bien entendu, les fichiers de pages de manuel doivent être installés pour une application donnée avant de pouvoir être affichés sur n'importe quelle plateforme.
Sécurité et sûreté
RISQUE : LOWUne source de page de manuel est du texte brut et ne s'exécute pas lors de la consultation. La seule mise en garde théorique est que roff est un langage de macros Turing-complet et que groff a historiquement eu des bogues d'analyse ; ainsi, le rendu d'un .1 provenant d'une source totalement non fiable est préférable avec mandoc, plus sûr et sandboxé, plutôt qu'avec le groff complet. En usage normal (lecture de docs de paquets et projets), un fichier .1 est inoffensif ; l'ouvrir dans un éditeur de texte est totalement sûr.
Détails du format
en brefProgrammes qui ouvrent les fichiers 1
Windows2 apps
WSL (man + groff)
Intégré Dans le Windows Subsystem for Linux, exécutez « man ./nom.1 » ; ou installez groff via MSYS2 pour effectuer le rendu de la page.
Notepad / any text editor
Gratuit Ouvrez la source .1 comme texte brut pour lire le balisage roff brut sur Windows (aucun formatage appliqué). 
macOS2 apps
man / groff (built-in)
Intégré macOS inclut man et groff : « man ./nom.1 » pour le lire ; groff pour convertir en texte/PS/PDF.
Terminal text editor / BBEdit
Freemium Ouvrez la source .1 dans n'importe quel éditeur pour voir/éditer le balisage roff. 
Linux3 apps
man (man-db)
Open-source Exécutez « man ./nom.1 » pour le voir formaté dans le terminal ; man appelle groff pour le rendu du gras/italique.
groff
Open-source Rendu direct : « groff -man -Tascii nom.1 | less » pour le texte, « -Thtml » pour le HTML, « -Tpdf » pour le PDF.
Text editor (Vi/Vim, GNU Emacs, nano, Notepad++)
Open-source Ouvrez la source .1 brute pour lire/éditer le balisage roff (vous verrez les macros .TH, .SH, pas une page formatée). Détails techniques
spécifications approfondies| Type de format | Source roff/groff en texte brut utilisant le paquet de macros man |
| Encodage | Texte brut ASCII ou UTF-8 ; aucun en-tête binaire ou BOM requis |
| Type MIME | text/troff (également accepté comme application/x-troff-man) |
| Signature de fichier | Pas d'octets magiques binaires ; les sources man commencent conventionnellement par une ligne de titre .TH, ex: .TH LS 1 |
| Section du manuel couverte | Section 1 - programmes exécutables et commandes utilisateur générales |
| Macros de balisage | .TH (titre/en-tête), .SH (titre de section), .B (gras), .I (italique), .TP (paragraphe étiqueté), .PP (saut de paragraphe) |
| Stockage sur disque | Souvent compressé avec gzip sous la forme nom.1.gz, stocké sous /usr/share/man/man1/ sur Linux |
| Taille non compressée typique | 1 Ko - 100 Ko |
| Rendu / visionneuse | Traité par groff ou nroff ; affiché via la commande man dans un terminal |
| Structure de page standard | Sections obligatoires : NAME, SYNOPSIS, DESCRIPTION ; ajouts courants : OPTIONS, FILES, SEE ALSO, AUTHOR, BUGS |
| Extensions de sections sœurs | .2 (appels système), .3 (fonctions de bibliothèque), .5 (formats de fichiers), .8 (administration système) |
| Systèmes d'exploitation associés | Linux, macOS, variantes BSD ; disponible sur Windows via WSL (Windows Subsystem for Linux) |
| Développeur / mainteneur | Originaire des Bell Labs (1971) ; implémentation groff maintenue par le Projet GNU |
| Variante pré-formatée | Certains fichiers .1 sont des « cat pages » - du texte pré-rendu avec gras par surimpression, et non une source roff |
| Publié | 1971 (Unix Programmer's Manual, V1); man macros standardized over the 1970s-80s |
| Dernière version | N/A (roff/man-macro convention; groff is the active implementation) |
| Standard ouvert | Oui · libre de droits |
| Spécification | man7.org |
Conversions 1
Q&R de la communauté
posées par les utilisateursPas encore de questions - soyez le premier à poser une question sur les fichiers 1.
