<!entity p-intro SYSTEM "privoxy.sgml">
<!entity contacting SYSTEM "contacting.sgml">
<!entity buildsource SYSTEM "buildsource.sgml">
-<!entity p-version SYSTEM "doc_version.tmp">
-<!entity p-status SYSTEM "doc_status.tmp">
+<!entity p-version "3.0.11">
+<!entity p-status "UNRELEASED">
+<!entity % p-not-stable "INCLUDE">
<!entity % p-stable "IGNORE">
-<!entity % p-not-stable "IGNORE"> <!-- beta or alpha -->
-<!entity % p-alpha "IGNORE">
-<!entity % p-beta "IGNORE">
<!entity % p-text "INCLUDE"> <!-- define we are a text only doc -->
<!entity % p-doc "IGNORE"> <!-- and never a text doc -->
<!entity % p-readme "INCLUDE"> <!-- all your README belong to us -->
Purpose : README for Privoxy
- $Id: readme.sgml,v 1.18 2002/06/05 00:31:55 hal9 Exp $
+ $Id: readme.sgml,v 2.20 2008/08/14 16:57:40 hal9 Exp $
- Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
+ Copyright (C) 2001-2008 Privoxy Developers http://www.privoxy.org/
See LICENSE.
========================================================================
NOTE: Please read developer-manual/documentation.html before touching
- anything in this, or other Privoxy documentation.
+ anything in this, or other Privoxy documentation. You have been warned!
+ Failure to abide by this rule will result in the revocation of your license
+ to live a peaceful existence!
========================================================================
===================================================================
to avoid extra blank lines, etc.
======================================================================
+ For stable releases, change
+
+ entity % p-not-stable "INCLUDE"
+
+ to
+
+ entity % p-not-stable "IGNORE"
+
+ in the DTD at the top. This will toggle various text 'off'. BOTH
+ MUST be toggled in this case or you will get both text referencing
+ stable and unstable versions. You only want one or the other!
+
-->
<article id="index">
<artheader>
*
* Purpose : README file to give a short intro.
*
- * Copyright : Written by and Copyright (C) 2001 the SourceForge
+ * Copyright : Written by and Copyright (C) 2001-2008 the SourceForge
* Privoxy team. http://www.privoxy.org/
*
* Based on the Internet Junkbuster originally written
* 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.
+ * or write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
+ * USA
*
*********************************************************************/
</literallayout>
<para>
<!-- include some conditional text -->
This README is included with <![%p-not-stable;[ the development version of]]>
- Privoxy &p-version;<![%p-not-stable;[, which will eventually become Privoxy v3.2]]><![%p-beta;[ (and soon we hope!)]]>.
- See http://www.privoxy.org/ for more information. The current code
- level is &p-status;<![%p-beta;[, but seems stable to us :)]]><![%p-alpha;[,
- and may break in mysterious ways :) There may be features only partially
- implemented, or worse, not functional. If you are interested in participating
- in Privoxy development, please see the Links at the bottom of this page]]>.
- </para>
+ Privoxy &p-version;. See http://www.privoxy.org/ for more information. The current code maturity
+ level is <quote>&p-status;</quote><![%p-not-stable;[, but seems stable to us :)]]>.
+</para>
</abstract>
</artheader>
<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="importantchanges" ><title>IMPORTANT CHANGES</title>
<para>
- NEWS! As of 03/24/02, the name of this project has been changed from
- ijbswa/Junkbuster to Privoxy. This is reflected in many of the included
- files.
+Privoxy development is between releases. The current sources are development
+quality. If you find problems please report them to the developers.
+</para>
+<para>
+ August 2008, Privoxy 3.0.10 is released! There are not any major new
+ features, but many improvements and refinements. As usual there are changes
+ that effect the configuration. See the "ChangeLog", and the "What's New"
+ section and the "Upgrader's Notes" in <citetitle>the User Manual</citetitle>
+ for details and specifics.
</para>
<para>
- WARNING! If upgrading from earlier versions of this project via RPM packages,
- the new package will delete any previously installed 'Junkbuster' packages.
+ June 2008, Privoxy 3.0.9 beta is released. There are no major new
+ features, but many improvements and refinements.
</para>
<para>
- IMPORTANT! READ! Configuration Change as of 17 Mar 2002: The default listening
- port is now 8118 due to conflicts with port 8000 assignment. You will need to
- change your browser if upgrading!!! And maybe firewall, etc.
+ NEWS! January 2008, Privoxy 3.0.8 stable is released. This is a significant
+ upgrade with many new and enhanced features, and many bugs fixed. All Privoxy
+ users are encouraged to upgrade. See the "ChangeLog", and the "What's New"
+ section and the "Upgrader's Notes" in <citetitle>the User Manual</citetitle>
+ for details and specifics. There are changes related to configuration, so
+ anyone upgrading and keeping their old configuration should read ahead
+ first.
+</para>
+<para>
+ December 2007, Privoxy 3.0.7 is released. This is a beta release in
+ preparation for the forthcoming 3.0.8 release.
</para>
</sect1>
<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="install" ><title>INSTALL</title>
-<!-- include buildsource.sgml boilerplate: -->
- &buildsource;
-<!-- end boilderplate -->
+<para>
+ See the <filename>INSTALL</filename> file in this directory, for installing
+ from raw source, and the <citetitle>User Manual</citetitle>, for all other
+ installation types.
+</para>
</sect1>
<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="run"><title>RUN</title>
<para>
- privoxy [——help] [——version]
- [——no-daemon] [——pidfile PIDFILE] [——user
- USER[.GROUP]] [config_file]
+ privoxy [--help] [--version]
+ [--no-daemon] [--pidfile PIDFILE] [--user USER[.GROUP]] [--chroot] [--pre-chroot-nslookup
+ HOSTNAME ][config_file]
</para>
<para>
- See the man page or User Manual for an explanation of each option, and
+ See the man page or <citetitle>User Manual</citetitle> for an explanation of each option, and
other configuration and usage issues.
</para>
<para>
for 'config.txt'). If no config_file is found, Privoxy will fail to start.
</para>
<para>
- Or for Red Hat based distributions: /etc/rc.d/init.d/privoxy start
-</para>
-<para>
- Or for SuSE: /etc/rc.d/privoxy start
+ Or for Red Hat and Fedora based distributions: /etc/rc.d/init.d/privoxy start
</para>
<para>
- Or Debian: /etc/init.d/privoxy start
+ Or Debian and Ubuntu: /etc/init.d/privoxy start
</para>
</sect1>
<!-- ~~~~~ New section ~~~~~ -->
<sect1 id="configuration"><title>CONFIGURATION</title>
<para>
- See: 'config', 'default.action', 'user.action', and 'default.filter'.
- 'user.action' is for personal and local configuration preferences. These are
- all well commented. Most of the magic is in '*.action' files. 'user.action'
- should be used for any actions customizations. On Unix-like systems, these
- files are installed in /etc/privoxy. On Windows, then wherever the
- executable itself is installed. There are many significant changes and
- advances since Junkbuster v2.0.x. The User Manual has an explanation of
- all configuration options, and examples: http://www.privoxy.org/user-manual/.
+ See: 'config', 'default.action', 'user.action', 'default.filter', and
+ 'user.filter'. 'user.action' and 'user.filter' are for personal and local
+ configuration preferences. These are all well commented. Most of the magic is
+ in '*.action' files. 'user.action' should be used for any actions
+ customizations. On Unix-like systems, these files are typically installed in
+ /etc/privoxy. On Windows, then wherever the executable itself is installed.
+ There are many significant changes and advances from earlier versions. The
+ <citetitle>User Manual</citetitle> has an explanation of all configuration
+ options, and examples: http://www.privoxy.org/user-manual/.
</para>
<para>
Be sure to set your browser(s) for HTTP/HTTPS Proxy at <IP>:<Port>, or
<sect1 id="documentation"><title>DOCUMENTATION</title>
<para>
There should be documentation in the 'doc' subdirectory<![%p-not-stable;[, but it
- may not be in sync with current code]]>. In particular, see the User Manual there,
- the FAQ, and those interested in Privoxy development, should look at
- developer-manual.
+ may not be completed at this point]]>. In particular, see the
+ <citetitle>User Manual</citetitle> there,
+ the <citetitle>FAQ</citetitle>, and those interested in Privoxy development, should look at
+ <citetitle>developer-manual</citetitle>.
</para>
<para>
<![%p-not-stable;[
The most up to date source of information on the current development version,
- may be either comments in the source code, or the included
+ may still be either comments in the source code, or the included
configuration files. ]]>The source and configuration files are all well
commented. The main configuration files are: 'config', 'default.action', and
- 'default.filter'<![%p-not-stable;[ in the toplevel source directory]]>.
+ 'default.filter'<![%p-not-stable;[ in the top-level source directory]]>.
</para>
<para>
- Included documentation may vary according to platform and packager.
+ Included documentation may vary according to platform and packager. All
+ documentation is posted on http://www.privoxy.org, in case you don't have it,
+ or can't find it.
</para>
</sect1>
<!-- </LiteralLayout> -->
<!-- </para> -->
<!-- <para> -->
-<!-- $Id: readme.sgml,v 1.18 2002/06/05 00:31:55 hal9 Exp $ -->
+<!-- $Id: readme.sgml,v 2.20 2008/08/14 16:57:40 hal9 Exp $ -->
<!-- </para> -->
</article>
projects / privoxy.git / blobdiff