groffer - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

groffer – zeigt Groff-Dateien und Manpages auf X und TTY an

ZUSAMMENFASSUNG

Groffer [--] [Dateispezifikation ....]

Groffer [Modusoption ....] [Groff-Optionen ....] [Mann-Optionen ....] [X-Optionen ....]
[--] [Dateispezifikation ....]

Groffer -h | --help

Groffer -v | --Version

BESCHREIBUNG

Die Groffer Programm ist der einfachste Weg, groff(1). Es kann beliebige
Dokumente, die in der groff Sprache, siehe groff(7) oder andere ab Sprachen, siehe
ab(7), die mit dem Original kompatibel sind troff Sprache. Es findet und führt alle
notwendig, groff Präprozessoren, wie z. B. Chem..

Die Groffer Das Programm enthält auch viele Funktionen zum Suchen und Anzeigen der Unix
Handbuchseiten (Mann Seiten), sodass es als Ersatz für ein Mann(1) Programm.
Darüber hinaus können komprimierte Dateien verarbeitet werden von gzip(1) oder bzip2(1) werden dekomprimiert auf-
die Fliege.

Die normale Verwendung ist ganz einfach, indem man einen Dateinamen oder einen Namen eines Mann Seite ohne
weitere Optionen. Aber die Optionenverwaltung bietet viele Möglichkeiten zur Erstellung spezieller
Verhaltensweisen. Dies kann entweder in Konfigurationsdateien, mit der Shell-Umgebung
Variable $GROFFER_OPToder in der Befehlszeile.

Die Ausgabe kann auf verschiedene Arten generiert und angezeigt werden, die für groff.
Dies beinhaltet das groff nativer X Window-Viewer gxditview(1), jeder Nachwort, pdf oder Dvi
Anzeigeprogramm, ein Webbrowser durch die Generierung html in www Modusoder mehrere Text Modi in
Textterminals.

Die meisten Optionen, die beim Ausführen benannt werden müssen groff direkt bestimmt werden
automatisch für Groffer, aufgrund der internen Nutzung der Grog(1) Programm. Aber alle
Teile können auch manuell durch Argumente gesteuert werden.

In den Kommandozeilenargumenten können mehrere Dateinamen angegeben werden. Diese werden umgewandelt
in ein einzelnes Dokument auf die übliche Weise groff.

