[svn] Manually applied Rob Mayoff <mayoff@dqd.com>'s patch (vs. 1.5.3, not 1.5.3+dev)

to add --bind-address, making many necessary alphabetization, coding style,
comment, documentation, and naming fixes and additions.

doc/ChangeLog

@@ -1,6 +1,7 @@
 2000-10-23  Dan Harkless  <dan-wget@dilvish.speed.net>
 
 	* wget.texi (Recursive Retrieval Options): Improved --delete-after docs.
+	(Download Options): Documented Rob Mayoff's new --bind-address option.
 	
 2000-10-20  Dan Harkless  <dan-wget@dilvish.speed.net>
 

doc/wget.info

@@ -26,8 +26,8 @@ notice identical to this one.
 
 Indirect:
 wget.info-1: 961
-wget.info-2: 48494
-wget.info-3: 97018
+wget.info-2: 48745
+wget.info-3: 97411
 
 Tag Table:
 (Indirect)
@@ -39,50 +39,50 @@ Node: Option Syntax8163
 Node: Basic Startup Options9587
 Node: Logging and Input File Options10287
 Node: Download Options12812
-Node: Directory Options20659
-Node: HTTP Options23137
-Node: FTP Options27853
-Node: Recursive Retrieval Options29835
-Node: Recursive Accept/Reject Options34856
-Node: Recursive Retrieval38082
-Node: Following Links40380
-Node: Relative Links41408
-Node: Host Checking41922
-Node: Domain Acceptance43947
-Node: All Hosts45617
-Node: Types of Files46044
-Node: Directory-Based Limits48494
-Node: FTP Links51134
-Node: Time-Stamping52004
-Node: Time-Stamping Usage53641
-Node: HTTP Time-Stamping Internals55210
-Node: FTP Time-Stamping Internals56680
-Node: Startup File57888
-Node: Wgetrc Location58761
-Node: Wgetrc Syntax59576
-Node: Wgetrc Commands60291
-Node: Sample Wgetrc68548
-Node: Examples73567
-Node: Simple Usage74174
-Node: Advanced Usage76568
-Node: Guru Usage79319
-Node: Various80981
-Node: Proxies81505
-Node: Distribution84270
-Node: Mailing List84621
-Node: Reporting Bugs85320
-Node: Portability87105
-Node: Signals88480
-Node: Appendices89134
-Node: Robots89549
-Node: Introduction to RES90696
-Node: RES Format92589
-Node: User-Agent Field93693
-Node: Disallow Field94457
-Node: Norobots Examples95068
-Node: Security Considerations96022
-Node: Contributors97018
-Node: Copying99661
-Node: Concept Index118824
+Node: Directory Options20910
+Node: HTTP Options23388
+Node: FTP Options28104
+Node: Recursive Retrieval Options30086
+Node: Recursive Accept/Reject Options35107
+Node: Recursive Retrieval38333
+Node: Following Links40631
+Node: Relative Links41659
+Node: Host Checking42173
+Node: Domain Acceptance44198
+Node: All Hosts45868
+Node: Types of Files46295
+Node: Directory-Based Limits48745
+Node: FTP Links51385
+Node: Time-Stamping52255
+Node: Time-Stamping Usage53892
+Node: HTTP Time-Stamping Internals55461
+Node: FTP Time-Stamping Internals56931
+Node: Startup File58139
+Node: Wgetrc Location59012
+Node: Wgetrc Syntax59827
+Node: Wgetrc Commands60542
+Node: Sample Wgetrc68941
+Node: Examples73960
+Node: Simple Usage74567
+Node: Advanced Usage76961
+Node: Guru Usage79712
+Node: Various81374
+Node: Proxies81898
+Node: Distribution84663
+Node: Mailing List85014
+Node: Reporting Bugs85713
+Node: Portability87498
+Node: Signals88873
+Node: Appendices89527
+Node: Robots89942
+Node: Introduction to RES91089
+Node: RES Format92982
+Node: User-Agent Field94086
+Node: Disallow Field94850
+Node: Norobots Examples95461
+Node: Security Considerations96415
+Node: Contributors97411
+Node: Copying100054
+Node: Concept Index119217
 
 End Tag Table

doc/wget.info-1

@@ -347,6 +347,12 @@ File: wget.info,  Node: Download Options,  Next: Directory Options,  Prev: Loggi
 Download Options
 ================
 
