Imported Upstream version 1.19upstream/1.19

1 files changed, 109 insertions, 75 deletions

diff --git a/doc/wget.info b/doc/wget.info
index 9b594f9..fcde859 100644
--- a/doc/wget.info
+++ b/doc/wget.info
@@ -1,4 +1,4 @@
-This is wget.info, produced by makeinfo version 6.0 from wget.texi.
+This is wget.info, produced by makeinfo version 6.3 from wget.texi.
 
 This file documents the GNU Wget utility for downloading network data.
 
@@ -20,7 +20,7 @@ END-INFO-DIR-ENTRY
 
 File: wget.info,  Node: Top,  Next: Overview,  Prev: (dir),  Up: (dir)
 
-Wget 1.18
+Wget 1.19
 *********
 
 This file documents the GNU Wget utility for downloading network data.
@@ -131,7 +131,7 @@ File: wget.info,  Node: Invoking,  Next: Recursive Download,  Prev: Overview,  U
 
 By default, Wget is very simple to invoke.  The basic syntax is:
 
-     wget [OPTION]… [URL]…
+     wget [OPTION]... [URL]...
 
    Wget will simply download all the URLs specified on the command line.
 URL is a “Uniform Resource Locator”, as defined below.
@@ -385,11 +385,25 @@ File: wget.info,  Node: Logging and Input File Options,  Next: Download Options,
      Downloads files covered in local Metalink FILE.  Metalink version 3
      and 4 are supported.
 
+‘--keep-badhash’
+     Keeps downloaded Metalink’s files with a bad hash.  It appends
+     .badhash to the name of Metalink’s files which have a checksum
+     mismatch, except without overwriting existing files.
+
 ‘--metalink-over-http’
      Issues HTTP HEAD request instead of GET and extracts Metalink
      metadata from response headers.  Then it switches to Metalink
      download.  If no valid Metalink metadata is found, it falls back to
-     ordinary HTTP download.
+     ordinary HTTP download.  Enables ‘Content-Type:
+     application/metalink4+xml’ files download/processing.
+
+‘--metalink-index=NUMBER’
+     Set the Metalink ‘application/metalink4+xml’ metaurl ordinal
+     NUMBER. From 1 to the total number of “application/metalink4+xml”
+     available.  Specify 0 or ‘inf’ to choose the first good one.
+     Metaurls, such as those from a ‘--metalink-over-http’, may have
+     been sorted by priority key’s value; keep this in mind to choose
+     the right NUMBER.
 
 ‘--preferred-location’
      Set preferred location for Metalink resources.  This has effect if
@@ -643,7 +657,7 @@ File: wget.info,  Node: Download Options,  Next: Directory Options,  Prev: Loggi
 
      When the output is not a TTY, the progress bar always falls back to
      “dot”, even if ‘--progress=bar’ was passed to Wget during
-     invokation.  This behaviour can be overridden and the “bar” output
+     invocation.  This behaviour can be overridden and the “bar” output
      forced by using the “force” parameter as ‘--progress=bar:force’.
 
      By default, the ‘bar’ style progress bar scroll the name of the
@@ -966,6 +980,15 @@ File: wget.info,  Node: Download Options,  Next: Directory Options,  Prev: Loggi
      specified when ‘--password’ is being used, because they are
      mutually exclusive.
 
+‘--use-askpass=COMMAND’
+     Prompt for a user and password using the specified command.  If no
+     command is specified then the command in the environment variable
+     WGET_ASKPASS is used.  If WGET_ASKPASS is not set then the command
+     in the environment variable SSH_ASKPASS is used.
+
+     You can set the default command for use-askpass in the ‘.wgetrc’.
+     That setting may be overridden from the command line.
+
 ‘--no-iri’
 
      Turn off internationalized URI (IRI) support.  Use ‘--iri’ to turn
@@ -1124,11 +1147,11 @@ File: wget.info,  Node: HTTP Options,  Next: HTTPS (SSL/TLS) Options,  Prev: Dir
      Another way to specify username and password is in the URL itself
      (*note URL Format::).  Either method reveals your password to
      anyone who bothers to run ‘ps’.  To prevent the passwords from