Die Optionenverwaltung erfolgt im GNU-Stil. Optionen und Dateinamen können frei gemischt werden. Die
Option `--' schließt die Optionenbehandlung ab, alle folgenden Argumente werden als Dateinamen behandelt.
Lange Optionen können auf verschiedene Weise abgekürzt werden.

zur Auswahl Überblick

Bruch Optionen

[-h | --help] [-v | --Version]

Groffer Modus Optionen

[--Auto] [--Ursprünglich] [--default-modes Modus1, Modus2, ….] [--dvi] [--groff]
[--html] [--latin1] [--Modus Anzeigemodus] [--pdf] [--pdf2] [--ps] [--Quelle]
[--Text] [--to-stdout] [--tty] [--utf8] [--Zuschauer prog] [- www] [--X | --X]

Optionen bezogene zu groff

[-T | --Gerät Gerät] [-Z | --intermediate-output | - ditroff]

Alle weiteren groff Kurze Optionen werden akzeptiert.

Optionen für Mann Seiten

[--apropos] [--apropos-data] [--apropos-devel] [--apropos-progs] [--Mann]
[--kein Mann] [--kein-Spezial] [--was ist]

lange Optionen gemacht übrig von GNU Mann

[--alle] [--ASCII] [- ditroff] [--Verlängerung Suffix] [- Gebietsschema Sprache]
[--lokale-Datei] [--Lage | --wo] [--manpath Verzeichnis1:Verzeichnis2:....] [--no-__cpLocation]
[-Pager Programm] [--Abschnitte Sek.1:Sek.2:....] [--Systeme sys1,sys2,....]
[--troff-Gerät Gerät]

Weitere lange Optionen von GNU Mann werden ebenfalls akzeptiert.

X Window Toolkit Optionen

[--bd | --bordercolor Pixel] [--bg | --Hintergrund Farbe]
[--sw | --borderwidth Pixel] [--Anzeige X-Anzeige] [--fg | --Vordergrund Farbe]
[--fn | --ft | --Schriftart Schriftartenname] [--Geometrie size_pos] [--Auflösung Wert] [--rv]
[--Titel Schnur] [--xrm X-Ressource]

Optionen für Entwicklung

[--debuggen] [--debug-filenames] [--debug-grog] [--debug-keep] [--debug-params]
[--debug-tmpdir] [--nichts tun] [--drucken Text] [-V]

Dateispezifikation Argumente

Die Dateispezifikation Parameter sind alle Argumente, die weder eine Option noch eine Option sind
Argument. Sie bedeuten in der Regel einen Dateinamen oder eine Mann Seite Suchschema.

Im Folgenden wird der Begriff Abschnittserweiterung verwendet wird. Es bedeutet ein Wort, das
besteht aus a Mann Abschnitt dem optional ein Erweiterung. Der Name von
a Mann Abschnitt ist ein einzelnes Zeichen aus [1–9on]den Erweiterung ist ein Wort. Die
Erweiterung fehlt meist.

Nein Dateispezifikation Parameter bedeutet Standardeingabe.

- steht für Standardeingabe (kann mehrfach vorkommen).

Dateinamen der Pfadname einer vorhandenen Datei.

Mann:Name(Abschnittserweiterung)
Mann:Name.Abschnittserweiterung
Name(Abschnittserweiterung)
Name.Abschnittserweiterung
Abschnittserweiterung Name
Durchsuchen Sie die Manpage Name im Abschnitt mit optionaler Erweiterung
Abschnittserweiterung.

Mann:Name Manpage in der untersten Mann Abschnitt das hat Name.

Name if Name ist keine vorhandene Dateisuche für die Manpage Name in England,
unterster Männerabschnitt.

zur Auswahl DETAILS

Die Groffer Das Programm kann normalerweise mit sehr wenigen Optionen ausgeführt werden. Für spezielle Zwecke
Es werden viele Optionen unterstützt. Diese können in 5 Optionsklassen eingeteilt werden.

Alle Short-Optionen von Groffer sind kompatibel mit den kurzen Optionen von groff(1). Alle langen
Optionen von Groffer sind kompatibel mit den langen Optionen von Mann(1).

Argumente für lange Optionsnamen können auf verschiedene Weise abgekürzt werden. Erstens das Argument
geprüft, ob es so verlängert werden kann. Darüber hinaus wird jedes Minuszeichen - is
als Ausgangspunkt für eine neue Abkürzung betrachtet. Dies führt zu einer Reihe von mehreren
Abkürzungen für ein einzelnes Argument. Zum Beispiel: --de-nf kann als Abkürzung verwendet werden
für --debug-not-func, Aber --de-n funktioniert auch. Wenn die Abkürzung des Arguments führt
Bei mehreren resultierenden Optionen wird ein Fehler ausgelöst.

Diese Abkürzungen sind nur in der Umgebungsvariable zulässig $GROFFER_OPTaber nicht in
die Konfigurationsdateien. In der Konfiguration müssen alle langen Optionen exakt sein.

Groffer Bruch Optionen
Sobald eine dieser Optionen in der Kommandozeile gefunden wird, wird sie ausgeführt und ausgegeben an
Standardausgabe und die laufende Groffer wird danach beendet. Alle anderen Argumente
werden ignoriert.

-h | --help
Drucken Sie Hilfeinformationen mit einer kurzen Erläuterung der Optionen zur Standardausgabe.

-v | --Version
Versionsinformationen in die Standardausgabe drucken.

Groffer Model Optionen
Der Anzeigemodus und die Anzeigeprogramme werden durch diese Optionen bestimmt. Wenn keine der
Diese Modus- und Viewer-Optionen werden angegeben Groffer versucht, einen geeigneten Anzeigemodus zu finden
automatisch. Die Standardmodi sind Modus pdf, Modus ps, Modus html, Modus x und Modus Dvi
in X Window mit verschiedenen Viewern und Modus tty mit Gerät utf8 für weniger auf einem Terminal;
andere Modi werden getestet, wenn die Programme für den Hauptstandardmodus nicht vorhanden sind.

In X Window erstellen viele Programme beim Aufruf ihr eigenes Fenster. Groffer kann diese ausführen
Viewer als eigenständiges Programm im Hintergrund. Da dies im Textmodus nicht funktioniert
Auf einem Terminal (TTY) muss es eine Möglichkeit geben, herauszufinden, welche Viewer X Window-Grafiken sind
Programme. Die Groffer Das Skript enthält einige Informationen zu einigen Viewer-Namen. Wenn ein
Das Viewer-Argument der Kommandozeile wählt ein Element aus, das als X Window-Programm in
In dieser Liste wird es als Viewer behandelt, der im Hintergrund ausgeführt werden kann. Alle anderen, unbekannten
Zuschaueranrufe werden nicht im Hintergrund ausgeführt.

Für jeden Modus können Sie den gewünschten Viewer auswählen. Das muss nicht unbedingt ein
grafische Anzeige für diesen Modus geeignet. Es besteht die Möglichkeit, die Ausgabequelle anzuzeigen; für
Beispielsweise kann die Kombination der Optionen --mode=ps und --viewer=weniger zeigt den Inhalt von
die Postskriptum Ausgabe, der Quellcode, mit dem Pager weniger.

--Auto Gleichwertig --mode=auto.

--Ursprünglich
Setzt die gesamte Konfiguration von zuvor verarbeiteten Befehlszeilenoptionen auf die
Standardwerte. Dies ist nützlich, um alle vorherigen Optionen des
Konfiguration, in $GROFFER_OPTund starten Sie die Optionsverarbeitung erneut, indem Sie nur den Rest verwenden
der Befehlszeile.

--default-modes Modus1, Modus2, ….
Stellen Sie die Reihenfolge der Modi ein für Auto Modus zur durch Kommas getrennten Liste in der
Streit. Sehen --Modus für Details zu den Modi. Anzeige in der Standardweise;
eigentlich bedeutet das, die Modi auszuprobieren x, ps und tty in dieser Reihenfolge.

--dvi Gleichwertig --mode=dvi.
--Zuschauer prog
Wählen Sie ein Viewer-Programm für Dvi Modus. Dies kann ein Dateiname oder ein Programm sein,
gesucht in $ PATHBekanntes X-Fenster Dvi Zu den Zuschauern zählen xdvi(1) und dvilx(1). Im
Es können jeweils ergänzend Argumente angeführt werden.

--groff
Gleichwertig --mode=groff.

--html Gleichwertig --mode=html.
--Zuschauer
Wählen Sie ein Webbrowser-Programm zum Anzeigen in html Modus. Es kann der Pfadname von
eine ausführbare Datei oder ein Programm in $ PATH. In jedem Fall können Argumente geliefert werden
zusätzlich.

--Modus Wert
Legen Sie den Anzeigemodus fest. Die folgenden Moduswerte werden erkannt:

Auto Wählen Sie die automatische Ermittlung des Anzeigemodus. Die Reihenfolge der
Die ausprobierten Modi können mit dem --default-modes Option. Nützlich für
Wiederherstellung der Standard Modus wenn zuvor ein anderer Modus angegeben wurde.

Dvi Formatierte Eingaben in einem Dvi Viewer-Programm. Standardmäßig wird die formatierte
Die Eingabe wird mit dem xdvi(1) Programm.

groff Nach der Dateiermittlung wechseln Sie Groffer um die Eingabe zu verarbeiten wie
groff(1) würde genügen. Dies deaktiviert die Groffer Anzeigefunktionen.

html Übersetzen Sie die Eingabe in das HTML-Format und zeigen Sie das Ergebnis in einem Webbrowser an
Programm. Standardmäßig ist die Existenz einer Reihe von Standard-Webbrowsern
wird getestet, beginnend mit Eroberer(1) und mozilla(1). Der Text-HTML-Viewer
is Luchs(1).

pdf Transformieren ab Varianten des Eingangssignals: Dateien in ein PDF Datei mit dem groff (1) Gerät
-TpdfDies ist die Standardeinstellung PDF Generator. Die erzeugte PDF Datei is
mit geeigneten Anzeigeprogrammen angezeigt, wie z. B. okular(1).

pdf2 Dies ist die traditionelle pdf Modus. Manchmal erzeugt dieser Modus korrektere
Ausgabe als die Standardeinstellung PDF ModusStandardmäßig wird die Eingabe formatiert durch
groff mit dem Postscript-Gerät, dann wird es in die PDF-Datei umgewandelt
Formatieren mit gs(1) oder ps2pdf(1). Wenn dies nicht möglich ist, Postskriptum
Modus (ps) wird stattdessen verwendet. Schließlich wird es mit verschiedenen Viewern angezeigt
Programme.

ps Formatierte Eingaben in einem Postscript-Viewer anzeigen. Standardmäßig
Die formatierte Eingabe wird in einem der vielen Anzeigeprogramme angezeigt.

Text Formatieren in einem groff Text Modus und schreiben Sie das Ergebnis in die Standardausgabe ohne
ein Pager oder Viewer-Programm. Das Textgerät, Latein1 standardmäßig kann
gewählt mit Option -T.

tty Formatieren in einem groff Text Modus und schreiben Sie das Ergebnis in die Standardausgabe mit einem
Textpager-Programm, auch im X Window.

www Gleichwertig --mode=html.

x Zeigen Sie die formatierte Eingabe in einem nativen ab Viewer. Standardmäßig ist der
formatierte Eingabe wird mit dem gxditview(1) das zu verteilende Programm
Zusammen mit groff. Aber das Standard-X Window-Tool xditview(1) kann auch
mit der Option gewählt --ZuschauerDie Standardauflösung ist 75dpi, Aber
100dpi sind ebenfalls möglich. Die Standardeinstellung groff Gerät zur Auflösung von
75dpi is X75-12Z. 100dpi es ist X100. Die entsprechende groff
Zwischen- Möglichkeiten für das Ausgangssignal: für das eigentliche Gerät generiert und das Ergebnis
angezeigt. Für eine Auflösung von 100dpi, die Standardbreite der Geometrie von
Das Anzeigeprogramm wird so gewählt, 850dpi.

X Gleichwertig --mode=x.

Die folgenden Modi verwenden nicht die Groffer Anzeigefunktionen. Sie sind nur
interessant für fortgeschrittene Anwendungen.

groff Generieren Sie Geräteausgabe mit einfachem groff ohne die spezielle Anzeige
Eigenschaften Groffer. Wenn kein Gerät per Option angegeben wurde -T die groff
Standard ps wird angenommen.

Quelle Gibt den Roff-Quellcode der Eingabedateien ohne weitere Verarbeitung aus.

--pdf Gleichwertig --mode=pdf.
--pdf2 Gleichwertig --mode=pdf2.
--Zuschauer prog
Wählen Sie ein Viewer-Programm für pdf Modus. Dies kann ein Dateiname oder ein Programm sein,
gesucht in $ PATH; Argumente können zusätzlich angegeben werden.

--ps Gleichwertig --mode=ps.
--Zuschauer prog
Wählen Sie ein Viewer-Programm für ps Modus. Dies kann ein Dateiname oder ein Programm sein,
gesucht in $ PATHZu den gängigen Postscript-Viewern gehören okular(1) beweisen(1) gv(1)
Geisteransicht(1) und gs(1) Es können jeweils ergänzend Argumente angeführt werden.

--Quelle
Gleichwertig --mode=Quelle.

--Text Gleichwertig --mode=text.

--to-stdout
Die Datei für den gewählten Modus wird generiert und ihr Inhalt wird standardmäßig gedruckt
Ausgabe. Es wird nicht im grafischen Modus angezeigt.

--tty Gleichwertig --mode=tty.
--Zuschauer prog
Wählen Sie einen Textpager für den Modus ttyDer Standard-Pager ist weniger(1). Diese Option ist
entspricht Mann ganz ohne irgendetwas tun oder drücken zu müssen. --pager=prog. Das Optionsargument kann ein Dateiname oder ein
Programm, in dem gesucht werden soll $ PATH; Argumente können zusätzlich angegeben werden.

- www Gleichwertig --mode=html.
--Zuschauer
prog.

--X | --X
Gleichwertig --mode=x.
--Zuschauer prog
Wählen Sie ein Viewer-Programm für x ModusGeeignete Viewer-Programme sind gxditview(1)
Dies ist die Standardeinstellung und xditview(1). Das Argument kann eine beliebige ausführbare Datei oder ein
Programm ein $ PATH; Argumente können zusätzlich angegeben werden.

-- Signalisiert das Ende der Optionenverarbeitung; alle verbleibenden Argumente werden interpretiert als
Dateispezifikation Parameter.

Neben diesen, Groffer akzeptiert alle Short-Optionen, die für die groff(1) Programm.
Alle Nicht-Groffer Optionen werden unverändert gesendet per Grog zu groff. So Postprozessoren, Makro
Pakete, Kompatibilität mit klassisch troffund vieles mehr können manuell angegeben werden.

Optionen bezogene zu groff
Alle Short-Optionen von Groffer sind kompatibel mit den kurzen Optionen von groff(1). Das
folgende von groff Optionen haben entweder eine zusätzliche spezielle Bedeutung innerhalb Groffer or
für den normalen Gebrauch sinnvoll.

Aufgrund des speziellen Ausgabeverhaltens der groff ganz ohne irgendetwas tun oder drücken zu müssen. -Z Groffer wurde entworfen, um
umgeschaltet werden in groff Modus; das Groffer Anzeigefunktionen sind dort deaktiviert. Die anderen
groff Mit den Optionen wird der Modus nicht umgeschaltet, sondern der Formatierungsprozess kann individuell angepasst werden.

--ein Dies erzeugt eine ASCII-Näherung der Ausgabe in der Text ModiDas könnte sein
wichtig, wenn der Textpager Probleme mit Steuersequenzen hat in tty Modus.

--M Datei
Speichern Datei als ein groff Makrodatei. Dies ist nützlich, wenn es nicht erkannt wird
automatisch.

--P opt_or_arg
Senden Sie das Argument opt_or_arg als Option oder Optionsargument zum eigentlichen groff
Postprozessor.

--T Entwicklername | --Gerät Entwicklername
Diese Option bestimmt groffAusgabegerät. Die wichtigsten Geräte sind die
Textausgabegeräte zur Bezugnahme auf die verschiedenen Zeichensätze, wie z. B. ASCII,
utf8, Latein1, utf8und andere. Jedes dieser Argumente wechselt Groffer in ein
Text Modus mit diesem Gerät, um Modus tty wenn der aktuelle Modus kein Text Modus.
Folgende Entwicklername Argumente werden den entsprechenden Groffer
--mode=Entwicklername Option: Dvi, html und ps. Alle X* Argumente werden zugeordnet auf Modus x.
Gegenseitig Entwicklername Argument wechselt zu Modus groff mit diesem Gerät.

--X entspricht groff -X. Es zeigt die groff Zwischen- Möglichkeiten für das Ausgangssignal: mit
gxditview. Da die Qualität relativ schlecht ist, ist diese Option veraltet; verwenden Sie --X
stattdessen, weil die x Modus verwendet eine X* Gerät für eine bessere Anzeige.

-Z | --intermediate-output | - ditroff
Wechseln Sie in groff Modus und formatieren Sie die Eingabe mit dem groff Zwischen- Möglichkeiten für das Ausgangssignal:
ohne Nachbearbeitung; siehe groff_out(5). Dies entspricht der Option - ditroff
of Mann, die ebenfalls verwendet werden können.

Alles Andere groff Optionen werden unterstützt durch Groffer, aber sie sind einfach durchsichtig
übertragen auf groff ohne Eingriff. Die Optionen, die nicht explizit
bearbeitet von Groffer werden transparent weitergegeben an groff. Daher diese transparenten Optionen
sind hier nicht dokumentiert, aber in groff(1). Aufgrund des Automatismus in Groffer, keiner von diesen
groff Optionen sollten erforderlich sein, außer für die erweiterte Nutzung.

Optionen für Mann Seiten
--apropos
Starte das apropos(1) Befehl oder Einrichtung von Mann(1) für die Suche nach Dateispezifikation
Argumente in allen Mann Seite Beschreibungen. Jeder Dateispezifikation Argument wird für
Suche wie sie ist; Abschnitt bestimmte Teile werden nicht behandelt, so dass 7 groff Suchbegriffe
für die beiden Argumente 7 und groff, mit einem großen Ergebnis; für die Dateispezifikation groff.7
nichts wird gefunden. Die Sprache Das Gebietsschema wird nur dann behandelt, wenn der aufgerufene
Programme unterstützen dies; die GNU apropos und Mann -k nicht. Die Anzeige unterscheidet sich
von dem apropos Programm durch die folgenden Konzepte:

* Erstellen Sie ein groff Rahmen ähnlich einem Mann Seite zur Ausgabe von apropos,

* jede Dateispezifikation Argument wird alleine gesucht.

* Die Einschränkung durch --Abschnitte wird auch behandelt,

* Platzhalterzeichen sind zulässig und werden ohne weitere Option verarbeitet.

--apropos-data
Nur die anzeigen apropos Beschreibungen für Datendokumente, das sind die Mann(7)
Abschnitte 4, 5 und 7. Direkte Abschnitt Deklarationen werden ignoriert, Platzhalter werden
akzeptiert.

--apropos-devel
Nur die anzeigen apropos Beschreibungen für Entwicklungsdokumente, das sind die Mann(7)
Abschnitte 2, 3 und 9. Direkte Abschnitt Deklarationen werden ignoriert, Platzhalter werden
akzeptiert.

--apropos-progs
Nur die anzeigen apropos Beschreibungen für Dokumente zu Programmen, das sind die Mann(7)
Abschnitte 1, 6 und 8. Direkte Abschnitt Deklarationen werden ignoriert, Platzhalter werden
akzeptiert.

--was ist
Für jeden Dateispezifikation Argumentsuche alle Mann Seiten und ihre Beschreibung anzeigen – oder
sagen, dass es kein Mann Seite. Dies ist neu geschrieben, also unterscheidet es sich von Mann's
was ist Ausgabe durch die folgenden Konzepte

* jeder abgerufene Dateiname wird hinzugefügt,

* Auch lokale Dateien werden verarbeitet,

* das Sprache und fragst Gebietsschema wird unterstützt,

* die Anzeige wird umrahmt von einem groff Ausgabeformat ähnlich einem Mann Seite,

* Platzhalterzeichen sind ohne weitere Option zulässig.

Die folgenden Optionen wurden hinzugefügt Groffer zur Auswahl, ob die Dateinamenargumente
werden als Namen für lokale Dateien oder als Suchmuster für Mann Seitendem „Vermischten Geschmack“. Seine
Standardmäßig wird nach lokalen Dateien gesucht.

--Mann Überprüfen Sie die Befehlszeilenargumente ohne Optionen (Dateispezifikationen) zuerst auf das Sein Mann Seiten,
dann, ob sie eine vorhandene Datei darstellen. Standardmäßig a Dateispezifikation ist zuerst
geprüft, ob es sich um eine vorhandene Datei handelt.

--kein Mann | --lokale-Datei
Überprüfen Sie nicht auf Mann Seiten. --lokale-Datei ist die entsprechende Mann .

--kein-Spezial
Deaktivieren Sie frühere Anrufe von --alle, --apropos* und --was ist.

lang Optionen gemacht übrig von GNU Mann
Die langen Optionen von Groffer wurden mit den langen Optionen von GNU synchronisiert Mann. Alle lange
Optionen von GNU Mann werden erkannt, aber nicht alle dieser Optionen sind wichtig für Groffer,
so dass die meisten von ihnen einfach ignoriert werden. Diese ignoriert Mann Optionen sind --Katzenmann, - troff und
--aktualisieren.

Im Folgenden Mann Optionen, die eine besondere Bedeutung haben für Groffer sind dokumentiert.

Wenn Ihr System über GNU verfügt Mann installiert den vollständigen Satz von langen und kurzen Optionen der GNU Mann
Programm kann über die Umgebungsvariable übergeben werden $MANOPT; sehen Mann(1).

--alle Auf der Suche Mann Seiten, rufen Sie alle passenden Dokumente ab, statt nur eines.

-7 | --ASCII
In Text Modi, Anzeige der ASCII-Übersetzung von Sonderzeichen für kritische
Umgebung. Dies entspricht groff -mtty_char; sehen groff_tmac(5).

- ditroff
Produziere groff Zwischen- Möglichkeiten für das Ausgangssignal:. Dies entspricht Groffer -Z.

--Verlängerung Suffix
einschränken Mann Seite Suche nach Dateinamen, die Suffix an ihren Abschnitt angehängt
Element. Zum Beispiel im Dateinamen /usr/share/man/man3/terminfo.3ncurses.gz
die Mann Seite Erweiterung ist Flüche.

- Gebietsschema Sprache
Stellen Sie die Sprache ein für Mann SeitenDies hat den gleichen Effekt, überschreibt aber $LANG.

--Lage
Drucken Sie den Speicherort der abgerufenen Dateien in die Standardfehlerausgabe.

--no-__cpLocation
Den Speicherort abgerufener Dateien nicht anzeigen; dies setzt einen früheren Aufruf zurück an
--Lage. Dies wurde hinzugefügt von Groffer.

--manpath 'dir1:dir2:....'
Verwenden Sie den angegebenen Suchpfad zum Abrufen Mann Seiten anstelle des Programms
Standardwerte. Wenn das Argument auf die leere Zeichenfolge "" gesetzt ist, wird die Suche nach Mann Seite is
behindert.

-Pager
Stellen Sie das Pager-Programm ein tty Modus; Standard ist wenigerDies kann eingestellt werden mit --Zuschauer.

--Abschnitte Sek.1:Sek.2:....
Suche einschränken auf Mann Seiten zum gegebenen Abschnitte, eine durch Doppelpunkte getrennte Liste.

--Systeme sys1,sys2,....
Suchen Sie nach Mann Seiten für die gegebenen Betriebssysteme; das Argument Systeme ist eine
durch Kommas getrennte Liste.

--wo
Gleichwertig --Lage.

X Window Toolkit Optionen
Die folgenden langen Optionen wurden von den entsprechenden Optionen des X Window Toolkit übernommen.
Groffer leitet sie an das eigentliche Anzeigeprogramm weiter, wenn es sich um ein X Window-Programm handelt.
Andernfalls werden diese Optionen ignoriert.

Leider verwenden diese Optionen den alten Stil eines einzelnen Minus für lange Optionen. Für
Groffer Dies wurde zum Standard geändert, indem für lange Optionen ein doppeltes Minus verwendet wurde.
Beispiel Groffer verwendet die Option --Schriftart für die X Window-Option -Schriftart.

Weitere Informationen finden Sie auch in den X(7) und die Dokumentation zu den X Window Toolkit-Optionen für weitere Details zu diesen
Optionen und ihre Argumente.

--Hintergrund Farbe
Legen Sie die Hintergrundfarbe des Viewer-Fensters fest.

--bd Pixel
Dies ist äquivalent zu --bordercolor.

--bg Farbe
Dies ist äquivalent zu --Hintergrund.

--sw Pixel
Dies ist äquivalent zu --borderwidth.

--bordercolor Pixel
Gibt die Farbe des Rahmens um das Viewer-Fenster an.

--borderwidth Pixel
Gibt die Breite des Rahmens um das Viewer-Fenster in Pixeln an.

--Anzeige X-Anzeige
Legen Sie die X Window-Anzeige fest, auf der das Viewer-Programm gestartet werden soll. Siehe
X Window-Dokumentation für die Syntax des Arguments.

--Vordergrund Farbe
Legen Sie die Vordergrundfarbe des Viewer-Fensters fest.

--fg Farbe
Dies ist äquivalent zu --Vordergrund.

--fn Schriftartenname
Dies ist äquivalent zu --Schriftart.

--Schriftart Schriftartenname
Legt die vom Viewer-Fenster verwendete Schriftart fest. Das Argument ist der Name einer X Window-Schriftart.

--ft Schriftartenname
Dies ist äquivalent zu --Schriftart.

--Geometrie size_pos
Legen Sie die Geometrie des Anzeigefensters fest, d. h. seine Größe und seinen Startpunkt
Position. Siehe X(7) für die Syntax des Arguments.

--Auflösung Wert
Stellen Sie die X Window-Auflösung in einigen Viewer-Programmen in dpi (dots per inch) ein. Die einzige
Unterstützte dpi-Werte sind 75 und 100. Tatsächlich ist die Standardauflösung für Groffer
eingestellt ist 75dpi. Die Auflösung legt auch das Standardgerät fest, in Modus x.

--rv Vorder- und Hintergrundfarbe des Viewer-Fensters umkehren.

--Titel 'manche Text'
Legen Sie den Titel für das Viewer-Fenster fest.

--xrm 'Ressource'
X Window-Ressource festlegen.

Optionen für Entwicklung
--debuggen
Alle Debugoptionen aktivieren --debuggen-tippe. Die temporären Dateien bleiben erhalten und nicht
gelöscht, die Grog Ausgabe wird gedruckt, der Name des temporären Verzeichnisses ist
gedruckt, die angezeigten Dateinamen werden gedruckt und die Parameter werden gedruckt.

--debug-filenames
Drucken Sie die Namen der Dateien und Mann Seiten die angezeigt werden durch Groffer.

--debug-grog
Drucken Sie die Ausgabe aller Grog Befehle.

--debug-keep
Aktivieren Sie zwei Debug-Informationen. Drucken Sie den Namen des temporären Verzeichnisses und
Behalten Sie die temporären Dateien, löschen Sie sie nicht während der Ausführung von Groffer.

--debug-params
Drucken Sie die Parameter aus, wie sie aus den Konfigurationsdateien abgerufen wurden, von GROFFER_OPT,
und die Befehlszeilenargumente.

--debug-tmpdir
Drucken Sie den Namen des temporären Verzeichnisses.

--nichts tun
Das ist wie --Version, jedoch ohne Ausgabe; es wird kein Viewer gestartet. Dies macht
nur Sinn in der Entwicklung.

--print=Text
Drucken Sie das Argument einfach in die Standardfehlerausgabe. Dies ist gut für die Parameterprüfung.

-V Dies ist eine erweiterte Option, die nur zum Debuggen dient. Anstatt die formatierte
Eingabe, viel Groffer Bestimmte Informationen werden auf der Standardausgabe gedruckt:

* der Name der Ausgabedatei im temporären Verzeichnis,

* der Anzeigemodus der tatsächlichen Groffer laufen,

* das Anzeigeprogramm zum Anzeigen der Ausgabe mit ihren Argumenten,

* die aktiven Parameter aus den Konfigurationsdateien, die Argumente in $GROFFER_OPT und
die Argumente der Kommandozeile,

* die Pipeline, die von der groff Programm, ohne es jedoch auszuführen.

Weitere nützliche Debugging-Optionen sind die groff ganz ohne irgendetwas tun oder drücken zu müssen. -Z und --mode=groff.

Dateispezifikation Argumente
A Dateispezifikation Parameter ist ein Argument, das keine Option oder Optionsargument ist. In Groffer,
Dateispezifikation Parameter sind ein Dateiname oder eine Vorlage für die Suche Mann SeitenDiese Eingabe
Quellen werden gesammelt und in einer einzigen Ausgabedatei zusammengefasst, wie z. B. groff tut.

Das seltsame POSIX-Verhalten, alle Argumente hinter dem ersten Nicht-Optionsargument als
Dateispezifikation Argumente werden ignoriert. Das GNU-Verhalten, Optionen auch dann zu erkennen, wenn sie mit
Dateispezifikation Argumente werden durchgehend verwendet. Aber wie üblich wird das doppelte Minus-Argument -- endet
die Optionenbehandlung und interpretiert alle folgenden Argumente als Dateispezifikation Argumente; also die
Das POSIX-Verhalten kann problemlos übernommen werden.

Die Optionen --apropos* haben einen besonderen Umgang mit Dateispezifikation Argumente. Jedes Argument ist
als eigenes Suchschema betrachtet. Auch ein Regexp (regulärer Ausdruck) kann in
die Dateispezifikation. Beispiel: Groffer --apropos '^gro.f$' Suchbegriffe groff in England, Mann Seite
Name, während Groffer --apropos groff Suchbegriffe groff irgendwo im Namen oder in der Beschreibung von
die Mann Seiten.

Alle anderen Teile von Groffer, wie die normale Anzeige oder die Ausgabe mit --was ist haben ein
anderes Schema für Dateispezifikationen. Für die Argumente werden keine regulären Ausdrücke verwendet. Die
Dateispezifikation Argumente werden nach dem folgenden Schema behandelt.

Es ist wichtig zu wissen, dass auf jedem System die Mann Seiten sind sortiert nach ihrer
Inhalt in mehrere Abschnitte. Die klassisch Mann Abschnitte einen einstelligen Namen haben,
entweder eine Ziffer aus 1 zu 9 oder einer der Charaktere n or o.

Optional kann noch eine Zeichenfolge folgen, die sogenannte Erweiterungdem „Vermischten Geschmack“. Seine Erweiterung
ermöglicht die Speicherung mehrerer Mann Seiten mit dem gleichen Namen im gleichen Abschnitt. Aber der
Erweiterung wird nur selten verwendet, meist wird es weggelassen. Dann Erweiterungen werden gesucht
automatisch nach Alphabet.

Im Folgenden verwenden wir den Namen Abschnittserweiterung für ein Wort, das aus einer einzigen
Charakter Abschnitt name oder a Abschnitt Zeichen, gefolgt von einem Erweiterung. Jeder
Dateispezifikation Parameter können in absteigender Reihenfolge eine der folgenden Formen haben.

* No Dateispezifikation Parameter bedeutet, dass Groffer wartet auf Standardeingabe. Die Minus-Option -
steht immer für Standardeingabe; es kann mehrmals vorkommen. Wenn Sie eine
Mann Seite namens - benutze das Argument Mann:-.

* Als nächstes ein Dateispezifikation geprüft, ob es sich um den Pfadnamen einer vorhandenen Datei handelt. Andernfalls
wird als Suchmuster für eine Mann Seite.

* Mann:Name(Abschnittserweiterung), Mann:Name.Abschnittserweiterung, Name(Abschnittserweiterung), or
Name.Abschnittserweiterung Durchsuchen Sie die Manpage Name im Mannabschnitt und möglicherweise Erweiterung von
Abschnittserweiterung.

* Jetzt Mann:Name sucht nach einem Mann Seite in der niedrigsten Mann Abschnitt das ein Dokument hat
namens Name.

* Abschnittserweiterung Name ist ein Muster von 2 Argumenten, das aus einer seltsamen
Argumentanalyse der Mann Programm. Auch hier wird die Manpage durchsucht Name mit
Abschnittserweiterung, eine Kombination aus einem Abschnitt Zeichen, optional gefolgt von einem
Erweiterung.

* Wir bleiben mit dem Argument zurück Name Dies ist keine vorhandene Datei. Es wird also nach
die Mann Seite namens Name in der niedrigsten Mann Abschnitt das ein Dokument für diesen Namen hat.

Es können mehrere Dateinamen-Argumente angegeben werden. Diese werden gemischt durch groff in einem einzigen
Dokument. Beachten Sie, dass der Satz der Optionsargumente zu allen diesen Dateiargumenten passen muss.
Sie sollten also zumindest den gleichen Stil haben wie groff Sprache.

AUSGABE MODI

Standardmäßig ist die Groffer Das Programm sammelt alle Eingaben in einer einzigen Datei, formatiert sie mit dem
groff Programm für ein bestimmtes Gerät und wählt dann ein geeignetes Viewer-Programm aus. Die
Geräte- und Viewer-Prozess in Groffer heißt a Modus. Der Modus und der Betrachter eines laufenden
Groffer Das Programm wird automatisch ausgewählt, der Benutzer kann es jedoch auch mit Optionen auswählen.
Die Modi werden durch die Option ausgewählt, die Argumente von --mode=Anymode. Darüber hinaus
Dieses Argument kann als eigene Option angegeben werden, beispielsweise Anymode. Die meisten von diesen
Modi verfügen über ein Viewer-Programm, das über die Option --Zuschauer.

Es werden verschiedene Modi angeboten, grafische Modi für X Window, Text Modi, Und einige
direkt groff Modi zum Debuggen und Entwickeln.

Standardmäßig Groffer erste Versuche, ob x Modus möglich ist, dann ps Modus, und schlussendlich
tty Modus. Diese Modus-Testsequenz für Auto Modus kann durch Angabe eines Kommas geändert werden
getrennte Liste der Modi mit der Option --Standardmodi.

Die Suche nach Mann Seiten und die Dekomprimierung der Eingabe sind in jedem Modus aktiv.

Grafische Display Modi
Die grafischen Anzeigemodi funktionieren meist in der X Window-Umgebung (oder ähnlichen
Implementierungen innerhalb anderer Fensterumgebungen). Die Umgebungsvariable $ANZEIGE
und die Option --Anzeige dienen zur Festlegung der zu verwendenden X Window-Anzeige. Wenn diese
Umgebungsvariable ist leer Groffer geht davon aus, dass kein X Window läuft und wechselt zu einem
Text Modus. Sie können dieses automatische Verhalten mit der Option --default-modes.

Bekannte Viewer für die grafischen Anzeigemodi und deren Standard-X Window-Viewer-Programme
sind

* in einem PDF-Viewer (pdf Modus)

* in einem Webbrowser (html or www Modus)

* in einem Postscript-Viewer (ps Modus)

* X-Fenster ab Zuschauer wie gxditview(1) oder xditview(1) (in x Modus)

* in einem DVI-Viewer-Programm (Dvi Modus)

Die pdf Modus hat einen großen Vorteil — es ist der einzige grafische Anzeigemodus, der es ermöglicht,
Suche nach Text im Viewer; das kann eine wirklich wichtige Funktion sein. Leider
Es dauert einige Zeit, die Eingabe in das PDF-Format umzuwandeln, daher wurde es nicht als das gewählt
Dur-Modus.

Diese grafischen Viewer können mit den Optionen des X Window Toolkits angepasst werden. Aber die
Groffer Optionen verwenden ein führendes Doppel-Minus anstelle des einfachen Minus, das von der
X Window Toolkit.

Text Modi
Es gibt zwei Modi für die Textausgabe, Modus Text für die einfache Ausgabe ohne Pager und
Modus tty für eine Textausgabe auf einem Textterminal mithilfe eines Pager-Programms.

Wenn die Variable $ANZEIGE ist nicht gesetzt oder leer, Groffer geht davon aus, dass es verwenden sollte tty Modus.

In der tatsächlichen Umsetzung groff Ausgabegerät Latein1 ist gewählt für Text Modi.
Dies kann durch Angabe der Option geändert werden -T or --Gerät.

Der zu verwendende Pager kann durch eine der Optionen angegeben werden -Pager und --Zuschauer, Oder durch
die Umgebungsvariable $PAGER. Wenn all dies nicht verwendet wird, weniger(1) Programm mit dem
ganz ohne irgendetwas tun oder drücken zu müssen. -r zur korrekten Anzeige von Steuersequenzen wird als Standardpager verwendet.

Spezial Modi für Fehlerbeseitigung und Entwicklung
Diese Modi verwenden die Groffer Dateibestimmung und Dekomprimierung. Dies wird zu einem
einzelne Eingabedatei, die direkt in groff mit anderer Strategie ohne die
Groffer Anzeigemöglichkeiten. Diese Modi gelten als fortgeschritten, sie sind nützlich für
Debugging- und Entwicklungszwecke.

Die Quelle Modus mit Option --Quelle zeigt nur die dekomprimierte Eingabe an.

Option --to-stdout wird nicht im grafischen Modus angezeigt. Es generiert nur die Datei für
den gewählten Modus und druckt dann seinen Inhalt auf die Standardausgabe.

Die groff Modus übergibt die Eingabe an groff nur einige geeignete Optionen verwenden, die zur Verfügung gestellt werden
Groffer. Dies ermöglicht dem Benutzer, die generierte Ausgabe in einer Datei zu speichern oder in
ein anderes Programm.

In groff Modus, die Option -Z deaktiviert die Nachbearbeitung und erzeugt so die groff
Zwischen- Möglichkeiten für das Ausgangssignal:. In diesem Modus wird die Eingabe formatiert, aber nicht nachbearbeitet; siehe
groff_out(5) für Details.

Alle groff Short-Optionen werden unterstützt durch Groffer.

HERREN SEITE SUCHE

Das Standardverhalten von Groffer besteht darin, zunächst zu testen, ob ein Dateiparameter eine
lokale Datei; wenn es sich nicht um einen vorhandenen Dateinamen handelt, wird angenommen, dass es sich um den Namen einer
Mann Seite. Mit den folgenden Optionen können Sie festlegen, ob die Argumente
als Dateiname behandelt oder Mann Seite Argumente.

--Mann erzwingt die Interpretation aller Dateiparameter als Dateispezifikationen für die Suche Mann Seiten.

--kein Mann
--lokale-Datei
Deaktivieren Sie die Mann Suche; daher werden nur lokale Dateien angezeigt.

Wenn weder eine lokale Datei noch ein Mann Seite wurde für einige Dateiparameter eine Warnung abgerufen
wird bei Standardfehler ausgegeben, die Verarbeitung wird jedoch fortgesetzt.

Suche Algorithmus
Nehmen wir nun an, dass ein Mann Seite gesucht werden soll. Die Groffer Programm bietet eine
Suchfunktion für Mann Seiten. Alle langen Optionen, alle Umgebungsvariablen und die meisten
die Funktionalität des GNU Mann(1) Programm implementiert wurden. Der Suchalgorithmus soll
bestimmen, welche Datei für eine bestimmte Mann SeiteDer Prozess kann modifiziert werden durch
Optionen und Umgebungsvariablen.

Die einzige Mann Aktion, die ausgelassen wird in Groffer sind die vorformatierten Mann Seiten, auch genannt
Katze Seiten. Mit der hervorragenden Leistung der aktuellen Computer, die vorformatierten
Mann Seiten sind nicht mehr notwendig. Darüber hinaus Groffer ist eine ab Programm; es will
lesen ab Quelldateien und formatieren Sie diese selbst.

Der Algorithmus zum Abrufen der Datei für eine Mann Seite benötigt zunächst eine Reihe von Verzeichnissen.
Dieses Set beginnt mit dem sogenannten Mann Weg das später durch Hinzufügen von Namen von
die fragst und Sprache. Dieser entstehende Satz wird zum Hinzufügen des Abschnitts verwendet
Verzeichnisse, die die Mann Seite Dateien.

Die Mann Weg ist eine Liste von Verzeichnissen, die durch Doppelpunkte getrennt sind. Es wird generiert durch die
folgenden Methoden.

* Die Umgebungsvariable $MANPATH kann eingestellt werden.

* Es kann aus den Argumenten der Umgebungsvariablen gelesen werden $MANOPT.

* Die Mann Weg kann manuell angegeben werden, indem Sie die Option --manpathEin leeres Argument
deaktiviert die Mann Seite suchen.

* Wenn nein Mann Weg wurde eingestellt Manpath(1) Programm wird versucht, eines zu bestimmen.

* Falls dies nicht funktioniert, ein sinnvoller Standardpfad von $ PATH festgestellt wird.

Wir haben nun einen Satz von Verzeichnissen. Die erste Möglichkeit, diesen Satz zu ändern, besteht darin,
Namen von die SystemeDies setzt voraus, dass Mann Seiten für mehrere die Systeme sind
installiert. Dies ist nicht immer der Fall. Die Namen solcher die Systeme kann vorgesehen sein
mit 3 Methoden.

* Die Umgebungsvariable $SYSTEM hat die niedrigste Priorität.

* Dies kann durch eine Option in überschrieben werden $MANOPT.

* Dies wird wiederum durch die Befehlszeilenoption überschrieben --Systeme.

Mehrere Namen von die Systeme können durch Anhängen ihrer Namen angegeben werden, getrennt durch ein
Komma.

Die Mann Weg wird geändert, indem jedes fragst Name als Unterverzeichnis am Ende jedes
Verzeichnis des Sets. Kein Verzeichnis des Mann Weg Satz wird beibehalten. Aber wenn keine fragst Name ist
spezifiziert die Mann Weg bleibt unverändert.

Anschließend kann der aktuelle Verzeichnissatz geändert werden durch Sprache Informationen. Diese
geht davon aus, dass es Mann Seiten in verschiedenen Sprachen. Die gesuchte Sprache kann sein
mit mehreren Methoden ausgewählt.

* Umgebungsvariable $LANG.

* Dies wird überschrieben durch $LC_MESSAGES.

* Dies wird überschrieben durch $LC_ALL.

* Dies kann überschrieben werden, indem eine Option in $MANOPT.

* Alle diese Umgebungsvariablen werden durch die Befehlszeilenoption überschrieben - Gebietsschema.

Die Standard Sprache kann durch Angabe eines der Pseudo-Sprachparameter angegeben werden
C oder POSIX. Dies ist wie das Löschen einer zuvor gegebenen Sprache Information. Das Mann Seiten
in England, Standard Sprache sind in der Regel auf Englisch.

Natürlich kann die Sprache Name wird bestimmt durch MannIn GNU Mann, wird es in der
Auf POSIX 1003.1 basierendes Format:

[_[.[,]]],

aber der zweistellige Code in ist für die meisten Zwecke ausreichend. Wenn für eine
kompliziert Sprache Formulierung Nr. Mann Seiten gefunden werden Groffer durchsucht den Landesteil
besteht ebenfalls aus diesen ersten beiden Zeichen.

Der aktuelle Verzeichnissatz wird dreimal kopiert. Die Sprache Name wird als Unterverzeichnis angehängt
zu jedem Verzeichnis in der ersten Kopie des aktuellen Verzeichnissatzes (dies geschieht nur, wenn ein
Sprachinformationen werden angegeben). Dann die 2-Buchstaben-Abkürzung der Sprache Name ist
als Unterverzeichnisse an die zweite Kopie des Verzeichnissatzes angehängt (dies geschieht nur, wenn
der angegebene Sprachname hat mehr als 2 Buchstaben). Die dritte Kopie des Verzeichnissatzes ist
unverändert bleiben (wenn keine Sprache Informationen werden gegeben, dies ist der beibehaltene Verzeichnissatz).
Diese maximal 3 Kopien werden angehängt, um den neuen Verzeichnissatz zu erhalten.

Wir verfügen nun über einen vollständigen Satz von Verzeichnissen, mit denen wir arbeiten können. In jedem dieser Verzeichnisse befindet sich die
Mann Dateien werden getrennt in AbschnitteDer Name eines Abschnitt wird durch eine einzelne
Zeichen, eine Ziffer zwischen 1 und 9oder das Zeichen o or n, in dieser Reihenfolge.

Für jeden verfügbaren Abschnitt, ein Unterverzeichnis Mann existiert, das alle Mann Dateien
hierfür Abschnitt, Wobei ist ein einzelnes Zeichen, wie zuvor beschrieben. Jedes Mann
Datei in a Abschnitt Verzeichnis hat die Form
Mann/.[ ][.], Wobei und
sind optional. ist der Name des Mann Seite das wird auch angegeben als
Dateispezifikationsargument in der Befehlszeile.

Die Erweiterung ist ein Zusatz zum Abschnitt. Dieses Postfix fungiert als Unterabschnitt. Ein
Erweiterung kommt nur im Dateinamen vor, nicht im Namen der Abschnitt Unterverzeichnis. Es kann
in der Befehlszeile angegeben werden.

Auf der anderen Seite, der Durckstufen ist lediglich eine Information darüber, wie die Datei komprimiert wird.
Dies ist für den Benutzer nicht wichtig, sodass es nicht in der Befehlszeile angegeben werden kann.

Es gibt 4 Methoden zum Angeben eines Abschnitt auf der Kommandozeile:

* Umgebungsvariable $MANSECT

* Befehlszeilenoption --Abschnitte

* Anhang zum Name Argument in der Form .

* Vorargument vor dem Name Argument in der Form

Es ist auch möglich, mehrere Abschnitte durch Anhängen der einzelnen Zeichen
durch Doppelpunkte getrennt. Man kann sich vorstellen, dass dies bedeutet, die Mann Seite Suche nach
nur ein paar Abschnitte. Das Vielfache Abschnitte sind nur möglich für $MANSECT und --Abschnitte.

Wenn nein Abschnitt ist alles angegeben Abschnitte werden nacheinander in der gegebenen
Reihenfolge, beginnend mit Abschnitt 1, bis eine geeignete Datei gefunden wird.

Es gibt 4 Methoden, um eine Erweiterung auf der Kommandozeile. Aber es ist nicht notwendig
Um den vollständigen Erweiterungsnamen anzugeben, reicht in den meisten Fällen eine Abkürzung aus.

* Umgebungsvariable $EXTENSION

* Befehlszeilenoption --Verlängerung

* Anhang zum . Argument in der Form .

* Vorargument vor dem Name Argument in der Form

Für weitere Details zu Mann Seite suchen, sehen Mann(1).

Beispiele of Mann Dateien
/usr/share/man/man1/groff.1
Dies ist eine unkomprimierte Datei für die Mann Seite groff in Abschnitt 1Es kann aufgerufen werden
by
sch# Groffer Groff
Nein Abschnitt ist hier angegeben, also alle Abschnitte gesucht werden sollte, aber als Abschnitt 1
zuerst gesucht wird, wird diese Datei zuerst gefunden. Der Dateiname setzt sich aus den
folgenden Komponenten. / usr / share / man / muss Teil des Mann Weg; das
Unterverzeichnis Mann1/ und das teil .1 stehen für die Abschnitt; groff ist der Name des
Mann Seite.

/usr/local/share/man/man7/groff.7.gz
Der Dateiname setzt sich aus den folgenden Komponenten zusammen. /usr/local/share/man sollen
sei ein teil von Mann Weg; das Unterverzeichnis Mann7/ und das teil .7 stehen für die
Abschnitt; groff ist der Name des Mann Seite; der letzte Teil gz steht für a
Kompression mit gzip(1). Als Abschnitt ist nicht der erste, es muss angegeben werden
Dies kann mit einem der folgenden Befehle erfolgen.
sch# groffer groff.7
sch# groffer 7 groff
sch# groffer --sections=7 groff

/usr/local/man/man1/ctags.1emacs21.bz2
Hier / usr / local / man muss drin sein Mann Weg; das Unterverzeichnis Mann1/ und den Dateinamen
Teil .1 stehen für Abschnitt 1; der Name des Mann Seite is Tags; der Abschnitt hat eine
Erweiterung emacs21; und die Datei wird komprimiert als . Bz2 mit bzip2(1). Die Datei kann
mit einem der folgenden Befehle angezeigt werden
sch# groffer ctags.1e
sch# Groffer 1e Ctags
sch# groffer --extension=e --sections=1 ctags
wobei e als Abkürzung für die Erweiterung emacs21 fungiert.

/usr/man/linux/de/man7/man.7.Z
Das Verzeichnis / usr / man ist jetzt Teil der Mann Weg; dann gibt es ein Unterverzeichnis
für ein die fragst Name linux/; als nächstes kommt ein Unterverzeichnis de / für die deutsche
Sprache; das Abschnitt Namen man7 und .7 sind bisher bekannt; Mann ist der Name des
Mann Seiteeschriebenen Art und Weise; und .Z bezeichnet die Komprimierung, die von gzip(1). Wir wollen
zeigen wir nun, wie man für einige Optionen mehrere Werte angeben kann. Das ist möglich für
Abschnitte und die fragst Namen. Also verwenden wir als Abschnitte 5 und 7 und als fragst
Namen linux und aixDer Befehl lautet dann

sch# groffer --locale=de --sections=5:7 --systems=linux,aix man
sch# LANG=de MANSECT=5:7 SYSTEM=linux,aix groffer man

NULL

Das Programm verfügt über eine Dekomprimierungsfunktion. Wenn die Standardeingabe oder eine abgerufene Datei
aus den Befehlszeilenparametern wird mit einem Format komprimiert, das entweder unterstützt wird von
gzip(1) oder bzip2(1) Es wird im laufenden Betrieb dekomprimiert. Dies beinhaltet die GNU gz, . Bz2 und
das traditionelle .Z Komprimierung. Das Programm zeigt die Verkettung aller
dekomprimierte Eingabe in der Reihenfolge, die in der Befehlszeile angegeben wurde.

Die Groffer Das Programm unterstützt viele Systemvariablen, die meisten davon mit freundlicher Genehmigung anderer
Programme. Alle Umgebungsvariablen von groff(1) und GNU Mann(1) und einige Standardsystem
Variablen werden berücksichtigt.

Ureinwohner Groffer Variablen
$GROFFER_OPT
Speicheroptionen für eine Reihe von Groffer. Die in dieser Variable angegebenen Optionen sind
durch die in der Kommandozeile angegebenen Optionen überschrieben. Der Inhalt dieser Variable
wird durch das Shell-Builtin `eval' ausgeführt; Argumente, die Leerzeichen oder
spezielle Shell-Zeichen sollten in Anführungszeichen gesetzt werden. Vergessen Sie nicht, diese Variable zu exportieren,
andernfalls existiert es während der Laufzeit nicht Groffer.

