consistent look. reuse of copyright, history et. al.
[privoxy.git] / doc / source / faq.sgml
1 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
2 <!entity % dummy "INCLUDE"> 
3 <!entity supported SYSTEM "supported.sgml">
4 <!entity newfeatures SYSTEM "newfeatures.sgml">
5 <!entity p-intro SYSTEM "privoxy.sgml">
6 <!entity seealso SYSTEM "seealso.sgml">
7 <!entity contacting SYSTEM "contacting.sgml">
8 <!entity history SYSTEM "history.sgml">
9 <!entity copyright SYSTEM "copyright.sgml">
10 <!entity p-version "2.9.13">
11 <!entity p-status "BETA">
12 <!entity % p-not-stable "INCLUDE"> <!-- set to IGNORE for stable release  -->
13 <!entity % p-stable "IGNORE">      <!-- set INCLUDE for stable release    -->
14 <!entity % p-text "IGNORE">        <!-- define we are not a text only doc -->
15 <!entity % p-doc "INCLUDE">        <!-- and we are a formal doc           -->
16 <!entity % p-supp-userman "INCLUDE"> <!-- Include all from supported.sgml -->
17 ]>
18 <!--
19  File        :  $Source: /cvsroot/ijbswa/current/doc/source/faq.sgml,v $
20
21  Purpose     :  FAQ
22                 This file belongs into
23                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
24                 
25  $Id: faq.sgml,v 1.41 2002/04/04 06:48:37 hal9 Exp $
26
27  Written by and Copyright (C) 2001 the SourceForge
28  Privoxy team. http://www.privoxy.org/
29
30  Based on the Internet Junkbuster originally written
31  by and Copyright (C) 1997 Anonymous Coders and 
32  Junkbusters Corporation.  http://www.junkbusters.com
33
34  <Qandaset defaultlabel='qanda'>
35   <QandAEntry>
36    <question>
37     <para> 
38      How are you?
39     </para>
40    </question>
41    <answer>
42     <para> 
43      Fine.
44     </para>
45    </answer>
46   </QandAEntry>
47  </QandASet>
48
49 -->
50
51
52 <article id="index" class="faq">
53 <artheader>
54 <title>Privoxy Frequently Asked Questions</title>
55
56 <pubdate>$Id: faq.sgml,v 1.41 2002/04/04 06:48:37 hal9 Exp $</pubdate>
57
58 <authorgroup>
59  <author>
60   <affiliation>
61    <orgname>By: Privoxy Developers</orgname>
62    </affiliation>
63  </author>
64 </authorgroup>
65
66 <abstract>
67 <![%dummy;[
68 <para>
69  <comment>
70   This is here to keep vim syntax file from breaking :/
71   If I knew enough to fix it, I would.
72   PLEASE DO NOT REMOVE! HB: hal@foobox.net
73  </comment>
74 </para>
75 ]]>
76  <para>
77  This FAQ gives users and developers alike answers to frequently asked
78  questions about <ulink url="http://www.privoxy.org">Privoxy</ulink>. 
79  </para>
80
81 <!--
82  Include privoxy.sgml boilerplate:
83 -->
84  &p-intro;
85
86  <para>
87   You can find the latest version of the document at <ulink
88   url="http://www.privoxy.org/faq/">http://www.privoxy.org/faq/</ulink>.
89   Please see the Contact section if you want to contact the developers.
90  </para>
91
92 <!--   <para> -->
93 <!--    Feel free to send a note to the developers at <email>ijbswa-developers@lists.sourceforge.net</email>. -->
94 <!--   </para> -->
95 </abstract>
96 </artheader>
97
98 <!--   ~~~~~       New section      ~~~~~     -->
99 <sect1 id="intro" label=""><title></title>
100 <!-- dummy section to force TOC on page by itself -->
101 <!-- DO NOT REMOVE! please ;) -->
102 <para> </para>
103 </sect1>
104
105 <!--   ~~~~~       New section      ~~~~~     -->
106
107 <sect1 label="1" id="general"><title>General Information</title>
108
109 <sect2 renderas="sect3" id="newjb"><title>What is this new version of <application>Privoxy</application>?</title>
110  <para>
111   The original <application><trademark>Internet
112   Junkbuster</trademark></application> (tm) is a copyrighted product of <ulink
113   url="http://www.junkbusters.com">Junkbusters Corporation</ulink>.
114   Development of this effort stopped some time ago as of version 2.0.2. Stefan
115   Waldherr started the ijbswa project on <ulink
116   url="http://sourceforge.net/projects/ijbswa/">Sourceforge</ulink> to
117   rekindle development. Other developers subsequently joined with Stefan, and
118   have since added many new features, refinements and enhancements. The result
119   of this effort is <application>Privoxy</application>.
120  </para>
121  <para>
122   <application>Privoxy</application> has evolved from the 
123   <application>Junkbuster 2.0.2</application> code base, and has advanced
124   significantly at this point. 
125  </para>
126  <para> 
127   Please see the History section for more
128   information on the history of <application>Junkbuster</application> and 
129   <application>Privoxy</application>.
130  </para>
131
132 </sect2>
133
134
135 <sect2 renderas="sect3">
136 <title id="whyprivoxy">Why <quote>Privoxy</quote>? Why a name change at all?</title>
137 <para>
138  <application>Privoxy</application> is the 
139  <quote><emphasis>Privacy Enhancing Proxy</emphasis></quote>.
140 </para>
141 <para>
142  There are potential legal complications from the continued use of the 
143  <application>Junkbuster</application> name, which is a trademark of 
144  <ulink url="http://junkbusters.com">Junkbusters Corporation</ulink>.
145  (There are, however, no objections from Junkbusters Corporation to the 
146  <application>Privoxy</application> project itself, and they, in fact, still
147  share our ideals and goals.)
148 </para>
149
150 <para>
151  The developers also believed that there are so many changes from the original 
152  code, that it was time to make a clean break from the past and make 
153  a name in their own right, especially now with the pending release of 
154  version 3.0.
155 </para>
156 </sect2>
157
158
159 <sect2 renderas="sect3" id="differs"><title>How does <application>Privoxy</application> differ
160 from the old <application>Junkbuster?</application></title> 
161 <para>
162   <application>Privoxy</application> picks up where
163   <application>Junkbuster</application> left off. All the old features remain.
164   The new <application>Privoxy</application> still blocks ads and banners,
165   still manages cookies, and still helps protect your privacy. But, these are
166   all enhanced, and many new features have been added, all in the same vein.
167  </para>
168  <para>
169   The configuration has changed significantly as well. This is something that
170   users will notice right off the bat. The <quote>blocklist</quote> file does
171   not exist any more. This is replaced by <quote>actions</quote> files, such
172   as <filename>default.actions</filename>. This is where most of the per site
173   configuration is now.
174  </para>
175 </sect2>
176
177 <sect2 renderas="sect3" id="features"><title>What are some of the new features?</title>
178 <!--
179  Include newfeatures.sgml
180 --> 
181 &newfeatures;
182
183 </sect2>
184
185 <sect2 renderas="sect3" id="proxymoron"><title>What is a <quote>proxy</quote>? How does
186 <application>Privoxy</application> work? </title>
187  <para>
188   When you connect to a web site with <application>Privoxy</application>, 
189   you are really connecting to your locally running version of 
190   <application>Privoxy</application>. <application>Privoxy</application>
191   intercepts your requests for the web page, and relays that to the 
192   <quote>real</quote> web site. The web site sends the HTTP data stream 
193   back to <application>Privoxy</application>, where
194   <application>Privoxy</application> can work its magic before it 
195   relays this data back to your web browser.
196  </para>
197
198  <para>
199   Since <application>Privoxy</application> sits between you and the 
200   WWW, it is in a position to intercept and completely manage all web traffic and 
201   HTTP content before it gets to your browser.
202   <application>Privoxy</application> uses various programming methods to do
203   this, all of which is under your control via the various configuration
204   files and options.
205  </para>
206
207  <para>
208   There are many kinds of proxies. <application>Privoxy</application> best 
209   fits the <quote>filtering proxy</quote> category.
210  </para>
211
212 </sect2>
213
214
215 <sect2 renderas="sect3">
216 <title id="knows">How does <application>Privoxy</application> know what is
217 an ad, and what is not?</title>
218 <para>
219  <application>Privoxy</application> processes all the raw content of every 
220  web page. So it reads everything on each page. It then compares this to the
221  rules as set up in the configuration files, and looks for any matches to
222  these rules. <application>Privoxy</application> makes heavy use of
223  <quote>regular expressions</quote>. (If you are not familiar with regular
224  expressions, it is explained briefly in <ulink
225  url="../user-manual/appendix.html">the user manual</ulink>.) Regular
226  expressions facilitate matching of one text string against another, using
227  wildcards to build complex patterns. So <application>Privoxy</application>
228  will typically look for URLs and other content that match certain key words
229  and expressions as defined in the configuration files. For instance a URL
230  that contains <quote>/banners</quote>, has a high probability of containing
231  ad banners, and thus would be a prime candidate to have a matching rule.
232 </para>
233 <para>
234  So <application>Privoxy</application> will look for these kinds of obvious 
235  looking culprits. And also, will use lists of known organizations that
236  specialize in ads. Again, using complex patterns to match as many potential 
237  combinations as possible since there tend to be many, many variations used by 
238  advertisers, and new ones are being introduced all the time.
239 </para>
240 </sect2>
241
242 <sect2 renderas="sect3">
243 <title id="mistakes">Can <application>Privoxy</application> make mistakes? 
244 This does not sound very scientific.</title>
245 <para>
246  Actually, it's a black art ;-) And yes, it is always possible to have a broad rule
247  accidentally block something by mistake. There is a good chance you may run 
248  into such a situation at some point. It is tricky writing rules to cover
249  every conceivable possibility, and not occasionally get false positives.
250 </para>
251
252 <para>
253  But this should not be a big concern since the
254  <application>Privoxy</application> configuration is very flexible, and
255  includes tools to help identify these types of situations so they can be
256  addressed as needed, allowing you to customize your installation.
257  (<link linkend="badsite">See the Troubleshooting section below</link>.)
258 </para>
259
260 </sect2>
261
262
263 <sect2 renderas="sect3" id="browsers2"><title>My browser does the same things as
264 <application>Privoxy</application>. Why should I use
265 <application>Privoxy</application> at all?</title>
266  <para>
267   Modern browsers do indeed have <emphasis>some</emphasis> of the same
268   functionality as <application>Privoxy</application>. Maybe this is
269   adequate for you. But <application>Privoxy</application> is much more
270   versatile and powerful, and can do a number of things that browsers just can't.
271  </para>
272  <para>
273   In addition, a proxy is good choice if you use multiple browsers, or 
274   have a LAN with multiple computers. This way all the configuration 
275   is in one place, and you don't have to maintain a similar configuration 
276   for possibly many browsers.
277
278  </para>
279 </sect2>
280
281
282
283 <sect2 renderas="sect3" id="license"><title>Is there is a license or fee? What about a 
284 warranty? Registration?</title>
285  <para>
286   <application>Privoxy</application> is licensed under the GNU General Public
287   License (GPL). It is free to use, copy, modify or distribute as you wish
288   under the terms of this license.  Please see the Copyright section for more
289   information on the license and copyright.
290
291   </para>
292  <para>
293   There is no warranty of any kind, expressed, implied or otherwise. That is
294   something that would cost real money ;-) There is no registration either.
295   <application>Privoxy</application> really is <emphasis>free</emphasis>
296   in every respect!
297
298  </para>
299
300 </sect2>
301
302 <sect2 renderas="sect3" id="jointeam"><title>I would like to help you, what do I do?</title>
303
304 <sect3 renderas="sect4" id="jointeam-money"><title>Money Money Money</title>
305 <para>
306  We, of course, welcome donations and use the money for domain registering,
307  regular world-wide get-togethers (hahaha). Anyway, we'll soon describe the
308  process how to donate money to the team.
309 </para>
310 </sect3>
311
312 <sect3 renderas="sect4" id="jointeam-work"><title>You want to work with us?</title>
313 <para>
314    Well, helping the team is always a good idea. We welcome new developers,
315    RPM gurus or documentation makers. Simply get an account on sourceforge.net
316    and mail your id to the developer mailing list. Then read the
317    section Quickstart in the <ulink url="../developer-manual/quickstart.html">
318    Developer's Manual</ulink>.
319 </para>
320 <para>
321  Once we have added you to the team, you'll have write access to the CVS
322  repository, and together we'll find a suitable task for you.
323 </para>
324 </sect3>
325
326 </sect2>
327
328 </sect1>
329
330
331 <!--   ~~~~~       New section      ~~~~~     -->
332
333 <sect1  label="2" id="installation"><title>Installation</title>
334
335 <sect2 renderas="sect3" id="whichbrowsers">
336 <title>Which browsers are supported by <application>Privoxy</application>?</title>
337 <para>
338  Any browser that can be configured to use a <quote>proxy</quote>, which 
339  should be virtually all browsers. Direct browser support is not necessary
340  since <application>Privoxy</application> runs as a separate application and
341  just exchanges standard HTML data with your browser, just like a web server
342  does.
343 </para>
344 </sect2>
345
346 <sect2 renderas="sect3" id="whichos">
347 <title>Which operating systems are supported?</title>
348 <!--
349 Include supported.sgml here:
350 -->
351 &supported;
352 </sect2>
353
354 <sect2 renderas="sect3" id="newinstall"><title>Can I install  
355  <application>Privoxy</application> over <application>Junkbuster</application>?</title>
356  <para>
357    We recommend you uninstall <application>Junkbuster</application>
358    first to minimize conflicts and confusion. You may want to 
359    save your old configuration files for future reference. The configuration
360    is substantially changed.
361  </para>
362  <para>
363   See the <ulink
364   url="../user-manual/index.html">user-manual</ulink> for
365   platform specific installation instructions. [FIXME: This is meant for after
366   the name change for 3.0!]
367  </para>
368  <para>
369   Note: Some installers may automatically uninstall
370   <application>Junkbuster</application>, if present!
371  </para>
372
373 </sect2>
374
375 <sect2 renderas="sect3">
376 <title id="firststep">I just installed <application>Privoxy</application>. Is there anything 
377 special I have to do now?</title>
378
379 <para>
380  All browsers must be told to use <application>Privoxy</application> 
381  as a proxy by specifying the correct proxy address and port number 
382  in the appropriate configuration area for the browser. See below.
383  Also, you should flush your browser's memory and disk cache to get rid of any
384  cached items.
385
386 </para>
387
388 </sect2>
389
390
391 <sect2 renderas="sect3" id="localhost"><title>What is the proxy address of <application>Privoxy</application>?</title>
392  <para>
393   If you set up the <application>Privoxy</application> to run on
394   the computer you browse from (rather than your ISP's server or some
395   networked computer on a LAN), the proxy will be on <quote>localhost</quote>
396   (which is the special name used by every computer on the Internet to refer
397   to itself) and the port will be 8118 (unless you have <application>Privoxy</application> to run on a different port with the
398   <emphasis>listen-address</emphasis> config option). 
399  </para>
400  <para>
401   When configuring your browser's proxy settings you typically enter
402   the word <quote>localhost</quote> in the boxes next to <quote>HTTP</quote>
403   and <quote>Secure</quote> (HTTPS) and then the number <quote>8118</quote>
404   for <quote>port</quote>.  This tells your browser to send all web 
405   requests to <application>Privoxy</application> instead of directly to the 
406   Internet.
407  </para>
408  <para>
409   <application>Privoxy</application> can also be used to proxy for 
410   a Local Area Network. In this case, your would enter either the IP 
411   address of the LAN host where <application>Privoxy</application> 
412   is running, or the equivalent hostname. Port assignment would be 
413   same as above.
414  </para>
415  <para>
416   <application>Privoxy</application> does not currently handle
417   protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet
418   protocols. 
419  </para>
420 </sect2>
421
422 <sect2 renderas="sect3">
423 <title id="nothing">I just installed <application>Privoxy</application>, and nothing is happening.
424 All the ads are there. What's wrong?</title>
425
426 <para>
427  Did you configure your browser to use <application>Privoxy</application> 
428  as a proxy? It does not sound like it. See above. You might also try flushing
429  the browser's caches to force a full re-reading of pages. You can verify 
430  that <application>Privoxy</application> is running, and your browser 
431  is correctly configured by entering the special URL: 
432  <ulink url="http://p.p/">http://p.p/</ulink>. This should give you 
433  a banner that says <quote>This is Privoxy</quote> and 
434  access to <application>Privoxy's</application> internal configuration. 
435  If you see this, then you are good to go. If not, the browser or 
436  <application>Privoxy</application> are not set up correctly.
437
438 </para>
439
440 </sect2>
441
442 </sect1>
443
444
445 <!--   ~~~~~       New section      ~~~~~     -->
446
447 <sect1  label="3" id="configuration"><title>Configuration</title>
448
449 <sect2 renderas="sect3" id="newconfig"><title>Can I use my old config files?</title>
450  <para>
451    There are major changes to <application>Junkbuster</application>/ 
452    <application>Privoxy</application> configuration from version 2.0.x to
453    2.9.x and later. Most of the older files will not work at all. This is 
454    especially true of <filename>blocklist</filename>. If this is the case, you
455    will need to re-enter your old data into the new configuration structure.
456    This is probably also a good recommendation even if upgrading from 2.9.x to
457    3.x since there were many minor changes along the way.
458  </para>
459 </sect2>
460
461 <sect2 renderas="sect3">
462 <title id="actionsfile">What is an <quote>actions</quote> file?</title>
463
464 <para>
465  <quote>actions</quote> files are where various actions that
466  <application>Privoxy</application> might take, are configured. 
467  Typically, you would define a set of default actions that apply 
468  to all URLs, then add exceptions to these defaults.
469 </para>
470  
471 <para>
472  Actions can be defined on a per site basis, or for groups of sites. Actions
473  can also be grouped together and then applied to one or more sites. There
474  are many possible actions that might apply to any given site. As an example,
475  if we are blocking cookies as one of our default
476  <application>actions</application>, but need to accept cookies from a given
477  site, we would define this in our <quote>actions</quote> file.
478
479 </para>
480
481 <para>
482  <application>Privoxy</application> comes with several default
483  <application>actions</application> files, with varying degrees 
484  of filtering and blocking, as starting points for your own 
485  configuration (see below).
486 </para>
487
488 </sect2>
489
490 <sect2 renderas="sect3" id="actionss">
491 <title>The <quote>actions</quote> concept confuses me. Please list 
492 some of these <quote>actions</quote>.</title>
493 <para>
494  These are all explained in the 
495  <ulink url="../user-manual/configuration.html#ACTIONSFILE">user-manual</ulink>.
496  Please refer to that.
497 </para>
498 </sect2>
499
500
501 <sect2 renderas="sect3">
502 <title id="actconfig">How are actions files configured? What is the easiest
503 way to do this?</title> 
504
505 <para>
506  The easiest way to do this, is to access <application>Privoxy</application>
507  with your web browser at <ulink url="http://p.p/">http://p.p/</ulink>, 
508  and then select 
509  "<ulink url="http://config.privoxy.org">Edit the actions list</ulink>"
510  from the selection list. You can also do this by editing the appropriate 
511  file with a text editor.
512 </para>
513
514 <para>
515  Please see the 
516  <ulink
517  url="../user-manual/configuration.html#ACTIONSFILE">user-manual</ulink> for a
518  detailed explanation of these and other configuration files, and their
519  various options and syntax.
520 </para>
521 </sect2>
522
523
524 <!--
525 FIXME: Commenting these out until we have some data there. HB 03/17/02.
526
527 <sect2 renderas="sect3" id="yahoo"><title>How can I make my Yahoo account work?</title>
528  <para>
529    Fillme.
530  </para>
531 </sect2>
532
533 <sect2 renderas="sect3" id="hotmail"> <title>How can I make my Hotmail account work?</title>
534   <para>
535    Fillme.
536   </para>
537 </sect2>
538
539 <sect2 renderas="sect3" id="gmx"> <title>How can I make my GMX account work?</title>
540  <para>
541    Fillme.
542  </para>
543 </sect2>
544 -->
545
546 <sect2 renderas="sect3" id="configfiles"> <title>What are the differences between
547 intermediate.action, basic.action, etc.?</title>
548  <para>
549 Configuring <application>Privoxy</application> is not easy. To help you get
550 started, we provide you with three different default configurations. The
551 following table shows you, which features are enabled in each configuration.
552  </para>
553  <para>
554 <table frame=all><title>Default Configurations</title>
555 <tgroup cols=5 align=left colsep=1 rowsep=1>
556 <colspec colname=c1>
557 <colspec colname=c2>
558 <colspec colname=c3>
559 <colspec colname=c4>
560 <colspec colname=c5>
561 <thead>
562 <row>
563   <entry>Feature</entry>
564   <entry>default.action</entry>
565   <entry>basic.action</entry>
566   <entry>intermediate.action</entry>
567   <entry>advanced.action</entry>
568 </row>
569 </thead>
570
571 <!--  <tfoot> -->
572 <!--  <row> -->
573 <!--    <entry>f1</entry> -->
574 <!--    <entry>f2</entry> -->
575 <!--    <entry>f3</entry> -->
576 <!--    <entry>f4</entry> -->
577 <!--    <entry>f5</entry> -->
578 <!--  </row> -->
579 <!--  </tfoot> -->
580
581 <tbody>
582 <!-- new row -->
583 <row>
584   <entry>ad-filtering</entry>
585   <entry>?</entry>
586   <entry>x</entry>
587   <entry>x</entry>
588   <entry>x</entry>
589 </row>
590 <!-- new row -->
591 <row>
592   <entry>blank image</entry>
593   <entry>?</entry>
594   <entry>x</entry>
595   <entry>x</entry>
596   <entry>x</entry>
597 </row>
598 <!-- new row -->
599 <row>
600   <entry>de-animate GIFs</entry>
601   <entry>?</entry>
602   <entry>x</entry>
603   <entry>x</entry>
604   <entry>x</entry>
605 </row>
606 <!-- new row -->
607 <row>
608   <entry>referer forging</entry>
609   <entry>?</entry>
610   <entry>x</entry>
611   <entry>x</entry>
612   <entry>x</entry>
613 </row>
614 <!-- new row -->
615 <row>
616   <entry>jon's +no-cookies-keep (i.e. session cookies only)</entry>
617   <entry>?</entry>
618   <entry>x</entry>
619   <entry>x</entry>
620   <entry>x</entry>
621 </row>
622 <!-- new row -->
623 <row>
624   <entry>no-popup windows</entry>
625   <entry>?</entry>
626   <entry></entry>
627   <entry>x</entry>
628   <entry>x</entry>
629 </row>
630 <!-- new row -->
631 <row>
632   <entry>fast redirects</entry>
633   <entry>?</entry>
634   <entry></entry>
635   <entry>x</entry>
636   <entry>x</entry>
637 </row>
638 <!-- new row -->
639 <row>
640   <entry>hide-referrer</entry>
641   <entry>?</entry>
642   <entry></entry>
643   <entry>x</entry>
644   <entry>x</entry>
645 </row>
646 <!-- new row -->
647 <row>
648   <entry>hide-useragent</entry>
649   <entry>?</entry>
650   <entry></entry>
651   <entry>x</entry>
652   <entry>x</entry>
653 </row>
654 <!-- new row -->
655 <row>
656   <entry>content-modification</entry>
657   <entry>?</entry>
658   <entry></entry>
659   <entry></entry>
660   <entry>x</entry>
661 </row>
662 <!-- new row -->
663 <row>
664   <entry>feature-x</entry>
665   <entry>?</entry>
666   <entry></entry>
667   <entry></entry>
668   <entry></entry>
669 </row>
670 <!-- new row -->
671 <row>
672   <entry>feature-y</entry>
673   <entry>?</entry>
674   <entry></entry>
675   <entry></entry>
676   <entry></entry>
677 </row>
678 <!-- new row -->
679 <row>
680   <entry>feature-z</entry>
681   <entry>?</entry>
682   <entry></entry>
683   <entry></entry>
684   <entry></entry>
685 </row>
686 <!-- finish -->
687 </tbody>
688 </tgroup>
689 </table>
690 </para>
691 </sect2>
692
693 <sect2 renderas="sect3" id="browseconfig"> <title>Why can I change the configuration with a
694 browser? Does that not raise security issues?</title>
695  <para>
696 What I don't understand, is how I can browser edit the config file as a
697 regular user, while the whole <filename>/etc/privoxy</filename> hierarchy
698 belongs to the user <quote>privoxy</quote>, with only 644 permissions.
699  </para>
700  <para>
701 When you use the browser-based editor, <application>Privoxy</application>
702 itself is writing to the config files.  Because
703 <application>Privoxy</application> is running as the user <quote>privoxy</quote>, it can
704 update the config files.
705  </para>
706  <para>
707 If you don't like this, setting <quote>enable-edit-actions 0</quote> in the
708 config file will disable the browser-based editor.  If you're that paranoid,
709 you should also consider setting <quote>enable-remote-toggle 0</quote> to prevent
710 browser-based enabling/disabling of <application>Privoxy</application>.
711  </para>
712  <para>
713 Note that normally only local users can connect to
714 <application>Privoxy</application>, so this is not (normally) a security
715 problem.
716  </para>
717 </sect2>
718
719
720 <sect2 renderas="sect3">
721 <title id="filterfile">What is <quote>default.filter</quote>?</title>
722 <para>
723  The <quote>default.filter</quote> file is used to <quote>filter</quote> any
724  web page content. By <quote>filtering</quote> we mean it can modify, remove, 
725  or change <emphasis>anything</emphasis> on the page, including HTML tags, and
726  JavaScript. Regular expressions are used to accomplish this, and operate 
727  on a line by line basis. This is potentially a very powerful feature, but
728  requires some expertise. 
729 </para>
730
731 <para>
732  If you are familiar with regular expressions, and HTML, you can look at 
733  the provided <filename>default.filter</filename> with a text editor and see
734  some of things it can be used for.
735 </para>
736
737 <para>
738  Presently, there is no GUI editor option for this part of the configuration, 
739  but you can disable/enable various sections of the included default 
740  file with the <quote>Actions List Editor</quote> from your browser.
741 </para>
742
743 </sect2>
744
745 <sect2 renderas="sect3">
746 <title id="lanconfig">How can I set up <application>Privoxy</application> to act as a proxy for my 
747  LAN?</title>
748 <para>
749  By default, <application>Privoxy</application> only responds to requests 
750  from localhost. To have it act as a server for a network, this needs to be 
751  changed in the main config file where the <application>Privoxy</application>
752  configuration is located. In that file is a <quote>listen-address</quote> 
753  option. It may be commented out with a <quote>#</quote> symbol. Make sure 
754  it is uncommented, and assign it the address of the LAN gateway interface, 
755  and port number to use:
756 </para>
757
758 <para>
759  <screen>
760   listen-address  192.168.1.1:8118
761  </screen>
762 </para>
763
764 <para>
765  Save the file, and restart <application>Privoxy</application>. Configure 
766  all browsers on the network then to use this address and port number.
767 </para>
768
769 </sect2>
770
771
772 <sect2 renderas="sect3">
773 <title id="noseeum">Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</title>
774 <para>
775  This is a configuration option for images that
776  <application>Privoxy</application> is stopping. You have the choice <!-- of
777  the --> <!-- <application>Privoxy</application> logo, --> of a checkerboard
778  pattern, a transparent 1x1 GIF image (aka <quote>blank</quote>), or a custom
779  URL of your choice. Note that to fit this category, the URL must match both 
780  the <quote>+image</quote> and <quote>+block</quote> actions.
781 </para>
782
783 <para>
784  If you want to see nothing, then change the <quote>+image-blocker</quote> 
785  action to <quote>+image-blocker{blank}</quote>. This can be done from the 
786  <quote>Edit Actions List</quote> selection at <ulink
787  url="http://p.p/">http://p.p/</ulink>. Or by hand editing the appropriate 
788  actions file. This will only effect what is defined as <quote>images</quote>
789  though. Also, some URLs that generate the bright red <quote>Blocked</quote>
790  banner, can be moved to the <quote>+image-blocker</quote> section for the
791  same reason, but there are some limits and risks to this (see below).
792 </para>
793
794 </sect2>
795
796
797 <sect2 renderas="sect3">
798 <title id="whyseeum">Why would anybody want to see a checkerboard pattern?</title>
799 <para>
800  This can be helpful for troubleshooting problems. It might also be good 
801  for anyone new to <application>Privoxy</application> so that they can 
802  see if their favorite pages are displaying correctly, and
803  <application>Privoxy</application> is not inadvertently removing something 
804  important.
805 </para>
806
807 </sect2>
808
809 <sect2 renderas="sect3">
810 <title id="blockedisugly">I see large red banners on some pages that say 
811 <quote>Blocked</quote>. Why and how do I get rid of this?</title>
812 <para>
813  These are URLs that match something in one of 
814  <application>Privoxy's</application> block actions (+block). It is meant
815  to be a warning so that you know something has been blocked and an easy way
816  for you to see why. These are handled differently than what has been defined
817  explicitly as <quote>images</quote> (e.g. ad banners). Depending on the 
818  URL itself, it is sometimes hard for <application>Privoxy</application> to 
819  really know whether there is indeed an ad image there or not. And there are
820  limitations as to what <application>Privoxy</application> can do to 
821  <quote>fool</quote> the browser.
822 </para>
823
824 <para>
825  For instance, if the ad is in a frame, then it is embedded in the separate
826  HTML page used for the frame. In this case, you cannot just substitute an
827  aribitray image (like we would for a <quote>blank</quote> image), for an HTML
828  page. The browser is expecting an HTML page, and that is what it must have
829  for frames. So this situation can be a little trickier to deal with, and 
830  <application>Privoxy</application> will use the <quote>Blocked</quote> page.
831 </para>
832
833 <para>
834  If you want these to be treated as if they were images, so that they can be
835  made invisible, you can try moving the offending URL from the
836  <quote>+block</quote> section to the <quote>+imageblock</quote> section of
837  your actions file. Just be forewarned, if any URL is made
838  <quote>invisible</quote>, you may not have any inkling that something has
839  been removed from that page, or why. If this approach does not work, then you are
840  probably dealing with a frame (or <quote>ilayer</quote>), and the only thing
841  that can go there is an HTML page of some sort.
842 </para>
843 <para>
844  To deal with this situation, you could modify the
845  <quote><filename>block</filename></quote> HTML template that is used by
846  <application>Privoxy</application> to display this, and make it something
847  more to your liking. Currently, there is no configuration option for this.
848  You will have to modify, or create your own page, and use this to replace
849  <filename>templates/blocked</filename>, which is what
850  <application>Privoxy</application> uses to display the <quote>Blocked</quote>
851  page.
852 </para>
853 <para>
854  Another way to deal with this is find why and where
855  <application>Privoxy</application> is blocking the frame, and 
856  diable this. Then let the <quote>+image-blocker</quote> action 
857  handle the ad that is embedded in the frame's HTML page. 
858 </para>
859
860 </sect2>
861
862 <sect2 renderas="sect3" id="alliseeisred">
863 <title>I cannot see all of the <quote>Blocked</quote> page banner. All I
864 see is a bright red square.</title>
865 <para>
866  There is not enough space to fit the entire page. Try right clicking on the
867  visible, red portion, and select <quote>Show Frame</quote>, or equivalent.
868  This will usually allow you to see the entire Privoxy <quote>Blocked</quote>
869  page, and from there you can see just what is being blocked, and why.
870 </para>
871 </sect2>
872
873 <sect2 renderas="sect3" id="otherproxy">
874 <title>How can I make <application>Privoxy</application> work with other 
875 proxies like <application>Squid</application>?</title>
876 <para>
877  This can be done. See the <ulink
878  url="../user-manual/configuration.html#FORWARDING">user manual</ulink>, 
879  which describes how to do this.
880
881 </para>
882
883 </sect2>
884
885 </sect1>
886
887 <!--   ~~~~~       New section      ~~~~~     -->
888
889 <sect1  label="4"id="misc"><title>Miscellaneous</title>
890
891 <sect2 renderas="sect3">
892 <title id="slowsme">How much does <application>Privoxy</application> slow my browsing down? This 
893 has to add extra time to browsing.</title>
894 <para>
895  It should not slow you down any in real terms, and may actually help 
896  speed things up since ads, banners and other junk are not being displayed.
897  The actual processing time required by <application>Privoxy</application> 
898  itself for each page, is relatively small in the overall scheme of things,
899  and happens very quickly. This is typically more than offset by time saved
900  not downloading and rendering ad images.
901 </para>
902
903 <para>
904  <quote>Filtering</quote> via the <filename>filterfile</filename> 
905  mechanism may cause a perceived slowdown, since the entire page is buffered
906  before displaying. See below.
907 </para>
908
909 </sect2>
910
911
912
913 <sect2 renderas="sect3" id="loadingtimes"><title>I noticed considerable
914 delays in page requests compared to the old Junkbuster. What's wrong?</title>
915 <para>
916 Using the default filtering configuration, I noticed considerable delays in
917 page requests compared to the old Junkbuster. Loading pages with large contents
918 seemed to take forever, then suddenly delivering all the content at once.
919  </para>
920 <para>
921 The whole content must be loaded in order to filter, and nothing is is
922 sent to the browser during this time. The loading time does not really
923 change in real numbers, but the feeling is different, because most
924 browsers are able to start rendering incomplete content, giving the
925 user a feeling of "it works". 
926  </para>
927 <para>
928 To modify the content of a page (i.e. make frames resizeable again, etc.) and
929 not just replace ads, <application>Privoxy</application> needs to download the
930 entire page first, do its content magic and then send the page to the browser.
931 </para>
932 </sect2>
933
934
935 <sect2 renderas="sect3" id="configurl"><title>What is the "http://p.p/"?</title>
936 <para>
937 Since <application>Privoxy</application> sits between your web browser and the Internet, it can be
938 programmed to handle certain pages specially.
939 </para>
940
941 <para>
942 With recent versions of <application>Privoxy</application> (version 2.9.x), you can get some
943 information about <application>Privoxy</application> and change some settings by going to
944 <ulink url="http://p.p/">http://p.p/</ulink> or, equivalently, <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink>
945 (Note that p.p is far easier to type but may not work in some
946 configurations. With the name change to <application>Privoxy</application>,
947 this is changed from the previous http://i.j.b/ or earlier 2.9.x versions).
948 </para>
949
950 <para>
951 These pages are <emphasis>not</emphasis> forwarded to a server on the Internet
952 - instead they are handled by a special web server which is built in to
953 <application>Privoxy</application>.
954 </para>
955
956 <para>
957 If you are not running <application>Privoxy</application>, then <ulink
958 url="http://p.p/">http://p.p/</ulink> will fail, and <ulink
959 url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> will
960 return a web page telling you you're not running
961 <application>Privoxy</application>.
962 </para>
963
964 <para>
965 If you have version 2.0.2, then the equivalent is
966 http://example.com/show-proxy-args (but you get far less information, and you
967 should really consider upgrading to 2.9.x).
968 </para>
969 </sect2>
970
971 <!--
972 FIXME: commented out until we have data. HB 03/18/02.
973
974 <sect2 renderas="sect3" id="badfiledesc"><title>I get the message 'Bad File Descriptor', why?</title>
975 <para>
976    Fillme.
977 </para>
978 </sect2>
979
980 <sect2 renderas="sect3" id="proxy-chaining"><title>How do I chain <application>Privoxy</application> with other proxies
981 (e.g. squid)?</title>
982 <para>
983    Fillme.
984 </para>
985 </sect2>
986 -->
987
988 <sect2 renderas="sect3" id="blocklist"><title>Do you still maintain the blocklists?</title>
989 <para>
990     No. The format of the blocklists has changed significantly in the versions
991     2.9.x. Once we have released the new stable version, v3.0, there will
992     again be blocklists that you can update automatically.
993 </para>
994 </sect2>
995
996 <sect2 renderas="sect3" id="newads"><title>How can I submit new ads?</title>
997 <para>
998     As of now, please discontinue to submit new ad blocking infos. Once we
999     have released the new version, there will again be a form on the website,
1000     which you can use to contribute new ads.
1001 </para>
1002 </sect2>
1003
1004 <sect2 renderas="sect3" id="ip"><title>How can I hide my IP address?</title>
1005 <para>
1006  You cannot hide your IP address with <application>Privoxy</application> or any other software, since
1007 the server needs to know your IP address to send the answer to you.
1008 </para>
1009 <para>
1010 Fortunately there are many publicly usable anonymous proxies out there, which
1011 solve the problem by providing a further level of indirection between you and
1012 the web server, shared by many people and thus letting your requests "drown"
1013 in white noise of unrelated requests as far as user tracking is concerned.
1014 </para>
1015 <para>
1016 Most of them will, however, log your IP address and make it available to the
1017 authorities in case you abuse that anonymity for criminal purposes. In fact
1018 you can't even rule out that some of them only exist to *collect* information
1019 on (those suspicious) people with a more than average preference for privacy.
1020 </para>
1021 <para>
1022 You can find a list of anonymous public proxies at <ulink
1023 url="http://www.multiproxy.org/anon_list.htm">multiproxy.org</ulink> and many
1024 more through Google.
1025 </para>
1026 </sect2>
1027
1028 <!--  <sect2 renderas="sect3" id="image"><title>What is the imagefile (simage.ini, etc.) for?</title> -->
1029 <!--  <para> -->
1030 <!--   Anytime <application>Privoxy</application> determines (with the help of the blocklist) that a URL -->
1031 <!--   contains an advertisement, it has to decide whether this advertisement is an -->
1032 <!--   image or not. <application>Privoxy</application> uses the imagefile for that purpose. -->
1033 <!--  </para> -->
1034 <!--  </sect2> -->
1035
1036 <sect2 renderas="sect3">
1037 <title id="anonforsure">Can <application>Privoxy</application> guarantee I am anonymous?</title>
1038 <para>
1039  No. Your chances of remaining anonymous are greatly improved, but unless you
1040  are an expert on Internet security it would be safest to assume that
1041  everything you do on the Web can be traced back to you.
1042 </para>
1043 <para>
1044  <application>Privoxy</application> can remove various information about you,
1045  and allows <emphasis>you</emphasis> more freedom  to decide which sites 
1046  you can trust. But it's still possible that web sites can find out who you
1047  are. Here's one way this can happen.
1048 </para>
1049 <para>
1050  A few browsers disclose the user's email address in certain situations, such
1051  as when transferring a file by FTP. <application>Privoxy</application>
1052  does not filter FTP. If you need this feature, or are concerned about the
1053  mail handler of your browser disclosing your email address, you might
1054  consider products such as <application>NSClean</application>.
1055 </para>
1056 <para>
1057  Browsers available only as binaries could use non-standard headers to give
1058  out any information they can have access to: see the manufacturer's license
1059  agreement. It's impossible to anticipate and prevent every breach of privacy
1060  that might occur. The professionally paranoid prefer browsers available as
1061  source code, because anticipating their behavior is easier. Trust the source,
1062  Luke!
1063 </para>
1064
1065 </sect2>
1066
1067 <sect2 renderas="sect3">
1068 <title id="sitebreak">Might some things break because header information is
1069 being altered?</title>
1070
1071 <para>
1072  Definitely. More and more sites use HTTP header content to decide what to
1073  display and how to display it. There is many ways that this can be handled, 
1074  so having hard and fast rules, is tricky.
1075 </para>
1076
1077 <para>
1078  <quote>USER AGENT</quote> in particular is often used in this way to identify
1079  the browser, and adjust content accordingly. Changing this now is not
1080  recommended, since so many sites do look for this. You may get undesirable 
1081  results by changing this.
1082 </para>
1083
1084 <para>
1085  For instance, different browsers use different encodings of Russian and Czech
1086  characters, certain web servers convert pages on-the-fly according to the
1087  User Agent header. Giving a <quote>User Agent</quote> with the wrong
1088  operating system or browser manufacturer causes some sites in these languages
1089  to be garbled; Surfers to Eastern European sites should change it to
1090  something closer. And then some page access counters work by looking at the
1091  <quote>REFERER</quote> header; they may fail or break if unavailable. The
1092  weather maps of Intellicast have been blocked by their server when no
1093  <quote>REFERER</quote> or cookie is provided, is another example. There are
1094  many, many other ways things can go wrong when trying to fool a web server.
1095 </para>
1096
1097 <para>
1098  If you have problems with a site, you will have to adjust your configuration 
1099  accordingly. Cookies are probably the most likely adjustment that may 
1100  be required, but by no means the only one.
1101
1102 </para>
1103
1104 </sect2>
1105
1106
1107 <sect2 renderas="sect3">
1108 <title id="caching">Can <application>Privoxy</application> act as a <quote>caching</quote> proxy to 
1109 speed up web browsing?</title>
1110 <para>
1111  No, it does not have this ability at all. You want something like 
1112  <ulink url="http://www.squid-cache.org/">Squid</ulink> for this. And, yes, 
1113  before you ask, <application>Privoxy</application> can co-exist 
1114  with other kinds of proxies like <application>Squid</application>.
1115 </para>
1116 </sect2>
1117
1118 <sect2 renderas="sect3">
1119 <title id="firewall">What about as a firewall? Can <application>Privoxy</application> protect me?</title>
1120 <para>
1121  Not in the way you mean, or in the way a true firewall can, or a proxy that
1122  has this specific capability. <application>Privoxy</application> can help
1123  protect your privacy, but not really protect you from intrusion attempts.
1124 </para>
1125 </sect2>
1126
1127
1128 <sect2 renderas="sect3">
1129 <title id="logo">The <application>Privoxy</application> logo that replaces ads is very blocky 
1130 and ugly looking. Can't a better font be used?</title>
1131
1132 <para>
1133  This is not a font problem. The logo is an image that is created by 
1134  <application>Privoxy</application> on the fly. So as to not waste 
1135  memory, the image is rather small. The blockiness comes when the 
1136  image is scaled to fill a largish area. There is not much to be done 
1137  about this, other than to use one of the other
1138  <quote>imageblock</quote> directives: <emphasis>pattern</emphasis>, 
1139  <emphasis>blank</emphasis>, or a URL of your choosing.
1140 </para>
1141 <para>
1142 Given the above problem, we have decided to remove the logo option entirely 
1143 [as of v2.9.13].
1144 </para>
1145 </sect2>
1146
1147
1148 <sect2 renderas="sect3">
1149 <title id="wasted">I have large empty spaces now where ads used to be. 
1150 Why?</title>
1151 <para>
1152  It would be easy enough to just eliminate this space altogether, rather than
1153  fill it with blank space. But, this would create problems with many pages
1154  that use the overall size of the ad to help organize the page layout and
1155  position the various components of the page where they were intended to be.
1156  It is best left this way.
1157 </para>
1158
1159 </sect2>
1160
1161 <sect2 renderas="sect3">
1162 <title id="ssl">How can <application>Privoxy</application> filter Secure (HTTPS) URLs?</title>
1163 <para>
1164  This is a limitation since HTTPS transactions are encrypted SSL sessions
1165  between your browser and the secure site, and are meant to be reliably 
1166  <emphasis>secure</emphasis> and private. This means that all cookies and HTTP
1167  header information are also encrypted from the time they leave your browser,
1168  to the site, and vice versa. <application>Privoxy</application> does not
1169  try to unencrypt this information, so it just passes through as is.
1170  <application>Privoxy</application> can still catch images and ads that
1171  are embedded in the SSL stream though.
1172 </para>
1173
1174 </sect2>
1175
1176
1177 <sect2 renderas="sect3">
1178 <title id="secure"><application>Privoxy</application> runs as a <quote>server</quote>. How 
1179 secure is it? Do I need to take any special precautions?</title>
1180 <para>
1181  There are no known exploits that might effect
1182  <application>Privoxy</application>. On Unix-like systems, 
1183  <application>Privoxy</application> can run as a non-privileged 
1184  user, which is how we recommend it be run. Also, by default 
1185  <application>Privoxy</application> only listens to requests 
1186  from <quote>localhost</quote>. The server aspect of
1187  <application>Privoxy</application> is not itself directly exposed to the
1188  Internet in this configuration. If you want to have
1189  <application>Privoxy</application> serve as a LAN proxy, this will have to
1190  be opened up to allow for LAN requests. In this case, we'd recommend
1191  you specify only the LAN gateway address, e.g. 192.168.1.1, in the main 
1192  <application>Privoxy</application> config file. All LAN hosts can then use 
1193  this as their proxy address in the browser proxy configuration. In this way, 
1194  <application>Privoxy</application> will not listen on any external ports.
1195  Of course, a firewall is always good too. Better safe than sorry.
1196 </para>
1197
1198 </sect2>
1199
1200 <sect2 renderas="sect3" id="turnoff">
1201 <title>How can I temporarily disable <application>Privoxy</application>?</title>
1202 <para>
1203  The easiest way is to access <application>Privoxy</application> with your 
1204  browser by using the special URL: <ulink url="http://p.p/">http://p.p/</ulink>
1205  and select "Toggle Privoxy on or off" from that page.
1206
1207 </para>
1208 </sect2>
1209
1210 </sect1>
1211
1212
1213 <!--   ~~~~~       New section      ~~~~~     -->
1214
1215 <sect1 label="5" id="trouble">
1216 <title>Troubleshooting</title>
1217
1218 <sect2 renderas="sect3">
1219 <title id="refused">I just upgraded and am getting <quote>connection refused</quote>
1220 with every web page?</title>
1221 <para>
1222  Either <application>Privoxy</application> is not running, or your 
1223  browser is configured for a different port than what
1224  <application>Privoxy</application> is using.
1225 </para>
1226
1227 <para>
1228  The old <application>Privoxy</application> (and also
1229  <application>Junkbuster</application>) used port 8000 by 
1230  default. This has been changed to port 8118 now, due to a conflict 
1231  with NAS (Network Audio Service), which uses port 8000. If you haven't, 
1232  you need to change your browser to the new port number, or alternately 
1233  change <application>Privoxy's</application> <quote>listen-address</quote>
1234  setting in the <filename>config</filename> file used to start 
1235  <application>Privoxy</application>.
1236 </para>
1237
1238 </sect2>
1239
1240 <sect2 renderas="sect3">
1241 <title id="flushit">I just added a new rule, but the steenkin ad is 
1242 still getting through. How?</title>
1243 <para>
1244  If the ad had been displayed before you added its URL, it will probably be
1245  held in the browser's cache for some time, so it will be displayed without
1246  the need for any request to the server, and <application>Privoxy</application>
1247  will not be in the picture. The best thing to do is try flushing the browser's
1248  caches. And then try again.
1249 </para>
1250
1251 <para>
1252  If this doesn't help, you probably have an error in the rule you
1253  applied. Try pasting the full URL of the offending ad into <ulink
1254  url="http://config.privoxy.org/show-url-info">http://config.privoxy.org/show-url-info</ulink>
1255  and see if any actions match your new rule.
1256 </para>
1257
1258 </sect2>
1259
1260 <sect2 renderas="sect3">
1261 <title id="badsite">One of my favorite sites does not work with <application>Privoxy</application>.
1262 What can I do?</title>
1263
1264 <para>
1265  First verify that it is indeed a <application>Privoxy</application> problem, 
1266  by disabling <application>Privoxy</application> filtering and blocking. 
1267  Go to <ulink url="http://p.p/">http://p.p/</ulink> and click on 
1268  <quote>Toggle Privoxy On or Off</quote>, then disable it. Now try that 
1269  page again. It's probably a good idea to flush the browser cache as well.
1270 </para>
1271
1272 <para>
1273  If still a problem, go to <quote>Show which actions apply to a URL and
1274  why</quote> from <ulink url="http://p.p/">http://p.p/</ulink> and paste
1275  the full URL of the page in question into the prompt. See which actions are
1276  being applied to the URL. Now, armed with this information, go to <quote>Edit
1277  the actions list</quote>. Here you should see various sections that have
1278  various <application>Privoxy</application> features disabled for specific
1279  sites. Most disabled <quote>actions</quote> will have a <quote>-</quote> (minus
1280  sign) in front of them. Some aliases are used just to disable other actions, 
1281  e.g. <quote>shop</quote> and <quote>fragile</quote>, and won't necessarily 
1282  use a <quote>+</quote> or <quote>-</quote> sign. Add your problem page
1283  URL to one of these sections that looks like it is disabling the feature that
1284  is causing the problem. Rember to flush your browser's caches when making 
1285  such changes! As a last resort, try <quote>fragile</quote> which
1286  disables most actions. Now re-try the page. There might be some trial and
1287  error involved. This is discussed in a little more detail in the <ulink
1288  url="../user-manual/appendix.html#ACTIONSANAT">user-manual appendix</ulink>.
1289
1290 </para>
1291
1292 <para>
1293  Alternately, if you are comfortable with a text editor, you can accomplish 
1294  the same thing by editing the appropriate <quote>actions</quote> file.
1295 </para>
1296
1297 </sect2>
1298
1299 <sect2 renderas="sect3" id="bugs">
1300 <title>Where can I get help? Report bugs? Feature Requests? Etc?</title>
1301 <para>
1302  Feedback is encouraged, whether good, bad or ugly. Please see the contact
1303  page in the <ulink url="../user-manual/contact.html">user-manual</ulink> for
1304  details.
1305
1306 </para>
1307
1308 </sect2>
1309
1310 <sect2 renderas="sect3">
1311 <title id="time">What time is it?</title>
1312 <para>
1313  Time for you to go!
1314 </para>
1315 </sect2>
1316
1317 </sect1>
1318 <!--
1319 </sect1>
1320 -->
1321
1322 <!--   ~~~~~       New section      ~~~~~     -->
1323 <!--
1324 FIXME: Commented out until we have something to put here. HB 03/18/02.
1325 <sect1 id="knownissues"><title>Known Issues</title>
1326 <para>
1327    Fillme.
1328 </para>
1329 </sect1>
1330 -->
1331
1332   <!--   ~~~~~       New section      ~~~~~     -->
1333   <sect1 id="contact"><title>Contacting the developers, Bug Reporting and Feature Requests</title>
1334 <!-- Include contacting.sgml  -->
1335  &contacting;
1336 <!-- end contacting -->
1337   </sect1>
1338   
1339   <!--   ~~~~~       New section      ~~~~~     -->
1340   <sect1 id="copyright"><title>Copyright and History</title>
1341
1342 <sect2><title>Copyright</title>
1343 <!-- Include copyright.sgml -->
1344  &copyright;
1345 <!-- end -->
1346 </sect2>
1347
1348 <sect2><title>History</title>
1349 <!-- Include history.sgml -->
1350  &history;
1351 <!-- end -->
1352 </sect2>
1353
1354   </sect1>
1355   
1356   <!--   ~~~~~       New section      ~~~~~     -->
1357   <sect1 id="seealso"><title>See also</title>
1358 <!-- Include seealso.sgml -->
1359  &seealso;
1360 <!-- end  -->
1361
1362   </sect1>
1363
1364 <!-- hhmts end -->
1365  <!--
1366  Tue 09/11/01 06:38:14 PM EST: Test SGML doc by Hal Burgiss.
1367  
1368  Last modified: Mon Sep 10 19:22:09 CEST 2001
1369  
1370  This program is free software; you can redistribute it 
1371  and/or modify it under the terms of the GNU General
1372  Public License as published by the Free Software
1373  Foundation; either version 2 of the License, or (at
1374  your option) any later version.
1375
1376  This program is distributed in the hope that it will
1377  be useful, but WITHOUT ANY WARRANTY; without even the
1378  implied warranty of MERCHANTABILITY or FITNESS FOR A
1379  PARTICULAR PURPOSE.  See the GNU General Public
1380  License for more details.
1381
1382  The GNU General Public License should be included with
1383  this file.  If not, you can view it at
1384  http://www.gnu.org/copyleft/gpl.html
1385  or write to the Free Software Foundation, Inc., 59
1386  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
1387
1388 $Log: faq.sgml,v $
1389 Revision 1.41  2002/04/04 06:48:37  hal9
1390 Structural changes to allow for conditional inclusion/exclusion of content
1391 based on entity toggles, e.g. 'entity % p-not-stable  "INCLUDE"'. And
1392 definition of internal entities, e.g. 'entity p-version "2.9.13"' that will
1393 eventually be set by Makefile.
1394 More boilerplate text for use across multiple docs.
1395
1396 Revision 1.40  2002/04/03 04:22:03  hal9
1397 Fixed several typos.
1398
1399 Revision 1.39  2002/04/03 03:53:03  hal9
1400 Revert some changes, and then make some news, to layout, and appearance.
1401
1402 Revision 1.38  2002/04/02 03:49:10  hal9
1403 Major changes to doc structure and layout. Sections are not automatically
1404 numbered now. TOC is on page by itself.
1405
1406 Revision 1.37  2002/04/01 16:24:07  hal9
1407 -Rework of supported Q/A.
1408 -Set up entities to include boilerplate text.
1409
1410 Revision 1.36  2002/03/31 23:18:47  hal9
1411 More on dealing with BLOCKED.
1412
1413 Revision 1.35  2002/03/30 04:14:19  hal9
1414 Fix privoxy.org/config links.
1415
1416 Revision 1.34  2002/03/29 04:35:56  hal9
1417 Touch ups.
1418
1419 Revision 1.33  2002/03/29 01:31:48  hal9
1420 Several new Q/A's and other touch ups.
1421
1422 Revision 1.32  2002/03/27 00:57:03  hal9
1423 Touch ups for name change.
1424
1425 Revision 1.31  2002/03/26 22:29:55  swa
1426 we have a new homepage!
1427
1428 Revision 1.30  2002/03/25 16:39:22  hal9
1429 A few new sections. Made all links relative to user-manual.
1430
1431 Revision 1.29  2002/03/25 05:23:57  hal9
1432 Moved section, and touch ups.
1433
1434 Revision 1.28  2002/03/25 04:27:33  hal9
1435 New section related to name change.
1436
1437 Revision 1.25  2002/03/24 16:08:08  swa
1438 we are too lazy to make a block-built
1439 privoxy logo. hence removed the option.
1440
1441 Revision 1.24  2002/03/24 15:46:20  swa
1442 name change related issue.
1443
1444 Revision 1.23  2002/03/24 12:33:01  swa
1445 more additions.
1446
1447 Revision 1.22  2002/03/24 11:51:00  swa
1448 name change. changed filenames.
1449
1450 Revision 1.21  2002/03/24 11:01:06  swa
1451 name change
1452
1453 Revision 1.20  2002/03/23 15:13:11  swa
1454 renamed every reference to the old name with foobar.
1455 fixed "application foobar application" tag, fixed
1456 "the foobar" with "foobar". left junkbustser in cvs
1457 comments and remarks to history untouched.
1458
1459 Revision 1.19  2002/03/21 17:01:54  hal9
1460 Some touch ups.
1461
1462 Revision 1.18  2002/03/18 16:40:31  hal9
1463 More additions.
1464
1465 Revision 1.17  2002/03/18 03:53:53  hal9
1466 Some new additions.
1467
1468 Revision 1.16  2002/03/17 21:32:56  hal9
1469 A few more additions.
1470
1471 Revision 1.15  2002/03/17 07:25:59  hal9
1472 Correcting some of my typos, and some additions.
1473
1474 Revision 1.14  2002/03/17 02:39:13  hal9
1475 A little more added ...
1476
1477 Revision 1.13  2002/03/17 00:22:20  hal9
1478 Adding new stuff, and trying to incorporate stuff from old faq.
1479
1480 Revision 1.12  2002/03/11 20:13:21  swa
1481 typo
1482
1483 Revision 1.11  2002/03/11 18:42:27  swa
1484 new section
1485
1486 Revision 1.10  2002/03/11 13:13:27  swa
1487 correct feedback channels
1488
1489 Revision 1.9  2002/03/10 23:34:04  swa
1490 more info on not hiding ip address
1491
1492 Revision 1.8  2002/03/09 15:55:48  swa
1493 added default config section
1494
1495 Revision 1.7  2002/03/07 18:16:55  swa
1496 looks better
1497
1498 Revision 1.6  2002/03/07 13:16:31  oes
1499 Committing changes by Stefan
1500
1501 Revision 1.5  2002/03/02 15:50:04  swa
1502 2.9.11 version. more input for docs.
1503
1504 Revision 1.4  2002/02/24 14:34:24  jongfoster
1505 Formatting changes.  Now changing the doctype to DocBook XML 4.1
1506 will work - no other changes are needed.
1507
1508 Revision 1.3  2001/09/23 10:13:48  swa
1509 upload process established. run make webserver and
1510 the documentation is moved to the webserver. documents
1511 are now linked correctly.
1512
1513 Revision 1.2  2001/09/13 15:20:17  swa
1514 merged standards into developer manual
1515
1516 Revision 1.1  2001/09/12 15:36:41  swa
1517 source files for junkbuster documentation
1518
1519 Revision 1.3  2001/09/10 17:43:59  swa
1520 first proposal of a structure.
1521
1522 Revision 1.2  2001/06/13 14:28:31  swa
1523 docs should have an author.
1524
1525 Revision 1.1  2001/06/13 14:20:37  swa
1526 first import of project's documentation for the webserver.
1527
1528 -->
1529
1530 </article>