1
0
mirror of https://github.com/moparisthebest/wget synced 2024-07-03 16:38:41 -04:00

Adjust manual to account for CSS support.

This commit is contained in:
Micah Cowan 2008-04-24 16:48:46 -07:00
parent ce983c8421
commit f394450be6
2 changed files with 37 additions and 21 deletions

View File

@ -1,3 +1,8 @@
2008-04-24 Micah Cowan <micah@cowan.name>
* wget.texi: Adjusted documentation to account for CSS support;
added Ted Mielczarek to contributors.
2008-04-11 Micah Cowan <micah@cowan.name>
* wget.texi <Contributors>: Added Julien Buty, Alexander

View File

@ -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,