mirror of
https://github.com/moparisthebest/wget
synced 2024-07-03 16:38:41 -04:00
[svn] Added section on dependencies.
This commit is contained in:
parent
119bb2a47f
commit
7c2dfc7ab6
108
INSTALL
108
INSTALL
@ -2,41 +2,69 @@
|
|||||||
GNU Wget Installation Procedure
|
GNU Wget Installation Procedure
|
||||||
===============================
|
===============================
|
||||||
|
|
||||||
0. Preparation
|
0. Introduction
|
||||||
--------------
|
---------------
|
||||||
|
|
||||||
To build GNU Wget from source code and install it on your system, you
|
This document describes how to build Wget from source-code on
|
||||||
need to unpack the archive (which you have presumably done, since you
|
Unix-like systems. If you want to install a precompiled Wget, this
|
||||||
are reading this) and read on. Like most GNU utilities, Wget uses the
|
document is not for you -- refer to the documentation provided by the
|
||||||
GNU Autoconf mechanism for build and installation; users familiar with
|
distributors instead. If you already have Wget and want to learn how
|
||||||
compiling GNU software should feel at home. Please note that
|
to use it, refer to Wget's Info documentation or man page which you
|
||||||
instructions in this file do not concern to installation on Windows,
|
should have received with your system. If you are using Windows
|
||||||
for which see windows/README.
|
(except for Cygwin), read windows/README instead. If you want to
|
||||||
|
compile Wget from source code on a Unix-like system, read on.
|
||||||
|
|
||||||
The system requirements include: a Unix-like system with the utilities
|
The preferred form of building Wget is to get a release archive and
|
||||||
typically shipped with Unix (sh, grep, awk, sed, etc.) and a C
|
unpack it (which you have presumably done, since you are reading
|
||||||
compilation environment, including the compiler, system headers,
|
this). If you have obtained the source code via the Subversion
|
||||||
`make', and so on.
|
repository, please follow the instructions in `README.checkout' before
|
||||||
|
continuing.
|
||||||
|
|
||||||
External dependencies (all optional):
|
1. Dependencies
|
||||||
- OpenSSL, for "https" URLs.
|
---------------
|
||||||
- GNU gettext, for translated messages.
|
|
||||||
|
|
||||||
1. Configuration
|
To build Wget, your system must support a Unix-like command-line
|
||||||
|
development environment, including the text-processing utilities (sh,
|
||||||
|
grep, awk, sed, etc.) and a functional C compiler. On some GNU/Linux
|
||||||
|
systems, this means that you will need to install packages such as
|
||||||
|
`gcc', `glibc-devel' (or `libc6-dev') and `make'. Most systems come
|
||||||
|
with these packages preinstalled, but it doesn't hurt to check. If
|
||||||
|
you have successfully compiled other software from source, you
|
||||||
|
probably have them all.
|
||||||
|
|
||||||
|
In addition to the C development environment, Wget can use a number of
|
||||||
|
optional libraries to provide additional features, such as translated
|
||||||
|
messages and support for "https" URLs. The "external" dependencies
|
||||||
|
include:
|
||||||
|
|
||||||
|
- OpenSSL -- for "https" URLs.
|
||||||
|
- GNU gettext -- for translated messages.
|
||||||
|
|
||||||
|
To be usable for building Wget, the listed libraries must be installed
|
||||||
|
with their "development" header files. On GNU/Linux systems this
|
||||||
|
typically means installing the corredponsing "lib<name>-devel" or
|
||||||
|
"lib<name>-dev" package along with the package with "lib<name>".
|
||||||
|
|
||||||
|
2. Configuration
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
Before compiling Wget, you need to "configure" it using the provided
|
Before compiling Wget, you need to "configure" it using the
|
||||||
`configure' script. Configuration serves two purposes: it enables the
|
`configure' script provided with the distribution. Configuration
|
||||||
compilation system to inspect certain features of your operating
|
serves two distinct purposes: it enables Wget's build system to
|
||||||
system for more robust compilation, and it enables you to choose which
|
inspect certain features of your operating system for more robust
|
||||||
features you want the resulting Wget to have.
|
compilation, and it enables you to choose which features you want the
|
||||||
|
resulting Wget to have.
|
||||||
|
|
||||||
The simplest way to configure Wget is by running the configure script
|
As is the case with most GNU software, Wget's configure script was
|
||||||
provided with the distribution without additional arguments. After
|
generated with GNU Autoconf. If you're not familiar with
|
||||||
running some programming-related tests, it will create the Makefiles
|
Autoconf-generated scripts, read on.
|
||||||
needed to compile Wget. If you have experience with Autoconf-based
|
|
||||||
build systems, you may use the standard arguments such configure
|
The most straightforward way to configure Wget is by running the
|
||||||
scripts take, the most important ones being:
|
configure script without any arguments. After running some
|
||||||
|
compilation-related tests, it will create the Makefiles needed to
|
||||||
|
build Wget. However, you may wish to customize Wget's configuration
|
||||||
|
by providing arguments to `configure'. Wget's configure script
|
||||||
|
accepts standard Autoconf arguments, the most important ones being:
|
||||||
|
|
||||||
--help display a help message and exit
|
--help display a help message and exit
|
||||||
|
|
||||||
@ -46,12 +74,14 @@ scripts take, the most important ones being:
|
|||||||
--infodir=DIR info documentation in DIR [PREFIX/info]
|
--infodir=DIR info documentation in DIR [PREFIX/info]
|
||||||
--mandir=DIR man documentation in DIR [PREFIX/man]
|
--mandir=DIR man documentation in DIR [PREFIX/man]
|
||||||
|
|
||||||
For example, if you are not root and want to install Wget in your home
|
For example, if you are not root and want to install Wget in
|
||||||
directory, you can use:
|
subdirectories of your home directory, you can use:
|
||||||
|
|
||||||
./configure --prefix=$HOME
|
./configure --prefix=$HOME
|
||||||
|
|
||||||
Options beginning with "--disable", such as `--disable-opie' or
|
In addition to the above generic options, Wget's configuration
|
||||||
|
supports a number of options more or less specific to Wget. Options
|
||||||
|
beginning with "--disable", such as `--disable-opie' or
|
||||||
`--disable-ntlm', allow you to turn off certain built-in functionality
|
`--disable-ntlm', allow you to turn off certain built-in functionality
|
||||||
you don't need in order to reduce the size of the executable. Options
|
you don't need in order to reduce the size of the executable. Options
|
||||||
beginning with "--with" turning off autodetection and use of external
|
beginning with "--with" turning off autodetection and use of external
|
||||||
@ -69,13 +99,13 @@ software Wget can link with, such as the SSL libraries. Recognized
|
|||||||
--disable-ipv6 disable IPv6 support
|
--disable-ipv6 disable IPv6 support
|
||||||
--disable-rpath do not hardcode runtime library paths
|
--disable-rpath do not hardcode runtime library paths
|
||||||
|
|
||||||
You can inspect the decisions made by configure by editing the
|
You can inspect decisions made by configure by editing the generated
|
||||||
generated Makefiles and the `src/config.h' include file. The defaults
|
Makefiles and the `src/config.h' include file. The defaults should
|
||||||
should work without intervention, but if you know what you are doing,
|
work without intervention, but if you know what you are doing, editing
|
||||||
editing the generated files before compilation is fine -- they will
|
the generated files before compilation is fine -- they will not be
|
||||||
not be regenerated until you run configure again.
|
regenerated until you run configure again.
|
||||||
|
|
||||||
configure will try to find a compiler in your PATH, defaulting to
|
`configure' will try to find a compiler in your PATH, defaulting to
|
||||||
`gcc', but falling back to `cc' if the former is unavailable. This is
|
`gcc', but falling back to `cc' if the former is unavailable. This is
|
||||||
a reasonable default on most Unix-like systems, but sometimes you
|
a reasonable default on most Unix-like systems, but sometimes you
|
||||||
might want to override it. The compiler choice is overridden by
|
might want to override it. The compiler choice is overridden by
|
||||||
@ -117,7 +147,7 @@ package and rerun configure. If you believe you have the necessary
|
|||||||
headers, but configure still fails to detect the library, please
|
headers, but configure still fails to detect the library, please
|
||||||
report it as a bug.
|
report it as a bug.
|
||||||
|
|
||||||
2. Compilation
|
3. Compilation
|
||||||
--------------
|
--------------
|
||||||
|
|
||||||
To compile GNU Wget after it has been configured, simply type make.
|
To compile GNU Wget after it has been configured, simply type make.
|
||||||
@ -130,7 +160,7 @@ in the src directory. At this point there is no formal test suite for
|
|||||||
testing the binary, but it should be easy enough to test whether the
|
testing the binary, but it should be easy enough to test whether the
|
||||||
basic functionality works.
|
basic functionality works.
|
||||||
|
|
||||||
3. Installation
|
4. Installation
|
||||||
---------------
|
---------------
|
||||||
|
|
||||||
Use `make install' to install GNU Wget to directories specified to
|
Use `make install' to install GNU Wget to directories specified to
|
||||||
|
Loading…
Reference in New Issue
Block a user