-Add privoxy-man-page.sgml, for man page.
[privoxy.git] / doc / source / buildsource.sgml
1 <!--
2  File        :  $Source: /cvsroot/ijbswa/current/doc/source/buildsource.sgml,v $
3
4  Purpose     :  Entity included in other project documents.
5                 
6  $Id: buildsource.sgml,v 1.1 2002/04/04 06:48:37 hal9 Exp $
7
8  Written by and Copyright (C) 2001 the SourceForge
9  Privoxy team. http://www.privoxy.org/
10
11  Based on the Internet Junkbuster originally written
12  by and Copyright (C) 1997 Anonymous Coders and 
13  Junkbusters Corporation.  http://www.junkbusters.com
14
15
16  ======================================================================
17   This file used for inclusion with other documents only.
18  ======================================================================
19
20  If you make changes to this file, please verify the finished 
21  docs all display as intended.
22
23  This file is included into:
24
25   user-manual
26   README
27
28 -->
29
30 <para>
31  There are several ways to install <application>Privoxy</application>.
32 </para>
33
34 <para>
35  To build <application>Privoxy</application> from source, 
36  autoconf and GNU make (gmake) are required. Source is available as gzipped
37  tar archives. For this, first unpack the source: 
38 </para>
39
40 <para>
41  <screen>
42  tar xzvf privoxy-&p-version;<![%p-not-stable;[-beta]]>-src* [.tgz or .tar.gz]
43  cd privoxy-&p-version;<![%p-not-stable;[-beta]]>
44  </screen>
45 </para>
46
47
48 <para>
49  For retrieving the current CVS sources, you'll need the CVS 
50  package installed first. Note CVS source is development quality, 
51  and may not be stable, or well tested. To download CVS source:
52 </para>
53
54 <para>
55  <screen>
56   cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
57   cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa co current
58   cd current
59  </screen>
60 </para>
61
62 <para>
63  This will create a directory named <filename>current/</filename>, which will 
64  contain the source tree.
65 </para>
66
67 <para>
68  Then, in either case, to build from unpacked tarball or CVS source:
69 </para>
70
71 <para>
72  <screen>
73  autoheader
74  autoconf
75  ./configure      (--help to see options)
76  make             (the make from gnu, gmake for *BSD) 
77  su 
78  make -n install  (to see where all the files will go)
79  make install     (to really install)
80  </screen>
81 </para>
82
83 <para>
84  Redhat and SuSE src and binary RPMs can be built with 
85  <quote><command>make redhat-dist</command></quote> or
86  <quote><command>make suse-dist</command></quote> from unpacked sources. You
87  will need to run <quote><command>autoconf; autoheader;
88  ./configure</command></quote> beforehand. *BSD will require gmake (from
89  <ulink url="http://www.gnu.org">http://www.gnu.org</ulink>). 
90  <![%p-readme;[See the user-manual for OS/2 build instructions.]]>
91 </para>
92
93  <![%p-readme;[
94  <para>
95   For binary RPM installation, and other platforms, see the user-manual 
96   as well.
97  </para>
98 ]]>