<!entity history SYSTEM "history.sgml">
<!entity copyright SYSTEM "copyright.sgml">
<!entity license SYSTEM "license.sgml">
-<!entity p-version "2.9.15">
+<!entity p-version "2.9.17">
<!entity p-status "beta">
<!entity % p-not-stable "INCLUDE">
<!entity % p-stable "IGNORE">
This file belongs into
ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
- $Id: faq.sgml,v 1.60 2002/05/22 17:17:48 oes Exp $
+ $Id: faq.sgml,v 1.61.2.9 2002/08/02 13:14:45 oes Exp $
Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
See LICENSE.
</subscript>
</pubdate>
-<pubdate>$Id: faq.sgml,v 1.60 2002/05/22 17:17:48 oes Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.61.2.9 2002/08/02 13:14:45 oes Exp $</pubdate>
<!--
This FAQ gives quick answers to frequently asked questions about
<ulink url="http://www.privoxy.org/">Privoxy</ulink>
<![%p-stable;[ v.&p-version]]>. It can't and doesn't replace the
- <ulink url="../user-manual/index.html">user manual</ulink>.
+ <ulink url="../user-manual/index.html"><citetitle>User Manual</citetitle></ulink>.
</para>
<!-- Include privoxy.sgml boilerplate: -->
<para>
You can find the latest version of the document at <ulink
url="http://www.privoxy.org/faq/">http://www.privoxy.org/faq/</ulink>.
- Please see the Contact section if you want to contact the developers.
+ Please see the <link linkend="contact">Contact section</link> if you want to
+ contact the developers.
</para>
<!-- <para> -->
the browser's caches to force a full re-reading of pages. You can verify
that <application>Privoxy</application> is running, and your browser
is correctly configured by entering the special URL:
- <ulink url="http:/config.privoxy.org/">http://config.privoxy.org/</ulink>.
+ <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink>.
This should take you to a page titled <quote>This is Privoxy..</quote> with
access to <application>Privoxy's</application> internal configuration.
If you see this, then you are good to go. If you receive a page saying
be that the browser is not set up correctly, or that
<application>Privoxy</application> is not running at all. Check the <ulink
url="../user-manual/config.html#LOGFILE">log file</ulink>.
-
-
</para>
</sect2>
+<!-- ~~~~~ New section ~~~~~ -->
+<sect2 id="osxuninstall">
+<title>In Mac OSX, I dragged the Privoxy folder to the trash in order to
+ uninstall it. Now the finder tells me I don't have sufficient privileges to
+ empty the trash.</title>
+ <para>
+ <application>Privoxy</application> is installed with root permissions.
+ When you drag the Privoxy folder to the trash, the general user does not
+ have (as the Finder says) sufficient privileges to delete it. Unfortunately,
+ the finder does not offer a way to enter the administrator password in order
+ to prove you do in fact own this computer. To fix this situation, open the
+ Terminal application and carefully enter the following commands:
+ <screen>
+ cd ~
+ cd .Trash
+ sudo rm -rf Privoxy
+ </screen>
+ The trash may still appear full after this command; emptying the trash
+ from the desktop should make it appear empty again.
+ </para>
+ <warning>
+ <para>
+ Be extra-sure to enter the commands <emphasis>EXACTLY</emphasis> as shown
+ above. Removing files recusively with administrator priviledges (as happens
+ with <literal>sudo rm -rf</literal> is serious business and even small
+ typos can have devasting effects!
+ </para>
+ </warning>
+</sect2>
+
</sect1>
<sect1 id="configuration"><title>Configuration</title>
+<sect2 renderas="sect3" id="getupdates"><title>Where can I get updated Actions Files?</title>
+ <para>
+ Based on your feedback and the continuing development, updated actions files will be
+ made available on the <ulink
+ url="http://sourceforge.net/project/showfiles.php?group_id=11118">files section</ulink> of
+ our <ulink url="http://sf.net/projects/ijbswa/">project page</ulink>.
+ </para>
+
+ <para>
+ If you wish to receive an email notification whenever we release updates of
+ <application>Privoxy</application> or the actions file, <ulink
+ url="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/">subscribe
+ to our announce mailing list</ulink>, ijbswa-announce@lists.sourceforge.net.
+ </para>
+
+</sect2>
+
<sect2 renderas="sect3" id="newconfig"><title>Can I use my old config files?</title>
<para>
The syntax, number, and purpose of configuration files has substantially
</sect2>
<sect2 renderas="sect3" id="configfiles"> <title>What's the difference between the
-<quote>Cautious</quote>, <quote>Medium</quote> and <quote>Advenced</quote> defaults?</title>
+<quote>Cautious</quote>, <quote>Medium</quote> and <quote>Advanced</quote> defaults?</title>
<para>
Configuring <application>Privoxy</application> is not entirely trivial. To help you get
started, we provide you with three different default action <quote>packages</quote> in
<row>
<entry>Pop-up killing</entry>
<entry>no</entry>
- <entry>no</entry>
+ <entry>yes</entry>
<entry>yes</entry>
</row>
<entry>yes</entry>
</row>
+<row>
+ <entry>Image tag reordering</entry>
+ <entry>no</entry>
+ <entry>no</entry>
+ <entry>yes</entry>
+</row>
+
+<row>
+ <entry>Ad-filtering by link</entry>
+ <entry>no</entry>
+ <entry>no</entry>
+ <entry>yes</entry>
+</row>
+
+
</tbody>
</tgroup>
</table>
<sect2 renderas="sect3">
-<title id="filterfile">What is the <filename>default.filter</filename> file?</title>
+<title id="filterfile">What is the <filename>default.filter</filename> file? What is a <quote>filter</quote>?</title>
<para>
The <ulink url="../user-manual/filter-file.html"><filename>default.filter</filename></ulink>
file is where <emphasis>filters</emphasis> are defined, which can be used to modify or
- remove, web page content on the fly. This applies to <emphasis>anything</emphasis>
+ remove, web page content on the fly. Filters apply to <emphasis>anything</emphasis>
in the page source, including HTML tags, and JavaScript. Regular expressions are used
to accomplish this. There are a number of pre-defined filters to deal with common
annoyances. The filters are only defined here, to invoke them, you need to use the
- <ulink url="../user-manual/actions-file.html#FILTER"><literal>filter</literal> action</ulink>.
+ <ulink
+ url="../user-manual/actions-file.html#FILTER"><literal>filter</literal>
+ action</ulink> in one of the actions files. Filtering is automatically
+ disabled for inappropriate MIME types.
</para>
<para>
If you are familiar with regular expressions, and HTML, you can look at
the provided <filename>default.filter</filename> with a text editor and define
your own filters. This is potentially a very powerful feature, but
- requires some expertise.
+ requires some expertise in both regular expressions and HTML/HTTP.
</para>
<para>
it is uncommented, and assign it the address of the LAN gateway interface,
and port number to use. Assuming your LAN address is 192.168.1.1 and you
wish to run <application>Privoxy</application> on port 8118, this line
- schould look like:
+ should look like:
</para>
<para>
content, giving the user a feeling of "it works". This effect is especially
noticeable on slow dialup connections.
</para>
+<para>
+ Filtering is automatically disabled for inappropriate MIME types.
+
+</para>
</sect2>
The easiest way is to access <application>Privoxy</application> with your
browser by using the remote toggle URL: <ulink
url="http://config.privoxy.org/toggle">http://config.privoxy.org/toggle</ulink>.
+ See the <ulink url="../user-manual/appendix.html#BOOKMARKLETS">Bookmarklets section</ulink>
+ of the <citetitle>User Manual</citetitle> for an easy way to access this
+ feature.
+</para>
+</sect2>
+
+<sect2 renderas="sect3" id="reallyoff">
+<title>When <quote>disabled</quote> is <application>Privoxy</application> totally
+out of the picture?</title>
+<para>
+ No, this just means all filtering and actions are disabled.
+ <application>Privoxy</application> is still acting as a proxy, but just not
+ doing any of the things that <application>Privoxy</application> would
+ normally be expected to do. It is still a <quote>middle-man</quote> in
+ the interaction between your browser and web sites.
</para>
</sect2>
</sect2>
+
+<!-- ~~~~~ New section ~~~~~ -->
+<sect2 id="dun">
+<title>After installing <application>Privoxy</application>, I have to log in
+every time I start IE. What gives?</title>
+
+<para>
+ This is a quirk that effects the installation of
+ <application>Privoxy</application>, in conjunction with Internet Explorer and
+ Internet Connection Sharing on Windows 2000 and Windows XP. The symptoms may
+ appear to be corrupted or invalid DUN settings, or passwords.
+</para>
+
+<para>
+ When setting up an NT based Windows system with
+ <application>Privoxy</application> you may find that things do not seem to be
+ doing what you expect. When you set your system up you will probably have set
+ up Internet Connection Sharing (ICS) with Dial up Networking (DUN) when
+ logged in with administrator privileges. You will probably have made this DUN
+ connection available to other accounts that you may have set-up on your
+ system. E.g. Mum or Dad sets up the system and makes accounts suitably
+ configured for the kids.
+</para>
+
+<para>
+ When setting up <application>Privoxy</application> in this environment you
+ will have to alter the proxy set-up of Internet Explorer (IE) for the
+ specific DUN connection on which you wish to use
+ <application>Privoxy</application>. When you do this the ICS DUN set-up
+ becomes user specific. In this instance you will see no difference if you
+ change the DUN connection under the account used to set-up the connection.
+ However when you do this from another user you will notice that the DUN
+ connection changes to make available to "Me only". You will also find that
+ you have to store the password under each different user!
+</para>
+
+<para>
+ The reason for this is that each user's set-up for IE is user specific. Each
+ set-up DUN connection and each LAN connection in IE store the settings for
+ each user individually. As such this enforces individual configurations
+ rather than common ones. Hence the first time you use a DUN connection after
+ re-booting your system it may not perform as you expect, and prompt you for
+ the password. Just set and save the password again and all should be OK.
+</para>
+
+<para>
+[Thanks to Ray Griffith for this submission.]
+</para>
+</sect2>
+
+
+<!-- ~~~~~ New section ~~~~~ -->
+<sect2 id="ftp">
+<title>I cannot connect to any FTP sites. <application>Privoxy</application>
+ seems to be blocking me.</title>
+ <para>
+ <application>Privoxy</application> cannot act as a proxy for FTP traffic,
+ so do not configure your browser to use <application>Privoxy</application>
+ as an FTP proxy. The same is true for any protocol other than HTTP or HTTPS.
+ </para>
+</sect2>
+
+<!-- ~~~~~ New section ~~~~~ -->
+<sect2 id="osxie">
+<title>In Mac OSX, I can't configure Microsoft Internet Explorer to use
+ <application>Privoxy</application> as the HTTP proxy.</title>
+ <para>
+ Microsoft Internet Explorer (in versions like 5.1) respects system-wide
+ network settings. In order to change the HTTP proxy, open System
+ Preferences, and click on the Network icon. In the settings pane that
+ comes up, click on the Proxies tab. Ensure the "Web Proxy (HTTP)" checkbox
+ is checked and enter <literal>127.0.0.1</literal> in the entry field.
+ Enter <literal>8118</literal> in the Port field. The next time you start
+ IE, it should reflect these values.
+ </para>
+</sect2>
+
</sect1>
<!--
</sect1>
Temple Place - Suite 330, Boston, MA 02111-1307, USA.
$Log: faq.sgml,v $
+Revision 1.61.2.9 2002/08/02 13:14:45 oes
+Added warning about sudo rm -r for Mac OSX deinstallation; moved this item to install section
+
+Revision 1.61.2.8 2002/08/02 02:01:42 david__schmidt
+Add FAQ item for MSIE on OSX HTTP proxy confusion
+
+Revision 1.61.2.7 2002/08/02 01:46:01 david__schmidt
+Added FAQ item for Mac OSX uninstall woes
+
+Revision 1.61.2.6 2002/07/30 20:04:56 hal9
+Fix typo: 'schould'.
+
+Revision 1.61.2.5 2002/07/26 15:22:58 oes
+- Updated to reflect changes in standard.action
+- Added info on where to get updated actions files
+
+Revision 1.61.2.4 2002/07/25 21:42:29 hal9
+Add brief notes on not proxying non-HTTP protocols.
+
+Revision 1.61.2.3 2002/06/09 16:36:33 hal9
+Clarifications on filtering and MIME. Hardcode 'latest release' in index.html.
+
+Revision 1.61.2.2 2002/06/06 02:51:34 hal9
+Fix typo in URL http:/config.privoxy.org
+
+Revision 1.61.2.1 2002/06/05 23:10:43 hal9
+Add new FAQ re: DUN/IE. Change release date from May to June :)
+
+Revision 1.61 2002/05/25 12:37:25 hal9
+Various minor changes and edits.
+
Revision 1.60 2002/05/22 17:17:48 oes
Proofread & added more links into u-m
projects / privoxy.git / blobdiff