-     being seen, store them in ‘.wgetrc’ or ‘.netrc’, and make sure to
-     protect those files from other users with ‘chmod’.  If the
-     passwords are really important, do not leave them lying in those
-     files either—edit the files and delete them after Wget has started
-     the download.
+     being seen, use the ‘--use-askpass’ or store them in ‘.wgetrc’ or
+     ‘.netrc’, and make sure to protect those files from other users
+     with ‘chmod’.  If the passwords are really important, do not leave
+     them lying in those files either—edit the files and delete them
+     after Wget has started the download.
 
 ‘--no-http-keep-alive’
      Turn off the “keep-alive” feature for HTTP downloads.  Normally,
@@ -1429,6 +1452,11 @@ File: wget.info,  Node: HTTP Options,  Next: HTTPS (SSL/TLS) Options,  Prev: Dir
      use ‘Content-Disposition’ headers to describe what the name of a
      downloaded file should be.
 
+     When combined with ‘--metalink-over-http’ and
+     ‘--trust-server-names’, a ‘Content-Type: application/metalink4+xml’
+     file is named using the ‘Content-Disposition’ filename field, if
+     available.
+
 ‘--content-on-error’
 
      If this is set to on, wget will not skip the content when the
@@ -1436,9 +1464,11 @@ File: wget.info,  Node: HTTP Options,  Next: HTTPS (SSL/TLS) Options,  Prev: Dir
 
 ‘--trust-server-names’
 
-     If this is set to on, on a redirect the last component of the
-     redirection URL will be used as the local file name.  By default it
-     is used the last component in the original URL.
+     If this is set, on a redirect, the local file name will be based on
+     the redirection URL. By default the local file name is based on the
+     original URL. When doing recursive retrieving this can be helpful
+     because in many web sites redirected URLs correspond to an
+     underlying file structure, while link URLs do not.
 
 ‘--auth-no-challenge’
 
@@ -2871,8 +2901,8 @@ content_disposition = on/off
      HTTP header—if set to ‘on’, the same as ‘--content-disposition’.
 
 trust_server_names = on/off
-     If set to on, use the last component of a redirection URL for the
-     local file name.
+     If set to on, construct the local file name from redirection URLs
+     rather than original URLs.
 
 continue = on/off
      If set to on, force continuation of preexistent partially retrieved
@@ -3705,7 +3735,7 @@ File: wget.info,  Node: Distribution,  Next: Web Site,  Prev: Proxies,  Up: Vari
 
 Like all GNU utilities, the latest version of Wget can be found at the
 master GNU archive site ftp.gnu.org, and its mirrors.  For example, Wget
-1.18 can be found at <https://ftp.gnu.org/pub/gnu/wget/wget-1.18.tar.gz>
+1.19 can be found at <https://ftp.gnu.org/pub/gnu/wget/wget-1.19.tar.gz>
 
 
 File: wget.info,  Node: Web Site,  Next: Mailing Lists,  Prev: Distribution,  Up: Various
@@ -4592,7 +4622,7 @@ notices just after the title page:
        Free Documentation License''.
 
    If you have Invariant Sections, Front-Cover Texts and Back-Cover
-Texts, replace the “with…Texts.” line with this:
+Texts, replace the “with...Texts.” line with this:
 
          with the Invariant Sections being LIST THEIR TITLES, with
          the Front-Cover Texts being LIST, and with the Back-Cover Texts
@@ -4631,13 +4661,13 @@ Concept Index
 * arguments:                             Invoking.            (line   6)
 * authentication:                        Download Options.    (line 530)
 * authentication <1>:                    HTTP Options.        (line  38)
-* authentication <2>:                    HTTP Options.        (line 364)
+* authentication <2>:                    HTTP Options.        (line 371)
 * backing up converted files:            Recursive Retrieval Options.
                                                               (line  90)
 * backing up files:                      Download Options.    (line 107)
 * bandwidth, limit:                      Download Options.    (line 325)
 * base for relative links in input file: Logging and Input File Options.
-                                                              (line  90)
+                                                              (line 104)
 * bind address:                          Download Options.    (line   6)
 * bind DNS address:                      Download Options.    (line  11)
 * bug reports:                           Reporting Bugs.      (line   6)