System Variablen
Die folgenden Variablen haben eine besondere Bedeutung für Groffer.

$ANZEIGE
Wenn diese Variable gesetzt ist, zeigt dies an, dass das X Window-System ausgeführt wird.
Durch das Testen dieser Variable wird entschieden, ob eine grafische oder eine Textausgabe erzeugt wird.
Diese Variable sollte vom Benutzer nicht leichtfertig geändert werden, sie kann jedoch verwendet werden, um
Starten Sie die grafische Groffer auf einem entfernten X Window-Terminal. Beispielsweise, abhängig
auf Ihrem System, Groffer kann auf dem zweiten Monitor mit dem Befehl gestartet werden

sch# DISPLAY=:0.1 groffer was auch immer &

$LC_ALL
$LC_MESSAGES
$LANG Wenn eine dieser Variablen gesetzt ist (in der obigen Reihenfolge), ist ihr Inhalt
interpretiert als das Gebietsschema, die zu verwendende Sprache, insbesondere beim Abrufen
Mann SeitenEin Gebietsschemaname hat typischerweise die Form
Sprache[_Gebiet[.Codesatz[@Modifikator]]], Wo Sprache ist eine ISO 639-Sprache
Code, Gebiet ist ein Ländercode nach ISO 3166 und Codesatz ist ein Zeichensatz oder
Kodierungskennung wie ISO-8859-1 oder UTF-8; siehe setlocale(3). Die Locale-Werte
C und POSIX stehen für den Standard, also die Mann Seite Verzeichnisse ohne Sprache
Präfix. Dies ist das gleiche Verhalten, als wenn alle drei Variablen nicht gesetzt sind.

