[[Getestet(general)]]

{{{#!Wissen
 * [1]: [:Pakete installieren: Installation von Programmen]
 * [2]: [:Paketquellen freischalten: Bearbeiten von Paketquellen]
 * [3]: [:Terminal: Ein Terminal öffnen]
}}}
[[TableOfContents]]

Sucht man Hilfe zur Funktion und den Optionen eines bestimmten Konsolenbefehls oder Programms, so kann man sich im Terminal [3] schnell umfangreiche Hilfedateien anzeigen lassen: Die sogenannten [wiki:Wikipedia/Manpage manpages] {de} . "man" steht für Manual (Anleitung). Diese Anleitungen haben unter Linux/Unix eine lange Tradition und werden ständig gepflegt.

= Funktion =
Die Syntax des Aufrufes lautet:
{{{#!Befehl
man [Option] [Thema]
}}}

== Umfang ==
Es gibt manpages für folgende Bereiche:
 *  Konsolenprogramme (z.B. `ln`)
 *  Geräte (z.B. `hd`)
 *  Dateiformate und Protokolle (z.B. `nfs`)
 *  Konventionen und Standards (z.B. `ascii`)
 *  Kommandos zur Systemadministration
 *  Anwendungsprogramme (z.B. `gedit` oder `firefox`)

== Sprache ==
Die manpages liegen in der Regel in englischer Sprache vor. Wer sie auf deutsch bevorzugt, sollte sich das Paket 
 *'''manpages-de''' (''universe'', [2])
installieren [1].

== man-Optionen ==
||<-4 rowclass="titel">Die Optionen||
||<rowclass="kopf">Option||Bedeutung||
||`-k Schlüsselwort`||zur Suche von Manual-Seiten mit einem bestimmten Schlüsselwort||
||<rowclass="highlight">`-f Thema`||Kurzinfo zum gewählten Thema||

== man-Themenbereich ==
In Unix- und Linux Literatur oder auch in den man-Pages selbst ist häufig eine man-Nummer hinter dem Kommando angegeben z.B. less'''(1)''' damit der man-Text zielgenau aufgerufen werden kann. Es gibt die Themenbereich 1 bis 9 und n.

 *  (1)  Benutzerkommandos
 *  (2)  Systemaufruf
 *  (3)  Funktionen der Programmiersprache C
 *  (4)  Dateiformate
 *  (5)  Konfigurationsdateien
 *  (6)  Spiele
 *  (7)  Diverses
 *  (8)  Kommandos zur Systemadministration
 *  (9)  Kernelfunktionen
 *  (n)  Neue Kommandos

Die Eingabe für den Aufruf von less mit dem Thema (1) sieht so aus:

{{{#!Befehl
man less 1
}}}

== man-Tastenkürzel ==
||<-4 rowclass="titel">Die Tastenkürzel||
||<rowclass="kopf">Taste||Bedeutung||Taste||Bedeutung||
||[[Tasten(hoch)]] oder [[Tasten(y)]]||im Text nach oben scrollen||[[Tasten(runter)]] oder [[Tasten(e)]]||im Text nach unten scrollen||
||<rowclass="highlight">[[Tasten(links)]]||im Text nach links scrollen||[[Tasten(rechts)]]||im Text nach rechts scrollen||
||[[Tasten(bild-auf)]] oder [[Tasten(u)]] oder [[Tasten(b)]]||im Text seitenweise nach oben scrollen||[[Tasten(bild-ab)]] oder [[Tasten(d)]] oder [[Tasten(f)]]||im Text seitenweise nach unten scrollen||
||<rowclass="highlight">[[Tasten(g)]]||zum Textanfang springen||[[Tasten(shift+g)]]||zum Textende springen||
||[[Tasten(shift+7)]]||in den Such modus "Vorwärtssuche"||[[Tasten(shift+sz)]]||in den Suchmodus "Rückwärtssuche"||
||<rowclass="highlight">[[Tasten(n)]]||zum nächsten Suchresultat springen||[[Tasten(shift+n)]]||zum vorherigen Suchresultat springen||
||[[Tasten(h)]]||Hilfetext mit vielen zusätzlichen Tasten und Optionen||[[Tasten(q)]]||Beenden||

= Bequeme Hilfe im Browser =
Benutzer des Konqueror können sich die manpages komfortabel im Browser anschauen. Dazu gibt man einfach als Adresse folgendes ein:
{{{#!Text
man:SEITENNAME
}}}
oder
{{{#!Text
info:SEITENNAME
}}}
oder
{{{#!Text
#SEITENNAME
}}}

Für den Firefox gilt etwa der gleiche Befehl, nämlich
{{{#!Text
man:SEITENNAME
}}}
als URL einzugeben. Zunächst erscheint ein Dialog mit der Frage, ob die entsprechende Anwendung gestartet werden soll. Bestätigt man diese (über eine Checkbox kann festgelegt werden, dass zukünftig die Anwendung immer gestartet werden soll), startet Firefox dann das Gui-Tool gnome-help.

Möchte man jedoch mit Firefox, IceCat oder Opera genauso wie mit Konqueror die Manpages direkt im Browser lesen findet man hier ein leicht zu installierendes Skript mit dem dies ermöglicht wird: [:Skripte/Manpages_im_Browser_lesen:Manpages im Browser lesen].

= Graphisches Interface für die man-pages =
Unter Gnome gibt es mit gnome-help - auch yelp genannt - ein grafisches Frontend zum Darstellen der Hilfetexte. Der Aufruf erfolgt durch
{{{#!Befehl
gnome-help man:SEITENNAME
}}}
oder
{{{#!Befehl
yelp man:SEITENNAME
}}}
= man-pages ohne man lesen =
Manchmal gibt es Situationen in denen man Manpages nicht mit dem man Befehl lesen kann, da sie zum Beispiel nicht in den richtigen Ordnern liegen. Dann kann man sie mit folgendem Befehl lesen:
{{{#!Befehl
nroff -man /Pfad/Zur/Manpage | less
}}}

----
 *["Kategorie/Shell"]