X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;f=doc%2Fsource%2Fbuildsource.sgml;h=ea3307469bdd2c596b214b97e5d2a6f74dd2cc2b;hb=960d3269ce383ec973a905afe63c37a87c38ca76;hp=afc2c6b9582fd88e76d1e06ad5046ad1f2828cbf;hpb=0428133610c525457cb16f7ac6a54203a2743d6c;p=privoxy.git diff --git a/doc/source/buildsource.sgml b/doc/source/buildsource.sgml index afc2c6b9..ea330746 100644 --- a/doc/source/buildsource.sgml +++ b/doc/source/buildsource.sgml @@ -1,11 +1,9 @@ first unpack the source: + + first unpack the source: - - + tar xzvf privoxy-&p-version;-src.tar.gz cd privoxy-&p-version; - - For retrieving the current CVS sources, you'll need a CVS client installed. - Note that sources from CVS are typically development quality, and may not be - stable, or well tested. To download CVS source, check the Sourceforge - documentation, which might give commands like: + To build the development version, you can get the source code by doing: - - - cvs -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa login - cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co current - cd current + + cd <root-dir> + git clone https://www.privoxy.org/git/privoxy.git - - This will create a directory named current/, which will - contain the source tree. + This will create a directory named <root-dir>/privoxy/, + which will contain the source tree. + Note that source code in GIT is development quality, and may not be + stable or well tested. + + + - It is also strongly recommended to not run Privoxy + It is strongly recommended to not run Privoxy as root. You should configure/install/run Privoxy as - an unprivileged user, preferably by creating a privoxy user + an unprivileged user, preferably by creating a privoxy user and group just for this purpose. See your local documentation for the correct command line to do add new users and groups (something like adduser, but the command syntax may vary from platform @@ -88,17 +81,13 @@ /etc/passwd might then look like: - privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell - And then /etc/group, like: - privoxy:*:7777: - Some binary packages may do this for you. @@ -108,7 +97,6 @@ Then, to build from either unpacked tarball or CVS source: - autoheader autoconf @@ -117,18 +105,15 @@ su # Possibly required make -n install # (to see where all the files will go) make -s install # (to really install, -s to silence output) - Using GNU make, you can have the first four steps automatically done for you by just typing: - make - in the freshly downloaded or unpacked source directory. @@ -139,13 +124,10 @@ users cannot easily bypass the proxy (e.g. Go There Anyway), or alter their own configurations, configure like this: - ./configure --disable-toggle --disable-editor --disable-force - -Then build as above. In Privoxy 3.0.7 and later, all of these options -can also be disabled through the configuration file. + Note that all of these options can also be disabled through the configuration file. WARNING: If installing as root, the install will fail @@ -171,10 +153,8 @@ can also be disabled through the configuration file. on the make command line, but be sure both already exist: - make -s install USER=privoxy GROUP=privoxy - The default installation path for make install is @@ -241,7 +221,7 @@ can also be disabled through the configuration file. For more detailed instructions on how to build Redhat RPMs, Windows self-extracting installers, building on platforms with special requirements etc, please consult the developer manual. + url="https://www.privoxy.org/developer-manual/newrelease.html">developer manual.