Being a computer geek, I tend to like things organized
in tables so options stand out. I took the time to rewrite
the text for the "--progress" section of the manpage, as
it was always difficult for me to find the values and
differences for the different subtags. Looking at the
"--progress=type", it doesn't quickly stand out what the
possible values are nor that there are ". I tended more
toward a BNF type specification, but the central change is
making the style types stand out. So even if you don't
like the exact wording, I do think the table format presents
the style options more clearly (i.e. they stand out quickly
note, output of man was used as template for the changes, so
this isn't directly applicable as a patch. I hope that isn't
a block to the change, as it seems simple enough but I don't
currently have a subversion source tree setup nor do I know
manpage source syntax by memory (not a frequently used source
language ;^) ):
--progress=<style>
Legal styles are "bar[:force]" and "dot[:<dotsize>]".
The "bar" style is used by default. It draws an
ASCII progress bar graphics (a.k.a "thermometer"
display) indicating the status of retrieval. If the
output is not a TTY, the "dot" style will be used.
To force "bar" usage when output is not a TTY, use
the ":force" tag (i.e. --progress=bar:force )
The "dot" style traces traces the retrieval by printing
dots on the screen, each dot representing a fixed
amount of downloaded data.
An optional "dotsize" tag can be specified to change
the the amount of downloaded data per dot, grouping
and line as follows (K = 1024 bytes; M = 1024KBytes ):
size per dots per
"dotsize" dot line group line
--------- --- ---- ----- ----
default 1K 50K 10 50
binary 8K 384K 16 48
mega 64K 3M 8 48
"default" is used if no "dotsize" tag is specified.
Note that you can set "per user" defaults using the
"progress" command in ".wgetrc". Note: specifying
an option on the command line overrides ".wgetrc"
settings.