@@ -4653,7 +4683,7 @@ Concept Index
 * comments, HTML:                        Recursive Retrieval Options.
                                                               (line 168)
 * connect timeout:                       Download Options.    (line 309)
-* Content On Error:                      HTTP Options.        (line 353)
+* Content On Error:                      HTTP Options.        (line 358)
 * Content-Disposition:                   HTTP Options.        (line 341)
 * Content-Length, ignore:                HTTP Options.        (line 155)
 * continue retrieval:                    Download Options.    (line 113)
@@ -4708,7 +4738,7 @@ Concept Index
 * following ftp links:                   FTP Links.           (line   6)
 * following links:                       Following Links.     (line   6)
 * force html:                            Logging and Input File Options.
-                                                              (line  83)
+                                                              (line  97)
 * ftp authentication:                    FTP Options.         (line   6)
 * ftp password:                          FTP Options.         (line   6)
 * ftp time-stamping:                     FTP Time-Stamping Internals.
@@ -4727,7 +4757,7 @@ Concept Index
 * http time-stamping:                    HTTP Time-Stamping Internals.
                                                               (line   6)
 * http user:                             HTTP Options.        (line  38)
-* idn support:                           Download Options.    (line 543)
+* idn support:                           Download Options.    (line 552)
 * ignore case:                           Recursive Accept/Reject Options.
                                                               (line  62)
 * ignore length:                         HTTP Options.        (line 155)
@@ -4746,8 +4776,10 @@ Concept Index
 * IP address, client:                    Download Options.    (line   6)
 * IPv6:                                  Download Options.    (line 478)
 * IRC:                                   Internet Relay Chat. (line   6)
-* iri support:                           Download Options.    (line 543)
+* iri support:                           Download Options.    (line 552)
 * Keep-Alive, turning off:               HTTP Options.        (line  54)
+* keep-badhash:                          Logging and Input File Options.
+                                                              (line  73)
 * latest version:                        Distribution.        (line   6)
 * limit bandwidth:                       Download Options.    (line 325)
 * link conversion:                       Recursive Retrieval Options.
@@ -4755,13 +4787,15 @@ Concept Index
 * links:                                 Following Links.     (line   6)
 * list:                                  Mailing Lists.       (line   5)
 * loading cookies:                       HTTP Options.        (line  85)
-* local encoding:                        Download Options.    (line 552)
+* local encoding:                        Download Options.    (line 561)
 * location of wgetrc:                    Wgetrc Location.     (line   6)
 * log file:                              Logging and Input File Options.
                                                               (line   6)
 * mailing list:                          Mailing Lists.       (line   6)
+* metalink-index:                        Logging and Input File Options.
+                                                              (line  85)
 * metalink-over-http:                    Logging and Input File Options.
-                                                              (line  73)
+                                                              (line  78)
 * mirroring:                             Very Advanced Usage. (line   6)
 * no parent:                             Directory-Based Limits.
                                                               (line  43)
@@ -4784,7 +4818,7 @@ Concept Index
 * portability:                           Portability.         (line   6)
 * POST:                                  HTTP Options.        (line 240)
 * preferred-location:                    Logging and Input File Options.
-                                                              (line  79)
+                                                              (line  93)
 * progress indicator:                    Download Options.    (line 184)
 * proxies:                               Proxies.             (line   6)
 * proxy:                                 Download Options.    (line 386)
@@ -4812,7 +4846,7 @@ Concept Index
 * reject suffixes:                       Types of Files.      (line  39)
 * reject wildcards:                      Types of Files.      (line  39)
 * relative links:                        Relative Links.      (line   6)
-* remote encoding:                       Download Options.    (line 566)
+* remote encoding:                       Download Options.    (line 575)
 * reporting bugs:                        Reporting Bugs.      (line   6)
 * required images, downloading:          Recursive Retrieval Options.
                                                               (line 103)
@@ -4834,7 +4868,7 @@ Concept Index
 * signal handling:                       Signals.             (line   6)
 * spanning hosts:                        Spanning Hosts.      (line   6)
 * specify config:                        Logging and Input File Options.
-                                                              (line 103)
+                                                              (line 117)
 * spider:                                Download Options.    (line 274)
 * SSL:                                   HTTPS (SSL/TLS) Options.
                                                               (line   6)