$PAGER Mit dieser Variable kann der Pager für die TTY-Ausgabe eingestellt werden. Zum Beispiel:
Deaktivieren Sie die Verwendung eines Pagers vollständig. Setzen Sie diese Variable auf Katze(1) Programm

sch# PAGER=Katzengroffer irgendwas

$ PATH Alle Programme innerhalb der Groffer Skripte werden ohne festen Pfad aufgerufen. Dies
Die Umgebungsvariable bestimmt die Menge der Programme, die während der Ausführung von Groffer.

Groff Variablen
Die Groffer Programm ruft intern auf groff, sodass alle Umgebungsvariablen in
groff(1) werden intern verwendet innerhalb Groffer auch. Die folgende Variable hat eine direkte
Bedeutung für die Groffer

$GROFF_TMPDIR
Wenn der Wert dieser Variable ein vorhandenes, beschreibbares Verzeichnis ist, Groffer benutzt es
zum Speichern seiner temporären Dateien, genau wie groff tut. Siehe die groff(1) Handbuchseite für
Weitere Details zum Speicherort temporärer Dateien.

HERREN Variablen
Teile der Funktionalität des Mann Programm wurden implementiert in Groffer; Unterstützung für alle
Umgebungsvariablen dokumentiert in Mann(1) wurde hinzugefügt zu Groffer, aber die Bedeutung war
leicht modifiziert aufgrund des unterschiedlichen Ansatzes in Groffer; aber die Benutzeroberfläche ist die
gleich. Die Mann Umgebungsvariablen können durch Optionen überschrieben werden, die mit $MANOPT,
die wiederum durch die Kommandozeile überschrieben wird.

