]> sjero.net Git - wget/blob - NEWS
Updated copyright year.
[wget] / NEWS
1 GNU Wget NEWS -- history of user-visible changes.
2
3 Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
4 2006, 2007, 2008 Free Software Foundation, Inc.
5 See the end for copying conditions.
6
7 Please send GNU Wget bug reports to <bug-wget@gnu.org>.
8 \f
9 * Changes in Wget (MAINLINE).
10
11 ** Gnulib is now used to provide code for certain portability aspects in
12 GNU Wget.
13
14 ** Wget uses Automake now as part of its build infrastructure.
15 \f
16 * Changes in Wget 1.11.
17
18 ** Timestamping now uses the value from the most recent HTTP response,
19 rather than the first one it got.
20
21 ** Authentication information is no longer sent as part of the Referer
22 header in recursive fetches.
23
24 ** No authentication credentials are sent until a challenge is issued,
25 for improved security. Authentication handling is still not
26 RFC-compliant, as once a Basic challenge has been received, it will
27 assume it can send credentials to any URL at that same host, and not
28 just the ones at or below the original authenticated location.
29 Credentials for Digest authentication are still never saved or issued
30 automatically, and continue to require a challenge for each resource.
31
32 ** Added --max-redirect option, allowing the user to specify what should
33 be the maximum number of HTTP redirects to follow.
34
35 ** Wget now supports saving HTTP downloads using file names specified by
36 the `Content-Disposition' header.  This is a standard way of specifying
37 the file name used by many web dynamically generated pages. However, the
38 current implementation is inefficient, and known to have bugs. It is
39 EXPERIMENTAL only, and not enabled by default. Use --content-disposition
40 to enable it.
41
42 ** The new option `--ignore-case' makes Wget ignore case when
43 matching files, directories, and wildcards.  This affects the -X, -I,
44 -A, and -R options, as well as globbing in FTP URLs.
45
46 ** ETA projection is now displayed in "dot" progress output as well as
47 in the default progress bar.  (The dot progress is used by default when
48 logging Wget's output to file using the `-o' option.)
49
50 ** The "lockable boolean" argument type is no longer supported.  It
51 was only used by the passive_ftp .wgetrc setting.  If you're running
52 broken scripts or Perl modules that unconditionally specify
53 `--passive-ftp' and your firewall disallows it, you can override them
54 by replacing wget with a script that execs wget "$@" --no-passive-ftp.
55
56 ** The source code has been migrated to Mercurial. The repositories are
57 available at http://hg.addictivecode.org/. Prior to this, the source
58 code was hosted on Subversion (migrated from the original CVS); you can
59 still get access to older tags and branches for Wget in the Subversion
60 repository at http://addictivecode.org/svn/wget/.
61 \f
62 * Changes in Wget 1.10.
63
64 ** Downloading files larger than 2GB, sometimes referred to as "large
65 files", now works on systems that support them.  This includes the
66 majority of modern Unixes, as well as MS Windows.
67
68 ** IPv6 is now supported by Wget.  Unlike the experimental code in
69 1.9, this version supports dual-family systems.  The new flags
70 `--inet4' and `--inet6' (or `-4' and `-6' for short) force the use of
71 IPv4 and IPv6 respectively.  Note that IPv6 support has not yet been
72 tested on Windows.
73
74 ** Microsoft's proprietary "NTLM" method of HTTP authentication is now
75 supported.  This authentication method is undocumented and only used
76 by IIS.  Note that *proxy* authentication is not supported in this
77 release; you can only authenticate to the target web site.
78
79 ** Wget no longer truncates partially downloaded files when download
80 has to start over because the server doesn't support Range.  Instead,
81 with such servers Wget now simply ignores the data up to the byte
82 where the last attempt left off, and only then continues appending to
83 the file.  That way the downloaded file never shrinks, and download
84 retries from servers without support for partial downloads work even
85 when downloading to stdout.
86
87 ** SSL/TLS changes:
88
89 *** SSL/TLS downloads now attempt to verify the server's certificate
90 against the recognized certificate authorities.  This requires CA
91 certificates to have been installed in a location visible to the
92 OpenSSL library.  If this is not the case, you can get the bundle
93 yourself from a source you trust (for example, the bundle extracted
94 from Mozilla available at http://curl.haxx.se/docs/caextract.html),
95 and point Wget to the PEM file using the `--ca-certificate'
96 command-line option or the corresponding `.wgetrc' command.
97
98 *** Secure downloads now verify that the host name in the URL matches
99 the "common name" in the certificate presented by the server.
100
101 *** Although the above checks provide more secure downloads, they
102 unavoidably break interoperability with some sites that worked with
103 previous versions, particularly those using self-signed, expired, or
104 otherwise invalid certificates.  If you encounter "certificate
105 verification" errors or complaints that "common name doesn't match
106 requested host name" and are convinced of the site's authenticity, you
107 can use `--no-check-certificate' to bypass both checks.
108
109 *** Talking to SSL/TLS servers over proxies now actually works.
110 Previous versions of Wget erroneously sent GET requests for https
111 URLs.  Wget 1.10 utilizes the CONNECT method designed for this
112 purpose.
113
114 *** The SSL/TLS-related options have been redesigned and, for the
115 first time, documented in the manual.  The old, undocumented, options
116 are no longer supported.
117
118 ** Passive FTP is now the default FTP transfer mode.  Use
119 `--no-passive-ftp' or specify `passive_ftp = off' in your init file to
120 revert to the old behavior.
121
122 ** The `--header' option can now be used to override generated
123 headers.  For example, `wget --header="Host: foo.bar"
124 http://127.0.0.1' tells Wget to connect to localhost, but to specify
125 "foo.bar" in the `Host' header.  In previous versions such use of
126 `--header' lead to duplicate headers in HTTP requests.
127
128 ** The responses without headers, aka "HTTP 0.9" responses, are
129 detected and handled.  Although HTTP 0.9 has long been obsolete, it is
130 still occasionally used, sometimes by accident.
131
132 ** The progress bar is now updated regularly even when the data does
133 not arrive from the network.
134
135 ** Wget no longer preserves permissions of files retrieved by FTP by
136 default.  Anonymous FTP servers frequently use permissions like "664",
137 which might not be what the user wants.  The new option
138 `--preserve-permissions' and the corresponding `.wgetrc' variable can
139 be used to revert to the old behavior.
140
141 ** The new option `--protocol-directories' instructs Wget to also use
142 the protocol name as a directory component of local file names.
143
144 ** Options that previously unconditionally set or unset various flags
145 are now boolean options that can be invoked as either `--OPTION' or
146 `--no-OPTION'.  Options that required an argument "on" or "off" have
147 also been changed this way, but they still accept the old syntax for
148 backward compatibility.  For example, instead of `--glob=off' you can
149 write `--no-glob'.
150
151 Allowing `--no-OPTION' for every `--OPTION' and the other way around
152 is useful because it allows the user to override non-default behavior
153 specified via `.wgetrc'.
154
155 ** The new option `--keep-session-cookies' causes `--save-cookies' to
156 save session cookies (normally only kept in memory) along with the
157 permanent ones.  This is useful because many sites track important
158 information, such as whether the user has authenticated, in session
159 cookies.  With this option multiple Wget runs are treated as a single
160 browser session.
161
162 ** Wget now supports the --ftp-user and --ftp-password command
163 switches to set username and password for FTP, and the --user and
164 --password command switches to set username and password for both FTP
165 and HTTP.  The --http-passwd and --proxy-passwd command switches have
166 been renamed to --http-password and --proxy-password respectively, and
167 the related http_passwd and proxy_passwd .wgetrc commands to
168 http_password and proxy_password respectively.  The login and passwd
169 .wgetrc commands have been deprecated.
170
171 * `wget -b' now works correctly under Windows.
172 \f
173 * Wget 1.9.1 is a bugfix release with no user-visible changes.
174 \f
175 * Changes in Wget 1.9.
176
177 ** It is now possible to specify that POST method be used for HTTP
178 requests.  For example, `wget --post-data="id=foo&data=bar" URL' will
179 send a POST request with the specified contents.
180
181 ** IPv6 support is available, although it's still experimental.
182
183 ** The `--timeout' option now also affects DNS lookup and establishing
184 the TCP connection.  Previously it only affected reading and writing
185 data.  Those three timeouts can be set separately using
186 `--dns-timeout', `--connection-timeout', and `--read-timeout',
187 respectively.
188
189 ** Download speed shown by the progress bar is based on the data
190 recently read, rather than the average speed of the entire download.
191 The ETA projection is still based on the overall average.
192
193 ** It is now possible to connect to FTP servers through FWTK
194 firewalls.  Set ftp_proxy to an FTP URL, and Wget will automatically
195 log on to the proxy as "username@host".
196
197 ** The new option `--retry-connrefused' makes Wget retry downloads
198 even in the face of refused connections, which are otherwise
199 considered a fatal error.
200
201 ** The new option `--no-dns-cache' may be used to prevent Wget from
202 caching DNS lookups.
203
204 ** Wget no longer escapes characters in local file names based on
205 whether they're appropriate in URLs.  Escaping can still occur for
206 nonprintable characters or for '/', but no longer for frequent
207 characters such as space.  You can use the new option
208 --restrict-file-names to relax or strengthen these rules, which can be
209 useful if you dislike the default or if you're downloading to
210 non-native partitions.
211
212 ** Handling of HTML comments has been dumbed down to conform to what
213 users expect and other browsers do: instead of being treated as SGML
214 declaration, a comment is terminated at the first occurrence of "-->".
215 Use `--strict-comments' to revert to the old behavior.
216
217 ** Wget now correctly handles relative URIs that begin with "//", such
218 as "//img.foo.com/foo.jpg".
219
220 ** Boolean options in `.wgetrc' and on the command line now accept
221 values "yes" and "no" along with the traditional "on" and "off".
222
223 ** It is now possible to specify decimal values for timeouts, waiting
224 periods, and download rate.  For instance, `--wait=0.5' now works as
225 expected, as does `--dns-timeout=0.5' and even `--limit-rate=2.5k'.
226 \f
227 * Wget 1.8.2 is a bugfix release with no user-visible changes.
228 \f
229 * Wget 1.8.1 is a bugfix release with no user-visible changes.
230 \f
231 * Changes in Wget 1.8.
232
233 ** A new progress indicator is now available and used by default.
234 You can choose the progress bar type with `--progress=TYPE'.  Two
235 types are available, "bar" (the new default), and "dot" (the old
236 dotted indicator).  You can permanently revert to the old progress
237 indicator by putting `progress = dot' in your `.wgetrc'.
238
239 ** You can limit the download rate of the retrieval using the
240 `--limit-rate' option.  For example, `wget --limit-rate=15k URL' will
241 tell Wget not to download the body of the URL faster than 15 kilobytes
242 per second.
243
244 ** Recursive retrieval and link conversion have been revamped:
245
246 *** Wget now traverses links breadth-first.  This makes the
247 calculation of depth much more reliable than before.  Also, recursive
248 downloads are faster and consume *significantly* less memory than
249 before.
250
251 *** Links are converted only when the entire retrieval is complete.
252 This is the only safe thing to do, as only then is it known what URLs
253 have been downloaded.
254
255 *** BASE tags are handled correctly when converting links.  Since Wget
256 already resolves <base href="..."> when resolving handling URLs, link
257 conversion now makes the BASE tags point to an empty string.
258
259 *** HTML anchors are now handled correctly.  Links to an anchor in the
260 same document (<a href="#anchorname">), which used to confuse Wget,
261 are now converted correctly.
262
263 *** When in page-requisites (-p) mode, no-parent (-np) is ignored when
264 retrieving for inline images, stylesheets, and other documents needed
265 to display the page.
266
267 *** Page-requisites (-p) mode now works with frames.  In other words,
268 `wget -p URL-THAT-USES-FRAMES' will now download the frame HTML files,
269 and all the files that they need to be displayed properly.
270
271 ** `--base' now works conjunction with `--input-file', providing a
272 base for each URL and thereby allowing the URLs in the file to be
273 relative.
274
275 ** If a host has more than one IP address, Wget uses the other
276 addresses when accessing the first one fails.
277
278 ** Host directories now contain port information if the URL is at a
279 non-standard port.
280
281 ** Wget now supports the robots.txt directives specified in
282 <http://www.robotstxt.org/wc/norobots-rfc.txt>.
283
284 ** URL parser has been fixed, especially the infamous overzealous
285 quoting.  Wget no longer dequotes reserved characters, e.g. `%3F' is
286 no longer translated to `?', nor `%2B' to `+'.  Unsafe characters
287 which are not reserved are still escaped, of course.
288
289 ** No more than 20 successive redirections are allowed.
290 \f
291 * Wget 1.7.1 is a bugfix release with no user-visible changes.
292 \f
293 * Changes in Wget 1.7.
294
295 ** SSL (`https') pages now work if you compile Wget with SSL support;
296 use the `--with-ssl' configure flag.  You need to have OpenSSL
297 installed.
298
299 ** Cookies are now supported.  Wget will accept cookies sent by the
300 server and return them in later requests.  Additionally, it can load
301 and save cookies to disk, in the same format that Netscape uses.
302
303 ** "Keep-alive" (persistent) HTTP connections are now supported.
304 Using keep-alive allows Wget to share one TCP/IP connection for
305 many retrievals, making multiple-file downloads faster and less
306 stressing for the server and the network.
307
308 ** Wget now recognizes FTP directory listings generated by NT and VMS
309 servers.
310
311 ** It is now possible to recurse through FTP sites where logging in
312 puts you in some directory other than '/'.
313
314 ** You may now use `~' to mean home directory in `.wgetrc'.  For
315 example, `load_cookies = ~/.netscape/cookies.txt' works as you would
316 expect.
317
318 ** The HTML parser has been rewritten.  The new one works more
319 reliably, allows finer-grained control over which tags and attributes
320 are detected, and has better support for some features like correctly
321 skipping comments and declarations, decoding entities, etc.  It is
322 also more general.
323
324 ** <meta name="robots"> tags are now respected.
325
326 ** Wget's internal tables now use hash tables instead of linked lists
327 where appropriate.  This results in huge speedups when retrieving
328 large sites (thousands of documents).
329
330 ** Wget now has a man page, automatically generated from the Texinfo
331 documentation.  (The last version that shipped with a man page was
332 1.4.5).  To get this, you need to have pod2man from the Perl
333 distribution installed on your system.
334 \f
335 * Changes in Wget 1.6
336
337 ** Administrative changes.
338
339 *** Maintainership.  Due to Hrvoje being plagued with a "real job",
340 Dan Harkless is the most active maintainer (not that he doesn't have a
341 real job as well).  Hrvoje still participates occasionally, and both
342 are being helped by many other people.
343
344 *** Web page.  Thanks to Jan Prikryl, Wget has an "official" web page.
345 Take a look at:
346
347     http://sunsite.dk/wget/
348
349 *** Anonymous CVS.  Thanks to ever-helpful Karsten Thygesen, Wget
350 sources are now available at an anonymous CVS server.  Take a look at
351 the web page for downloading instructions.
352
353 ** New -K / --backup-converted / backup_converted = on option causes files
354 modified due to -k to be saved with a .orig prefix before being changed.  When
355 using -N as well, it is these .orig files that are compared against the server.
356
357 ** New --follow-tags / follow_tags = ... option allows you to restrict
358 Wget to following only certain HTML tags when doing a recursive
359 retrieval.  -G / --ignore-tags / ignore_tags = ... is just the
360 opposite -- all tags but the ones you specify will be followed.
361
362 ** New --waitretry / waitretry = SECONDS option allows waiting between retries
363 of failed downloads.  Wget will use "linear" backoff, waiting 1 second after the
364 first failure, 2 after the second, up to SECONDS.  waitretry is set to 10 by
365 default in the system wgetrc.
366
367 ** New -p / --page-requisites / page_requisites = on option causes
368 Wget to download all ancillary files necessary to display a given HTML
369 page properly (e.g. inlined images).
370
371 ** New -E / --html-extension / html_extension = on option causes Wget
372 to append ".html" to text/html filenames not ending in regexp
373 "\.[Hh][Tt][Mm][Ll]?".
374
375 ** New type of .wgetrc command -- "lockable Boolean".  Can be set to on, off,
376 always, or never.  This allows the .wgetrc to override the commandline.  So far,
377 passive_ftp is the only .wgetrc command which takes a lockable Boolean.
378
379 ** A number of new translation files have been added.
380
381 ** New --bind-address / bind_address = <address> option for people on hosts 
382 bound to multiple IP addresses.
383
384 ** wget now accepts (illegal per HTTP spec) relative URLs in HTTP redirects.
385 \f
386 * Wget 1.5.3 is a bugfix release with no user-visible changes.
387 \f
388 * Wget 1.5.2 is a bugfix release with no user-visible changes.
389 \f
390 * Wget 1.5.1 is a bugfix release with no user-visible changes.
391 \f
392 * Changes in Wget 1.5.0
393
394 ** Wget speaks many languages!
395
396 On systems with gettext(), Wget will output messages in the language
397 set by the current locale, if available.  At this time we support
398 Czech, German, Croatian, Italian, Norwegian and Portuguese.
399
400 ** Opie (Skey) is now supported with FTP.
401
402 ** HTTP Digest Access Authentication (RFC2069) is now supported.
403
404 ** The new `-b' option makes Wget go to background automatically.
405
406 ** The `-I' and `-X' options now accept wildcard arguments.
407
408 ** The `-w' option now accepts suffixes `s' for seconds, `m' for
409 minutes, `h' for hours, `d' for days and `w' for weeks.
410
411 ** Upon getting SIGHUP, the whole previous log is now copied to
412 `wget-log'.
413
414 ** Wget now understands proxy settings with explicit usernames and
415 passwords, e.g. `http://user:password@proxy.foo.com/'.
416
417 ** You can use the new `--cut-dirs' option to make Wget create less
418 directories.
419
420 ** The `;type=a' appendix to FTP URLs is now recognized.  For
421 instance, the following command will retrieve the welcoming message in
422 ASCII type transfer:
423
424     wget "ftp://ftp.somewhere.com/welcome.msg;type=a"
425
426 ** `--help' and `--version' options have been redone to to conform to
427 standards set by other GNU utilities.
428
429 ** Wget should now be compilable under MS Windows environment.  MS
430 Visual C++ and Watcom C have been used successfully.
431
432 ** If the file length is known, percentages are displayed during
433 download.
434
435 ** The manual page, now hopelessly out of date, is no longer
436 distributed with Wget.
437 \f
438 * Wget 1.4.5 is a bugfix release with no user-visible changes.
439 \f
440 * Wget 1.4.4 is a bugfix release with no user-visible changes.
441 \f
442 * Changes in Wget 1.4.3
443
444 ** Wget is now a GNU utility.
445
446 ** Can do passive FTP.
447
448 ** Reads .netrc.
449
450 ** Info documentation expanded.
451
452 ** Compiles on pre-ANSI compilers.
453
454 ** Global wgetrc now goes to /usr/local/etc (i.e. $sysconfdir).
455
456 ** Lots of bugfixes.
457 \f
458 * Changes in Wget 1.4.2
459
460 ** New mirror site at ftp://sunsite.auc.dk/pub/infosystems/wget/,
461 thanks to Karsten Thygesen.
462
463 ** Mailing list!  Mail to wget-request@sunsite.auc.dk to subscribe.
464
465 ** New option --delete-after for proxy prefetching.
466
467 ** New option --retr-symlinks to retrieve symbolic links like plain
468 files.
469
470 ** rmold.pl -- script to remove files deleted on the remote server
471
472 ** --convert-links should work now.
473
474 ** Minor bugfixes.
475 \f
476 * Changes in Wget 1.4.1
477
478 ** Minor bugfixes.
479
480 ** Added -I (the opposite of -X).
481
482 ** Dot tracing is now customizable; try wget --dot-style=binary
483 \f
484 * Changes in Wget 1.4.0
485
486 ** Wget 1.4.0 [formerly known as Geturl] is an extensive rewrite of
487 Geturl.  Although many things look suspiciously similar, most of the
488 stuff was rewritten, like recursive retrieval, HTTP, FTP and mostly
489 everything else.  Wget should be now easier to debug, maintain and,
490 most importantly, use.
491
492 ** Recursive HTTP should now work without glitches, even with Location
493 changes, server-generated directory listings and other naughty stuff.
494
495 ** HTTP regetting is supported on servers that support Range
496 specification. WWW authorization is supported -- try
497 wget http://user:password@hostname/
498
499 ** FTP support was rewritten and widely enhanced. Globbing should now
500 work flawlessly. Symbolic links are created locally. All the
501 information the Unix-style ls listing can give is now recognized.
502
503 ** Recursive FTP is supported, e.g.
504     wget -r ftp://gnjilux.cc.fer.hr/pub/unix/util/
505
506 ** You can specify "rejected" directories, to which you do not want to
507 enter, e.g. with wget -X /pub
508
509 ** Time-stamping is supported, with both HTTP and FTP. Try wget -N URL.
510
511 ** A new texinfo reference manual is provided.  It can be read with
512 Emacs, standalone info, or converted to HTML, dvi or postscript.
513
514 ** Fixed a long-standing bug, so that Wget now works over SLIP
515 connections.
516
517 ** You can have a system-wide wgetrc (/usr/local/lib/wgetrc by
518 default). Settings in $HOME/.wgetrc override the global ones, of
519 course :-)
520
521 ** You can set up quota in .wgetrc to prevent sucking too much
522 data. Try `quota = 5M' in .wgetrc (or quota = 100K if you want your
523 sysadmin to like you).
524
525 ** Download rate is printed after retrieval.
526
527 ** Wget now sends the `Referer' header when retrieving
528 recursively.
529
530 ** With the new --no-parent option Wget can retrieve FTP recursively
531 through a proxy server.
532
533 ** HTML parser, as well as the whole of Wget was rewritten to be much
534 faster and less memory-consuming (yes, both).
535
536 ** Absolute links can be converted to relative links locally. Check
537 wget -k.
538
539 ** Wget catches hangup, filtering the output to a log file and
540 resuming work. Try kill -HUP %?wget.
541
542 ** User-defined headers can be sent.  Try
543
544     wget http://fly.cc.her.hr/ --header='Accept-Charset: iso-8859-2'
545
546 ** Acceptance/Rejection lists may contain wildcards.
547
548 ** Wget can display HTTP headers and/or FTP server response with the
549 new `-S' option.  It can save the original HTTP headers with `-s'.
550
551 ** socks library is now supported (thanks to Antonio Rosella
552 <Antonio.Rosella@agip.it>). Configure with --with-socks.
553
554 ** There is a nicer display of REST-ed output.
555
556 ** Many new options (like -x to force directory hierarchy, or -m to
557 turn on mirroring options).
558
559 ** Wget is now distributed under GNU General Public License (GPL).
560
561 ** Lots of small features I can't remember. :-)
562
563 ** A host of bugfixes.
564 \f
565 * Changes in Geturl 1.3
566
567 ** Added FTP globbing support (ftp://fly.cc.fer.hr/*)
568
569 ** Added support for no_proxy
570
571 ** Added support for ftp://user:password@host/
572
573 ** Added support for %xx in URL syntax
574
575 ** More natural command-line options
576
577 ** Added -e switch to execute .geturlrc commands from the command-line
578
579 ** Added support for robots.txt
580
581 ** Fixed some minor bugs
582 \f
583 * Geturl 1.2 is a bugfix release with no user-visible changes.
584 \f
585 * Changes in Geturl 1.1
586
587 ** REST supported in FTP
588
589 ** Proxy servers supported
590
591 ** GNU getopt used, which enables command-line arguments to be ordered
592 as you wish, e.g.  geturl http://fly.cc.fer.hr/ -vo log is the same as
593 geturl -vo log http://fly.cc.fer.hr/
594
595 ** Netscape-compatible URL syntax for HTTP supported: host[:port]/dir/file
596
597 ** NcFTP-compatible colon URL syntax for FTP supported: host:/dir/file
598
599 ** <base href="xxx"> supported
600
601 ** autoconf supported
602 \f
603 ----------------------------------------------------------------------
604 Copyright information:
605
606 Copyright (C) 1997-2005 Free Software Foundation, Inc.
607
608    Permission is granted to anyone to make or distribute verbatim
609    copies of this document as received, in any medium, provided that
610    the copyright notice and this permission notice are preserved, thus
611    giving the recipient permission to redistribute in turn.
612
613    Permission is granted to distribute modified versions of this
614    document, or of portions of it, under the above conditions,
615    provided also that they carry prominent notices stating who last
616    changed them.