diff --git a/doc/ChangeLog b/doc/ChangeLog index c5614d4a..aec852db 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2008-04-24 Micah Cowan + + * wget.texi: Adjusted documentation to account for CSS support; + added Ted Mielczarek to contributors. + 2008-04-11 Micah Cowan * wget.texi : Added Julien Buty, Alexander diff --git a/doc/wget.texi b/doc/wget.texi index 583c7fcf..95c00d51 100644 --- a/doc/wget.texi +++ b/doc/wget.texi @@ -133,13 +133,13 @@ which can be a great hindrance when transferring a lot of data. @c man end @end ignore @c man begin DESCRIPTION -Wget can follow links in @sc{html} and @sc{xhtml} pages and create local -versions of remote web sites, fully recreating the directory structure of -the original site. This is sometimes referred to as ``recursive -downloading.'' While doing that, Wget respects the Robot Exclusion -Standard (@file{/robots.txt}). Wget can be instructed to convert the -links in downloaded @sc{html} files to the local files for offline -viewing. +Wget can follow links in @sc{html}, @sc{xhtml}, and @sc{css} pages, to +create local versions of remote web sites, fully recreating the +directory structure of the original site. This is sometimes referred to +as ``recursive downloading.'' While doing that, Wget respects the Robot +Exclusion Standard (@file{/robots.txt}). Wget can be instructed to +convert the links in downloaded files to point at the local files, for +offline viewing. @c man end @item @@ -1076,6 +1076,11 @@ re-downloading, you must use @samp{-k} and @samp{-K} so that the original version of the file will be saved as @file{@var{X}.orig} (@pxref{Recursive Retrieval Options}). +As of version 1.12, Wget will also ensure that any downloaded files of +type @samp{text/css} end in the suffix @samp{.css}. Obviously, this +makes the name @samp{--html-extension} misleading; a better name is +expected to be offered as an alternative in the near future. + @cindex http user @cindex http password @cindex authentication @@ -1926,16 +1931,17 @@ GNU Wget is capable of traversing parts of the Web (or a single @sc{http} or @sc{ftp} server), following links and directory structure. We refer to this as to @dfn{recursive retrieval}, or @dfn{recursion}. -With @sc{http} @sc{url}s, Wget retrieves and parses the @sc{html} from -the given @sc{url}, documents, retrieving the files the @sc{html} -document was referring to, through markup like @code{href}, or -@code{src}. If the freshly downloaded file is also of type -@code{text/html} or @code{application/xhtml+xml}, it will be parsed and -followed further. +With @sc{http} @sc{url}s, Wget retrieves and parses the @sc{html} or +@sc{css} from the given @sc{url}, retrieving the files the document +refers to, through markup like @code{href} or @code{src}, or @sc{css} +@sc{uri} values specified using the @samp{url()} functional notation. +If the freshly downloaded file is also of type @code{text/html}, +@code{application/xhtml+xml}, or @code{text/css}, it will be parsed +and followed further. -Recursive retrieval of @sc{http} and @sc{html} content is +Recursive retrieval of @sc{http} and @sc{html}/@sc{css} content is @dfn{breadth-first}. This means that Wget first downloads the requested -@sc{html} document, then the documents linked from that document, then the +document, then the documents linked from that document, then the documents linked by them, and so on. In other words, Wget first downloads the documents at depth 1, then those at depth 2, and so on until the specified maximum depth. @@ -2724,7 +2730,8 @@ Define a header for HTTP downloads, like using @item html_extension = on/off Add a @samp{.html} extension to @samp{text/html} or -@samp{application/xhtml+xml} files without it, like @samp{-E}. +@samp{application/xhtml+xml} files without it, or a @samp{.css} +extension to @samp{text/css} files without it, like @samp{-E}. @item http_keep_alive = on/off Turn the keep-alive feature on or off (defaults to on). Turning it @@ -3086,7 +3093,7 @@ wget -r http://www.gnu.org/ -o gnulog @end example @item -The same as the above, but convert the links in the @sc{html} files to +The same as the above, but convert the links in the downloaded files to point to local files, so you can view the documents off-line: @example @@ -3735,21 +3742,24 @@ Junio Hamano---donated support for Opie and @sc{http} @code{Digest} authentication. @item -Mauro Tortonesi---Improved IPv6 support, adding support for dual +Mauro Tortonesi---improved IPv6 support, adding support for dual family systems. Refactored and enhanced FTP IPv6 code. Maintained GNU Wget from 2004--2007. @item -Christopher G.@: Lewis---Maintenance of the Windows version of GNU WGet. +Christopher G.@: Lewis---maintenance of the Windows version of GNU WGet. @item -Gisle Vanem---Many helpful patches and improvements, especially for +Gisle Vanem---many helpful patches and improvements, especially for Windows and MS-DOS support. @item -Ralf Wildenhues---Contributed patches to convert Wget to use Automake as +Ralf Wildenhues---contributed patches to convert Wget to use Automake as part of its build process, and various bugfixes. +@item +Ted Mielczarek---donated support for CSS. + @item People who provided donations for development---including Brian Gough. @end itemize @@ -3881,6 +3891,7 @@ Andre Majorel, Aurelien Marchand, Matthew J.@: Mellon, Jordan Mendelson, +Ted Mielczarek, Lin Zhe Min, Jan Minar, Tim Mooney,