Add a FAQ entry for tainted sockets
[privoxy.git] / doc / source / developer-manual.sgml
index ce6aa42..f6b892d 100644 (file)
@@ -5,7 +5,7 @@
 <!entity p-intro SYSTEM "privoxy.sgml">
 <!entity history SYSTEM "history.sgml">
 <!entity seealso SYSTEM "seealso.sgml">
-<!entity p-version "3.0.22">
+<!entity p-version "3.0.25">
 <!entity p-status "UNRELEASED">
 <!entity % p-not-stable "INCLUDE">
 <!entity % p-stable "IGNORE">
@@ -21,9 +21,9 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
 
- $Id: developer-manual.sgml,v 2.57 2013/03/01 17:44:24 fabiankeil Exp $
+ $Id: developer-manual.sgml,v 2.66 2016/02/02 13:08:55 fabiankeil Exp $
 
- Copyright (C) 2001-2012 Privoxy Developers http://www.privoxy.org/
+ Copyright (C) 2001-2016 Privoxy Developers http://www.privoxy.org/
  See LICENSE.
 
  ========================================================================
     <!-- Completely the wrong markup, but very little is allowed  -->
     <!-- in this part of an article. FIXME -->
       <ulink url="http://www.privoxy.org/user-manual/copyright.html">Copyright</ulink>
-      &my-copy; 2001-2013 by
+      &my-copy; 2001-2016 by
       <ulink url="http://www.privoxy.org/">Privoxy Developers</ulink>
      </subscript>
     </pubdate>
 
 
-    <pubdate>$Id: developer-manual.sgml,v 2.57 2013/03/01 17:44:24 fabiankeil Exp $</pubdate>
+    <pubdate>$Id: developer-manual.sgml,v 2.66 2016/02/02 13:08:55 fabiankeil Exp $</pubdate>
 
 <!--
 
@@ -1979,24 +1979,7 @@ Install the rpm. Any error messages?
         </orderedlist>
 </para>
     </sect2>
-
-    <!--   ~~~~~       New section      ~~~~~     -->
-    <sect2 id="testing-report"><title>Test reports</title>
-      <para>
-Please submit test reports only with the <ulink url="http://sourceforge.net/tracker/?func=add&amp;group_id=11118&amp;atid=395005">test form</ulink>
-at sourceforge. Three simple steps:
-        <itemizedlist>
-
-          <listitem><para>Select category: the distribution you test on.</para></listitem>
-          <listitem><para>Select group: the version of <application>Privoxy</application> that we are about to release.</para></listitem>
-          <listitem><para>Fill the Summary and Detailed Description with something
-              intelligent (keep it short and precise).</para>
-          </listitem>
-        </itemizedlist>
-        Do not mail to the mailing list (we cannot keep track on issues there).
-      </para>
-    </sect2>
-
+    <!-- XXX: Document how to write test reports and where to send them -->
   </sect1>
 
   <!--   ~~~~~       New section      ~~~~~     -->
@@ -2563,9 +2546,9 @@ at sourceforge. Three simple steps:
 
     <sect3 id="newrelease-windows"><title>Windows</title>
       <para>
-        You should ensure you have the latest version of Cygwin (from
-        <ulink url="http://www.cygwin.com/">http://www.cygwin.com/</ulink>).
-        Run the following commands from within a Cygwin bash shell.
+        Use the <ulink url="http://www.fruitbat.org/Cygwin/index.html#cygwincirca">
+        Cygwin Time Machine</ulink> to install the last 1.5 version of Cygwin.
+        Run the following commands from within the Cygwin 1.5 bash shell.
       </para>
       <para>
         First, <emphasis>make sure that you have freshly exported the right
@@ -2736,114 +2719,10 @@ at sourceforge. Three simple steps:
 
     <sect3 id="newrelease-freebsd"><title>FreeBSD</title>
       <para>
-        Login to Sourceforge's compile-farm via ssh:
-      </para>
-      <para>
-        <programlisting>
-  ssh cf.sourceforge.net
-</programlisting>
-      </para>
-      <para>
-        Choose the right operating system.
-        When logged in, <emphasis>make sure that you have freshly exported the right
-        version into an empty directory</emphasis>. (See "Building and releasing
-        packages" above). Then run:
-      </para>
-      <para>
-        <programlisting>
-  cd current
-  autoheader && autoconf && ./configure
-</programlisting>
-      </para>
-      <para>
-        Then run:
-      </para>
-      <para>
-        <programlisting>
-  gmake freebsd-dist
-</programlisting>
-      </para>
-      <para>
-        which creates a gzip'ed tar archive. Sadly, you cannot use <command>make
-        freebsd-upload</command> on the Sourceforge machine (no ncftpput). You now have
-        to manually upload the archive to Sourceforge's ftp server and release
-        the file publicly. Use the release notes and Change Log from the
-        source tarball package.
-      </para>
-    </sect3>
-
-    <sect3 id="newrelease-hpux"><title>HP-UX 11</title>
-      <para>
-        First, <emphasis>make sure that you have freshly exported the right
-        version into an empty directory</emphasis>. (See "Building and releasing
-        packages" above). Then run:
-      </para>
-      <para>
-        <programlisting>
-  cd current
-  autoheader && autoconf && ./configure
-</programlisting>
-      </para>
-      <para>
-        Then do FIXME.
-      </para>
-    </sect3>
-
-    <sect3 id="newrelease-amiga"><title>Amiga OS</title>
-      <para>
-        First, <emphasis>make sure that you have freshly exported the right
-        version into an empty directory</emphasis>. (See "Building and releasing
-        packages" above). Then run:
-      </para>
-      <para>
-        <programlisting>
-  cd current
-  autoheader && autoconf && ./configure
-</programlisting>
-      </para>
-      <para>
-        Then do FIXME.
-      </para>
-    </sect3>
-
-    <sect3 id="newrelease-aix"><title>AIX</title>
-      <para>
-        Login to Sourceforge's compilefarm via ssh:
-      </para>
-      <para>
-        <programlisting>
-  ssh cf.sourceforge.net
-</programlisting>
-      </para>
-      <para>
-        Choose the right operating system.
-        When logged in, <emphasis>make sure that you have freshly exported the right
-        version into an empty directory</emphasis>. (See "Building and releasing
-        packages" above). Then run:
-      </para>
-      <para>
-        <programlisting>
-  cd current
-  autoheader && autoconf && ./configure
-</programlisting>
-      </para>
-      <para>
-        Then run:
-      </para>
-      <para>
-        <programlisting>
-  make aix-dist
-</programlisting>
-      </para>
-      <para>
-        which creates a gzip'ed tar archive. Sadly, you cannot use <command>make
-        aix-upload</command> on the Sourceforge machine (no ncftpput). You now have
-        to manually upload the archive to Sourceforge's ftp server and release
-        the file publicly. Use the release notes and Change Log from the
-        source tarball package.
+        Update the www/privoxy port and submit a diff upstream.
+        For details see the <ulink url="https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/">FreeBSD Porter's Handbook</ulink>.
       </para>
     </sect3>
-   </sect2>
 
    <sect2 id="releasing">
    <title>Uploading and Releasing Your Package</title>