]> sjero.net Git - wget/blob - README
Mention PathGuidelines link in README file.
[wget] / README
1                                                           -*- text -*-
2 GNU Wget
3 ========
4                   Current Web home: http://www.gnu.org/software/wget/
5
6 GNU Wget is a free utility for non-interactive download of files from
7 the Web.  It supports HTTP, HTTPS, and FTP protocols, as well as
8 retrieval through HTTP proxies.
9
10 It can follow links in HTML pages and create local versions of remote
11 web sites, fully recreating the directory structure of the original
12 site.  This is sometimes referred to as "recursive downloading."
13 While doing that, Wget respects the Robot Exclusion Standard
14 (/robots.txt).  Wget can be instructed to convert the links in
15 downloaded HTML files to the local files for offline viewing.
16
17 Recursive downloading also works with FTP, where Wget can retrieves a
18 hierarchy of directories and files.
19
20 With both HTTP and FTP, Wget can check whether a remote file has
21 changed on the server since the previous run, and only download the
22 newer files.
23
24 Wget has been designed for robustness over slow or unstable network
25 connections; if a download fails due to a network problem, it will
26 keep retrying until the whole file has been retrieved.  If the server
27 supports regetting, it will instruct the server to continue the
28 download from where it left off.
29
30 If you are behind a firewall that requires the use of a socks style
31 gateway, you can get the socks library and compile wget with support
32 for socks.
33
34 Most of the features are configurable, either through command-line
35 options, or via initialization file .wgetrc.  Wget allows you to
36 install a global startup file (/usr/local/etc/wgetrc by default) for
37 site settings.
38
39 Wget works under almost all Unix variants in use today and, unlike
40 many of its historical predecessors, is written entirely in C, thus
41 requiring no additional software, such as Perl.  The external software
42 it does work with, such as OpenSSL, is optional.  As Wget uses the GNU
43 Autoconf, it is easily built on and ported to new Unix-like systems.
44 The installation procedure is described in the INSTALL file.
45
46 As with other GNU software, the latest version of Wget can be found at
47 the master GNU archive site ftp.gnu.org, and its mirrors.  Wget
48 resides at <ftp://ftp.gnu.org/pub/gnu/wget/>.
49
50 Please report bugs in Wget to <bug-wget@gnu.org>.
51
52 See the file `MAILING-LIST' for information about Wget mailing lists.
53 Wget's home page is at <http://www.gnu.org/software/wget/>.
54
55 If you would like to contribute code for Wget, please read
56 http://wget.addictivecode.org/PatchGuidelines.
57
58 MAINTAINER: Micah Cowan <micah@cowan.name>
59
60 Wget was originally written and mainained by Hrvoje Niksic.  Please see
61 the file AUTHORS for a list of major contributors, and the ChangeLogs
62 for a detailed listing of all contributions.
63
64
65 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004
66 2005, 2006, 2007 Free Software Foundation, Inc.
67
68 This program is free software; you can redistribute it and/or modify
69 it under the terms of the GNU General Public License as published by
70 the Free Software Foundation; either version 3 of the License, or
71 (at your option) any later version.
72
73 This program is distributed in the hope that it will be useful,
74 but WITHOUT ANY WARRANTY; without even the implied warranty of
75 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
76 GNU General Public License for more details.
77
78 You should have received a copy of the GNU General Public License
79 along with this program; if not, write to the Free Software
80 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
81 USA.
82
83 In addition, as a special exception, the Free Software Foundation
84 gives permission to link the code of its release of Wget with the
85 OpenSSL project's "OpenSSL" library (or with modified versions of it
86 that use the same license as the "OpenSSL" library), and distribute
87 the linked executables.  You must obey the GNU General Public License
88 in all respects for all of the code used other than "OpenSSL".  If you
89 modify this file, you may extend this exception to your version of the
90 file, but you are not obligated to do so.  If you do not wish to do
91 so, delete this exception statement from your version.