$EXTENSION
Beschränken Sie die Suche auf Mann Seiten auf Dateien mit dieser Erweiterung. Dies ist
durch Option überschrieben --Verlängerung; Einzelheiten finden Sie dort.

$MANOPT
Diese Variable enthält Optionen als Vorgabe für Mann(1). Da nicht alle davon
relevant für Groffer nur die wesentlichen Teile seines Wertes werden extrahiert. Die
Die in dieser Variable angegebenen Optionen überschreiben die Werte der anderen Umgebung
Variablen, die spezifisch sind für Mann. Alle in dieser Variable angegebenen Optionen sind
durch die in der Befehlszeile angegebenen Optionen überschrieben.

$MANPATH
Wenn diese Variable gesetzt ist, enthält sie die Verzeichnisse, in denen die Mann Seite Bäume sind
gespeichert. Dies wird durch die Option überschrieben --manpath.

$MANSECT
Handelt es sich um eine durch Doppelpunkte getrennte Liste von Abschnittsnamen, wird die Suche nach Mann Seiten is
beschränkt auf die Handbuchabschnitte in dieser Reihenfolge. Dies wird durch die Option
--Abschnitte.

$SYSTEM
Wenn dies auf eine durch Kommas getrennte Liste von Namen eingestellt ist, werden diese interpretiert als Mann Seite
Bäume für verschiedene Betriebssysteme. Diese Variable kann durch die Option überschrieben werden
--Systeme; Einzelheiten finden Sie dort.

Die Umgebungsvariable $MANROFFSEQ wird ignoriert von Groffer denn die notwendigen
Präprozessoren werden automatisch ermittelt.

CONFIGURATION DATEIEN

Die Groffer Das Programm kann durch zwei Konfigurationsdateien vorkonfiguriert werden.

/etc/groff/groffer.conf
Systemweite Konfigurationsdatei für Groffer.

$HOME/.groff/groffer.conf
Benutzerspezifische Konfigurationsdatei für Groffer, Wobei $ HOME bezeichnet das Zuhause des Benutzers
Verzeichnis. Diese Datei wird nach der systemweiten Konfigurationsdatei aufgerufen, um
Überschreiben durch den Benutzer.

Beide Dateien werden für die Konfiguration verwendet, aber die Konfigurationsdatei in / Etc kommt
zuerst; es wird durch die Konfigurationsdatei im Home-Verzeichnis überschrieben; beide
Konfigurationsdateien werden durch die Umgebungsvariable überschrieben $GROFFER_OPT; alles
wird durch die Befehlszeilenargumente überschrieben.

Die Konfigurationsdateien enthalten Optionen, die als Standard für jeden aufgerufen werden sollten Groffer
run. Diese Optionen werden in Zeilen geschrieben, sodass jede Zeile entweder eine lange Option, eine
Kurzoption oder ein Kurzoptionscluster; jeweils mit oder ohne Argument. Jede Zeile
mit Konfigurationsinformationen beginnt mit einem Minuszeichen `-'; eine Zeile mit einem langen
Option beginnt mit zwei Minuszeichen `--', eine Zeile mit einer Kurzoption oder Kurzoption
Cluster beginnt mit einem einzelnen Minuszeichen `-'.

Die Optionsnamen in den Konfigurationsdateien dürfen nicht abgekürzt werden, sie müssen exakt sein.

Das Argument für eine lange Option kann vom Optionsnamen entweder durch ein Gleichheitszeichen getrennt werden
Zeichen `=' oder durch Leerzeichen, also ein oder mehrere Leerzeichen oder Tabulatorzeichen. Ein Argument für eine
Kurzoption oder Kurzoptionscluster können direkt an den Optionsnamen angehängt werden oder
durch Leerzeichen getrennt. Das Ende eines Arguments ist das Ende der Zeile. Es ist nicht
darf eine Shell-Umgebungsvariable in einem Optionsnamen oder Argument verwenden.

