rebuild docs
[privoxy.git] / doc / webserver / user-manual / installation.html
index 08b74c5..a384626 100644 (file)
       <table border="0" bgcolor="#E0E0E0" width="100%">
         <tr>
           <td>
-            <pre class="SCREEN"> tar xzvf privoxy-3.0.33-beta-src.tar.gz
- cd privoxy-3.0.33-beta</pre>
+            <pre class="SCREEN">  tar xzvf privoxy-3.0.33-beta-src.tar.gz
 cd privoxy-3.0.33-beta</pre>
           </td>
         </tr>
       </table>
       <table border="0" bgcolor="#E0E0E0" width="100%">
         <tr>
           <td>
-            <pre class="SCREEN"> autoheader
- autoconf
- ./configure      # (--help to see options)
- make             # (the make from GNU, sometimes called gmake)
- su               # Possibly required
- make -n install  # (to see where all the files will go)
- make -s install  # (to really install, -s to silence output)</pre>
+            <pre class="SCREEN">  autoheader
 autoconf
 ./configure      # (--help to see options)
 make             # (the make from GNU, sometimes called gmake)
 su               # Possibly required
 make -n install  # (to see where all the files will go)
 make -s install  # (to really install, -s to silence output)</pre>
           </td>
         </tr>
       </table>
       <table border="0" bgcolor="#E0E0E0" width="100%">
         <tr>
           <td>
-            <pre class="SCREEN"> ./configure  --disable-toggle  --disable-editor  --disable-force</pre>
+            <pre class="SCREEN">  ./configure  --disable-toggle  --disable-editor  --disable-force</pre>
           </td>
         </tr>
       </table>
       <table border="0" bgcolor="#E0E0E0" width="100%">
         <tr>
           <td>
-            <pre class="SCREEN"> make -s install  USER=privoxy GROUP=privoxy</pre>
+            <pre class="SCREEN">  make -s install  USER=privoxy GROUP=privoxy</pre>
           </td>
         </tr>
       </table>
           <p>If you want to be able to make a Windows release package, get the NSIS .zip file from <a href=
           "https://sourceforge.net/projects/nsis/files/NSIS%203/" target=
           "_top">https://sourceforge.net/projects/nsis/files/NSIS%203/</a> and extract the NSIS directory to <tt class=
-          "LITERAL">privoxy/windows</tt>. Then edit the windows/GNUmakefile to set the location of the NSIS executable
-          - eg:</p>
+          "LITERAL">/&lt;root-dir&#62;/nsis/</tt>. Then edit the <tt class="FILENAME">windows/GNUmakefile</tt> to set
+          the location of the NSIS executable - eg:</p>
           <table border="0" bgcolor="#E0E0E0" width="100%">
             <tr>
               <td>
