1004 lines
43 KiB
HTML
1004 lines
43 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MAN</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MAN</H1>
|
|
Section: Dienstprogramme für Handbuchseiten (1)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>BEZEICHNUNG</H2>
|
|
|
|
man - eine Oberfläche für die System-Referenzhandbücher
|
|
<A NAME="lbAC"> </A>
|
|
<H2>ÜBERSICHT</H2>
|
|
|
|
|
|
|
|
<B>man</B> [<I>man Optionen</I>] [[<I>Abschnitt</I>] <I>Seite</I> ...] ...
|
|
<BR>
|
|
|
|
|
|
<B>man</B> <B>-k</B> [<I>apropos Optionen</I>] <I>Regulärer_Ausdruck</I> ...
|
|
<BR>
|
|
|
|
|
|
<B>man</B> <B>-K</B> [<I>man Optionen</I>] [<I>Abschnitt</I>] <I>Begriff</I> ...
|
|
<BR>
|
|
|
|
|
|
<B>man</B> <B>-f</B> [<I>whatis</I> <I>Optionen</I>] <I>Seite</I> ...
|
|
<BR>
|
|
|
|
|
|
<B>man</B> <B>-l</B> [<I>man Optionen</I>] <I>Datei</I> ...
|
|
<BR>
|
|
|
|
<B>man</B> <B>-w</B>|<B>-W</B> [<I>man Optionen</I>] <I>Seite</I> ...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>BESCHREIBUNG</H2>
|
|
|
|
<B>man</B> ist das System-Anzeigeprogramm für die Handbuchseiten. Jedes an
|
|
<B>man</B> übergebene Argument <I>Seite</I> ist normalerweise der Name eines
|
|
Programms oder einer Funktion. Gefunden und angezeigt wird die
|
|
<I>Handbuchseite</I>, die auf jedes der Argumente passt. Wenn ein <I>Abschnitt</I>
|
|
angegeben wird, sucht <B>man</B> nur in diesem <I>Abschnitt</I> der
|
|
Handbuchseiten. Ohne eine explizite Angabe werden alle verfügbaren
|
|
<I>Abschnitte</I> in einer festgelegten Reihenfolge durchsucht (siehe
|
|
<B>VOREINSTELLUNGEN</B>) und nur die jeweils zuerst gefundene <I>Seite</I>
|
|
angezeigt, wenn die <I>Seite</I> in mehreren <I>Abschnitten</I> vorkommt.
|
|
<P>
|
|
Die folgende Tabelle zeigt die Nummern der <I>Abschnitte</I> der Handbuchseiten
|
|
und den Typ der dort zu findenden Seiten.
|
|
<P>
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>1</TD><TD>
|
|
Ausführbare Programme oder Shell-Befehle
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>2</TD><TD>
|
|
Systemaufrufe (Kernel-Funktionen)
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>3</TD><TD>
|
|
Bibliotheksaufrufe (Funktionen in Programmbibliotheken)
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>4</TD><TD>
|
|
Spezielle Dateien (gewöhnlich in <I>/dev/</I>)
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>5</TD><TD>
|
|
Dateiformate und Konventionen, z.B. <I>/etc/passwd</I>
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>6</TD><TD>
|
|
Spiele
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>7</TD><TD>
|
|
Verschiedenes (einschließlich Makropaketen und Konventionen),
|
|
z. B. <B><A HREF="/cgi-bin/man/man2html?7+man">man</A></B>(7), <B><A HREF="/cgi-bin/man/man2html?7+groff">groff</A></B>(7)
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>8</TD><TD>
|
|
Befehle für die Systemverwaltung (in der Regel nur für root)
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>9</TD><TD>
|
|
Kernel-Routinen [nicht Standard]
|
|
<BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<P>
|
|
Eine Handbuchseite besteht aus verschiedenen Abschnitten.
|
|
<P>
|
|
Zu den gebräuchlichen Abschnittsnamen gehören <B>BEZEICHNUNG</B>, <B>ÜBERSICHT</B>,
|
|
<B>KONFIGURATION</B>, <B>BESCHREIBUNG</B>, <B>OPTIONEN</B>, <B>EXIT-STATUS</B>,
|
|
<B>RÜCKGABEWERT</B>, <B>FEHLER</B>, <B>UMGEBUNGSVARIABLEN</B>, <B>DATEIEN</B>, <B>VERSIONEN</B>,
|
|
<B>KONFORM ZU</B>, <B>ANMERKUNGEN</B>, <B>FEHLER</B>, <B>BEISPIEL</B>, <B>AUTOREN</B> und
|
|
<B>SIEHE AUCH</B>.
|
|
<P>
|
|
Die folgenden Konventionen gelten für den Abschnitt <B>ÜBERSICHT</B> und können
|
|
für andere Abschnitte als Leitfaden benutzt werden.
|
|
<P>
|
|
<TABLE>
|
|
<TR VALIGN=top><TD><B>Fettdruck</B></TD><TD>
|
|
genau wie angegeben eingeben
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>Kursivdruck</I></TD><TD>
|
|
durch passendes Argument ersetzen
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>[<B>-abc</B>]</TD><TD>
|
|
Ein oder mehrere Argumente innerhalb
|
|
der [ ] sind optional.
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD><B>-a</B>|<B>-b</B></TD><TD>
|
|
Durch | abgegrenzte Optionen können
|
|
nicht zusammen benutzt werden.
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD><I>Argument</I> ...</TD><TD>
|
|
Das <I>Argument</I> kann wiederholt werden.
|
|
<BR></TD></TR>
|
|
<TR VALIGN=top><TD>[<I>Ausdruck</I>] ...</TD><TD>
|
|
Der gesamte <I>Ausdruck</I> innerhalb [ ]
|
|
kann wiederholt werden.
|
|
<BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<P>
|
|
Die Darstellung ist vom Ausgabegerät abhängig. So kann <B>man</B> im
|
|
Allgemeinen Kursivschrift auf Terminals nicht darstellen und stattdessen den
|
|
Text unterstreichen oder einfärben.
|
|
<P>
|
|
Die Befehls- oder Funktionsdarstellung ist ein Muster, das zu allen
|
|
möglichen Aufrufen passen sollte. In manchen Fällen ist es ratsam, wie im
|
|
Abschnitt <B>ÜBERSICHT</B> dieser Handbuchseite praktiziert, die verschiedenen,
|
|
sich ausschließenden Aufrufe anzugeben.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>BEISPIELE</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>man</B><I> ls</I><DD>
|
|
Zeigt die Handbuchseite für den <I>Begriff</I> (das Programm) <I>ls</I> an.
|
|
<DT id="2"><B>man</B> <I>man</I>.<I>7</I><DD>
|
|
Zeigt die Handbuchseite für das Makropaket <I>man</I> aus Abschnitt <I>7</I>
|
|
an. Dies ist eine alternative Schreibweise für »<B>man</B> <I>7 man</I>«.
|
|
<DT id="3"><B>man '</B><I>man</I>(<I>7</I>)'<DD>
|
|
Zeigt die Handbuchseite für das Makropaket <I>man</I> aus Abschnitt <I>7</I>
|
|
an. Dies ist eine weitere alternative Schreibweise für "<B>man</B> <I>7
|
|
man</I>". Dies könnte beim Kopieren und Einfügen von Querverweisen in
|
|
Handbuchseiten bequemer sein. Beachten Sie, dass die Klammern normalerweise
|
|
in Anführungszeichen gesetzt werden müssen, um zu verhindern, dass sie von
|
|
der Shell interpretiert werden.
|
|
<DT id="4"><B>man -a</B><I> intro</I><DD>
|
|
Zeigt nacheinander alle vorhandenen »<I>intro</I>«-Handbuchseiten an. Sie können
|
|
zwischen den aufeinander folgendenden Ausgaben der Seiten abbrechen oder
|
|
beliebige Seiten überspringen.
|
|
<DT id="5"><B>man -t </B><I>bash </I>|<I> lpr -Pps</I><DD>
|
|
Formatiert die von Handbuchseite für <I>bash</I>in das Standardformat von
|
|
<B>Troff</B> oder <B>Groff</B> und schickt sie zum Drucker <I>ps</I>. Für <B>Groff</B> ist
|
|
das Standardausgabeformat gewöhnlich PostScript. Mit <B>man --help</B> können
|
|
Sie herausfinden, welcher Prozessor mit der Option <B>-t</B> verbunden ist.
|
|
<DT id="6"><B>man -l -T</B><I>dvi ./foo.1x.gz</I><B> > </B><I>./foo.1x.dvi</I><DD>
|
|
Dieser Befehl dekomprimiert und formatiert den Nroff-Quelltext der
|
|
Handbuchseite <I>./foo.1x.gz</I> in eine geräteunabhängige (device-independent)
|
|
<B>dvi</B>-Datei. Die Umleitung der Ausgabe ist notwendig, da die Option <B>-T</B>
|
|
ohne Anzeigeprogramm die Ausgabe zur <B>Standardausgabe</B> schickt. Die Ausgabe
|
|
kann mit einem Programm wie <B>xdvi</B> betrachtet oder mit einem Programm wie
|
|
<B>dvips</B> zu PostScript weiterverarbeitet werden.
|
|
<DT id="7"><B>man -k</B><I> printf</I><DD>
|
|
Sucht in den Kurzbeschreibungen und Namen der Handbuchseiten nach dem als
|
|
regulären Ausdruck angesehenen Schlüsselwort <I>printf</I> und gibt alle
|
|
Fundstellen aus. Diese Option entspricht <B>apropos</B> <I> printf</I><B>.</B>
|
|
<DT id="8"><B>man -f</B><I> smail</I><DD>
|
|
Sucht die durch <I>smail</I> angegebenen Handbuchseiten und gibt alle
|
|
Kurzbeschreibungen der gefundenen Seiten aus. Diese Option entspricht
|
|
<B>apropos</B> <I> printf</I><B>.</B>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ÜBERSICHT</H2>
|
|
|
|
Um dem Benutzer eine größtmögliche Flexibilität zu bieten, sind in <B>man</B>
|
|
viele Optionen verfügbar. Veränderungen können am Suchpfad, in der
|
|
Reihenfolge der Abschnitte, am Ausgabeprozessor sowie weiteren
|
|
Verhaltensweisen und Operationen vorgenommen werden. Dies wird weiter unten
|
|
beschrieben.
|
|
<P>
|
|
Wenn sie gesetzt sind, werden verschiedene Umgebungsvariablen für die
|
|
Festlegung der Arbeitsweise von <B>man</B> ausgewertet. Sie können die
|
|
Allzweckvariable $<B>MANOPT</B> auf einen beliebigen Ausdruck im
|
|
Befehlszeilenformat setzen. Bei der Zuweisung des Wertes an $<B>MANOPT</B>
|
|
müssen Sie Leerzeichen als Teil von Argumenten einer Option mit einem
|
|
Backslash (linksseitigem Schrägstrich) maskieren (schützen). <B>man</B> wertet
|
|
diese Variable vor der eigenen Befehlszeile aus. Die Optionen, die ein
|
|
Argument benötigen, werden durch die gleichen Optionen in der Befehlszeile
|
|
überschrieben. Um alle in $<B>MANOPT</B> gesetzten Optionen zurückzusetzen, kann
|
|
als erste Befehlszeilen-Option <B>-D</B> angegeben werden. Dies ermöglicht
|
|
<B>man</B>, alle in $<B>MANOPT</B> gesetzten Optionen zu »vergessen«, obwohl diese
|
|
weiterhin gültig gewesen sein mussten.
|
|
<P>
|
|
Handbuchseiten werden normalerweise im Format <B><A HREF="/cgi-bin/man/man2html?1+nroff">nroff</A></B>(1) in einem
|
|
Verzeichnis wie <I>/usr/share/man</I> gespeichert. In einigen Installationen
|
|
kann es auch vorformatierte <I>cat-Seiten</I> geben, um die Performance zu
|
|
verbessern. Siehe <B><A HREF="/cgi-bin/man/man2html?5+manpath">manpath</A></B>(5) für Details dazu, wo diese Dateien
|
|
gespeichert sind.
|
|
<P>
|
|
Dieses Paket unterstützt Internationalisierung. Wenn auf Ihrem System
|
|
Handbuchseiten in Ihrer Muttersprache verfügbar sind, können Sie mittels
|
|
<I>Locale</I>-Funktionen auf diese Seiten zugreifen. Falls Ihr System nicht
|
|
bereits automatisch vornimmt, muss um diese Unterstützung zu aktivieren,
|
|
entweder in $<B>LC_MESSAGES</B>, $<B>LANG</B> oder anderen systemabhängigen
|
|
Umgebungsvariablen die gewünschte Sprache festgelegt werden. Die Sprache
|
|
wird normalerweise im <B>POSIX</B>- Format angegeben:
|
|
<P>
|
|
|
|
|
|
|
|
<<I>Sprache</I>>[<B>_</B><<I>Region</I>>[<B>.</B><<I>Zeichensatz</I>>[<B>,</B><<I>Version</I>>]]]
|
|
<P>
|
|
Wenn die angeforderte Seite in Ihrer <I>Locale</I> verfügbar ist, wird sie
|
|
anstelle der (normalerweise in amerikanischem Englisch verfassten)
|
|
Standardseite angezeigt.
|
|
<P>
|
|
Wenn Sie diese Handbuchseiten und die Ausgaben der Hilfsprogramme gerne in
|
|
Ihrer Landessprache hätten, aber diese nicht vorfinden und Sie diese
|
|
beisteuern möchten, nehmen Sie bitte mit dem Betreuer dieser Software
|
|
Kontakt auf, der dann die Übersetzung koordiniert.
|
|
<P>
|
|
Individuelle Handbuchseiten werden normalerweise von den Betreuern des
|
|
Programms, der Funktion oder sonstigen Themas gepflegt und daher in diesem
|
|
Paket nicht enthalten. Wenn Sie der Meinung sind, dass eine Handbuchseite
|
|
fehlt oder unzureichend ist, melden Sie dies an die Betreuer des fraglichen
|
|
Pakets.
|
|
<P>
|
|
Informationen über weitere Funktionen und Erweiterungen, die für dieses
|
|
Handbuch-Anzeigeprogramm verfügbar sind, geben Ihnen die mit dem Paket
|
|
verteilten Dokumente.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>VOREINSTELLUNGEN</H2>
|
|
|
|
Die Reihenfolge der zu durchsuchenden Abschnitte kann durch die
|
|
Umgebungsvariable $<B>MANSECT</B> oder durch die <B>SECTION</B>-Anweisung in
|
|
<I>/etc/manpath.config</I> außer Kraft gesetzt werden. Folgende Reihenfolge
|
|
ist voreingestelllt:
|
|
<P>
|
|
<DL COMPACT><DT id="9"><DD>
|
|
1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7
|
|
</DL>
|
|
|
|
<P>
|
|
Die formatierte Handbuchseite wird mit Hilfe eines <I>Anzeigeprogramms</I>
|
|
dargestellt. Dieses kann auf verschiedene Arten angegeben werden oder
|
|
anderenfalls auf eine Voreinstellung ausgewichen werden (siehe die Option
|
|
<B>-P</B> für Details).
|
|
<P>
|
|
Die Filter werden in mehreren Schritten zusammengestellt: Zuerst wird die
|
|
Befehlszeilenoption <B>-p</B> oder die Umgebungsvariable $<B>MANROFFSEQ</B>
|
|
untersucht. Wenn <B>-p</B> nicht benutzt wird und die Umgebungsvariable nicht
|
|
gesetzt ist, wird die Anfangszeile der Nroff-Datei nach einer Zeichenkette
|
|
für den Präprozessor untersucht. Um eine gültige Präprozessor-Zeichenkette
|
|
zu enthalten, muss die erste Zeile
|
|
<P>
|
|
<B>'\"</B> <<B>Zeichenkette</B>>
|
|
<P>
|
|
ähneln, wobei <B>Zeichenkette</B> jede weiter unten unter <B>-p</B> beschriebene
|
|
Buchstabenkombination sein kann.
|
|
<P>
|
|
Wenn keine der obigen Methoden eine Filterinformation ergibt, wird ein Satz
|
|
von Standardwerten verwendet.
|
|
<P>
|
|
|
|
Aus den Filtern und dem Hauptformatierprogramm (<B>Nroff</B> oder [<B>tg</B>]<B>roff</B>
|
|
mit <B>-t</B>) wird eine Formatier-Pipeline gebildet und ausgeführt. Wenn
|
|
alternativ ein ausführbares Programm <I>mandb_nfmt</I> (oder <I>mandb_tfmt</I> mit
|
|
<B>-t</B>) in der Wurzel der Handbuchhierarchie existiert, wird dieses an Stelle
|
|
der Pipeline ausgeführt. Ihm wird die Handbuchquelldatei, die Zeichenkette
|
|
für den Präprozessor und wahlweise das durch die Argumente <B>-T</B> oder <B>-E</B>
|
|
festgelegte »Gerät« (tatsächlich ein Dateiformat oder ein Zeichensatz)
|
|
übergeben.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>OPTIONEN</H2>
|
|
|
|
Optionen ohne Argumente, die entweder in der Befehlszeile, in $<B>MANOPT</B>
|
|
oder in beiden doppelt vorkommen, sind nicht schädlich. Für Optionen, die
|
|
ein Argument benötigen, überschreibt jedes Duplikat den vorhergehenden Wert.
|
|
<A NAME="lbAI"> </A>
|
|
<H3>Allgemeine Optionen</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="10"><B>-C </B><I>Datei</I>, <B>--config-file=</B><I>Datei</I><DD>
|
|
Verwendung dieser benutzerspezifischen Konfigurationsdatei an Stelle der
|
|
Vorgabe <I>~/.manpath</I>
|
|
<DT id="11"><B>-d</B>, <B>--debug</B>
|
|
|
|
|
|
<DD>
|
|
Ausgabe von Debug-Informationen
|
|
<DT id="12"><B>-D</B>, <B>--default</B>
|
|
|
|
|
|
<DD>
|
|
Diese Option wird normalerweise nur als die allererste angegeben und setzt
|
|
das Verhalten von <B>man</B> auf die Vorgabewerte zurück. Der Zweck dieser
|
|
Option ist es, vielleicht schon in der Umgebungsvariablen $<B>MANOPT</B>
|
|
gesetzte Optionen wieder aufzuheben. Alle Optionen, die <B>-D</B> folgen, haben
|
|
wieder ihren normalen Effekt.
|
|
<DT id="13"><B>--warnings</B>[=<I>Warnmeldungen/</I>]<DD>
|
|
Aktiviert <I>Groff</I>-Warnmeldungen. Damit kann der Zustand der
|
|
Handbuch-Quelltexte geprüft werden. <I>Warnmeldungen</I> ist eine kommagetrennte
|
|
Liste von Warnungen. Wird kein Wert vorgegeben, wird die Voreinstellung
|
|
»mac« angewendet (siehe den Punkt »warnings« in <B>info Groff</B> für eine Liste
|
|
verfügbarer Warnungen).
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H3>Haupt-Betriebsarten</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="14"><B>-f</B>, <B>--whatis</B>
|
|
|
|
|
|
<DD>
|
|
Diese Option ist äquivalent zu <B>whatis</B>. Wenn die Handbuchseite verfügbar
|
|
ist, wird eine Kurzbeschreibung der gewünschten Handbuchseite angezeigt. Zu
|
|
Details siehe <B><A HREF="/cgi-bin/man/man2html?1+whatis">whatis</A></B>(1).
|
|
<DT id="15"><B>-k</B>, <B>--apropos</B>
|
|
|
|
|
|
<DD>
|
|
Diese Option ist äquivalent zu <B>apropos</B>. Es werden die
|
|
Kurzbeschreibungen der Handbuchseiten nach Schlüsselwörtern durchsucht und
|
|
alle Treffer angezeigt. Zu Details siehe <B><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></B>(1).
|
|
<DT id="16"><B>-K</B>, <B>--global-apropos</B>
|
|
|
|
|
|
<DD>
|
|
Sucht den Text in allen Handbuchseiten. Dieses Vorgehen mit roher Gewalt
|
|
(brute-force) wird wahrscheinlich einige Zeit dauern. Daher sollten Sie,
|
|
wenn möglich, einen Abschnitt angeben, um die Anzahl der zu durchsuchenden
|
|
Seiten zu reduzieren. Suchbegriffe können einfache Zeichenketten
|
|
(Voreinstellung) oder bei Verwendung der Option <B>--regex</B> reguläre
|
|
Ausdrücke sein.
|
|
<DT id="17"><DD>
|
|
Beachten Sie, dass dies die <I>Quellen</I> der Handbuchseiten, nicht den
|
|
dargestellten Text, durchsucht und daher aufgrund von Kommentaren und
|
|
ähnlichem in den Quelltexten falsche Treffer enthalten kann. Durchsuchen des
|
|
dargestellten Textes wäre viel langsamer.
|
|
<DT id="18"><B>-l</B>, <B>--local-file</B>
|
|
|
|
|
|
<DD>
|
|
|
|
|
|
|
|
Aktiviert den »lokalen« Modus. Formatiert und zeigt lokale Handbuchdateien
|
|
an, anstatt die System-Handbuchsammlung zu durchsuchen. Jedes
|
|
Handbuchseiten-Argument wird als gültig formatierte Nroff-Quelle
|
|
interpretiert. Es werden keine Cat-Dateien erstellt. Wenn eines der
|
|
Argumente »-« ist, wird die Eingabe von der Standardeingabe übernommen. Wenn
|
|
diese Option nicht verwendet wird und <B>man</B> die gewünschte Seite nicht
|
|
findet, nimmt <B>man</B> diese Option als angegeben an, betrachtet den Namen als
|
|
Dateinamen und sucht nach einer exakten Übereinstimmung, bevor es eine
|
|
Fehlermeldung anzeigt.
|
|
<DT id="19"><B>-w</B>, <B>--where</B>, <B>--path</B>, <B>--location</B>
|
|
|
|
|
|
<DD>
|
|
Zeigt nicht die Handbuchseiten an, sondern gibt den Ort der Nroff-Quelldatei
|
|
aus, die formatiert werden würde. Wenn die Option <B>-a</B> ebenfalls angegeben
|
|
wird, dann werden die Orte aller Quelldateien angegeben, die den
|
|
Suchkriterien entsprechen.
|
|
<DT id="20"><B>-W</B>, <B>--where-cat</B>, <B>--location-cat</B>
|
|
|
|
|
|
<DD>
|
|
Zeigt nicht die Handbuchseiten an, sondern den Speicherort der Cat-Dateien,
|
|
die angezeigt würden. Wenn die Option <B>-a</B> ebenfalls angegeben wird, dann
|
|
werden die Orte aller vorformatierten Cat-Dateien ausgegeben, die den
|
|
Suchkriterien entsprechen.
|
|
<DT id="21"><DD>
|
|
Wenn sowohl <B>-w</B> als auch <B>-W</B> angegeben werden, dann werden sowohl die
|
|
Quelldatei als auch die Cat-Datei angegeben, durch Leerraum getrennt. Falls
|
|
<B>-w</B>, <B>-W</B> und <B>-a</B> zusammen angegeben werden, dann wird dies für jeden
|
|
möglichen Treffer ausgeführt.
|
|
<DT id="22"><B>-c</B>, <B>--catman</B>
|
|
|
|
|
|
<DD>
|
|
Diese Option ist nicht für den allgemeinen Gebrauch bestimmt und sollte nur
|
|
von dem Programm <B>catman</B> verwendet werden.
|
|
<DT id="23"><B>-R </B><I>Kodierung</I>, <B>--recode</B>=<I>Kodierung</I><DD>
|
|
Anstatt die Seite wie üblich zu formatieren, wird der Quelltext in die
|
|
angegebene Kodierung umgewandelt und ausgegeben. Wenn Sie die Kodierung der
|
|
Quelldatei bereits kennen, können Sie auch direkt <B><A HREF="/cgi-bin/man/man2html?1+manconv">manconv</A></B>(1)
|
|
aufrufen. Diese Option ermöglicht Ihnen aber die Umkodierung mehrerer
|
|
Handbuchseiten ohne die ausdrückliche Angabe der Kodierung jeder einzelnen
|
|
Datei, wenn die Seiten schon in einer zu den Handbuchhierarchien analogen
|
|
Struktur installiert sind.
|
|
<DT id="24"><DD>
|
|
Ziehen Sie in Erwägung, <B><A HREF="/cgi-bin/man/man2html?1+man-recode">man-recode</A></B>(1) zu verwenden, anstatt mehrere
|
|
Handbuchseiten umzuwandeln, da dessen Benutzerschnittstelle für
|
|
Mehrfachumwandlungen entworfen wurde und daher viel schneller sein kann.
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H3>Handbuchseiten finden</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="25"><B>-L </B><I>Locale</I>, <B>--locale=</B><I>Locale</I><DD>
|
|
<B>man</B> wird in der Regel Ihre aktuelle Locale durch einen Aufruf der
|
|
C-Funktion <B><A HREF="/cgi-bin/man/man2html?3+setlocale">setlocale</A></B>(3) bestimmen, welche verschiedene Umgebungsvariablen
|
|
auswertet (darunter sind eventuell auch $<B>LC_MESSAGES</B> und $<B>LANG</B>). Um
|
|
den ermittelten Wert vorübergehend außer Kraft zu setzen, können Sie
|
|
<B>man</B> mit dieser Option eine <I>Locale</I> vorgeben. Beachten Sie, dass
|
|
dieser Wert erst wirksam wird, wenn die Suche tatsächlich
|
|
beginnt. Programm-Meldungen wie Hilfe-Nachrichten werden immer in der zu
|
|
Anfang ermittelten Locale angezeigt werden.
|
|
<DT id="26"><B>-m</B> <I>system</I>[,...], <B>--systems=</B><I>System</I>[,...]<DD>
|
|
Wenn Ihr System auch auf die Handbuchseiten eines anderen Betriebssystems
|
|
zugreifen kann, können diese mit dieser Option durchsucht werden. Um nach
|
|
einer Handbuchseite aus der Handbuchseiten-Sammlung von NewOS zu suchen,
|
|
verwenden Sie die Option <B>-m</B> <B>NewOS</B>.
|
|
<P>
|
|
Das angegebene <I>System</I> kann eine durch Kommata abgetrennte Aufzählung von
|
|
Betriebssystemnamen sein. Um auch die Handbuchseiten des eigenen
|
|
Betriebssystems zu durchsuchen, fügen sie den Systemnamen <B>man</B> in die
|
|
Argument-Zeichenkette ein. Diese Option überschreibt die Umgebungsvariable
|
|
$<B>SYSTEM</B>.
|
|
<DT id="27"><B>-M </B><I>Pfad</I>, <B>--manpath=</B><I>Pfad</I><DD>
|
|
Gibt die Verwendung eines alternativen Pfades vor. Standardmäßig verwendet
|
|
<B>man</B> von <B>manpath</B> abgeleiteten Code, um den Suchpfad zu
|
|
ermitteln. Diese Option überschreibt die Umgebungsvariable $<B>MANPATH</B> und
|
|
sorgt dafür, das <B>-m</B> ignoriert wird.
|
|
<P>
|
|
Ein als Handbuch-Pfad festgelegter Pfad muss die Wurzel einer in Abschnitte
|
|
gegliederten Handbuchhierarchie sein. Das ist im Handbuch von man-db (unter
|
|
»The manual page system«) beschrieben (für die Anzeige von Handbuchseiten
|
|
außerhalb solcher Hierarchien siehe die Option <B>-l</B>).
|
|
<DT id="28"><B>-S</B> <I>Liste/</I>, <B>-s</B> <I>Liste/</I>, <B>--sections=</B><I>Liste/</I><DD>
|
|
Mit der Liste, in der Sie Doppelpunkte oder Kommas als Trennzeichen
|
|
verwenden können, können sie eine bestimmte Suchreihenfolge vorgeben. Diese
|
|
Option setzt die Umgebungsvariable $<B>MANSECT</B> außer Kraft. (Die
|
|
Schreibweise <B>-s</B> ist kompatibel mit System V.)
|
|
<DT id="29"><B>-e </B><I>Unter-Erweiterung</I>, <B>--extension=</B><I>Unter-Erweiterung</I><DD>
|
|
Einige Systeme integrieren umfangreiche Handbuchseiten-Pakete, wie
|
|
z. B. Zubehör für das <B>Tcl</B>-Paket, in die normalen Abschnitte. Für die
|
|
Lösung des Problems zweier unterschiedlicher Handbuchseiten mit gleichem
|
|
Namen, wie <B><A HREF="/cgi-bin/man/man2html?3+exit">exit</A></B>(3), wurden früher alle <B>Tcl</B>-Seiten dem Abschnitt <B>l</B>
|
|
zugeordnet und mit einer speziellen Endung versehen, in diesem Fall
|
|
<B>exit</B>(3tcl). Dies erwies sich als unglückliche Lösung. Diese Version von
|
|
<B>man</B> ermöglicht es, die Seiten in die richtigen Abschnitte einzuordnen
|
|
und ihre. <B>exit</B>(3tcl), anzufügen. Im Normalbetrieb zeigt <B>man</B>
|
|
bevorzugt <B><A HREF="/cgi-bin/man/man2html?3+exit">exit</A></B>(3) gegenüber <B>exit</B>(3tcl) an. Um diese Situation zu
|
|
bewältigen, können Sie <B>man</B> die Zeichenkette <I>Unter-Erweiterung</I>
|
|
übergeben. Diese gibt an, in welchem Paket die Handbuchseite zu finden
|
|
ist. Im obigen Beispiel wird die Option <B>-e tcl</B> die Suche von <B>man</B>
|
|
auf Seiten mit der Erweiterung <B>*tcl</B> beschränken.
|
|
<DT id="30"><B>-i</B>, <B>--ignore-case</B>
|
|
|
|
|
|
<DD>
|
|
bei der Suche nach Handbuchseiten Groß- und Kleinschreibung ignorieren
|
|
(Voreinstellung)
|
|
<DT id="31"><B>-I</B>, <B>--match-case</B>
|
|
|
|
|
|
<DD>
|
|
Handbuchseiten-Suche unter Beachtung von Groß- und Kleinschreibung
|
|
<DT id="32"><B>--regex</B>
|
|
|
|
|
|
<DD>
|
|
Zeigt alle Seiten an, bei denen ein Teil der Namen oder der Beschreibungen
|
|
auf den als Argument übergebenen regulären Ausdruck <I>Seite</I> passen, wie bei
|
|
<B><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></B>(1). Gewöhnlich gibt es keinen begründeten Weg, um bei der Suche
|
|
nach einem regulären Ausdruck eine »beste« Seite zu bestimmen. Darum
|
|
impliziert diese Option <B>-a</B>.
|
|
<DT id="33"><B>--wildcard</B>
|
|
|
|
|
|
<DD>
|
|
Zeigt alle Seiten an, bei denen ein Teil der Namen oder der Beschreibungen
|
|
auf den als Argument übergebenen Shell-Platzhalter (Wildcard) <I>Seite</I>
|
|
passen, wie bei <B><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></B>(1) <B>--wildcard</B>. Das Argument <I>Seite</I> muss mit
|
|
dem gesamten Namen oder einem Abschnitt der Beschreibung innerhalb von
|
|
Wortgrenzen übereinstimmen. Gewöhnlich gibt es keinen begründeten Weg, um
|
|
bei der Suche nach einem Platzhalter eine »beste« Seite zu bestimmen. Darum
|
|
impliziert diese Option <B>-a</B>.
|
|
<DT id="34"><B>--names-only</B>
|
|
|
|
|
|
<DD>
|
|
Wenn die Optionen <B>--regex</B> oder <B>--wildcard</B> zum Einsatz kommen, wird wie
|
|
bei <B><A HREF="/cgi-bin/man/man2html?1+whatis">whatis</A></B>(1) nur in den Paketnamen und nicht in den Beschreibungen
|
|
gesucht, Ansonsten hat diese Option keine Auswirkung.
|
|
<DT id="35"><B>-a</B>, <B>--all</B>
|
|
|
|
|
|
<DD>
|
|
Wird eine Handbuchseite in einem Abschnitt gefunden, so terminiert <B>man</B>
|
|
nach Anzeige dieser Seite. Wird diese Option angegeben, werden alle
|
|
passenden Handbuchseiten nacheinander angezeigt.
|
|
<DT id="36"><B>-u</B>, <B>--update</B>
|
|
|
|
|
|
<DD>
|
|
Diese Option veranlasst <B>man</B>, seine Zwischenspeicher-Datenbank der
|
|
installierten Handbuchseiten zu aktualisieren. Dies ist nur in seltenen
|
|
Fällen notwendig. Es ist normalerweise besser, stattdessen den Befehl
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mandb">mandb</A></B>(8) auszuführen.
|
|
<DT id="37"><B>--no-subpages</B>
|
|
|
|
|
|
<DD>
|
|
Standardmäßig versucht <B>man</B>, auf seiner Befehlszeile übergebene
|
|
Namenspaare als gleichwertig mit einem Namen, der einen Bindestrich oder
|
|
einen Unterstrich enthält, zu interpretieren. Dies unterstützt das
|
|
verbreitete Muster von Programmen, die eine Reihe von Unterbefehlen
|
|
implementieren, sodass für den Aufruf der entsprechenden Handbuchseiten eine
|
|
ähnliche Syntax wie für den Aufruf der Befehle genutzt werden kann. Zum
|
|
Beispiel:
|
|
<P>
|
|
<PRE>
|
|
$ man -aw git diff /usr/share/man/man1/git-diff.1.gz</PRE>
|
|
|
|
<P>
|
|
Dieses Verhalten deaktivieren Sie mit der Option <B>--no-subpages</B>.
|
|
<P>
|
|
<PRE>
|
|
$ man -aw --no-subpages git diff /usr/share/man/man1/git.1.gz /usr/share/man/man3/Git.3pm.gz /usr/share/man/man1/diff.1.gz</PRE>
|
|
|
|
</DL>
|
|
<A NAME="lbAL"> </A>
|
|
<H3>Steuerung der Ausgabeformatierung</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="38"><B>-P </B><I>Anzeigeprogramm</I>, <B>--pager=</B><I>Anzeigeprogramm</I><DD>
|
|
Gibt an, welches Anzeigeprogramm verwendet werden soll. Standardmäßig
|
|
verwendet <B>man</B> <B>pager</B>, wobei auf <B>cat</B> ausgewichen wird, falls
|
|
<B>pager</B> nicht gefunden wurde oder nicht ausführbar ist. Diese Option
|
|
überschreibt die Umgebungsvariable $<B>MANPAGER</B>, welche wiederum die
|
|
Umgebungsvariable $<B>PAGER</B> überschreibt. Die Option wird nicht zusammen mit
|
|
<B>-f</B> oder <B>-k</B> verwendet.
|
|
<P>
|
|
Der Wert kann ein einfacher Befehlsname oder ein Befehl mit Argumenten
|
|
sein. Er darf Shell-Maskierung (also linksseitige Schrägstriche sowie
|
|
einfache und doppelte Anführungszeichen) enthalten. Er darf keine Pipelines
|
|
verwenden, um mehrere Befehle zu verbinden. Wenn Sie das benötigen,
|
|
verwenden Sie ein Skript, das die gewünschte Seite entweder als Argument
|
|
erhält oder von der Standardeingabe liest.
|
|
<DT id="39"><B>-r </B><I>Eingabeaufforderung</I>, <B>--prompt=</B><I>Eingabeaufforderung</I><DD>
|
|
Wenn eine aktuelle Version von <B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1) als Anzeigeprogramm verwendet
|
|
wird, versucht <B>man</B>, dort einige sinnvolle Optionen zu setzen. Die
|
|
Standard-Eingabeaufforderung ähnelt
|
|
<P>
|
|
<B> Handbuchseite</B><I> Name</I><B>(</B><I>Abschnitt</I><B>)</B><B> Zeile</B><I> x</I>
|
|
<P>
|
|
|
|
|
|
|
|
|
|
wobei <I>Name</I> die Handbuchseite bezeichnet, <I>x</I> die aktuelle Zeilennumer
|
|
und <I>Abschnitt</I> den Fundort bezeichnet. Diese Anzeige wird durch Verwendung
|
|
der Umgebungsvariable $<B>LESS</B> erreicht.
|
|
<P>
|
|
|
|
|
|
|
|
|
|
Die Option <B>-r</B> in Verbindung mit einer Zeichenkette setzt diese Vorgabe
|
|
außer Kraft. Wenn diese Zeichenkette <B>$MAN_PN</B> enthält, wird dieser Text
|
|
durch den Namen der Handbuchseite gefolgt von der Abschnittsnummer, umgeben
|
|
von »(« und »)«, ersetzt. Die Zeichenkette für die Erzeugung der
|
|
Voreinstellung könnte als
|
|
<P>
|
|
<B>\ Manual\ page\ \$MAN_PN\ ?ltline\ %lt?L/%L.:</B>
|
|
<BR>
|
|
|
|
<B>byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%..</B>
|
|
<BR>
|
|
|
|
<B>h gibt einen Hilfstext aus, q beendet das Programm</B>
|
|
<P>
|
|
ausgedrückt werden.) Die dreizeilige Darstellung wurde nur der besseren
|
|
Lesbarkeit wegen gewählt. Was das bedeutet, steht in der Handbuchseite von
|
|
<B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1). Da die Zeichenkette zuerst von der Shell ausgewertet wird,
|
|
müssen alle einfachen und doppelten Anführungszeichen sowie der linksseitige
|
|
Schrägstrich (Backslash) durch einen vorangestellten Backslash geschützt
|
|
werden. Weitere Optionen für <B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1) können nach einem geschützten $ am
|
|
Ende der Zeichenkette hinzugefügt werden. Die Standardwerte sind hier
|
|
<B>-ix8</B>.
|
|
<P>
|
|
Wie nachfolgend beschrieben, kann die Umgebungsvariable $<B>MANLESS</B> zum
|
|
Festlegen einer Vorgabe-Zeichenkette für die Eingabeaufforderung verwendet
|
|
werden, sofern in der Befehlszeile keine angegeben wird.
|
|
<DT id="40"><B>-7</B>, <B>--ascii</B>
|
|
|
|
|
|
<DD>
|
|
Bei der Anzeige einer in reinem <I><A HREF="/cgi-bin/man/man2html?7+ascii">ascii</A></I>(7) kodierten Handbuchseite auf
|
|
einem 7-Bit-Terminal oder -Terminal-Emulator können einige Zeichen nicht
|
|
korrekt angezeigt werden, wenn die <B><A HREF="/cgi-bin/man/man2html?7+latin1">latin1</A></B>(7)-Gerätebeschreibung mit <B>GNU
|
|
Nroff</B> benutzt wird. Diese Option ermöglicht die Anzeige von in reinem
|
|
<I>ascii</I> kodierten Handbuchseiten als <I>ascii</I>-Zeichen auf dem
|
|
<I>latin1</I>-»Gerät«. <I>Latin1</I>-kodierter Text wird nicht übersetzt. Die
|
|
folgende Tabelle zeigt die Übersetzungen, die durchgeführt werden: Ein Teil
|
|
davon kann nur dann richtig angezeigt werden, wenn das <I>latin1</I>-»Gerät« von
|
|
<B>GNU Nroff</B> verwendet wird.
|
|
<P>
|
|
|
|
|
|
|
|
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>Beschreibung</TD><TD ALIGN=center>oktal</TD><TD ALIGN=center>latin1</TD><TD ALIGN=center>ascii<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=4><HR></TD></TR>
|
|
<TR VALIGN=top><TD>
|
|
Bindestrich
|
|
</TD><TD ALIGN=center>255</TD><TD ALIGN=center></TD><TD ALIGN=center>-<BR></TD></TR>
|
|
<TR VALIGN=top><TD>
|
|
Aufzählungszeichen (middle dot)
|
|
</TD><TD ALIGN=center>267</TD><TD ALIGN=center>•</TD><TD ALIGN=center>o<BR></TD></TR>
|
|
<TR VALIGN=top><TD>
|
|
Accent aigu
|
|
</TD><TD ALIGN=center>264</TD><TD ALIGN=center>´</TD><TD ALIGN=center>'<BR></TD></TR>
|
|
<TR VALIGN=top><TD>
|
|
Multiplikationszeichen
|
|
</TD><TD ALIGN=center>327</TD><TD ALIGN=center>×</TD><TD ALIGN=center>x<BR></TD></TR>
|
|
</TABLE>
|
|
|
|
|
|
<P>
|
|
Wenn die <I>latin1</I>-Spalte richtig angezeigt wird, kann das Terminal für die
|
|
Anzeige von <I>latin1</I>-Zeichen eingerichtet sein und diese Option ist nicht
|
|
notwendig. Wenn die Spalten <I>latin1</I> und <I>ascii</I> identisch sind, lesen Sie
|
|
diese Seite schon mit dieser Option oder <B>man</B> hat diese Seite nicht mit
|
|
der <I>latin1</I>-Gerätebeschreibung formatiert. Wenn die <I>latin1</I>-Spalte fehlt
|
|
oder beschädigt ist, müssen Sie möglicherweise die Handbuchseiten mit dieser
|
|
Option ansehen.
|
|
<P>
|
|
Diese Option wird ignoriert, wenn Sie die Optionen <B>-t</B>, <B>-H</B>, <B>-T</B> oder
|
|
<B>-Z</B> verwenden und kann nutzlos sein, wenn Sie eine andere als die
|
|
<B>GNU</B>-Version von <B>Nroff</B> verwenden.
|
|
<DT id="41"><B>-E </B><I>Kodierung</I>, <B>--encoding</B>=<I>Kodierung</I><DD>
|
|
Erzeugt eine Ausgabe für eine vom Standard verschiedene
|
|
Zeichenkodierung. Aus Gründen der Abwärtskompatibilität kann <I>Kodierung</I>
|
|
ein <B>Nroff</B>-Gerät wie <B>ascii</B>, <B>latin1</B> oder <B>utf8</B> sowie eine richtige
|
|
Zeichenkodierung wie <B>UTF-8</B> sein.
|
|
<DT id="42"><B>--no-hyphenation</B>, <B>--nh</B>
|
|
|
|
|
|
<DD>
|
|
Normalerweise wird <B>Nroff</B> automatisch Text an Zeilenumbrüchen trennen, um
|
|
damit den Text ohne übermäßige Abstände darzustellen. Dazu trennt es auch
|
|
Wörter, die keinen Bindestrich enthalten. Diese Option deaktiviert die
|
|
automatische Silbentrennung. Sie trennt nur Wörter, die bereits Bindestriche
|
|
enthalten.
|
|
<P>
|
|
Wenn Sie eine Handbuchseite schreiben und einfach nur <B>Nroff</B> von der
|
|
falschen Trennung eines Wortes abhalten wollen, verwenden Sie nicht diese
|
|
Option. Lesen Sie stattdessen die <B>Nroff</B>-Dokumentation. Beispielsweise
|
|
können Sie können durch das Einfügen von »\%« in einem Wort diese Stelle
|
|
als Trennstelle markieren oder mit »\%« am Wortanfang das Wort als nicht
|
|
trennbar kennzeichnen.
|
|
<DT id="43"><B>--no-justification</B>, <B>--nj</B>
|
|
|
|
|
|
<DD>
|
|
Normalerweise setzt <B>Nroff</B> den Text automatisch im Blocksatz. Diese Option
|
|
deaktiviert die Ausrichtung des Textes an der rechten Seite und bewirkt
|
|
damit an der rechten Seite unterschiedliche Leerräume (»ragged right«).
|
|
<P>
|
|
Wenn Sie eine Handbuchseite schreiben und Sie wollen einfach nur <B>Nroff</B>
|
|
vom Blocksatz bestimmter Absätze abhalten, verwenden Sie nicht diese
|
|
Option. Lesen Sie stattdessen die <B>Nroff</B>-Dokumentation. Beispielsweise
|
|
können Sie die Direktiven .».na.«, ».nf«, ».fi« und ».ad« verwenden, um
|
|
zeitweise Ausrichten und Füllen zu deaktivieren.
|
|
<DT id="44"><B>-p </B><I>Zeichenkette</I><B>, --preprocessor=</B><I>Zeichenkette</I><DD>
|
|
Diese Option gibt die Reihenfolge an, in der die Präprozessoren vor <B>Nroff</B>
|
|
oder <B>Troff</B>/<B>Groff</B> aufgerufen werden. Nicht alle Installationen verfügen
|
|
über alle Präprozessoren. Einige der Präprozessoren und die Zeichen, die sie
|
|
repräsentieren, sind: <B>eqn</B> (<B>e</B>), <B>grap</B> (<B>g</B>), <B>pic</B> (<B>p</B>), <B>tbl</B>
|
|
(<B>t</B>), <B>vgrind</B> (<B>v</B>), <B>refer</B> (<B>r</B>). Diese Option überschreibt die
|
|
Umgebungsvariable $<B>MANROFFSEQ</B>. Der Präprozessor <B>zsoelim</B> wird immer als
|
|
erster gestartet.
|
|
<DT id="45"><B>-t</B>, <B>--troff</B>
|
|
|
|
|
|
<DD>
|
|
Mit dieser Option wird <I>groff -mandoc</I> verwendet, um die Handbuchseite zu
|
|
formatieren und an die Standardausgabe zu liefern. In Verbindung mit <B>-H</B>,
|
|
<B>-T</B> oder <B>-Z</B> ist diese Option nicht erforderlich.
|
|
<DT id="46"><B>-T</B>[<I>Gerät/</I>], <B>--troff-device</B>[=<I>Gerät/</I>]<DD>
|
|
Diese Option wird dazu verwendet, um das Ausgabeformat von <B>Groff</B> (oder
|
|
möglicherweise <B>Troff</B>) für andere als das Standardausgabegerät
|
|
anzupassen. Diese Option impliziert <B>-t</B>. Zu den verfügbaren
|
|
Ausgabeformaten (von Groff-1.17) gehören <B>dvi</B>, <B>latin1</B>, <B>ps</B>, <B>utf8</B>,
|
|
<B>X75</B> und <B>X100</B>.<B>X75</B> und <B>X100</B>.
|
|
<DT id="47"><B>-H</B>[<I>Browser/</I>], <B>--html</B>[=<I>Browser/</I>]<DD>
|
|
Diese Option veranlasst <B>Groff</B>, eine HTML-Ausgabe zu erzeugen und diese in
|
|
einem Webbrowser anzuzeigen. Der Browser wird durch das optionale Argument
|
|
<I>Browser</I> ausgewählt. Fehlt es, wird er durch die Umgebungsvariable
|
|
$<B>BROWSER</B> oder Vorgaben beim Bau des Programms (in der Regel <B>lynx</B>)
|
|
bestimmt. Diese Option impliziert <B>-t</B> und wird nur mit <B>GNU</B> <B>Troff</B>
|
|
arbeiten.
|
|
<DT id="48"><B>-X</B>[<I>dpi/</I>], <B>--gxditview</B>[=<I>dpi/</I>]<DD>
|
|
Diese Option zeigt die Ausgabe von <B>Groff</B> mit dem Programm <B>gxditview</B> in
|
|
einem Grafik-Fenster an. Mögliche Werte für <I>dpi</I> (dots per inch) sind 75,
|
|
75-12, 100 oder 100-12 sein; Standard ist 75. Die 12-Varianten verwenden
|
|
eine 12-Punkt-Basisschrift. Diese Option impliziert mit den »Geräten« X75,
|
|
X75-12, X100 oder X100-12 jeweils <B>-T</B>.
|
|
<DT id="49"><B>-Z</B>, <B>--ditroff</B>
|
|
|
|
|
|
<DD>
|
|
<B>Groff</B> ruft <B>Troff</B> und anschließend den passenden Postprozessor auf, um
|
|
eine für das gewählte »Gerät« verwendbare Ausgabe zu erzeugen. Wenn
|
|
<I>groff -mandoc</I> <B>Groff</B> ist, wird diese Option an <B>Groff</B> weitergereicht und
|
|
verhindert den Gebrauch eines Postprozessors. Diese Option impliziert <B>-t</B>.
|
|
</DL>
|
|
<A NAME="lbAM"> </A>
|
|
<H3>Hilfe bekommen</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="50"><B>-?</B>, <B>--help</B>
|
|
|
|
|
|
<DD>
|
|
Hilfetext anzeigen und beenden
|
|
<DT id="51"><B>--usage</B>
|
|
|
|
|
|
<DD>
|
|
zeigt eine kurze Anwendungszusammenfassung an und beendet das Programm.
|
|
<DT id="52"><B>-V</B>, <B>--version</B>
|
|
|
|
|
|
<DD>
|
|
Versionsinformation anzeigen und beenden
|
|
</DL>
|
|
<A NAME="lbAN"> </A>
|
|
<H2>EXIT-STATUS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="53"><B>0</B>
|
|
|
|
|
|
<DD>
|
|
erfolgreiche Programmausführung
|
|
<DT id="54"><B>1</B>
|
|
|
|
|
|
<DD>
|
|
Fehler beim Aufruf, in der Syntax oder in der Konfigurationsdatei
|
|
<DT id="55"><B>2</B>
|
|
|
|
|
|
<DD>
|
|
betriebsbedingter Fehler
|
|
<DT id="56"><B>3</B>
|
|
|
|
|
|
<DD>
|
|
Ein Kind-Prozess gab einen von Null verschiedenen EXIT-Status zurück.
|
|
<DT id="57"><B>16</B>
|
|
|
|
|
|
<DD>
|
|
Mindestens eine Seite/Datei oder ein Schlüsselwort gibt es nicht oder es
|
|
wurden keine Treffer dafür gefunden.
|
|
</DL>
|
|
<A NAME="lbAO"> </A>
|
|
<H2>UMGEBUNGSVARIABLEN</H2>
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="58"><B>MANPATH</B>
|
|
|
|
|
|
<DD>
|
|
Wenn $<B>MANPATH</B> gesetzt ist, wird ihr Wert als Suchpfad für die
|
|
Handbuchseiten benutzt.
|
|
<DT id="59"><B>MANROFFOPT</B>
|
|
|
|
|
|
<DD>
|
|
Jedes Mal, wenn <B>man</B> das Formatierungsprogramm aufruft (<B>nroff</B>, <B>troff</B>
|
|
oder <B>groff</B>), wird der Inhalt von $<B>MANROFFOPT</B> zur Befehlszeile des
|
|
Formatierungsprogramms hinzugefügt.
|
|
<DT id="60"><B>MANROFFSEQ</B>
|
|
|
|
|
|
<DD>
|
|
Wenn $<B>MANROFFSEQ</B> gesetzt ist, wird ihr Wert benutzt, um die Abfolge der
|
|
Präprozessoren zu bestimmen, die jede Handbuchseite vor <B>Nroff</B> oder
|
|
<B>Troff</B> durchläuft. Als Standard durchlaufen die Seiten den Präprozessor
|
|
<B>tbl</B> (<B>t</B>).
|
|
<DT id="61"><B>MANSECT</B>
|
|
|
|
|
|
<DD>
|
|
Wenn $<B>MANSECT</B> gesetzt ist, wird ihr Wert als eine durch Doppelpunkte
|
|
gegliederte Liste von Abschnitten interpretiert und dazu benutzt, die zu
|
|
durchsuchenden Abschnitte und deren Reihenfolge zu bestimmen. Die Vorgabe
|
|
ist »1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7«, es sei denn, dies wird durch die <B>SECTION</B>-Anweisung in
|
|
<I>/etc/manpath.config</I> außer Kraft gesetzt.
|
|
<DT id="62"><B>MANPAGER</B>,<B> PAGER</B>
|
|
|
|
|
|
<DD>
|
|
Wenn $<B>MANPAGER</B> oder $<B>PAGER</B> gesetzt ist ($<B>MANPAGER</B> wird bevorzugt
|
|
verwendet), legt dieser Wert das Anzeigeprogramm für die Handbuchseite
|
|
fest. Standardmäßig wird <B>pager</B> verwendet, wobei auf <B>cat</B>
|
|
ausgewichen wird, falls <B>pager</B> nicht gefunden wurde oder nicht
|
|
ausführbar ist.
|
|
<P>
|
|
Der Wert kann ein einfacher Befehlsname oder ein Befehl mit Argumenten
|
|
sein. Er darf Shell-Maskierung (also linksseitige Schrägstriche sowie
|
|
einfache und doppelte Anführungszeichen) enthalten. Er darf keine Pipelines
|
|
verwenden, um mehrere Befehle zu verbinden. Wenn Sie das benötigen,
|
|
verwenden Sie ein Skript, das die gewünschte Seite entweder als Argument
|
|
erhält oder von der Standardeingabe liest.
|
|
<DT id="63"><B>MANLESS</B>
|
|
|
|
|
|
<DD>
|
|
Wenn $<B>MANLESS</B> gesetzt ist, wird deren Wert als Zeichenkette für die
|
|
Festlegung einer Eingabeaufforderung für das Anzeigeprogramm <B>less</B>
|
|
verwendet, so als ob dieser Wert mit der Option <B>-r</B> übergeben worden wäre
|
|
(daher werden sonstige Vorkommen des Textes <B>$MAN_PN</B> in der gleichen Weise
|
|
expandiert). Wenn Sie beispielsweise die Eingabeaufforderung unbedingt auf
|
|
»Meine Eingabeaufforderung« setzen wollen, setzen Sie $<B>MANLESS</B> auf
|
|
'<B>-PMeine Eingabeaufforderung</B>'. Durch die Option <B>-r</B> wird diese
|
|
Umgebungsvariable außer Kraft gesetzt.
|
|
<DT id="64"><B>BROWSER</B>
|
|
|
|
|
|
<DD>
|
|
Wenn $<B>BROWSER</B> gesetzt ist, ist Wert eine durch Doppelpunkte getrennte
|
|
Liste von Befehlen. Mit allen diesen Befehlen wird versucht, einen
|
|
Web-Browser für <B>man --html</B> zu starten. In jedem Befehl wird <I>%s</I> durch
|
|
einen Dateinamen für die HTML-Ausgabe von <B>Groff</B>, <I>%%</I> durch ein
|
|
einzelnes Prozentzeichen und <I>%c</I> durch einen Doppelpunkt (:) ersetzt.
|
|
<DT id="65"><B>SYSTEM</B>
|
|
|
|
|
|
<DD>
|
|
Wenn $<B>SYSTEM</B> gesetzt ist, hat das die gleiche Wirkung wie die Verwendung
|
|
als Argument für die Option <B>-m</B>.
|
|
<DT id="66"><B>MANOPT</B>
|
|
|
|
|
|
<DD>
|
|
Wenn $<B>MANOPT</B> gesetzt ist, wird der Wert dieser Variablen vor der
|
|
<B>man</B>-Befehlszeile ausgewertet. Es wird vorausgesetzt, das der Wert im
|
|
gleichen Format wie die Befehlszeile vorliegt. Da alle anderen für <B>man</B>
|
|
spezifischen Umgebungsvariablen auch als Befehlszeilenoptionen ausgedrückt
|
|
und in $<B>MANOPT</B> aufgenommen werden können, ist zu erwarten, dass Sie
|
|
obsolet werden. Übrigens müssen alle Leerzeichen, die als Teil eines
|
|
Arguments interpretiert werden sollen, geschützt werden.
|
|
<DT id="67"><B>MANWIDTH</B>
|
|
|
|
|
|
<DD>
|
|
Wenn $<B>MANWIDTH</B> gesetzt ist, wird ihr Wert als die Zeilenlänge für die
|
|
Formatierung der Handbuchseiten verwendet. Wenn sie nicht gesetzt ist,
|
|
werden die Handbuchseiten mit einer für das aktuelle Terminal angemessenen
|
|
Zeilenlänge angezeigt, die (bei Verfügbarkeit) mit einem Aufruf von
|
|
<B><A HREF="/cgi-bin/man/man2html?2+ioctl">ioctl</A></B>(2) oder dem Wert von $<B>COLUMNS</B> bestimmt wurde. Scheitert alles
|
|
Andere, werden 80 Zeichen pro Zeile ausgegeben. Cat-Seiten werden nur dann
|
|
gespeichert, wenn die Standard-Formatierung verwendet werden kann, also die
|
|
Zeilenlänge zwischen zwischen 66 und 80 Zeichen liegt.
|
|
<DT id="68"><B>MAN_KEEP_FORMATTING</B>
|
|
|
|
|
|
<DD>
|
|
Wenn die Ausgabe nicht zu einem Terminal (zum Beispiel in eine Datei oder
|
|
eine Pipeline) geschickt wird, werden Formatierungszeichen verworfen, um das
|
|
Ergebnis ohne Spezialwerkzeuge lesen zu können. Ist aber
|
|
$<B>MAN_KEEP_FORMATTING</B> auf einen nicht leeren Wert gesetzt, werden diese
|
|
Formatierungszeichen beibehalten. Dies kann nützlich sein für Adapter, die
|
|
<B>man</B> interpretieren und Formatierungszeichen verarbeiten können.
|
|
<DT id="69"><B>MAN_KEEP_STDERR</B>
|
|
|
|
|
|
<DD>
|
|
Normalerweise werden bei der Ausgabe auf einem Terminal (in der Regel mit
|
|
einem Anzeigeprogramm) alle Fehlermeldungen der Formatierprogramme
|
|
verworfen, um die Ausgabe des Anzeigeprogramms nicht zu stören. Programme
|
|
wie <B>Groff</B> produzieren häufig relativ harmlose, hässliche Fehlermeldungen
|
|
über typografische Probleme wie schlechte Ausrichtung. Die Anzeige dieser
|
|
Meldungen ist in der Regel verwirrend, wenn sie zusammen mit der
|
|
Handbuchseite erfolgt. Einige Benutzer wollen sie trotzdem sehen. Setzen Sie
|
|
$<B>MAN_KEEP_STDERR</B> auf einen nicht leeren Wert, damit Fehlermeldungen wie
|
|
gewohnt angezeigt werden.
|
|
<DT id="70"><B>LANG</B>,<B> LC_MESSAGES</B>
|
|
|
|
|
|
<DD>
|
|
Abhängig von System und Implementierung werden entweder $<B>LANG</B> oder
|
|
$<B>LC_MESSAGES</B> oder beide nach Informationen zur aktuellen <I>Locale</I>
|
|
durchsucht. <B>man</B> wird (wenn möglich) seine Nachrichten in dieser
|
|
<I>Locale</I> anzeigen. Für genaue Details siehe <B><A HREF="/cgi-bin/man/man2html?3+setlocale">setlocale</A></B>(3).
|
|
</DL>
|
|
<A NAME="lbAP"> </A>
|
|
<H2>DATEIEN</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="71"><I>/etc/manpath.config</I>
|
|
|
|
|
|
<DD>
|
|
Konfigurationsdatei für Man-db
|
|
<DT id="72"><I>/usr/share/man</I>
|
|
|
|
|
|
<DD>
|
|
globale Handbuchhierarchie.
|
|
</DL>
|
|
<A NAME="lbAQ"> </A>
|
|
<H2>SIEHE AUCH</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+groff">groff</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+manpath">manpath</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+nroff">nroff</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+troff">troff</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+whatis">whatis</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+zsoelim">zsoelim</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+manpath">manpath</A></B>(5),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+man">man</A></B>(7),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+catman">catman</A></B>(8),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mandb">mandb</A></B>(8)
|
|
|
|
|
|
<P>
|
|
|
|
Für einige Pakete kann die Dokumentation in anderen Formaten verfügbar sein,
|
|
zum Beispiel <B><A HREF="/cgi-bin/man/man2html?1+info">info</A></B>(1) oder HTML.
|
|
<A NAME="lbAR"> </A>
|
|
<H2>GESCHICHTE</H2>
|
|
|
|
1990, 1991 - John W. Eaton (<A HREF="mailto:jwe@che.utexas.edu">jwe@che.utexas.edu</A>) schrieb die erste
|
|
Version.
|
|
<P>
|
|
23. Dez. 1992: Fehlerbereinigung durch Rik Faith (<A HREF="mailto:faith@cs.unc.edu">faith@cs.unc.edu</A>)
|
|
,unterstützt durch Willem Kasdorp (<A HREF="mailto:wkasdo@nikhefk.nikef.nl">wkasdo@nikhefk.nikef.nl</A>).
|
|
<P>
|
|
30. April 1994 - 23. Februar 2000: Wilf (<A HREF="mailto:G.Wilford@ee.surrey.ac.uk">G.Wilford@ee.surrey.ac.uk</A>) hat
|
|
mit der Hilfe von einigen wenigen engagierten Menschen dieses Paket
|
|
weiterentwickelt und gewartet.
|
|
<P>
|
|
30. Oktober 1996 - Februar 2000: Fabrizio Polacco
|
|
<<A HREF="mailto:fpolacco@debian.org">fpolacco@debian.org</A>> wartete und erweiterte mit Hilfe aus der
|
|
gesamten Community dieses Paket für das Debian-Projekt.
|
|
<P>
|
|
31. März 2001 - heute: Colin Watson <<A HREF="mailto:cjwatson@debian.org">cjwatson@debian.org</A>>
|
|
entwickelt und wartet man-db.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="73"><A HREF="#lbAB">BEZEICHNUNG</A><DD>
|
|
<DT id="74"><A HREF="#lbAC">ÜBERSICHT</A><DD>
|
|
<DT id="75"><A HREF="#lbAD">BESCHREIBUNG</A><DD>
|
|
<DT id="76"><A HREF="#lbAE">BEISPIELE</A><DD>
|
|
<DT id="77"><A HREF="#lbAF">ÜBERSICHT</A><DD>
|
|
<DT id="78"><A HREF="#lbAG">VOREINSTELLUNGEN</A><DD>
|
|
<DT id="79"><A HREF="#lbAH">OPTIONEN</A><DD>
|
|
<DL>
|
|
<DT id="80"><A HREF="#lbAI">Allgemeine Optionen</A><DD>
|
|
<DT id="81"><A HREF="#lbAJ">Haupt-Betriebsarten</A><DD>
|
|
<DT id="82"><A HREF="#lbAK">Handbuchseiten finden</A><DD>
|
|
<DT id="83"><A HREF="#lbAL">Steuerung der Ausgabeformatierung</A><DD>
|
|
<DT id="84"><A HREF="#lbAM">Hilfe bekommen</A><DD>
|
|
</DL>
|
|
<DT id="85"><A HREF="#lbAN">EXIT-STATUS</A><DD>
|
|
<DT id="86"><A HREF="#lbAO">UMGEBUNGSVARIABLEN</A><DD>
|
|
<DT id="87"><A HREF="#lbAP">DATEIEN</A><DD>
|
|
<DT id="88"><A HREF="#lbAQ">SIEHE AUCH</A><DD>
|
|
<DT id="89"><A HREF="#lbAR">GESCHICHTE</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:04:56 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|