@@ -4870,9 +4904,9 @@ Concept Index
 * timeout, read:                         Download Options.    (line 314)
 * timestamping:                          Time-Stamping.       (line   6)
 * tries:                                 Download Options.    (line  26)
-* Trust server names:                    HTTP Options.        (line 358)
+* Trust server names:                    HTTP Options.        (line 363)
 * types of files:                        Types of Files.      (line   6)
-* unlink:                                Download Options.    (line 581)
+* unlink:                                Download Options.    (line 590)
 * updating the archives:                 Time-Stamping.       (line   6)
 * URL:                                   URL Format.          (line   6)
 * URL syntax:                            URL Format.          (line   6)
@@ -4908,51 +4942,51 @@ Ref: URL Format-Footnote-19450
 Node: Option Syntax9556
 Node: Basic Startup Options12334
 Node: Logging and Input File Options13192
-Node: Download Options17684
-Node: Directory Options46591
-Node: HTTP Options49442
-Node: HTTPS (SSL/TLS) Options67713
-Node: FTP Options80246
-Node: Recursive Retrieval Options87308
-Node: Recursive Accept/Reject Options96565
-Node: Exit Status100770
-Node: Recursive Download101805
-Node: Following Links105044
-Node: Spanning Hosts106010
-Node: Types of Files108279
-Node: Directory-Based Limits113173
-Node: Relative Links116440
-Node: FTP Links117290
-Node: Time-Stamping118181
-Node: Time-Stamping Usage119866
-Node: HTTP Time-Stamping Internals121738
-Ref: HTTP Time-Stamping Internals-Footnote-1123086
-Node: FTP Time-Stamping Internals123289
-Node: Startup File124776
-Node: Wgetrc Location125716
-Node: Wgetrc Syntax126570
-Node: Wgetrc Commands127335
-Node: Sample Wgetrc143654
-Node: Examples149682
-Node: Simple Usage150043
-Node: Advanced Usage151492
-Node: Very Advanced Usage155308
-Node: Various156852
-Node: Proxies157561
-Node: Distribution160518
-Node: Web Site160858
-Node: Mailing Lists161158
-Node: Internet Relay Chat162895
-Node: Reporting Bugs163190
-Node: Portability165759
-Node: Signals167406
-Node: Appendices168113
-Node: Robot Exclusion168461
-Node: Security Considerations172336
-Node: Contributors173546
-Node: Copying this manual179276
-Node: GNU Free Documentation License179516
-Node: Concept Index204870
+Node: Download Options18405
+Node: Directory Options47745
+Node: HTTP Options50596
+Node: HTTPS (SSL/TLS) Options69269
+Node: FTP Options81802
+Node: Recursive Retrieval Options88864
+Node: Recursive Accept/Reject Options98121
+Node: Exit Status102326
+Node: Recursive Download103361
+Node: Following Links106600
+Node: Spanning Hosts107566
+Node: Types of Files109835
+Node: Directory-Based Limits114729
+Node: Relative Links117996
+Node: FTP Links118846
+Node: Time-Stamping119737
+Node: Time-Stamping Usage121422
+Node: HTTP Time-Stamping Internals123294
+Ref: HTTP Time-Stamping Internals-Footnote-1124642
+Node: FTP Time-Stamping Internals124845
+Node: Startup File126332
+Node: Wgetrc Location127272
+Node: Wgetrc Syntax128126
+Node: Wgetrc Commands128891
+Node: Sample Wgetrc145220
+Node: Examples151248
+Node: Simple Usage151609
+Node: Advanced Usage153058
+Node: Very Advanced Usage156874
+Node: Various158418
+Node: Proxies159127
+Node: Distribution162084
+Node: Web Site162424
+Node: Mailing Lists162724
+Node: Internet Relay Chat164461
+Node: Reporting Bugs164756
+Node: Portability167325
+Node: Signals168972
+Node: Appendices169679
+Node: Robot Exclusion170027
+Node: Security Considerations173902
+Node: Contributors175112
+Node: Copying this manual180842
+Node: GNU Free Documentation License181082
+Node: Concept Index206436
 
 End Tag Table