1 GnuTLS README-alpha -- Information for developers. -*- outline -*-
2 Copyright (C) 2009-2012 Free Software Foundation, Inc.
3 See the end for copying conditions.
5 This file contains instructions for developers and advanced users that
6 want to build from version controlled sources.
8 We require several tools to check out and build the software, including:
10 - Make <http://www.gnu.org/software/make/>
11 - Automake <http://www.gnu.org/software/automake/> (use 1.11.3 or later)
12 - Autoconf <http://www.gnu.org/software/autoconf/>
13 - Autogen <http://www.gnu.org/software/autogen/> (use 5.15pre15 or later)
14 - Libtool <http://www.gnu.org/software/libtool/>
15 - Gettext <http://www.gnu.org/software/gettext/>
16 - Texinfo <http://www.gnu.org/software/texinfo/>
17 - help2man <http://www.gnu.org/software/help2man/>
18 - Tar <http://www.gnu.org/software/tar/>
19 - Gzip <http://www.gnu.org/software/gzip/>
20 - Texlive & epsf <http://www.tug.org/texlive/> (for PDF manual)
21 - CVS <http://www.gnu.org/software/cvs/> (for gettext autopoint)
22 - GTK-DOC <http://www.gtk.org/gtk-doc/> (for API manual)
23 - Git <http://git-scm.com/>
24 - Perl <http://www.cpan.org/>
25 - Valgrind <http://valgrind.org/> (optional)
26 - Nettle <http://www.lysator.liu.se/~nisse/nettle/>
27 - Guile <http://www.gnu.org/software/guile/>
28 - p11-kit <http://p11-glue.freedesktop.org/p11-kit.html>
29 - libtasn1 <http://josefsson.org/libtasn1/> (optional)
30 - datefudge <http://packages.debian.org/datefudge> (optional)
31 - Libidn <http://www.gnu.org/software/libidn/> (optional, for crywrap)
32 - AWK <http://www.gnu.org/software/awk/> (for make dist, pmccabe2html)
33 - git2cl <http://josefsson.org/git2cl/> (for make dist, ChangeLog)
35 The required software is typically distributed with your operating
36 system, and the instructions for installing them differ. Here are
39 gNewSense/Debian/Ubuntu:
40 apt-get install git-core autoconf libtool gettext autopoint
41 apt-get install texinfo texlive texlive-generic-recommended texlive-extra-utils
42 apt-get install help2man gtk-doc-tools valgrind
43 apt-get install guile-1.8-dev libtasn1-3-dev
44 apt-get install datefudge libidn11-dev gawk
46 You will sometimes need to install more recent versions of Automake,
47 Nettle, P11-kit and Autogen, which you will need to build from
48 sources. If your system has the recent versions, you could do:
50 apt-get install automake autogen nettle-dev libp11-kit-dev
52 To download the version controlled sources:
54 $ git clone git://git.savannah.gnu.org/gnutls.git
57 The next step is to run autoreconf (etc) and then ./configure:
61 When built this way, some developer defaults will be enabled. See
64 Then build the project normally:
71 ----------------------------------------------------------------------
72 Copying and distribution of this file, with or without modification,
73 are permitted in any medium without royalty provided the copyright
74 notice and this notice are preserved.