-                <pre class="SCREEN"># Path to NSIS
-MAKENSIS = ./nsis/makensis.exe</pre>
+                <pre class="SCREEN">  # Path to NSIS
+  MAKENSIS = /&lt;root-dir&#62;/nsis/makensis.exe</pre>
+              </td>
+            </tr>
+          </table>
+          <p>Get the latest 8.x PCRE code from <a href="https://ftp.pcre.org/pub/pcre/" target="_top">PCRE
+          https://ftp.pcre.org/pub/pcre/</a> and build the static PCRE libraries with</p>
+          <table border="0" bgcolor="#E0E0E0" width="100%">
+            <tr>
+              <td>
+                <pre class="SCREEN">  export CFLAGS="-O2 -fstack-protector-strong -D_FORTIFY_SOURCE=2"
+  export LDFLAGS="-fstack-protector-strong"
+  export CPPFLAGS="-DPCRE_STATIC"
+
+  ./configure  --host=i686-w64-mingw32 \
+               --prefix=/usr/local/i686-w64-mingw32 \
+               --enable-utf  --enable-unicode-properties \
+               --enable-jit \
+               --enable-newline-is-anycrlf \
+               --enable-pcre16 \
+               --enable-pcre32 \
+               --disable-pcregrep-libbz2 \
+               --disable-pcregrep-libz \
+               --disable-pcretest-libreadline \
+               --disable-stack-for-recursion  \
+               --enable-static --disable-shared \
+    &#38;&#38;  make</pre>
+              </td>
+            </tr>
+          </table>
+          <p>If you want to be able to have Privoxy do TLS Inspection, get the latest 2.16.x MBED-TLS library source
+          code from <a href="https://github.com/ARMmbed/mbedtls/tags" target=
+          "_top">https://github.com/ARMmbed/mbedtls/tags</a>, extract the tar file into <tt class=
+          "LITERAL">&lt;root-dir&gt;</tt> and build the static libraries with</p>
+          <table border="0" bgcolor="#E0E0E0" width="100%">
+            <tr>
+              <td>
+                <pre class="PROGRAMLISTING">  export WINDOWS_BUILD=1
+  #  build for a Windows platform
+
+  unset DEBUG
+
+  export CC=i686-w64-mingw32-gcc
+  export LD=i686-w64-mingw32-gcc
+  export CFLAGS="-O2 -fstack-protector-strong -D_FORTIFY_SOURCE=2"
+  export LDFLAGS="${LDFLAGS} -fstack-protector-strong"
+
+  make lib
+  #  build the libraries</pre>
+              </td>
+            </tr>
+          </table>
+          <p>Get the brotli library from <a href="https://github.com/google/brotli/releases" target=
+          "_top">https://github.com/google/brotli/releases</a> and build the static libraries with</p>
+          <table border="0" bgcolor="#E0E0E0" width="100%">
+            <tr>
+              <td>
+                <pre class="PROGRAMLISTING">  ./bootstrap
+  #  to create the GNU autotools files
+
+  autoconf
+
+  export CFLAGS="-O2 -fstack-protector-strong -D_FORTIFY_SOURCE=2"
+  export LDFLAGS="${LDFLAGS} -fstack-protector-strong"
+
+  ./configure  --host=i686-w64-mingw32 \
+               --prefix=/usr/local/i686-w64-mingw32 \
+               --enable-static   \
+               --disable-shared  \
+               --with-gnu-ld     \
+               --disable-silent-rules \
+    &#38;&#38; make</pre>
               </td>
             </tr>
           </table>
@@ -353,10 +423,10 @@ MAKENSIS = ./nsis/makensis.exe</pre>
           <table border="0" bgcolor="#E0E0E0" width="100%">
             <tr>
               <td>
-                <pre class="PROGRAMLISTING">  autoheader              # creates config.h.in
-  autoconf                # uses config.h.in to create the configure shell script
-  ./configure [options]   # creates GNUmakefile
-  make        [options]   # builds the program</pre>
+                <pre class="PROGRAMLISTING">  autoheader              # creates config.h.in
+  autoconf                # uses config.h.in to create the configure shell script
+  ./configure [options]   # creates GNUmakefile
+  make        [options]   # builds the program</pre>
               </td>
             </tr>
           </table>
@@ -370,7 +440,8 @@ MAKENSIS = ./nsis/makensis.exe</pre>
   --enable-zlib
   --enable-static-linking
   --disable-pthread
-  --disable-dynamic-pcre</pre>
+  --with-brotli
+  --with-mbedtls</pre>
               </td>
             </tr>
           </table>
@@ -382,7 +453,7 @@ MAKENSIS = ./nsis/makensis.exe</pre>
                 <pre class="PROGRAMLISTING">  $ export CFLAGS="-O2"              # set gcc optimization level
   $ export LDFLAGS="-Wl,--nxcompat"  # Enable DEP
   $ ./configure --host=i686-w64-mingw32 --enable-mingw32  --enable-zlib \
-  &#62;             --enable-static-linking --disable-pthread --disable-dynamic-pcre
+  &#62;             --enable-static-linking --disable-pthread
   $ make                             # build Privoxy</pre>
               </td>
             </tr>