muž (Unix)

Muž

Popis tohoto obrázku, také komentován níže Screenshot stránky s anglickým manuálem pro příkaz "man" Informace
Číst formáty Man page ( d )
Typ Obslužný program UNIX ( d )

manje příkaz dostupný v operačních systémech typu Unix . Umožňuje vám zobrazit obsah dokumentace naformátovaný tak, aby byl použitelný pro man ; Původně se používá pro přístup k příkazu manuály k Unix shell a popis jazyka C funkce .

použití

Mělo by být použito v následující podobě:

man [-s<section>] <nom_de_commande>

Chcete-li například zobrazit příručku k příkazu ftp , zadejte

$> man ftp

Chcete-li se pohybovat po stránce, měli byste obecně použít šipky nahoru a dolů nebo klávesy stránky dolů a stránky nahoru nebo mezerník, v závislosti na použitém pageru . Stránku obvykle opustíte klávesou Q, ale u některých verzí musíte stisknout mezerník, dokud se nedostanete na konec ruční stránky.

Sekce

Manuální stránky Unixu jsou rozděleny do několika sekcí. Například v Linuxu najdeme následující sekce:

  1. Uživatelské příkazy
  2. Systémová volání
  3. Funkce knihovny
  4. Speciální soubory
  5. Formáty souborů
  6. Hry
  7. Rozličný
  8. Správa systému
  9. Rozhraní jádra Linuxu

Každá část má úvodní stránku, která seznamuje s částí a je dostupná zadáním man <section> intro.

Manové stránky jsou uloženy ve zdrojových souborech Roff . Většina verzí člověka skryje naformátované verze naposledy zobrazených stránek, aby se urychlilo budoucí zobrazení.

Další informace o člověku najdete na stránce manuálu pro člověka s příkazem man man.

Historický

Příručka programátora UNIX (UNIX Programmer Manual) byla zveřejněna dne3. listopadu 1971. Tuto první stránku manuálu napsali Dennis Ritchie a Ken Dolotta na základě opakovaných žádostí Douga McIlroya. Použitá makra troff byla vytvořena pro obecné použití Tedem Dolottou a také některé doplňky pro manuálové stránky.

V té době byla dostupnost online dokumentace pomocí manuálových stránek považována za hlavní pokrok. Ode dneška mají téměř všechny aplikace příkazového řádku pro Unix vlastní manuálovou stránku. Mnoho uživatelů Unixu vnímá nedostatek manuálové stránky jako známku špatné kvality. Ve skutečnosti některé projekty, například Debian , píší své vlastní manuálové stránky pro příkazy, které ji nemají.

Málo alternativ k manměli stejný úspěch, s možnou výjimkou GNU projektu „  info “, jednoduchý a předchůdce hypertextový systém .

Formát jedné stránky na aplikaci, nedostatek klasifikace v sekcích a relativně nekomplikované funkce rozvržení však motivovaly vývoj alternativních dokumentačních systémů, jako je infojiž zmíněný systém .

Většina grafických aplikací pro UNIX (zejména ty, které jsou vytvořeny pro prostředí GNOME a KDE ) nyní poskytuje dokumentaci v HTML a obsahuje nástroj pro čtení těchto stránek přímo v aplikaci.

Manové stránky jsou obecně dostupné v angličtině . Na některých stránkách jsou k dispozici překlady do jiných jazyků, někdy méně aktuální než anglická verze.

Výchozí formát pro man stránky je troff , buď s man makry (orientovaný na prezentaci) nebo mdoc makra (sémanticky orientovaný). Tyto formáty umožňují převádět manuálové stránky do jiných formátů, jako je HTML, PostScript atd.

externí odkazy

Existuje několik webů, které publikují manuálové stránky. Zde je několik: