Dear Tatsuya,

attached to this mail, You get a slightly modified w3m manual page
file and the respective german version. Differences with comments below.

Best regards
Markus

-----------------------------------------------------------------------------

diff -w 0.5.3-29/doc/w3m.1 0.5.3-27_mh/doc/w3m.1
3c3
< .TH W3M 1 "2016-04-02" "w3m 0.5.3"
---
> .TH W3M 1 "2016-08-06" "w3m 0.5.3"
48c48
#colons not necessary at the end of a heading
< .SS General options:
---
> .SS General options
81c81
< toggle wrapping in searches
---
> toggle wrapping mode in searches
88c88
< .SS Browser options:
---
> .SS Browser options
120c120
< .SS Text pager options:
---
> .SS Text pager options
136c136
< .SS Data type/encoding options:
---
> .SS Data type/encoding options
146c146
< .SS Options for data output, followed by immediate exit:
---
> .SS Options for data output, followed by immediate exit
168c168
# configuration is the correct English word
< show all available config options
---
> show all available configuration options
172c172
< .SS Options for overriding default settings and resources:
---
> .SS Options for overriding default settings and resources
178c178
# configuration is the correct English word
< use \fIfile\fR instead of the default config file
---
> use \fIfile\fR instead of the default configuration file
184c184
# mark-up of an option string
< modify one configuration item with an explicitly given value; without 
\fIoption=value\fR, equivalent to -show-option
---
> modify one configuration item with an explicitly given value; without 
> \fIoption=value\fR, equivalent to \fB-show-option\fR
.nr N -1
.nr D 5
.TH W3M 1 "2016-08-06" "w3m 0.5.3"
.SH NAME
w3m \- a text based web browser and pager
.SH SYNOPSIS
w3m [OPTION]... [ \fIfile\fP | \fIURL\fP ]...
.SH DESCRIPTION
.\" This defines appropriate quote strings for nroff and troff
.ds lq \&"
.ds rq \&"
.if t .ds lq ``
.if t .ds rq ''
.\" Just in case these number registers aren't set yet...
.if \nN==0 .nr N 10
.if \nD==0 .nr D 5

\fIw3m\fP is a text based browser which can display local or remote
web pages as well as other documents. It is able to process HTML
tables and frames but it ignores JavaScript and Cascading Style
Sheets. \fIw3m\fP can also serve as a pager for text files named as
arguments or passed on standard input, and as a general purpose
directory browser.

\fIw3m\fP organizes its content in buffers or tabs, allowing easy
navigation between them. With the w3m-img extension installed, \fIw3m\fP can
display inline graphics in web pages. And whenever \fIw3m\fP's HTML
rendering capabilities do not meet your needs, the target URL can be
handed over to a graphical browser with a single command.

For help with runtime options, press \(lqH\(rq while running \fIw3m\fP. 

.SH ARGUMENTS

When given one or more command line arguments, \fIw3m\fP will handle
targets according to content type. For web, \fIw3m\fP gets this
information from HTTP headers; for relative or absolute file system
paths, it relies on filenames.

With no argument, \fIw3m\fP expects data from standard input and
assumes \(lqtext/plain\(rq unless another MIME type is given by the user.

If provided with no target and no fallback target (see for instance
option \fB\-v\fP below), \fIw3m\fP will exit with usage information.
.SH OPTIONS
Command line options are introduced with a single \(lq\-\(rq character and
may take an argument.
.SS General options
.TP
\fB\-B\fP
with no other target defined, use the bookmark page for startup
.TP
\fB\-M\fP
monochrome display
.TP
\fB\-no-mouse\fP
deactivate mouse support
.TP
\fB\-num\fP
display each line's number
.TP
\fB\-N\fP
distribute multiple command line arguments to tabs. By default, a
stack of buffers is used
.TP 
\fB\-ppc \fInum\fR
width of \fInum\fR pixels per character. Range of 4.0 to 32.0, default 8.0.
Larger values will make tables narrower. (Implementation not verified)
.TP
\fB\-ppl \fInum\fR
height of \fInum\fR pixels per line. Range of 4.0 to 64.0. (Implementation not 
verified)
.TP
\fB\-title\fP, \fB\-title=TERM\fP
use the buffer name as terminal title string. With specified TERM,
this sets the title configuration style accordingly
.TP
\fB\-v\fP
with no other target defined, welcome users with a built-in page
.TP
\fB\-W\fP
toggle wrapping mode in searches
.TP
\fB\-X\fP
do not initialize/deinitialize the terminal
.TP
\fB+\fInum\fR
go to line \fInum\fR; only effective for \fInum\fR larger than the number of 
lines in the terminal
.SS Browser options
.TP
\fB\-cols \fInum\fR
with stdout as destination; HTML is rendered to lines of \fInum\fR characters
.TP
\fB\-cookie\fP, \fB\-no-cookie\fP
use stored cookies and accept new ones, or do neither
.TP
\fB\-F\fP
render frames
.TP
\fB\-graph\fP, \fB\-no-graph\fP
use or do not use graphic characters for drawing HTML table and frame borders
.TP
\fB\-header \fIstring\fR
append \fIstring\fR to the HTTP(S) request. Expected to match the header syntax 
\f(CWVariable: Value\fP
.TP
\fB\-m\fP
Render the body of Usenet messages according to the header \(lqContent-type\(rq 
.TP
\fB\-no-proxy\fP
do not use proxy
.TP
\fB\-post \fIfile\fR
use POST method to upload data defined in \fIfile\fR. The syntax to be used
is \f(CWvar1=value1[&var2=value2]...\fP
.TP
\fB\-4\fP
IPv4 only. Corresponds to dns_order=4 in configuration files
.TP
\fB\-6\fP
IPv6 only. Corresponds to dns_order=6 in configuration files
.SS Text pager options
.TP
\fB\-l \fInum\fR
number of lines preserved internally when receiving plain text from
stdin (default 10,000)
.TP
\fB\-r\fP
use caret notation to display special escape characters (such
as ANSI escapes or nroff-style backspaces for bold and underlined
characters) instead of processing them
.TP
\fB\-s\fP
squeeze multiple blank lines into one
.TP
\fB\-t\fP \fInum\fP
set tab width to \fInum\fR columns. No effect on stdout
.SS Data type/encoding options
.TP
\fB\-I \fIcharset\fR
user defined character encoding of input data
.TP
\fB\-O \fIcharset\fR
user defined character encoding of output data
.TP
\fB\-T \fItype\fR
explicit characterization of input data by MIME type
.SS Options for data output, followed by immediate exit
.TP
\fB\-dump\fP
dump rendered page into stdout. Set implicitly when output is directed
to a file or pipe
.TP
\fB\-dump_source\fP
dump the page's source code into stdout
.TP
\fB\-dump_head\fP
dump response of a HEAD request for a URL into stdout
.TP
\fB\-dump_both\fP
dump HEAD, and source code for a URL into stdout
.TP
\fB\-dump_extra\fP
dump HEAD, source code, and extra information for a URL into stdout
.TP
\fB\-help\fP
show a summary of compiled-in features and command line options
.TP
\fB\-show-option\fP
show all available configuration options
.TP
\fB\-version\fP
show the version of \fIw3m\fP
.SS Options for overriding default settings and resources
.TP
\fB\-bookmark \fIfile\fR
use \fIfile\fR instead of the default bookmark.html file
.TP
\fB\-config \fIfile\fR
use \fIfile\fR instead of the default configuration file
.TP
\fB\-debug\fP
DO NOT USE
.TP
\fB\-o \fIoption=value\fR
modify one configuration item with an explicitly given value; without 
\fIoption=value\fR, equivalent to \fB-show-option\fR
.TP
\fB\-reqlog\fP
log headers of HTTP communication in file \f(CW~/.w3m/request.log\fP
.SH EXAMPLES
.SS Pager-like usage 
.TP
Combine snippets of HTML code and preview the page 
.EX
$ cat header.html footer.html | w3m -T text/html
.EE
.TP
Compare two files using tabs 
.EX
$ w3m -N config.old config
.EE
.SS Browser-like usage 
.TP
Display web content in monochrome terminal
.EX
$ w3m -M http://w3m.sourceforge.net
.EE
.TP
Display embedded graphics
.EX
$ w3m -o auto_image=TRUE http://w3m.sourceforge.net
.EE
.TP
Display content from Usenet
.EX
$ w3m -m nntp://news.aioe.org/comp.os.linux.networking
.EE
.TP
Upload data for a URL using the POST method 
.EX
$ w3m -post - http://example.com/form.php <<<'a=0&b=1'
.EE
.SS Filter-like usage
.TP
Convert an HTML file to plain text with a defined line length
.EX
$ w3m -cols 40 foo.html > foo.txt
.EE
.TP
Output the bookmarks page as text with an appended list of links
.EX
$ w3m -B -o display_link_number=1 > out.txt
.EE
.TP
Conversion of file format and character encoding
.EX
$ w3m -T text/html -I EUC-JP -O UTF-8 < foo.html > foo.txt
.EE
.SS Start with no input
.TP
Welcome users with a built-in page
.EX
$ w3m -v
.EE
.\".SH Errors
.SH ENVIRONMENT
\fIw3m\fP recognises the environment variable WWW_HOME as defining a
fallback target for use if it is invoked without one.
.SH FILES
.TP
\f(CW~/.w3m/bookmark.html\fP
default bookmark file 
.TP
\f(CW~/.w3m/config\fP
user defined configuration file; overrides \f(CW/etc/w3m/config\fP
.TP
\f(CW~/.w3m/cookie\fP
cookie jar; written on exit, read on launch   
.TP
\f(CW~/.w3m/history\fP
browser history - visited files and URLs
.TP
\f(CW~/.w3m/keymap\fP
user defined key bindings; overrides default key bindings
.TP
\f(CW~/.w3m/mailcap\fP
external viewer configuration file
.TP
\f(CW~/.w3m/menu\fP
user defined menu; overrides default menu
.TP
\f(CW~/.w3m/mime.types\fP
MIME types file
.TP
\f(CW~/.w3m/mouse\fP
user defined mouse settings
.TP
\f(CW~/.w3m/passwd\fP
password and username file
.TP
\f(CW~/.w3m/pre_form\fP
contains predefined values to fill recurrent HTML forms
.\" .TP
.\" .I $~/.w3m/urimethodmap
.\" ???
.SH SEE ALSO
README and example files are to be found in the doc directory of your \fIw3m\fP 
installation. Recent information about \fIw3m\fP may be found on 
.UR http://w3m.sourceforge.net
the project's web pages at
.UE
.SH ACKNOWLEDGMENTS
\fIw3m\fP has incorporated code from several sources.
Users have contributed patches and suggestions over time.
.SH AUTHOR
.UR [email protected]
Akinori ITO
.UE

.nr N -1
.nr D 5
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH W3M 1 2016\-08\-06 "w3m 0.5.3" 
.SH NAME
w3m \- Ein auf Texte ausgerichtetes Programme zur Anzeige von Dateien und
Datenströmen sowie zum Browsen im Internet
.SH SYNOPSIS
w3m [OPTION]... [ \fIDatei\fP | \fIURL\fP ]...
.SH BESCHREIBUNG
.\" This defines appropriate quote strings for nroff and troff
.ds lq "
.ds rq "
.if  t .ds lq ``
.if  t .ds rq ''
.if  \nN==0 .nr N 10
.\" Just in case these number registers aren't set yet...
.if  \nD==0 .nr D 5

\fIw3m\fP ist ein textorientierter Browser, der lokale oder im Internet
liegende Seiten sowie andere Dokumente anzeigen kann. Er verarbeitet
HTML\-Tabellen und Frames, nicht jedoch JavaScript und Cascading Style
Sheets. \fIw3m\fP kann auch als Textbetrachter (Pager) dienen. Entsprechende
Dateien werden beim Aufruf als Argument angegeben oder an der
Standardeingabe als Datenstrom übernommen. Mit \fIw3m\fP kann sich der Benutzer
überdies durch Verzeichnisbäume bewegen.

\fIw3m\fP arbeitet mit Reitern (Registerkarten, Tabs) und Puffern, was einen
einfachen Wechsel zwischen geladenen Inhalten erlaubt. Wenn die Erweiterung
w3m\-img installiert ist, zeigt \fIw3m\fP auch in die Seiten eingebundene
Grafiken an. Wann immer die Umsetzung von HTML\-Inhalten durch \fIw3m\fP Ihren
Ansprüchen nicht genügt, reicht ein einzelnes Kommando, um die Ziel\-URL
einem grafischen Browser zu übergeben.

Um nach Start des Programms Hilfe zu den Optionen zu erhalten, drücken Sie
\(lqH\(rq.

.SH ARGUMENTE

Wenn das Programm mit einem oder mehreren Argumenten aufgerufen wird,
behandelt \fIw3m\fP diese Ziele je nach Typ des Inhalts. Bei Daten aus dem
Internet verwertet \fIw3m\fP die Angabe in den HTTP\-Kopfzeilen. Bei relativen
oder absoluten Pfaden in Dateisystemen richtet sich \fIw3m\fP nach dem
Dateinamen.

Ohne Argument aufgerufen, erwartet \fIw3m\fP unformatierte Daten aus der
Standardeingabe, es sei denn, der Benutzer hat einen anderen MIME\-Typ
angegeben.

Sollte \fIw3m\fP weder ein Zielobjekt vorliegen noch ein Ausweichen vorgesehen
sein (beispielsweise durch die Option \fB\-v\fP, siehe unten), gibt das Programm
nur Benutzungshinweise aus.
.SH OPTIONEN
Vor Befehlszeilen\-Optionen steht das \(lq\-\(rq Zeichen einzeln, ihnen kann
ein Argument folgen.
.SS "Allgemeine Optionen"
.TP 
\fB\-B\fP
starte mit einer Ansicht aller Lesezeichen (wenn kein anderes Zielobjekt
angegeben ist)
.TP 
\fB\-M\fP
monochrome Anzeige
.TP 
\fB\-no\-mouse\fP
Mausfunktion aus
.TP 
\fB\-num\fP
zeige Zeilennummern an
.TP 
\fB\-N\fP
verteile die übergebenen Argumente unter Reitern. Standardmäßig würde ein
Stapel von Puffern benutzt
.TP  
\fB\-ppc \fP\fInum\fP
Weite von \fInum\fP Bildpunkten pro Zeichen, einstellbar von 4.0 bis 32.0,
standardmäßig 8.0. Größere Werte machen Tabellen enger. (Implementierung
unklar)
.TP 
\fB\-ppl \fP\fInum\fP
Höhe von \fInum\fP Bildpunkten pro Linie, einstellbar von 4.0 bis
64.0. (Implementierung unklar)
.TP 
\fB\-title\fP, \fB\-title=TERM\fP
verwende den Puffernamen auch als Titel des Terminalfensters. Soweit TERM
eingegeben wurde, konfiguriert dieser Wert den Stil des Titels
.TP 
\fB\-v\fP
begrüße den Benutzer mit einer eingebauten Seite (wenn kein anderes
Zielobjekt angegeben ist)
.TP 
\fB\-W\fP
wechsle zwischen umlaufendem und nicht umlaufendem Suchen
.TP 
\fB\-X\fP
initialisiere nach Verlassen des Programms das Terminal nicht neu
.TP 
\fB+\fP\fIZahl\fP
gehe zu Zeile \fIZahl\fP; wirkt nur, wenn \fIZahl\fP größer ist als die im
Terminal verfügbare Zeilenzahl
.SS Browser\-Optionen
.TP 
\fB\-cols \fP\fInum\fP
bei für die Standardausgabe bestimmten Inhalten, nimm bei der Umsetzung von
HTML eine Länge von \fInum\fP Zeichen pro Zeile
.TP 
\fB\-cookie\fP, \fB\-no\-cookie\fP
verwende gespeicherte Cookies und akzeptiere neue. Oder tue weder das eine
noch das andere
.TP 
\fB\-F\fP
verarbeite Frames
.TP 
\fB\-graph\fP, \fB\-no\-graph\fP
bei der Umsetzung von Tabellen und Frames grafische Zeichen verwenden oder
nicht verwenden
.TP 
\fB\-header \fP\fIZeichenkette\fP
füge \fIZeichenkette\fP der HTTP(S)\-Anfrage an. Diese muss der 
Kopfdaten\-Syntax
\f(CWVariable: Wert\fP entsprechen
.TP 
\fB\-m\fP
stelle eine Usenet\-Nachricht entsprechend \(lqContent\-type\(rq in den
Kopfdaten dar
.TP 
\fB\-no\-proxy\fP
verwende keinen Proxy
.TP 
\fB\-post \fP\fIDatei\fP
verwende die Methode POST, um in \fIDatei\fP hinterlegte Daten
hochzuladen. Hierbei wird die Syntax \f(CWvar1=wert1[&var2=wert2]…\fP erwartet
.TP 
\fB\-4\fP
nur IPv4. Entspricht dns_order=4 in der Konfigurationsdatei
.TP 
\fB\-6\fP
nur IPv6. Entspricht dns_order=6 in der Konfigurationsdatei
.SS Textbetrachter\-Optionen
.TP 
\fB\-l \fP\fInum\fP
Anzahl der Zeilen, die zwischengespeichert werden, wenn Text per
Standardeingabe übergeben wurde. (Voreinstellung ist 10000)
.TP 
\fB\-r\fP
verarbeite spezielle Escape\-Zeichen (beispielsweise ANSI\-Escape\-Zeichen oder
nroff\-Rückwärtsschritte für fette und unterstrichene Zeichen) nicht, sondern
zeige sie stattdessen mittels Caret\-Notation.
.TP 
\fB\-s\fP
mehrere leere Zeilen werden bis auf eine gelöscht
.TP 
\fB\-t\fP \fInum\fP
berücksichtige Tab\-Zeichen so, dass Spalten mit einer Weite von \fInum\fP
Zeichen entstehen
.SS "Datenart\- und Datenkodierungs\-Optionen"
.TP 
\fB\-I \fP\fIcharset\fP
zu benutzende Zeichenkodierung für erhaltene Daten
.TP 
\fB\-O \fP\fIcharset\fP
zu benutzende Zeichenkodierung für auszugebende Daten
.TP 
\fB\-T \fP\fITyp\fP
zu benutzender MIME\-Typ für erhaltenen Daten
.SS "Optionen zur Datenausgabe, mit sofortigem Verlassen des Programms"
.TP 
\fB\-dump\fP
leite die verarbeitete Seite der Standardausgabe zu. Die Option gilt als
gesetzt, wenn der Aufruf beinhaltet, dass die Ausgabe in eine Datei
umgeleitet oder einem weiteren Programm übergeben wird.
.TP 
\fB\-dump_source\fP
leite den Seitenquelltext der Standardausgabe zu
.TP 
\fB\-dump_head\fP
leite die Antwort einer HEAD\-Anfrage für eine URL der Standardausgabe zu
.TP 
\fB\-dump_both\fP
leite Antwort auf HEAD\-Anfrage und Seitenquelltext der Standardausgabe zu
.TP 
\fB\-dump_extra\fP
leite Antwort auf HEAD\-Anfrage, Seitenquelltext und Extrainformation der
Standardausgabe zu
.TP 
\fB\-help\fP
zeige eine Zusammenfassung verfügbarer Funktionen und Befehlszeilen\-Optionen
.TP 
\fB\-show\-option\fP
zeige alle zur Konfiguration verfügbaren Optionen
.TP 
\fB\-version\fP
gibt die Version von \fIw3m\fP aus
.SS "Optionen, die Standards für Einstellungen und Datenquellen außer Kraft 
setzen"
.TP 
\fB\-bookmark \fP\fIDatei\fP
benutze anstelle der Standarddatei bookmark.html für Lesezeichen die Datei
\fIDatei\fP
.TP 
\fB\-config \fP\fIDatei\fP
benutze \fIDatei\fP anstelle der Standardkonfigurationsdatei
.TP 
\fB\-debug\fP
BITTE NICHT BENUTZEN
.TP 
\fB\-o \fP\fIOption=Wert\fP
arbeite mit einer Konfiguration, bei der die Einstellung \fIOption\fP mit
\fIWert\fP belegt ist. Ohne \fIOption=Wert\fP gleichwertig mit 
\fB\-show\-option\fP
.TP 
\fB\-reqlog\fP
Protokolliere Header der HTTP\-Kommunikation in Datei \f(CW~/.w3m/request.log\fP
.SH BEISPIELE   
.SS "Verwendung als Textbetrachter"
.TP 
zwei HTML\-Fragmente zusammengefügt anzeigen
.EX
$ cat header.html footer.html | w3m \-T text/html
.EE
.TP 
zwei Dateien unter Reitern einander gegenüberstellen
.EX
$ w3m \-N config.old config
.EE
.SS "browser\-artige Verwendung"
.TP 
zeige Internet\-Inhalt in monochromem Terminal
.EX
$ w3m \-M http://w3m.sourceforge.net
.EE
.TP 
zeige eingebettete Grafiken an
.EX
$ w3m \-o auto_image=TRUE http://w3m.sourceforge.net
.EE
.TP 
zeige Inhalt aus dem Usenet
.EX
$ w3m \-m nntp://news.aioe.org/comp.os.linux.networking
.EE
.TP 
mit der POST\-Methode Daten für eine URL hochladen 
.EX
$ w3m \-post \- http://example.com/form.php <<<'a=0&b=1'
.EE
.SS "filterartige Verwendung"
.TP 
konvertiere eine HTML\-Datei in reinen Text von bestimmter Zeilenlänge
.EX
$ w3m \-cols 40 foo.html > foo.txt
.EE
.TP 
übergib den Bestand an Lesezeichen mit zugehörigen Links als reinen Text 
einer Datei.
.EX
$ w3m \-B \-o display_link_number=1 > out.txt
.EE
.TP 
Konvertierung in ein anderes Dateiformat und eine andere Zeichenkodierung
.EX
$ w3m \-T text/html \-I EUC\-JP \-O UTF\-8 < foo.html > foo.txt
.EE
.SS "starte ohne Eingabedaten"
.TP 
begrüße den Benutzer mit einer eingebauten Seite
.EX
$ w3m \-v
.EE
.\".SH Errors
.SH UMGEBUNGSVARIABLEN
\fIw3m\fP weicht auf den Wert der Umgebungsvariablen WWW_HOME aus, wenn das
Programm ohne Zielobjekt aufgerufen wurde.
.SH DATEIEN
.TP 
\f(CW~/.w3m/bookmark.html\fP
voreingestellte Datei für Lesezeichen
.TP 
\f(CW~/.w3m/config\fP
benutzerdefinierte Konfigurationsdatei; gegenüber \f(CW/etc/w3m/config\fP
vorrangig
.TP 
\f(CW~/.w3m/cookie\fP
Ablageort für Cookies; wird beim Verlassen des Programms geschrieben und
beim Aufruf gelesen
.TP 
\f(CW~/.w3m/history\fP
Chronik besuchter Seiten und URLs
.TP 
\f(CW~/.w3m/keymap\fP
benutzerdefinierte Tastaturbelegung, setzt standardmäßige Belegung außer
Kraft
.TP 
\f(CW~/.w3m/mailcap\fP
Konfigurationsdatei für Programme zur externen Anzeige
.TP 
\f(CW~/.w3m/menu\fP
benutzerdefiniertes Menü; vorrangig gegenüber Standardmenü
.TP 
\f(CW~/.w3m/mime.types\fP
Datei mit MIME\-Typen
.TP 
\f(CW~/.w3m/mouse\fP
benutzerdefinierte Mauseinstellungen
.TP 
\f(CW~/.w3m/passwd\fP
Datei mit Nutzerkonto\-Passwort\-Liste
.TP 
\f(CW~/.w3m/pre_form\fP
.\" .TP
.\" .I $~/.w3m/urimethodmap
.\" ???
enthält vordefinierte Werte für wiederkehrende HTML\-Formulare
.SH "SIEHE AUCH"
README und Beispieldateien finden Sie im Dokumentationsverzeichnis Ihrer
\fIw3m\fP\-Installation. Aktuelle Informationen zu \fIw3m\fP finden Sie auf der
Projektseite
.UR http://w3m.sourceforge.net
unter
.UE
.SH DANKSAGUNGEN
In \fIw3m\fP ist Programmcode verschiedener Quellen eingeflossen. Benutzer
haben mit Korrekturen (Patch\-Dateien) und Vorschlägen zur Verbesserung des
Programms beigetragen.
.SH AUTOR
.UR [email protected]
Akinori ITO
.UE
Die deutsche Übersetzung wurde 2016 von
.UR [email protected]
Markus Hiereth
.UE
erstellt.

Reply via email to