retawq Documentation
Command-Line Options
- --colors=off: don't use colors; if you never want to use
colors, you can set this more easily (permanently) with the run-time configuration option "colors"
- --colors=reverse: use black-on-white colors; if you always
want to use colors this way, you can set this more easily (permanently) with
the run-time configuration option "colors"
- --console: enter console runmode which
provides a functionality similar to that of the usual, old, shell-like FTP
clients; cf. Custom Connections
- --download=URL: download the content from the given URL, write it to standard output as it is received and
quit when done. (Technobabble: this option causes the program to enter the
download runmode.) Cf. the keyboard command "ctrl-d" for more information. Redirection
of the output to a file or to another program and errors are handled as
described for the "--dump" option below.
- --dump=URL: receive the document from the given URL completely, then "dump" it to standard output
(layouted) and quit. (Technobabble: this option causes the program to enter the
dump runmode.) Cf. the keyboard
command "d". To store the output in a file, apply the shell redirection
operator ">" as usual, e.g. "retawq --dump=about:retawq >ABOUT". To
redirect the output to another program, apply the shell pipeline operator "|"
as usual, e.g. "retawq --dump=about:retawq | wc --lines". If an error occurs, a
"fatal error" message is printed to standard error (so it's redirectable with
the shell operator "2>"), and the program exits with a non-zero exitcode. -
More detailed control over the output formatting will be possible in a later
version with a "dumpstyle" option.
- --help, -h: print a help text and quit
- --resume-session: resume a session from
the default session file (usually something like
"/home/your_home/.retawq/session") in curses-like runmode
- --resume-session=filename: resume a session from the given file in curses-like runmode
- --rtcfg=letters: which run-time
configuration shall actually be used; the letter "b" stands for "built-in"
(cf. the compile-time configuration option
OPTION_BIRTCFG), the letter "e" for "external file"; you can also combine both
letters or leave them out completely; by default, all "existing" run-time
configurations are used.
- --userdir=path: the path to a retawq user directory which
usually contains at least a run-time configuration
file; cf. the section "User Directory" in the user
guide. By default, the user directory is something like
"/home/your_home/.retawq/", depending on the environment variable
"HOME"; this option allows you to use several profiles easily.
- --version, -v: print a short version information and
quit
You can also specify the URLs of one or two
documents which are then shown (in curses-like runmode).
This documentation file is part of version 0.2.6b of retawq, a network client created by
Arne Thomaßen. retawq is basically released under
certain versions of the GNU General Public License and WITHOUT ANY WARRANTY.
Copyright (C) 2001-2005 Arne Thomaßen.