*********************************************************************/
-This README is included with the development version of Privoxy 2.9.13, which
+This README is included with the development version of Privoxy 2.9.14, which
will eventually become Privoxy v3.0 (and soon we hope!). See http://
www.privoxy.org/ for more information. The current code level is beta, and
seems stable to us :).
To build Privoxy from source, autoconf and GNU make (gmake) are required.
Source is available as gzipped tar archives. For this, first unpack the source:
- tar xzvf privoxy-2.9.13-beta-src* [.tgz or .tar.gz]
- cd privoxy-2.9.13-beta
+ tar xzvf privoxy-2.9.14-beta-src* [.tgz or .tar.gz]
+ cd privoxy-2.9.14-beta
For retrieving the current CVS sources, you'll need the CVS package installed
We value your feedback. However, to provide you with the best support, please
note:
- * Use the Sourceforge Support Forum to get help:
+ * Use the Sourceforge Support Forum to get help:
http://sourceforge.net/tracker/?group_id=11118&atid=211118
- * Submit bugs only through our Sourceforge Bug Forum:
+ * Submit bugs only through our Sourceforge Bug Forum:
http://sourceforge.net/tracker/?group_id=11118&atid=111118.
platform, browser, any pertinent log data, any other relevant details
(please be specific) and, if possible, some way to reproduce the bug.
- * Submit feature requests only through our Sourceforge feature request forum:
+ * Submit feature requests only through our Sourceforge feature request forum:
http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse.
- * Submit missed ads and banners, and incorrectly blocked images, popups, etc:
-
- http://p.p/, and select "actions file feedback system"
+ * You can also send feedback on websites that Privoxy has problems with. Please bookmark
+ the following link: "Privoxy - Submit Filter Feedback"
+ . Once you surf to a page with problems, use the
+ bookmark to send us feedback. We will look into the issue as soon as possible.
- This page can also be reached from many of the internal CGI pages.
-
- * For any other issues, feel free to use the mailing lists:
+ * For any other issues, feel free to use the mailing lists:
http://sourceforge.net/mail/?group_id=11118.
Anyone interested in actively participating in development and related
discussions can also join the appropriate mailing list. Archives are
- available too.
+ available, too.
-------------------------------------------------------------------------
ijbswa-developers@lists.sourceforge.net
-$Id: readme.sgml,v 1.6 2002/04/08 22:59:26 hal9 Exp $
+$Id: readme.sgml,v 1.8 2002/04/12 10:09:50 swa Exp $
By: Privoxy Developers
-$Id: developer-manual.sgml,v 1.31 2002/04/11 09:32:52 oes Exp $
+$Id: developer-manual.sgml,v 1.33 2002/04/12 03:49:53 hal9 Exp $
The developer manual gives the users information on how to help the developer
team. It provides guidance on coding, testing, documentation and other issues.
For the time being (read, this section is under construction), please note the
following guidelines for changing stuff in the code. If it is
- 1. A bug-fix / clean-up / cosmetic thing: shoot
+ 1. A bugfix / clean-up / cosmetic thing: shoot
2. A new feature that can be turned off: shoot
5. A major redesign of some part of the code: ask the list
+Note that near a major public release, we get a bit more cautious - if unsure,
+it doesn't hurt to ask first.
+
-------------------------------------------------------------------------------
4. Documentation Guidelines
doc/text/ and to update all HTML documents in doc/webserver/.
Documentation writers should please make sure documents build successfully
-before committing to CVS.
+before committing to CVS, if possible.
How do you update the webserver (i.e. the pages on privoxy.org)?
Some common elements that you likely will use:
-<para></para>, paragraph delimiter. Most text needs to be within paragraph
-elements (there are some exceptions).
-<emphasis></emphasis>, the stylesheets make this italics.
-<filename></filename>, files and directories.
-<command></command>, command examples.
-<literallayout></literallayout>, like <pre>, more or less.
-<itemizedlist></itemizedlist>, list with bullets.
-<listitem></listitem>, member of the above.
-<screen></screen>, screen output, implies <literallayout>.
-<ulink url="example.com"></ulink>, like HTML <a> tag.
-<quote></quote>, for, doh, quoting text.
+, paragraph delimiter. Most text needs to be within paragraph elements (there
+are some exceptions).
+, the stylesheets make this italics.
+, files and directories.
+, command examples.
+, like
+, more or less.
+, list with bullets.
+, member of the above.
+, screen output, implies .
+, like HTML tag.
+, for, doh, quoting text.
Look at any of the existing docs for examples of all these and more.
Example:
-#include <iostream.h> /* This is not a local include */
+#include /* This is not a local include */
#include "config.h" /* This IS a local include */
Exception:
/* This is not a local include, but requires a path element. */
-#include <sys/fileName.h>
+#include
Note: Please! do not add "-I." to the Makefile without a _very_ good reason.
This duplicates the #include "file.h" behavior.
Example for file comments:
-const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.31 2002/04/11 09:32:52 oes Exp $";
-/*********************************************************************
- *
- * File : $Source$
- *
- * Purpose : (Fill me in with a good description!)
- *
- * Copyright : Written by and Copyright (C) 2001 the SourceForge
- * Privoxy team. http://www.privoxy.org/
- *
- * Based on the Internet Junkbuster originally written
- * by and Copyright (C) 1997 Anonymous Coders and
- * Junkbusters Corporation. http://www.junkbusters.com
- *
- * This program is free software; you can redistribute it
- * and/or modify it under the terms of the GNU General
- * Public License as published by the Free Software
- * Foundation; either version 2 of the License, or (at
- * your option) any later version.
- *
- * This program is distributed in the hope that it will
- * be useful, but WITHOUT ANY WARRANTY; without even the
- * implied warranty of MERCHANTABILITY or FITNESS FOR A
- * PARTICULAR PURPOSE. See the GNU General Public
- * License for more details.
- *
- * The GNU General Public License should be included with
- * this file. If not, you can view it at
- * http://www.gnu.org/copyleft/gpl.html
- * or write to the Free Software Foundation, Inc., 59
- * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
- *
- * Revisions :
- * $Log$
- *
- *********************************************************************/
-
-
-#include "config.h"
-
- ...necessary include files for us to do our work...
-
-const char FILENAME_h_rcs[] = FILENAME_H_VERSION;
+const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.33 2002/04/12 03:49:53 hal9 Exp $";
+/*********************************************************************
+ *
+ * File : $Source$
+ *
+ * Purpose : (Fill me in with a good description!)
+ *
+ * Copyright : Written by and Copyright (C) 2001 the SourceForge
+ * Privoxy team. http://www.privoxy.org/
+ *
+ * Based on the Internet Junkbuster originally written
+ * by and Copyright (C) 1997 Anonymous Coders and
+ * Junkbusters Corporation. http://www.junkbusters.com
+ *
+ * This program is free software; you can redistribute it
+ * and/or modify it under the terms of the GNU General
+ * Public License as published by the Free Software
+ * Foundation; either version 2 of the License, or (at
+ * your option) any later version.
+ *
+ * This program is distributed in the hope that it will
+ * be useful, but WITHOUT ANY WARRANTY; without even the
+ * implied warranty of MERCHANTABILITY or FITNESS FOR A
+ * PARTICULAR PURPOSE. See the GNU General Public
+ * License for more details.
+ *
+ * The GNU General Public License should be included with
+ * this file. If not, you can view it at
+ * http://www.gnu.org/copyleft/gpl.html
+ * or write to the Free Software Foundation, Inc., 59
+ * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ *
+ * Revisions :
+ * $Log$
+ *
+ *********************************************************************/
+
+
+#include "config.h"
+
+ ...necessary include files for us to do our work...
+
+const char FILENAME_h_rcs[] = FILENAME_H_VERSION;
Note: This declares the rcs variables that should be added to the
"show-proxy-args" page. If this is a brand new creation by you, you are free to
Example for file header comments:
-#ifndef _FILENAME_H
-#define _FILENAME_H
-#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.31 2002/04/11 09:32:52 oes Exp $"
-/*********************************************************************
- *
- * File : $Source$
- *
- * Purpose : (Fill me in with a good description!)
- *
- * Copyright : Written by and Copyright (C) 2001 the SourceForge
- * Privoxy team. http://www.privoxy.org/
- *
- * Based on the Internet Junkbuster originally written
- * by and Copyright (C) 1997 Anonymous Coders and
- * Junkbusters Corporation. http://www.junkbusters.com
- *
- * This program is free software; you can redistribute it
- * and/or modify it under the terms of the GNU General
- * Public License as published by the Free Software
- * Foundation; either version 2 of the License, or (at
- * your option) any later version.
- *
- * This program is distributed in the hope that it will
- * be useful, but WITHOUT ANY WARRANTY; without even the
- * implied warranty of MERCHANTABILITY or FITNESS FOR A
- * PARTICULAR PURPOSE. See the GNU General Public
- * License for more details.
- *
- * The GNU General Public License should be included with
- * this file. If not, you can view it at
- * http://www.gnu.org/copyleft/gpl.html
- * or write to the Free Software Foundation, Inc., 59
- * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
- *
- * Revisions :
- * $Log$
- *
- *********************************************************************/
-
-
-#include "project.h"
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
- ... function headers here ...
-
-
-/* Revision control strings from this header and associated .c file */
-extern const char FILENAME_rcs[];
-extern const char FILENAME_h_rcs[];
-
-
-#ifdef __cplusplus
-} /* extern "C" */
-#endif
-
-#endif /* ndef _FILENAME_H */
-
-/*
- Local Variables:
- tab-width: 3
- end:
-*/
+#ifndef _FILENAME_H
+#define _FILENAME_H
+#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.33 2002/04/12 03:49:53 hal9 Exp $"
+/*********************************************************************
+ *
+ * File : $Source$
+ *
+ * Purpose : (Fill me in with a good description!)
+ *
+ * Copyright : Written by and Copyright (C) 2001 the SourceForge
+ * Privoxy team. http://www.privoxy.org/
+ *
+ * Based on the Internet Junkbuster originally written
+ * by and Copyright (C) 1997 Anonymous Coders and
+ * Junkbusters Corporation. http://www.junkbusters.com
+ *
+ * This program is free software; you can redistribute it
+ * and/or modify it under the terms of the GNU General
+ * Public License as published by the Free Software
+ * Foundation; either version 2 of the License, or (at
+ * your option) any later version.
+ *
+ * This program is distributed in the hope that it will
+ * be useful, but WITHOUT ANY WARRANTY; without even the
+ * implied warranty of MERCHANTABILITY or FITNESS FOR A
+ * PARTICULAR PURPOSE. See the GNU General Public
+ * License for more details.
+ *
+ * The GNU General Public License should be included with
+ * this file. If not, you can view it at
+ * http://www.gnu.org/copyleft/gpl.html
+ * or write to the Free Software Foundation, Inc., 59
+ * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ *
+ * Revisions :
+ * $Log$
+ *
+ *********************************************************************/
+
+
+#include "project.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+ ... function headers here ...
+
+
+/* Revision control strings from this header and associated .c file */
+extern const char FILENAME_rcs[];
+extern const char FILENAME_h_rcs[];
+
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif
+
+#endif /* ndef _FILENAME_H */
+
+/*
+ Local Variables:
+ tab-width: 3
+ end:
+*/
Example for function comments:
8.6. Windows
-Ensure that you have the latest code version. Hence run
+You should ensure you have the latest version of Cygwin (from http://
+www.cygwin.com/). Run the following commands from within a Cygwin bash shell.
- cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
- cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa export -r v_X_Y_Z current
- cd current
+First check out a clean copy of the correct code version, by running:
+
+ mkdir dist
+ cd dist
+ cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
+ cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa export -r v_X_Y_Z .
-Run:
+(Note: It is important that this is a clean copy of the code, do not re-use a
+working directory after you have manually compiled there).
- autoheader && autoconf && ./configure
+Then you can build the package. This is fully automated, and is controlled by
+winsetup/GNUmakefile. All you need to do is:
+
+ cd winsetup
+ make
-Then do FIXME.
+Now you can manually rename privoxy_setup.exe to privoxy_setup_X_Y_Z.exe, and
+upload it to SourceForge.
-------------------------------------------------------------------------------
We value your feedback. However, to provide you with the best support, please
note:
- * Use the Sourceforge Support Forum to get help:
+ * Use the Sourceforge Support Forum to get help:
http://sourceforge.net/tracker/?group_id=11118&atid=211118
- * Submit bugs only through our Sourceforge Bug Forum:
+ * Submit bugs only through our Sourceforge Bug Forum:
http://sourceforge.net/tracker/?group_id=11118&atid=111118.
platform, browser, any pertinent log data, any other relevant details
(please be specific) and, if possible, some way to reproduce the bug.
- * Submit feature requests only through our Sourceforge feature request forum:
+ * Submit feature requests only through our Sourceforge feature request forum:
http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse.
- * Submit missed ads and banners, and incorrectly blocked images, popups, etc:
-
- http://p.p/, and select "actions file feedback system"
+ * You can also send feedback on websites that Privoxy has problems with. Please bookmark
+ the following link: "Privoxy - Submit Filter Feedback"
+ . Once you surf to a page with problems, use the
+ bookmark to send us feedback. We will look into the issue as soon as possible.
- This page can also be reached from many of the internal CGI pages.
-
- * For any other issues, feel free to use the mailing lists:
+ * For any other issues, feel free to use the mailing lists:
http://sourceforge.net/mail/?group_id=11118.
Anyone interested in actively participating in development and related
discussions can also join the appropriate mailing list. Archives are
- available too.
+ available, too.
-------------------------------------------------------------------------------
By: Privoxy Developers
-$Id: faq.sgml,v 1.47 2002/04/10 04:05:32 hal9 Exp $
+$Id: faq.sgml,v 1.49 2002/04/12 10:10:18 swa Exp $
This FAQ gives users and developers alike answers to frequently asked questions
about Privoxy .
If you have version 2.0.2, then the equivalent is http://example.com/
show-proxy-args (but you get far less information, and you should really
-consider upgrading to 2.9.13).
+consider upgrading to 2.9.14).
-------------------------------------------------------------------------------
We value your feedback. However, to provide you with the best support, please
note:
- * Use the Sourceforge Support Forum to get help:
+ * Use the Sourceforge Support Forum to get help:
http://sourceforge.net/tracker/?group_id=11118&atid=211118
- * Submit bugs only through our Sourceforge Bug Forum:
+ * Submit bugs only through our Sourceforge Bug Forum:
http://sourceforge.net/tracker/?group_id=11118&atid=111118.
platform, browser, any pertinent log data, any other relevant details
(please be specific) and, if possible, some way to reproduce the bug.
- * Submit feature requests only through our Sourceforge feature request forum:
+ * Submit feature requests only through our Sourceforge feature request forum:
http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse.
- * Submit missed ads and banners, and incorrectly blocked images, popups, etc:
-
- http://p.p/, and select "actions file feedback system"
+ * You can also send feedback on websites that Privoxy has problems with. Please bookmark
+ the following link: "Privoxy - Submit Filter Feedback"
+ . Once you surf to a page with problems, use the
+ bookmark to send us feedback. We will look into the issue as soon as possible.
- This page can also be reached from many of the internal CGI pages.
-
- * For any other issues, feel free to use the mailing lists:
+ * For any other issues, feel free to use the mailing lists:
http://sourceforge.net/mail/?group_id=11118.
Anyone interested in actively participating in development and related
discussions can also join the appropriate mailing list. Archives are
- available too.
+ available, too.
-------------------------------------------------------------------------------
By: Privoxy Developers
-$Id: user-manual.sgml,v 1.73 2002/04/10 18:45:15 swa Exp $
+$Id: user-manual.sgml,v 1.75 2002/04/12 02:08:48 david__schmidt Exp $
The user manual gives users information on how to install, configure and use
Privoxy.
The directory you choose to install Privoxy into will contain all of the
configuration files.
-If you would like to build binary images on OS/2 yourself, you will need a few
-Unix-like tools: autoconf, autoheader and sh. These tools will be used to
-create the required config.h file, which is not part of the source distribution
-because it differs based on platform. You will also need a compiler. The
-distribution has been created using IBM VisualAge compilers, but you can use
-any compiler you like. GCC/EMX has the disadvantage of needing to be
-single-threaded due to a limitation of EMX's implementation of the select()
-socket call.
-
-In addition to needing the source code distribution as outlined earlier, you
-will want to extract the os2seutp directory from CVS:
-
- cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
- cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa co os2setup
-
-
-This will create a directory named os2setup/, which will contain the
-Makefile.vac makefile and os2build.cmd which is used to completely create the
-binary distribution. The sequence of events for building the executable for
-yourself goes something like this:
-
- cd current
- autoheader
- autoconf
- sh configure
- cd ..\os2setup
- nmake -f Makefile.vac
-
-
-You will see this sequence laid out in os2build.cmd.
-
-------------------------------------------------------------------------------
3.1.4. Windows
config.privoxy.org/), which is an internal page. You will see the following
section:
-Please choose from the following options:
+ Please choose from the following options:
* Show information about the current configuration
* Show the source code version numbers
We value your feedback. However, to provide you with the best support, please
note:
- * Use the Sourceforge Support Forum to get help:
+ * Use the Sourceforge Support Forum to get help:
http://sourceforge.net/tracker/?group_id=11118&atid=211118
- * Submit bugs only through our Sourceforge Bug Forum:
+ * Submit bugs only through our Sourceforge Bug Forum:
http://sourceforge.net/tracker/?group_id=11118&atid=111118.
platform, browser, any pertinent log data, any other relevant details
(please be specific) and, if possible, some way to reproduce the bug.
- * Submit feature requests only through our Sourceforge feature request forum:
+ * Submit feature requests only through our Sourceforge feature request forum:
http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse.
- * Submit missed ads and banners, and incorrectly blocked images, popups, etc:
-
- http://p.p/, and select "actions file feedback system"
+ * You can also send feedback on websites that Privoxy has problems with. Please bookmark
+ the following link: "Privoxy - Submit Filter Feedback"
+ . Once you surf to a page with problems, use the
+ bookmark to send us feedback. We will look into the issue as soon as possible.
- This page can also be reached from many of the internal CGI pages.
-
- * For any other issues, feel free to use the mailing lists:
+ * For any other issues, feel free to use the mailing lists:
http://sourceforge.net/mail/?group_id=11118.
Anyone interested in actively participating in development and related
discussions can also join the appropriate mailing list. Archives are
- available too.
+ available, too.
-------------------------------------------------------------------------------
it does nothing. Every action is disabled. This is not particularly informative
for our purposes here. OK, next section:
- Matches for http://google.com:
+ Matches for http://google.com:
{ -add-header -block +deanimate-gifs -downgrade +fast-redirects
+filter{html-annoyances} +filter{js-annoyances} +filter{no-popups}
And now we pull it altogether in the bottom section and summarize how Privoxy
is appying all its "actions" to "google.com":
- Final results:
+ Final results:
-add-header -block -deanimate-gifs -downgrade -fast-redirects
+filter{html-annoyances} +filter{js-annoyances} +filter{no-popups}
Now another example, "ad.doubleclick.net":
- { +block +image }
+ { +block +image }
.ad.doubleclick.net
{ +block +image }
One last example. Let's try "http://www.rhapsodyk.net/adsl/HOWTO/". This one is
giving us problems. We are getting a blank page. Hmmm...
- Matches for http://www.rhapsodyk.net/adsl/HOWTO/:
+ Matches for http://www.rhapsodyk.net/adsl/HOWTO/:
{ -add-header -block +deanimate-gifs -downgrade +fast-redirects
+filter{html-annoyances} +filter{js-annoyances} +filter{no-popups}
explictly does not block (-block) pages with "adsl". There are various ways to
handle such exceptions. Example:
- { -block }
+ { -block }
/adsl
But now what about a situation where we get no explicit matches like we did
with:
- { -block }
+ { -block }
/adsl
cause would be one of the "{+filter}" actions. Try adding the URL for the site
to one of aliases that turn off "+filter":
- {shop}
+ {shop}
.quietpc.com
.worldpay.com # for quietpc.com
.jungle.com
"{shop}" is an "alias" that expands to "{ -filter -no-cookies -no-cookies-keep
}". Or you could do your own exception to negate filtering:
- {-filter}
+ {-filter}
.forbes.com
><TD
><PRE
CLASS="PROGRAMLISTING"
->const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.31 2002/04/11 09:32:52 oes Exp $";
+>const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.33 2002/04/12 03:49:53 hal9 Exp $";
/*********************************************************************
*
* File : $Source$
CLASS="PROGRAMLISTING"
>#ifndef _FILENAME_H
#define _FILENAME_H
-#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.31 2002/04/11 09:32:52 oes Exp $"
+#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.33 2002/04/12 03:49:53 hal9 Exp $"
/*********************************************************************
*
* File : $Source$
><LI
><P
CLASS="LITERALLAYOUT"
-> Use the Sourceforge Support Forum to get help:<br>
+>Use the Sourceforge Support Forum to get help:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit bugs only through our Sourceforge Bug Forum:<br>
+>Submit bugs only through our Sourceforge Bug Forum:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit feature requests only through our Sourceforge feature request forum:<br>
+>Submit feature requests only through our Sourceforge feature request forum:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit missed ads and banners, and incorrectly blocked images, popups, etc:<br>
- <br>
- <A
-HREF="http://p.p/"
-TARGET="_top"
->http://p.p/</A
->, and select <A
+>You can also send feedback on websites that Privoxy has problems with. Please bookmark<br>
+the following link: <A
HREF="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions','Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"
TARGET="_top"
><SPAN
CLASS="QUOTE"
->"actions file feedback system"</SPAN
+>"Privoxy - Submit Filter Feedback"</SPAN
></A
-><br>
+>. Once you surf to a page with problems, use the<br>
+bookmark to send us feedback. We will look into the issue as soon as possible.<br>
</P
-><P
-> This page can also be reached from many of the internal CGI pages.
- </P
></LI
><LI
><P
CLASS="LITERALLAYOUT"
-> For any other issues, feel free to use the mailing lists:<br>
+>For any other issues, feel free to use the mailing lists:<br>
<br>
<A
HREF="http://sourceforge.net/mail/?group_id=11118"
><P
> Anyone interested in actively participating in development and related
discussions can also join the appropriate mailing list. Archives are
- available too.
+ available, too.
</P
></LI
></UL
><H2
CLASS="SECT2"
><A
-NAME="AEN957"
+NAME="AEN962"
>10.1. Copyright</A
></H2
><P
> is free software; you can
redistribute it and/or modify it under the terms of the GNU General Public
-
License as published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.</P
><P
> This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-
more details, which is available from the Free Software Foundation, Inc, 59
Temple Place - Suite 330, Boston, MA 02111-1307, USA.</P
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN964"
+NAME="AEN969"
>10.2. History</A
></H2
><P
</P
><P
> Documentation writers should please make sure documents build
- successfully before committing to CVS.
+ successfully before committing to CVS, if possible.
</P
><P
> How do you update the webserver (i.e. the pages on privoxy.org)?
><H2
CLASS="SECT2"
><A
-NAME="AEN185"
+NAME="AEN186"
>4.3. Privoxy Custom Entities</A
></H2
><P
></DIV
><P
CLASS="PUBDATE"
->$Id: developer-manual.sgml,v 1.31 2002/04/11 09:32:52 oes Exp $<BR></P
+>$Id: developer-manual.sgml,v 1.33 2002/04/12 03:49:53 hal9 Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
></DT
><DT
>4.3. <A
-HREF="documentation.html#AEN185"
+HREF="documentation.html#AEN186"
>Privoxy Custom Entities</A
></DT
></DL
><DL
><DT
>10.1. <A
-HREF="copyright.html#AEN957"
+HREF="copyright.html#AEN962"
>Copyright</A
></DT
><DT
>10.2. <A
-HREF="copyright.html#AEN964"
+HREF="copyright.html#AEN969"
>History</A
></DT
></DL
>8.6. Windows</A
></H2
><P
-> Ensure that you have the latest code version. Hence run
- </P
+> You should ensure you have the latest version of Cygwin (from
+ <A
+HREF="http://www.cygwin.com/"
+TARGET="_top"
+>http://www.cygwin.com/</A
+>).
+ Run the following commands from within a Cygwin bash shell.
+ </P
><P
-> <TABLE
+> First check out a clean copy of the correct code version, by running:
+ </P
+><P
+> <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TD
><PRE
CLASS="PROGRAMLISTING"
-> cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
- cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa export -r v_X_Y_Z current
- cd current
- </PRE
+> mkdir dist
+ cd dist
+ cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
+ cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa export -r v_X_Y_Z .
+ </PRE
></TD
></TR
></TABLE
>
- </P
+ </P
><P
-> Run:
- </P
+> (Note: It is important that this is a clean copy of the code,
+ do not re-use a working directory after you have manually compiled
+ there).
+ </P
><P
-> <TABLE
+> Then you can build the package. This is fully automated, and is
+ controlled by <TT
+CLASS="FILENAME"
+>winsetup/GNUmakefile</TT
+>.
+ All you need to do is:
+ </P
+><P
+> <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TD
><PRE
CLASS="PROGRAMLISTING"
-> autoheader && autoconf && ./configure
- </PRE
+> cd winsetup
+ make
+ </PRE
></TD
></TR
></TABLE
>
- </P
+ </P
><P
-> Then do FIXME.
- </P
+> Now you can manually rename <TT
+CLASS="FILENAME"
+>privoxy_setup.exe</TT
+> to
+ <TT
+CLASS="FILENAME"
+>privoxy_setup_X_Y_Z.exe</TT
+>, and upload it to
+ SourceForge.
+ </P
></DIV
><DIV
CLASS="SECT2"
>3. Quickstart to Privoxy Development</A
></H1
><P
->You'll need an account on <A
+> You'll need an account on <A
HREF="http://sourceforge.net"
TARGET="_top"
>Sourceforge</A
-> to support our development.
-Mail your ID to the list and wait until a project manager has added you.</P
+> to support our
+ development. Mail your ID to the list and wait until a project
+ manager has added you.
+ </P
><P
->For the time being (read, this section is under construction), please note the
-following guidelines for changing stuff in the code. If it is
- <P
+> For the time being (read, this section is under construction), please
+ note the following guidelines for changing stuff in the code. If it is
+ <P
></P
><OL
TYPE="1"
><LI
><P
-> A bug-fix / clean-up / cosmetic thing: shoot
- </P
+> A bugfix / clean-up / cosmetic thing: shoot
+ </P
></LI
><LI
><P
-> A new feature that can be turned off: shoot
- </P
+> A new feature that can be turned off: shoot
+ </P
></LI
><LI
><P
-> A clear improvement w/o side effects on other parts of the code: shoot
- </P
+> A clear improvement w/o side effects on other parts of the code: shoot
+ </P
></LI
><LI
><P
-> A matter of taste: ask the list
- </P
+> A matter of taste: ask the list
+ </P
></LI
><LI
><P
-> A major redesign of some part of the code: ask the list
- </P
+> A major redesign of some part of the code: ask the list
+ </P
></LI
></OL
->
- </P
+>
+ </P
+><P
+> Note that near a major public release, we get a bit more cautious - if
+ unsure, it doesn't hurt to ask first.
+ </P
></DIV
><DIV
CLASS="NAVFOOTER"
><LI
><P
CLASS="LITERALLAYOUT"
-> Use the Sourceforge Support Forum to get help:<br>
+>Use the Sourceforge Support Forum to get help:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit bugs only through our Sourceforge Bug Forum:<br>
+>Submit bugs only through our Sourceforge Bug Forum:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit feature requests only through our Sourceforge feature request forum:<br>
+>Submit feature requests only through our Sourceforge feature request forum:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit missed ads and banners, and incorrectly blocked images, popups, etc:<br>
- <br>
- <A
-HREF="http://p.p/"
-TARGET="_top"
->http://p.p/</A
->, and select <A
+>You can also send feedback on websites that Privoxy has problems with. Please bookmark<br>
+the following link: <A
HREF="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions','Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"
TARGET="_top"
><SPAN
CLASS="QUOTE"
->"actions file feedback system"</SPAN
+>"Privoxy - Submit Filter Feedback"</SPAN
></A
-><br>
+>. Once you surf to a page with problems, use the<br>
+bookmark to send us feedback. We will look into the issue as soon as possible.<br>
</P
-><P
-> This page can also be reached from many of the internal CGI pages.
- </P
></LI
><LI
><P
CLASS="LITERALLAYOUT"
-> For any other issues, feel free to use the mailing lists:<br>
+>For any other issues, feel free to use the mailing lists:<br>
<br>
<A
HREF="http://sourceforge.net/mail/?group_id=11118"
><P
> Anyone interested in actively participating in development and related
discussions can also join the appropriate mailing list. Archives are
- available too.
+ available, too.
</P
></LI
></UL
><H2
CLASS="SECT2"
><A
-NAME="AEN722"
+NAME="AEN720"
>8.1. Copyright</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN729"
+NAME="AEN727"
>8.2. History</A
></H2
><P
></DIV
><P
CLASS="PUBDATE"
->$Id: faq.sgml,v 1.47 2002/04/10 04:05:32 hal9 Exp $<BR></P
+>$Id: faq.sgml,v 1.49 2002/04/12 10:10:18 swa Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
><DL
><DT
>8.1. <A
-HREF="copyright.html#AEN722"
+HREF="copyright.html#AEN720"
>Copyright</A
></DT
><DT
>8.2. <A
-HREF="copyright.html#AEN729"
+HREF="copyright.html#AEN727"
>History</A
></DT
></DL
><P
> If you have version 2.0.2, then the equivalent is
http://example.com/show-proxy-args (but you get far less information, and
- you should really consider upgrading to 2.9.13).</P
+ you should really consider upgrading to 2.9.14).</P
></DIV
><DIV
CLASS="SECT2"
></DT
><DT
><A
-HREF="#MOREINFOS"
->More infos</A
+HREF="#MOREINFO"
+>More info</A
></DT
><DT
><A
></DT
><DT
><A
-HREF="#AEN94"
+HREF="#AEN95"
>Copyright</A
></DT
><DT
><A
-HREF="#AEN101"
+HREF="#AEN102"
>History</A
></DT
></DL
><HR><H1
CLASS="SECT1"
><A
-NAME="MOREINFOS"
->More infos</A
+NAME="MOREINFO"
+>More info</A
></H1
><P
><P
><P
CLASS="LITERALLAYOUT"
> <A
+HREF="team/index.html"
+TARGET="_top"
+>Pictures of the Privoxy Team</A
+><br>
+ </P
+></LI
+><LI
+><P
+CLASS="LITERALLAYOUT"
+> <A
HREF="developer-manual/index.html"
TARGET="_top"
>Developer Manual</A
><LI
><P
CLASS="LITERALLAYOUT"
-> Use the Sourceforge Support Forum to get help:<br>
+>Use the Sourceforge Support Forum to get help:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit bugs only through our Sourceforge Bug Forum:<br>
+>Submit bugs only through our Sourceforge Bug Forum:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit feature requests only through our Sourceforge feature request forum:<br>
+>Submit feature requests only through our Sourceforge feature request forum:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit missed ads and banners, and incorrectly blocked images, popups, etc:<br>
- <br>
- <A
-HREF="http://p.p/"
-TARGET="_top"
->http://p.p/</A
->, and select <A
+>You can also send feedback on websites that Privoxy has problems with. Please bookmark<br>
+the following link: <A
HREF="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions','Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"
TARGET="_top"
><SPAN
CLASS="QUOTE"
->"actions file feedback system"</SPAN
+>"Privoxy - Submit Filter Feedback"</SPAN
></A
-><br>
+>. Once you surf to a page with problems, use the<br>
+bookmark to send us feedback. We will look into the issue as soon as possible.<br>
</P
-><P
-> This page can also be reached from many of the internal CGI pages.
- </P
></LI
><LI
><P
CLASS="LITERALLAYOUT"
-> For any other issues, feel free to use the mailing lists:<br>
+>For any other issues, feel free to use the mailing lists:<br>
<br>
<A
HREF="http://sourceforge.net/mail/?group_id=11118"
><P
> Anyone interested in actively participating in development and related
discussions can also join the appropriate mailing list. Archives are
- available too.
+ available, too.
</P
></LI
></UL
><HR><H1
CLASS="SECT1"
><A
-NAME="AEN94"
+NAME="AEN95"
>Copyright</A
></H1
><P
><HR><H1
CLASS="SECT1"
><A
-NAME="AEN101"
+NAME="AEN102"
>History</A
></H1
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1613"
+NAME="AEN1602"
>9.2. <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
Privoxy main page:
</P
><A
-NAME="AEN1628"
+NAME="AEN1617"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show information about the current configuration:
</P
><A
-NAME="AEN1635"
+NAME="AEN1624"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the source code version numbers:
</P
><A
-NAME="AEN1640"
+NAME="AEN1629"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the client's request headers:
</P
><A
-NAME="AEN1645"
+NAME="AEN1634"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show which actions apply to a URL and why:
</P
><A
-NAME="AEN1650"
+NAME="AEN1639"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
to run, but only as a pass-through proxy, with no actions taking place:
</P
><A
-NAME="AEN1656"
+NAME="AEN1645"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
> Short cuts. Turn off, then on:
</P
><A
-NAME="AEN1660"
+NAME="AEN1649"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
</P
></BLOCKQUOTE
><A
-NAME="AEN1663"
+NAME="AEN1652"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Edit the actions list file:
</P
><A
-NAME="AEN1668"
+NAME="AEN1657"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><H2
CLASS="SECT2"
><A
-NAME="AEN277"
+NAME="AEN268"
>5.1. Controlling <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><H2
CLASS="SECT2"
><A
-NAME="AEN295"
+NAME="AEN286"
>5.2. Configuration Files Overview</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN326"
+NAME="AEN317"
>5.3. The Main Configuration File</A
></H2
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN359"
+NAME="AEN350"
>5.3.1. Defining Other Configuration Files</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN452"
+NAME="AEN443"
>5.3.2. Other Configuration Options</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN589"
+NAME="AEN580"
>5.3.3. Access Control List (ACL)</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN787"
+NAME="AEN778"
>5.3.5. Windows GUI Options</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN889"
+NAME="AEN880"
>5.4.1. URL Domain and Path Syntax</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN965"
+NAME="AEN956"
>5.4.2. Actions</A
></H3
><P
> include:
</P
><A
-NAME="AEN1075"
+NAME="AEN1066"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><H3
CLASS="SECT3"
><A
-NAME="AEN1287"
+NAME="AEN1278"
>5.4.3. Aliases</A
></H3
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1353"
+NAME="AEN1344"
>5.6. Templates</A
></H2
><P
><LI
><P
CLASS="LITERALLAYOUT"
-> Use the Sourceforge Support Forum to get help:<br>
+>Use the Sourceforge Support Forum to get help:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit bugs only through our Sourceforge Bug Forum:<br>
+>Submit bugs only through our Sourceforge Bug Forum:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit feature requests only through our Sourceforge feature request forum:<br>
+>Submit feature requests only through our Sourceforge feature request forum:<br>
<br>
<A
HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse"
><LI
><P
CLASS="LITERALLAYOUT"
-> Submit missed ads and banners, and incorrectly blocked images, popups, etc:<br>
- <br>
- <A
-HREF="http://p.p/"
-TARGET="_top"
->http://p.p/</A
->, and select <A
+>You can also send feedback on websites that Privoxy has problems with. Please bookmark<br>
+the following link: <A
HREF="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions','Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"
TARGET="_top"
><SPAN
CLASS="QUOTE"
->"actions file feedback system"</SPAN
+>"Privoxy - Submit Filter Feedback"</SPAN
></A
-><br>
+>. Once you surf to a page with problems, use the<br>
+bookmark to send us feedback. We will look into the issue as soon as possible.<br>
</P
-><P
-> This page can also be reached from many of the internal CGI pages.
- </P
></LI
><LI
><P
CLASS="LITERALLAYOUT"
-> For any other issues, feel free to use the mailing lists:<br>
+>For any other issues, feel free to use the mailing lists:<br>
<br>
<A
HREF="http://sourceforge.net/mail/?group_id=11118"
><P
> Anyone interested in actively participating in development and related
discussions can also join the appropriate mailing list. Archives are
- available too.
+ available, too.
</P
></LI
></UL
><H2
CLASS="SECT2"
><A
-NAME="AEN1405"
+NAME="AEN1394"
>7.1. Copyright</A
></H2
><P
></DIV
><P
CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.73 2002/04/10 18:45:15 swa Exp $<BR></P
+>$Id: user-manual.sgml,v 1.75 2002/04/12 02:08:48 david__schmidt Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
><DL
><DT
>4.1. <A
-HREF="quickstart.html#AEN232"
+HREF="quickstart.html#AEN223"
>Command Line Options</A
></DT
></DL
><DL
><DT
>5.1. <A
-HREF="configuration.html#AEN277"
+HREF="configuration.html#AEN268"
>Controlling <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></DT
><DT
>5.2. <A
-HREF="configuration.html#AEN295"
+HREF="configuration.html#AEN286"
>Configuration Files Overview</A
></DT
><DT
>5.3. <A
-HREF="configuration.html#AEN326"
+HREF="configuration.html#AEN317"
>The Main Configuration File</A
></DT
><DD
><DL
><DT
>5.3.1. <A
-HREF="configuration.html#AEN359"
+HREF="configuration.html#AEN350"
>Defining Other Configuration Files</A
></DT
><DT
>5.3.2. <A
-HREF="configuration.html#AEN452"
+HREF="configuration.html#AEN443"
>Other Configuration Options</A
></DT
><DT
>5.3.3. <A
-HREF="configuration.html#AEN589"
+HREF="configuration.html#AEN580"
>Access Control List (ACL)</A
></DT
><DT
></DT
><DT
>5.3.5. <A
-HREF="configuration.html#AEN787"
+HREF="configuration.html#AEN778"
>Windows GUI Options</A
></DT
></DL
><DL
><DT
>5.4.1. <A
-HREF="configuration.html#AEN889"
+HREF="configuration.html#AEN880"
>URL Domain and Path Syntax</A
></DT
><DT
>5.4.2. <A
-HREF="configuration.html#AEN965"
+HREF="configuration.html#AEN956"
>Actions</A
></DT
><DT
>5.4.3. <A
-HREF="configuration.html#AEN1287"
+HREF="configuration.html#AEN1278"
>Aliases</A
></DT
></DL
></DT
><DT
>5.6. <A
-HREF="configuration.html#AEN1353"
+HREF="configuration.html#AEN1344"
>Templates</A
></DT
></DL
><DL
><DT
>7.1. <A
-HREF="copyright.html#AEN1405"
+HREF="copyright.html#AEN1394"
>Copyright</A
></DT
><DT
></DT
><DT
>9.2. <A
-HREF="appendix.html#AEN1613"
+HREF="appendix.html#AEN1602"
><SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
>Privoxy</SPAN
>
into will contain all of the configuration files.</P
-><P
-> If you would like to build binary images on OS/2 yourself, you will need
- a few Unix-like tools: autoconf, autoheader and sh. These tools will be
- used to create the required config.h file, which is not part of the
- source distribution because it differs based on platform. You will also
- need a compiler.
- The distribution has been created using IBM VisualAge compilers, but you
- can use any compiler you like. GCC/EMX has the disadvantage of needing
- to be single-threaded due to a limitation of EMX's implementation of the
- <TT
-CLASS="FUNCTION"
->select()</TT
-> socket call.</P
-><P
-> In addition to needing the source code distribution as outlined earlier,
- you will want to extract the <TT
-CLASS="FILENAME"
->os2seutp</TT
-> directory from CVS:
- <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><PRE
-CLASS="SCREEN"
-> cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
- cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa co os2setup
- </PRE
-></TD
-></TR
-></TABLE
->
- This will create a directory named os2setup/, which will contain the
- <TT
-CLASS="FILENAME"
->Makefile.vac</TT
-> makefile and <TT
-CLASS="FILENAME"
->os2build.cmd</TT
->
- which is used to completely create the binary distribution. The sequence
- of events for building the executable for yourself goes something like this:
- <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><PRE
-CLASS="SCREEN"
-> cd current
- autoheader
- autoconf
- sh configure
- cd ..\os2setup
- nmake -f Makefile.vac
- </PRE
-></TD
-></TR
-></TABLE
->
- You will see this sequence laid out in <TT
-CLASS="FILENAME"
->os2build.cmd</TT
->.</P
></DIV
><DIV
CLASS="SECT3"
><H2
CLASS="SECT2"
><A
-NAME="AEN232"
+NAME="AEN223"
>4.1. Command Line Options</A
></H2
><P