Es ist nicht notwendig, Anführungszeichen in einer Option oder einem Argument zu verwenden, außer bei leeren Argumenten.
Ein leeres Argument kann bereitgestellt werden, indem man ein Paar Anführungszeichen an das trennende Gleichheitszeichen anhängt.
Zeichen oder Leerzeichen; bei einer kurzen Option kann das Trennzeichen auch weggelassen werden. Bei einer langen
Option mit einem trennenden Gleichheitszeichen `=', kann das Anführungszeichenpaar weggelassen werden, wodurch
die Zeile mit dem trennenden Gleichheitszeichen. Alle anderen Anführungszeichen werden gelöscht
im Inneren.

In den Konfigurationsdateien sind beliebige Leerzeichen am Anfang jeder Zeile zulässig.
es wird einfach ignoriert. Jedes Leerzeichen innerhalb einer Zeile wird durch ein einzelnes Leerzeichen ersetzt
` ' intern.

Alle Zeilen der Konfigurationszeilen, die nicht mit einem Minuszeichen beginnen, werden ignoriert,
sodass Kommentare, die mit ` beginnen#' sind möglich. Es gibt also keine Shell-Befehle in der
Konfigurationsdateien.

Als Beispiel betrachten Sie die folgende Konfigurationsdatei, die entweder in
/etc/groff/groffer.conf or ~/.groff/groffer.conf .

# Groffer-Konfigurationsdatei
#
# Groffer-Optionen, die bei jedem Aufruf von Groffer verwendet werden
--foreground=Dunkelblau
--resolution=100
--viewer=gxditview -geometry 900x1200
--viewer xpdf -Z 150

Die Zeilen beginnend mit # werden einfach ignoriert, sie fungieren also als Befehlszeilen. Dies
Konfiguration setzt vier Groffer Optionen (die Zeilen, die mit `-'). Dies hat die
folgende Effekte:

