]> sjero.net Git - wget/blob - README.checkout
Updated README.checkout (lynx -dump from wiki).
[wget] / README.checkout
1 Compiling From Repository Sources
2
3    To reduce bandwidth and needless updates, the source code repository
4    does not contain automatically-generated files, even when these are
5    normally present in the distribution tarballs. Therefore, to build GNU
6    Wget from the sources in the repository, you'll need to have one or
7    more of the following (note that gettext, OpenSSL, libidn and libiconv
8    are not absolutely required):
9
10      * [20]autoconf (currently, GNU Wget requires version 2.61). This is
11        needed to generate the configure script from configure.in. This is
12        not required when building from a tarball distribution; only when
13        building from repository sources.
14
15      * [21]automake (currently, GNU Wget requires version 1.10.1). This is
16        needed for generating the Makefile.in templates that the configure
17        script uses to generate the Makefiles. As with autoconf, it is not
18        required when building from a tarball distribution; only when
19        building from repository sources.
20
21      * [22]flex is needed to generate the CSS-parsing code.
22
23      * [23]Perl, if you wish to generate the wget(1) manpage, or run the
24        tests in the tests/ sub directory. Tarball distributions include an
25        already-generated wget.1 manual. The command "make check" runs the
26        test suite written in perl. To execute all the tests you need
27        [24]libwww-perl perl library. If "perl -MCPAN -e 'install
28        Bundle::LWP'" fails then you most likely don't have cpan module
29        installed. First download [25]CPAN and [26]install it. Then execute
30        "perl -MCPAN -e 'install Bundle::LWP'". Now "make check" should
31        pass most of the tests in the test suite.
32
33      * [27]texinfo in order to generate Info, PostScript and/or HTML
34        documentation. You don't need texinfo in order to generate the
35        wget(1) manpage; however, note that the manpage does not include
36        the full documentation. Tarball distributions include the
37        already-generated documentation in these formats.
38
39      * [28]gettext, if you wish to compile with NLS (Native Language
40        Support), which is enabled by default. If you do not have gettext,
41        you can compile without it by specifying --disable-nls to the
42        ./configure script. This is true regardless of where you obtained
43        the source you're building. NOTE: if you get errors about
44        AM_GNU_GETTEXT and/or AM_INTL_SUBDIR, you probably have a buggy
45        version of GNU m4. Upgrade to the latest version. You may also need
46        to export M4=<new m4 path>, to be sure that autoconf/automake use
47        it instead of the old one.
48
49      * [29]OpenSSL to handle encrypted web sessions. You almost certainly
50        want this. It is not enough to have the library installed; you need
51        to have the header files available to compile against as well. For
52        GNU/Linux systems, this usually means installing a "developer"
53        package for openssl (for example, [30]Debian systems require
54        installation of the libssl-dev package). Alternatively, you can
55        compile GNU Wget against the [31]GNUTLS library instead, by
56        specifying --with-ssl=gnutls to the ./configure script; however,
57        building against GNUTLS is currently experimental, and not
58        officially supported. If you have OpenSSL and its development
59        headers installed, but don't want to build Wget with it, specify
60        --without-ssl to the ./configure script.
61
62      * [32]libidn is required for IDN/IRI support (non-ASCII characters
63        within what would otherwise be URLs).
64
65      * [33]libiconv is required on non-GNU systems, for IDN/IRI support.
66        On GNU systems, the functionality provided by libiconv is already
67        present in the system libraries.
68
69    For those who might be confused as to what to do once they check out
70    the source code, considering configure and Makefile do not yet exist at
71    that point, a shell script called autogen.sh has been provided. After
72    calling ./autogen.sh you're ready to build GNU Wget in the normal
73    fashion, with ./configure and make.
74
75    So, to sum up, after checking out the source code as described above,
76    you may proceed as follows:
77     1. Change to the topmost GNU Wget directory:
78  $  cd wget        # assumes you've cloned a repository to "./wget"
79     2. Generate all the automatically-generated files required prior to
80        configuring the package:
81  $  ./autogen.sh
82     3. Configure the package and compile it:
83  $  ./configure [some_parameters]
84  $  make
85     4. Hack, compile, test, hack, compile, test...
86  $  src/wget --version
87  GNU Wget 1.12-devel (9cb2563197bc)
88
89  Copyright © 2008 Free Software Foundation, Inc.
90  License GPLv3+: GNU GPL version 3 or later
91  <http://www.gnu.org/licenses/gpl.html>.
92  This is free software: you are free to change and redistribute it.
93  There is NO WARRANTY, to the extent permitted by law.
94
95  Originally written by Hrvoje Niksic <hniksic@xemacs.org>.
96  Currently maintained by Micah Cowan <micah@cowan.name>.
97
98    CompilingRepoSources (last edited 2009-09-21 18:36:34 by
99    [34]MicahCowan)
100
101      * [35]Edit
102      * [36]Comments
103      * [37]Info
104      * [38]Attachments
105      * More Actions:
106        [Raw Text................] Do
107
108      * [39]MoinMoin Powered
109      * [40]Python Powered
110      * [41]GPL licensed
111      * [42]Valid HTML 4.01
112      __________________________________________________________________
113
114    All content © 2007 Free Software Foundation. For terms of use,
115    redistribution, and modification, please see the [43]WikiLicense page.
116
117 References
118
119   20. http://www.gnu.org/software/autoconf/
120   21. http://www.gnu.org/software/automake/
121   22. http://flex.sourceforge.net/
122   23. http://www.perl.org/
123   24. http://search.cpan.org/dist/libwww-perl/lib/Bundle/LWP.pm
124   25. http://search.cpan.org/CPAN/authors/id/A/AN/ANDK/CPAN-1.9402.tar.gz
125   26. http://apthorpe.cynistar.net/code/configuring_cpan.html
126   27. http://www.gnu.org/software/texinfo/
127   28. http://www.gnu.org/software/gettext/
128   29. http://www.openssl.org/
129   30. http://www.debian.org/
130   31. http://www.gnu.org/software/gnutls/
131   32. http://www.gnu.org/software/libidn/
132   33. http://www.gnu.org/software/libiconv/
133   34. http://wget.addictivecode.org/MicahCowan
134   35. http://wget.addictivecode.org/CompilingRepoSources?action=edit&editor=text
135   36. http://wget.addictivecode.org/CompilingRepoSources
136   37. http://wget.addictivecode.org/CompilingRepoSources?action=info
137   38. http://wget.addictivecode.org/CompilingRepoSources?action=AttachFile
138   39. http://moinmo.in/
139   40. http://moinmo.in/Python
140   41. http://moinmo.in/GPL
141   42. http://validator.w3.org/check?uri=referer
142   43. http://wget.addictivecode.org/WikiLicense