Added entreaty to donate, improved clarity of sections and miscellaneous rewording
[OSXPackageBuilder.git] / pkg content skeleton / Applications / Privoxy / readme.rtfd / TXT.rtf
index bfc4423..9fc1570 100644 (file)
@@ -1,6 +1,8 @@
 {\rtf1\ansi\ansicpg1252\cocoartf1038\cocoasubrtf360
-{\fonttbl\f0\fswiss\fcharset0 Helvetica;}
-{\colortbl;\red255\green255\blue255;\red255\green19\blue25;}
+{\fonttbl\f0\fswiss\fcharset0 Helvetica;\f1\fswiss\fcharset0 ArialMT;\f2\fnil\fcharset0 LucidaGrande;
+\f3\fmodern\fcharset0 CourierNewPSMT;}
+{\colortbl;\red255\green255\blue255;\red255\green19\blue25;\red126\green0\blue20;\red126\green0\blue20;
+\red10\green0\blue139;}
 \margl1440\margr1440\vieww21240\viewh13460\viewkind0
 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 
@@ -32,13 +34,16 @@ and for Opera at:\
 \
 Opera > Preferences > Advanced > Network > Proxy Servers\
 \
+All done! To test that you've set things up correctly please follow the instructions in the next section.\
 \
 \
-
-\b\fs26 Checking that Privoxy is working for you
-\b0\fs24 \
 \
-Simply point your web browser here:\
+\pard\pardeftab720\sa240\ql\qnatural
+
+\f1\b\fs36 \cf3 Checking that Privoxy is working for you
+\f0\b0\fs24 \cf0 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+\cf0 Simply point your web browser here:\
 \
 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 {\field{\*\fldinst{HYPERLINK "http://config.privoxy.org/"}}{\fldrslt \cf0 http://config.privoxy.org/}}\
@@ -49,16 +54,58 @@ If you see a page like the following screenshot then all is well and Privoxy is
 
 \b0\fs24 \cf0 {{\NeXTGraphic Screen shot 2012-01-30 at 1.23.15 PM.png \width25300 \height12660
 }¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
-
-\b\fs26 \cf0 \
+\cf0 \
 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 \cf0 \
 \
 \
-Configuring Privoxy
-\b0\fs24 \
+
+\b\fs26 \
+\pard\pardeftab720\sa240\ql\qnatural
+
+\f1\fs36 \cf3 Known Problems
+\f0\fs26 \cf0 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+
+\b0\fs24 \cf0 The OS X 'Mavericks' & 'Yosemite' releases have a bug that causes an intermittent problem for Privoxy that a simple upgrade install will not cure. If you have a persistent problem with Privoxy not starting (in your web browser you get a "Cannot connect to proxy server" error) then the best advice is to completely uninstall Privoxy (using the guide in the readme file at /Applications/Privoxy) then reinstall from scratch. Please ensure you take a copy of your config file and filters if you have made any customisations you do not want to lose.\
 \
-You can access your Privoxy installation configuration at:\
+For the technically minded, the bug is that the _privoxy user & group cannot be reliably read from directory services at system startup time (there are suggestions that usernames with leading underscore are no longer properly supported), causing Privoxy to fail to load. Details can be found in these discussion threads:\
+\
+https://sourceforge.net/p/ijbswa/support-requests/1601/\
+https://sourceforge.net/p/ijbswa/support-requests/1599/\
+https://sourceforge.net/p/ijbswa/bugs/882/
+\b\fs26 \
+\
+\
+\
+\pard\pardeftab720\sa240\ql\qnatural
+
+\f1\fs36 \cf4 Is there a particular feature from our TODO list you'd like to see implemented sooner rather than later? Would you like to donate in general?\
+\pard\pardeftab720\sa240\ql\qnatural
+
+\b0\fs24 \cf0 Donations are welcome, and you are free to discuss with us what your donation should be used for. Our {\field{\*\fldinst{HYPERLINK "http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/current/TODO"}}{\fldrslt \cf5 TODO list}} is rather long and being able to pay one (or more) developers to work on Privoxy would make a huge difference, even if it was only for a couple of weeks. Donations may also be used for Privoxy-related travel expenses (for example to attend conferences), for hardware used for Privoxy development and for hosting expenses etc.\
+Privoxy is an associated project of {\field{\*\fldinst{HYPERLINK "http://www.spi-inc.org/"}}{\fldrslt \cf5 Software in the Public Interest (SPI)}}, which allows us to receive tax-deductible donations in the United States. If you want to donate through SPI, please use {\field{\*\fldinst{HYPERLINK "http://www.spi-inc.org/donations"}}{\fldrslt \cf5 SPI's donation page}} to see what the options are.\
+You can also donate to Privoxy using a bank account managed by {\field{\*\fldinst{HYPERLINK "https://www.zwiebelfreunde.de/"}}{\fldrslt \cf5 Zwiebelfreunde e.V.}}:\
+\'a0Name\'a0on\'a0Account:\'a0Zwiebelfreunde\'a0e.V.
+\f2 \uc0\u8232 
+\f1 \'a0IBAN:\'a0DE95430609671126825604
+\f2 \uc0\u8232 
+\f1 \'a0BIC:\'a0GENODEM1GLS
+\f2 \uc0\u8232 
+\f1 \'a0Bank:\'a0GLS\'a0Bank\
+Donations made through Zwiebelfreunde e.V. are tax-deductible in Germany and other countries that recognize German charitable clubs. Feel free to use the Subject field to provide a name to be credited and a list of TODO list items you are interested in the most. For example: Max Mustermann: #16, #1, #14.\
+If you have any questions regarding donations please mail to either the public user mailing list or, if it's a private matter, to {\field{\*\fldinst{HYPERLINK "mailto:fk@fabiankeil.de"}}{\fldrslt \cf5 Fabian Keil}} (Privoxy's SPI liason) directly.\
+\pard\pardeftab720\ql\qnatural
+\cf0 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+
+\f0\b\fs26 \cf0 \
+\pard\pardeftab720\sa240\ql\qnatural
+
+\f1\fs36 \cf3 Configuring Privoxy
+\f0\b0\fs24 \cf0 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+\cf0 You can access your Privoxy installation configuration at:\
 \
 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 {\field{\*\fldinst{HYPERLINK "http://config.privoxy.org/"}}{\fldrslt \cf0 http://config.privoxy.org/}}\
@@ -72,42 +119,76 @@ Note that to make configuration changes here you first have to manually enable t
 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 
 \b\fs26 \cf0 \
-Merging an existing configuration
-\b0\fs24 \
+\pard\pardeftab720\sa240\ql\qnatural
+
+\f1\fs36 \cf3 Merging in an existing configuration
+\f0\b0\fs24 \cf0 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+\cf0 If you already had Privoxy installed prior to this installation, then your configuration is unchanged. It is possible however that the configuration files supplied with this new installation contain new options that your existing configuration files do not. If you wish to manually merge your settings into the new files you will find them all at /usr/local/etc/privoxy/\
 \
-If you already had Privoxy installed prior to this installation, then your configuration is unchanged. It is possible however that the configuration files supplied with this new installation contain new options that your existing configuration files do not. If you wish to manually merge your settings into the new files you will find them all at /usr/local/etc/privoxy/\
 \
 \
+\pard\pardeftab720\sa240\ql\qnatural
+
+\f1\b\fs36 \cf3 Starting and stopping Privoxy
+\f0\fs26 \cf0 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+
+\b0\fs24 \cf0 Privoxy can be started and stopped using the two scripts in /Applications/Privoxy named startPrivoxy.sh and stopPrivoxy.sh. They must be run as sudo from an account that has administrative rights. To do this, open a Terminal window then enter the following commands:\
 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+
+\f3 \cf0 cd /Applications/Privoxy\
+sudo ./startPrivoxy.sh\
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+
+\f0 \cf0 \
+<or>
+\b \
+\
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+
+\f3\b0 \cf0 sudo ./stopPrivoxy.sh\
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 
-\b\fs26 Uninstallation
-\b0 \
+\f0\b \cf0 \
+\
+\
+\pard\pardeftab720\sa240\ql\qnatural
 
-\fs24 \
-To remove Privoxy once it has been installed, first of all reconfigure your web browser(s) not to use Privoxy as a proxy (see the top of this file for details). Once you're happy that you're not using Privoxy any more you can run its uninstall script.\
+\f1\fs36 \cf3 Uninstalling Privoxy
+\f0\b0\fs24 \cf0 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+\cf0 To remove Privoxy once it has been installed, first of all reconfigure your web browser(s) not to use Privoxy as a proxy (see the top of this file for details). Once you're happy that you're not using Privoxy any more you can run its uninstall script.\
 \
 To do this, open a Terminal window then enter the following commands:\
 \
-cd /Applications/Privoxy\
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+
+\f3 \cf0 cd /Applications/Privoxy\
 sudo ./uninstall.command\
-\
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+
+\f0 \cf0 \
 You will be prompted for your password, since the script requires super-user privileges to run. If your account is not an administrator account, then the script won't work; you'll need to log in using an administrator account and try again. If you have already dragged the Privoxy application folder to the trash, use the 'Put Back' feature to restore it or else recreate the Privoxy folder in your Applications folder, drag the uninstall.command file from the trash to that folder and proceed as above.\
 \
 \
 \
+\pard\pardeftab720\sa240\ql\qnatural
 
-\b Thanks\
-
-\b0 \
-This installer is based on previous work done by Mark Miller, David Schmidt and John Daniels, to whom I am indebted. Thanks also to Fabian Keil for occasional technical and significant licensing guidance, and to Andrew Jones, Andreas Rutkauskas, Julien Joubert, Lizik Grelier and Steven Kolins for testing.\
+\f1\b\fs36 \cf3 Thanks
+\f0\b0\fs24 \cf0 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+\cf0 This installer is based on previous work done by Mark Miller, David Schmidt and John Daniels, to whom I am indebted. Thanks also to Fabian Keil for occasional technical and significant licensing guidance, and to Andrew Jones, Andreas Rutkauskas, Julien Joubert, Lizik Grelier and Steven Kolins for testing.\
 \
 \
 \
+\pard\pardeftab720\sa240\ql\qnatural
 
-\b Copyright and Licensing\
-
-\b0 \
-All files that comprise this installation of Privoxy are written by and Copyright (C) 2001-2012 the Privoxy team. http://www.privoxy.org/\
+\f1\b\fs36 \cf3 Copyright and licensing
+\f0\b0\fs24 \cf0 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
+\cf0 All files that comprise this installation of Privoxy are written by and Copyright (C) 2001-2012 the Privoxy team. http://www.privoxy.org/\
 \
 \pard\pardeftab720\ql\qnatural
 \cf0 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.\