Wat is het 1-bestandsformaat?
.1 bestanden slaan Unix manual pages op in platte tekst, specifiek voor sectie 1 - uitvoerbare programma's en gebruikerscommando's. Ze worden gewoonlijk man-pagina's genoemd en zijn geschreven in .roff markup met behulp van het man macro-pakket (groff), waarbij directives met een punt-prefix zoals .TH, .SH, .B, en .TP de lay-out bepalen tijdens het renderen.
Man-pagina's worden bekeken door man naam_van_de_applicatie uit te voeren in een Unix-terminal. Het numerieke achtervoegsel geeft de handleidingssectie aan: .1 behandelt gebruikerscommando's, terwijl .2 tot en met .8 respectievelijk systeemaanroepen, bibliotheekfuncties, bestandsformaten, spellen en administratiecommando's behandelen. Alle secties delen hetzelfde onderliggende roff-bronformaat.
Man-paginabestanden kunnen gecomprimeerd worden opgeslagen - op de meeste Linux- en macOS-systemen bevinden ze zich op paden zoals /usr/share/man/man1/ls.1.gz en worden ze op verzoek gedecomprimeerd door het man commando. De .gz compressie is onzichtbaar vanuit het perspectief van de gebruiker.
Windows gebruikt een ander helpsysteem: in grafische modus is hulp toegankelijk via F1, en vanuit PowerShell door /? of -? aan een commando toe te voegen. Voor Unix-stijl man-pagina's op Windows biedt het Windows Subsystem for Linux (WSL) een volledige man en groff omgeving. Uiteraard moeten man-paginabestanden voor een bepaalde applicatie geïnstalleerd zijn voordat ze op welk platform dan ook kunnen worden weergegeven.
Beveiliging & veiligheid
RISICO: LOWEen man-pagina bronbestand is platte tekst en wordt niet uitgevoerd bij het bekijken. De enige theoretische waarschuwing is dat roff een Turing-complete macrotaal is en groff historisch gezien parsing-fouten heeft gehad, dus het renderen van een .1 van een volledig onbetrouwbare bron kan het beste worden gedaan met het veiligere, gesandboxte mandoc in plaats van de volledige groff. Bij normaal gebruik (het lezen van documentatie uit pakketten en projecten) is een .1 bestand onschadelijk; het openen in een tekstverwerker is volledig veilig.
Formaatdetails
in een notendopProgramma's die 1-bestanden openen
Windows2 apps
WSL (man + groff)
Ingebouwd Voer in Windows Subsystem for Linux „man ./naam.1” uit; of installeer groff via MSYS2 om de pagina te renderen.
Notepad / any text editor
Gratis Open de .1 bron als platte tekst om de ruwe roff-markup op Windows te lezen (geen opmaak toegepast). 
macOS2 apps
man / groff (built-in)
Ingebouwd macOS wordt geleverd met man en groff: „man ./naam.1” om het te lezen; groff om te converteren naar tekst/PS/PDF.
Terminal text editor / BBEdit
Freemium Open de .1 bron in elke editor om de roff-markup te bekijken/bewerken. 
Linux3 apps
man (man-db)
Open-source Voer „man ./naam.1” uit om het geformatteerd in de terminal te bekijken; man roept groff aan om vet/cursief te renderen.
groff
Open-source Direct renderen: „groff -man -Tascii naam.1 | less” voor tekst, „-Thtml” voor HTML, „-Tpdf” for PDF.
Text editor (Vi/Vim, GNU Emacs, nano, Notepad++)
Open-source Open de ruwe .1 bron om de roff-markup te lezen/bewerken (u ziet .TH, .SH macro's, geen geformatteerde pagina). Technische details
diepe specificaties| Formaat-type | Platte tekst roff/groff broncode met gebruik van het man macro-pakket |
| Codering | ASCII of UTF-8 platte tekst; geen binaire header of BOM vereist |
| MIME-type | text/troff (ook geaccepteerd als application/x-troff-man) |
| Bestandssignatuur | Geen binaire magic bytes; man-bronnen beginnen conventioneel met een .TH titelregel, bijv. .TH LS 1 |
| Behandelde handleidingssectie | Sectie 1 - uitvoerbare programma's en algemene gebruikerscommando's |
| Markup-macro's | .TH (titel/header), .SH (sectiekop), .B (vet), .I (cursief), .TP (getagde paragraaf), .PP (paragraaf-einde) |
| Opslag op schijf | Vaak gzip-gecomprimeerd als naam.1.gz, opgeslagen onder /usr/share/man/man1/ op Linux |
| Typische ongecomprimeerde grootte | 1 KB - 100 KB |
| Renderer / viewer | Verwerkt door groff of nroff; weergegeven via het man commando in een terminal |
| Standaard paginastructuur | Verplichte secties: NAME, SYNOPSIS, DESCRIPTION; veelvoorkomende toevoegingen: OPTIONS, FILES, SEE ALSO, AUTHOR, BUGS |
| Extensies van zusterecties | .2 (systeemaanroepen), .3 (bibliotheekfuncties), .5 (bestandsformaten), .8 (systeembeheer) |
| Bijbehorende besturingssystemen | Linux, macOS, BSD-varianten; beschikbaar op Windows via WSL (Windows Subsystem for Linux) |
| Ontwikkelaar / onderhouder | Ontstaan bij Bell Labs (1971); groff-implementatie onderhouden door het GNU Project |
| Voorgeformatteerde variant | Sommige .1 bestanden zijn cat-pagina's - vooraf gerenderde tekst met backspace-overstrike voor vetgedrukte tekst, geen roff-bron |
| Uitgebracht | 1971 (Unix Programmer's Manual, V1); man macros standardized over the 1970s-80s |
| Laatste versie | N/A (roff/man-macro convention; groff is the active implementation) |
| Open standaard | Ja · royaltyvrij |
| Specificatie | man7.org |
1 conversies
Community V&A
gevraagd door gebruikersNog geen vragen - wees de eerste om iets te vragen over 1-bestanden.