+`--bind-address=ADDRESS'
+     When making client TCP/IP connections, `bind()' to ADDRESS on the
+     local machine.  ADDRESS may be specified as a hostname or IP
+     address.  This option can be useful if your machine is bound to
+     multiple IPs.
+
 `-t NUMBER'
 `--tries=NUMBER'
      Set number of retries to NUMBER.  Specify 0 or `inf' for infinite

doc/wget.info-2

@@ -341,9 +341,10 @@ some cases is the "lockable" Boolean, which may be set to `on', `off',
 value will be locked in for the duration of the wget invocation -
 commandline options will not override.
 
-   Some commands take pseudo-arbitrary values.  STRING values can be
-any non-empty string.  N can be any positive integer, or `inf' for
-infinity, where appropriate.
+   Some commands take pseudo-arbitrary values.  ADDRESS values can be
+hostnames or dotted-quad IP addresses.  N can be any positive integer,
+or `inf' for infinity, where appropriate.  STRING values can be any
+non-empty string.
 
    Most of these commands have commandline equivalents (*Note
 Invoking::), though some of the more obscure or rarely used ones do not.
@@ -370,6 +371,9 @@ base = STRING
      Consider relative URLs in URL input files forced to be interpreted
      as HTML as being relative to STRING - the same as `-B'.
 
+bind_address = ADDRESS
+     Bind to ADDRESS, like the `--bind-address' option.
+
 cache = on/off
      When set to off, disallow server-caching.  See the `-C' option.
 

doc/wget.info-3

@@ -474,9 +474,11 @@ Concept Index
 * authentication:                        HTTP Options.
 * backing up converted files:            Recursive Retrieval Options.
 * base for relative links in input file: Logging and Input File Options.
+* bind() address:                        Download Options.
 * bug reports:                           Reporting Bugs.
 * bugs:                                  Reporting Bugs.
 * cache:                                 HTTP Options.
+* client IP address:                     Download Options.
 * clobbering, file:                      Download Options.
 * command line:                          Invoking.
 * Content-Length, ignore:                HTTP Options.
@@ -520,6 +522,7 @@ Concept Index
 * incremental updating:                  Time-Stamping.
 * input-file:                            Logging and Input File Options.
 * invoking:                              Invoking.
+* IP address, client:                    Download Options.
 * latest version:                        Distribution.
 * link conversion:                       Recursive Retrieval Options.
 * links:                                 Following Links.
@@ -547,8 +550,8 @@ Concept Index
 * pause:                                 Download Options.
 * portability:                           Portability.
 * proxies:                               Proxies.
-* proxy <1>:                             HTTP Options.
-* proxy:                                 Download Options.
+* proxy <1>:                             Download Options.
+* proxy:                                 HTTP Options.
 * proxy authentication:                  HTTP Options.
 * proxy filling:                         Recursive Retrieval Options.
 * proxy password:                        HTTP Options.

doc/wget.texi

@@ -443,6 +443,15 @@ links in the file specified by @samp{-i}.
 @section Download Options
 
 @table @samp
+@cindex bind() address
+@cindex client IP address
+@cindex IP address, client
+@item --bind-address=@var{ADDRESS}
+When making client TCP/IP connections, @code{bind()} to @var{ADDRESS} on
+the local machine.  @var{ADDRESS} may be specified as a hostname or IP
+address.  This option can be useful if your machine is bound to multiple
+IPs.
+
 @cindex retries
 @cindex tries
 @cindex number of retries
@@ -1707,9 +1716,10 @@ option is set to @samp{always} or @samp{never}, that value will be
 locked in for the duration of the wget invocation -- commandline options
 will not override.
 
-Some commands take pseudo-arbitrary values.  @var{string} values can be
-any non-empty string.  @var{n} can be any positive integer, or
-@samp{inf} for infinity, where appropriate.
+Some commands take pseudo-arbitrary values.  @var{address} values can be
+hostnames or dotted-quad IP addresses.  @var{n} can be any positive
+integer, or @samp{inf} for infinity, where appropriate.  @var{string}
+values can be any non-empty string.
 
 Most of these commands have commandline equivalents (@xref{Invoking}),
 though some of the more obscure or rarely used ones do not.
@@ -1741,6 +1751,9 @@ Consider relative @sc{url}s in @sc{url} input files forced to be
 interpreted as @sc{html} as being relative to @var{string} -- the same
 as @samp{-B}.
 
+@item bind_address = @var{address}
+Bind to @var{address}, like the @samp{--bind-address} option.
+
 @item cache = on/off
 When set to off, disallow server-caching.  See the @samp{-C} option.