github-repos/wget
1
0
Fork 0
mirror of https://github.com/mirror/wget.git synced 2026-08-22 19:03:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

Documentation fixes for IRI options, and rename --locale -> --local-encoding.

Browse Source
This commit is contained in:
Micah Cowan
2009-07-26 21:50:19 -07:00
parent 25a3d032fa
commit da2ac85f40
12 changed files with 85 additions and 47 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
doc/ChangeLog
View File

@@ -1,3 +1,9 @@
2009-07-26 Micah Cowan <micah@cowan.name>
* wget.texi (Download Options): Change --iri item to --no-iri;
rename --locale to --local-encoding.
(Wgetrc Commands): Document iri, local_encoding, remote_encoding.
2009-07-06 Micah Cowan <micah@cowan.name>
* wget.texi (Logging and Input File Options): Alter description of

91
doc/wget.texi
View File

@@ -683,30 +683,6 @@ Another instance where you'll get a garbled file if you try to use
Note that @samp{-c} only works with @sc{ftp} servers and with @sc{http}
servers that support the @code{Range} header.
@cindex iri support
@cindex idn support
@item --iri
Turn on internationalized URI (IRI) support. Use @samp{--no-iri} to
turn it off. IRI support is activated by default.
You can set the default state of IRI support using @code{iri} command in
@file{.wgetrc}. That setting may be overridden from the command line.
@cindex local encoding
@cindex locale
@item --locale=@var{encoding}
Force Wget to use @var{encoding} as the default system encoding. That affects
how Wget converts URLs specified as arguments from locale to @sc{utf-8} for
IRI support.
Wget use the function @code{nl_langinfo()} and then the @code{CHARSET}
environment variable to get the locale. If it fails, @sc{ascii} is used.
You can set the default locale using the @code{locale} command in
@file{.wgetrc}. That setting may be overridden from the command line.
@cindex progress indicator
@cindex dot style
@item --progress=@var{type}
@@ -738,21 +714,6 @@ command line. The exception is that, when the output is not a TTY, the
``dot'' progress will be favored over ``bar''. To force the bar output,
use @samp{--progress=bar:force}.
@cindex remote encoding
@item --remote-encoding=@var{encoding}
Force Wget to use encoding as the default remote server encoding. That
affects how Wget converts URIs found in files from remote encoding to
@sc{utf-8} during a recursive fetch. This options is only useful for
IRI support, for the interpretation of non-@sc{ascii} characters.
For HTTP, remote encoding can be found in HTTP @code{Content-Type}
header and in HTML @code{Content-Type http-equiv} meta tag.
You can set the default encoding using the @code{remoteencoding}
command in @file{.wgetrc}. That setting may be overridden from the
command line.
@item -N
@itemx --timestamping
Turn on time-stamping. @xref{Time-Stamping}, for details.
@@ -1044,6 +1005,46 @@ options for @sc{http} connections.
@item --ask-password
Prompt for a password for each connection established. Cannot be specified
when @samp{--password} is being used, because they are mutually exclusive.
@cindex iri support
@cindex idn support
@item --no-iri
Turn off internationalized URI (IRI) support. Use @samp{--iri} to
turn it on. IRI support is activated by default.
You can set the default state of IRI support using the @code{iri}
command in @file{.wgetrc}. That setting may be overridden from the
command line.
@cindex local encoding
@item --local-encoding=@var{encoding}
Force Wget to use @var{encoding} as the default system encoding. That affects
how Wget converts URLs specified as arguments from locale to @sc{utf-8} for
IRI support.
Wget use the function @code{nl_langinfo()} and then the @code{CHARSET}
environment variable to get the locale. If it fails, @sc{ascii} is used.
You can set the default local encoding using the @code{local_encoding}
command in @file{.wgetrc}. That setting may be overridden from the
command line.
@cindex remote encoding
@item --remote-encoding=@var{encoding}
Force Wget to use @var{encoding} as the default remote server encoding.
That affects how Wget converts URIs found in files from remote encoding
to @sc{utf-8} during a recursive fetch. This options is only useful for
IRI support, for the interpretation of non-@sc{ascii} characters.
For HTTP, remote encoding can be found in HTTP @code{Content-Type}
header and in HTML @code{Content-Type http-equiv} meta tag.
You can set the default encoding using the @code{remoteencoding}
command in @file{.wgetrc}. That setting may be overridden from the
command line.
@end table
@node Directory Options, HTTP Options, Download Options, Invoking
@@ -2857,6 +2858,10 @@ Ignore certain @sc{html} tags when doing a recursive retrieval, like
Specify a comma-separated list of directories you wish to follow when
downloading---the same as @samp{-I @var{string}}.
@item iri = on/off
When set to on, enable internationalized URI (IRI) support; the same as
@samp{--iri}.
@item inet4_only = on/off
Force connecting to IPv4 addresses, off by default. You can put this
in the global init file to disable Wget's attempts to resolve and
@@ -2878,6 +2883,10 @@ The same as @samp{--limit-rate=@var{rate}}.
@item load_cookies = @var{file}
Load cookies from @var{file}. See @samp{--load-cookies @var{file}}.
@item local_encoding = @var{encoding}
Force Wget to use @var{encoding} as the default system encoding. See
@samp{--local-encoding}.
@item logfile = @var{file}
Set logfile to @var{file}, the same as @samp{-o @var{file}}.
@@ -2997,6 +3006,10 @@ the @sc{http} spec who got the spelling of ``referrer'' wrong.)
Follow only relative links---the same as @samp{-L} (@pxref{Relative
Links}).
@item remote_encoding = @var{encoding}
Force Wget to use @var{encoding} as the default remote server encoding.
See @samp{--remote-encoding}.
@item remove_listing = on/off
If set to on, remove @sc{ftp} listings downloaded by Wget. Setting it
to off is the same as @samp{--no-remove-listing}.