* Verwenden Sie eine Textfarbe von Dunkelblau in allen Viewern, die dies unterstützen, wie z. B. gxditview.

* Verwenden Sie eine Auflösung von 100dpi in allen Viewern, die dies unterstützen, wie z. B. gxditview. Durch
Dies ist das Standardgerät in x Modus eingestellt ist X100.

* Gewalt gxditview(1) als x-Modus Viewer mit der Geometrieoption zum Einstellen der Breite
zu 900px und die Höhe bis 1200px. Diese Geometrie eignet sich für eine Auflösung von
100dpi.

* Verwenden xpdf(1) als pdf-Modus Zuschauer mit dem Argument -Z 150.

Beispiele:

Die Verwendung von Groffer ist sehr einfach. Normalerweise wird es nur mit einem Dateinamen aufgerufen oder
Mann Seite. Die folgenden Beispiele zeigen jedoch, dass Groffer hat viel mehr Phantasie
Funktionen.

sch# groffer /usr/local/share/doc/groff/meintro.ms.gz

Dekomprimieren, formatieren und anzeigen der komprimierten Datei meintro.ms.gz im Verzeichnis
/usr/local/share/doc/groff, mit dem Standard-Viewer gxditview als grafischer Viewer, wenn
im X Window oder die weniger(1) Pager-Programm, wenn nicht im X Window.

sch# Groffer Groff

Wenn die Datei ./groff existiert, verwenden Sie es als Eingabe. Andernfalls interpretieren Sie das Argument als Suche
für die Mann Seite namens groff in der kleinstmöglichen Mann Abschnitt, wobei Abschnitt 1 in diesem
Fall.

sch# groffer man:groff

Suche nach dem Mann Seite of groff selbst wenn die Datei ./groff besteht.

sch# groffer groff.7
sch# groffer 7 groff

Suche das Mann Seite of groff in Mann Abschnitt 7. Diese Abschnittssuche funktioniert nur für eine Ziffer
oder ein einzelnes Zeichen aus einem kleinen Satz.

sch# groffer fb.modes

Wenn die Datei ./fb.modes existiert nicht interpretieren dies als eine Suche nach der Mann Seite of
fb.modes. Als Erweiterung Modi ist kein einziges Zeichen im klassischen Abschnittsstil, das
Argument wird nicht in eine Suche nach fb.

sch# groffer groff 'troff(1)' man:roff

Die Argumente, die keine vorhandenen Dateien sind, werden wie folgt gesucht Mann Seiten: groff
(automatische Suche, sollte gefunden werden in Mann Abschnitt 1), troff (in Abschnitt 1) ​​und ab (in
der Abschnitt mit der niedrigsten Nummer, in diesem Fall 7). Die Anführungszeichen um 'troff(1)'
sind notwendig, da die Klammern spezielle Shell-Zeichen sind; sie mit einem Escapezeichen zu versehen
Backslash-Zeichen \( und \) wäre auch möglich. Die formatierten Dateien sind
aneinandergereiht und in einem Stück angezeigt.

sch# LANG=de groffer --man --viewer=galeon ls

Holen Sie sich die deutsche Mann Seite (Sprache de) für die ls Programm, dekomprimieren Sie es, formatieren Sie es
html Format (www Modus) und sehen Sie sich das Ergebnis im Webbrowser an Galeonen. Die Option --Mann
garantiert, dass die Mann Seite abgerufen wird, auch wenn eine lokale Datei ls existiert in der tatsächlichen
Verzeichnis.

sch# groffer --source 'man:ab(7)'

Erleben Sie das Einfache. Mann Seite namens ab in Mann Abschnitt 7, dekomprimieren Sie es und drucken Sie es unformatiert
Inhalt, sein Quellcode.

sch# groffer --de-p --in --ap

Dies ist eine Reihe von verkürzten Argumenten, die bestimmt werden als

sch# groffer --debug-params --intermediate-output --apropos

sch# cat-Datei.gz | groffer -Z -mfoo

Die Datei Datei.gz wird an die Standardeingabe gesendet, dies wird dekomprimiert und dann wird dies
transportiert zum groff Zwischen- Möglichkeiten für das Ausgangssignal: Modus ohne Nachbearbeitung (groff ganz ohne irgendetwas tun oder drücken zu müssen.
-Z), mithilfe des Makropakets foo (groff ganz ohne irgendetwas tun oder drücken zu müssen. -m).

sch# echo '\f[CB]WOW!' |
> groffer --x --bg rot --fg gelb --geometry 200x100 -

Zeigen Sie das Wort WOW! in einem kleinen Fenster in Fettschrift mit konstanter Breite, mit der Farbe Gelb auf
roter Hintergrund.

KOMPATIBILITÄT

Die Groffer Das Programm ist in Perl geschrieben, die Perl-Version zum Zeitpunkt des Schreibens war v5.8.8.

Groffer bietet einen eigenen Parser für Kommandozeilenargumente, der kompatibel ist zu beiden
POSIX Getopte(1) und GNU getopt(1). Es kann Optionsargumente und Dateinamen verarbeiten
mit Leerzeichen und einer großen Anzahl von Sonderzeichen. Der folgende Standard
Es werden verschiedene Optionstypen unterstützt.

* Die Option besteht aus einem einzelnen Minus - bezieht sich auf die Standardeingabe.

* Ein einzelnes Minus gefolgt von Zeichen bezieht sich auf eine einzelne Zeichenoption oder eine
Kombination davon; zum Beispiel die Groffer Short-Optionskombination -Qmfoo is
entspricht -Q -m foo.

* Lange Optionen sind Optionen mit Namen, die länger als ein Zeichen sind; ihnen wird immer vorangestellt
durch ein doppeltes Minus. Ein Optionsargument kann entweder zum nächsten Kommandozeilenargument
oder mit einem Gleichheitszeichen an das Argument angehängt werden; zum Beispiel, --long=Argument ist gleichwertig
zu --lang arg.

* Ein Argument von -- beendet die Optionsanalyse; alle weiteren Kommandozeilenargumente sind
Interpretiert als Dateispezifikation Parameter, also Dateinamen oder Konstrukte für die Suche
Mann Seiten).

* Alle Kommandozeilenargumente, die weder Optionen noch Optionsargumente sind, werden interpretiert
as Dateispezifikation Parameter und gespeichert, bis die Optionenanalyse abgeschlossen ist. Zum Beispiel die
Befehlszeile

sch# groffer Datei1 -a -o arg Datei2

entspricht

sch# groffer -a -o arg -- Datei1 Datei2

Die freie Mischung von Optionen und Dateispezifikation Parameter folgt dem GNU-Prinzip. Das bedeutet
erfüllt nicht das seltsame Optionsverhalten von POSIX, das die Optionsverarbeitung beendet, sobald
das erste Nicht-Optionsargument erreicht wurde. Das Ende der Optionsverarbeitung kann
erzwungen durch die Option `--' Trotzdem.

Verwenden Sie groffer online mit den Diensten von onworks.net