From c5aed82a9a4d52c7f44885058167a6e402815226 Mon Sep 17 00:00:00 2001 From: hal9 Date: Mon, 29 Apr 2002 03:36:29 +0000 Subject: [PATCH] Sync with source. --- doc/webserver/developer-manual/coding.html | 4 +- doc/webserver/developer-manual/copyright.html | 4 +- doc/webserver/developer-manual/index.html | 11 +- .../developer-manual/newrelease.html | 104 ++++++++- doc/webserver/faq/configuration.html | 213 ++++++++++++------ doc/webserver/faq/copyright.html | 4 +- doc/webserver/faq/general.html | 2 +- doc/webserver/faq/index.html | 75 +++--- doc/webserver/faq/misc.html | 42 ++-- doc/webserver/faq/trouble.html | 31 +-- doc/webserver/user-manual/actions-file.html | 94 +++++--- doc/webserver/user-manual/appendix.html | 18 +- doc/webserver/user-manual/copyright.html | 2 +- doc/webserver/user-manual/filter-file.html | 2 +- doc/webserver/user-manual/index.html | 22 +- 15 files changed, 418 insertions(+), 210 deletions(-) diff --git a/doc/webserver/developer-manual/coding.html b/doc/webserver/developer-manual/coding.html index fe73473d..019d8cff 100644 --- a/doc/webserver/developer-manual/coding.html +++ b/doc/webserver/developer-manual/coding.html @@ -2019,7 +2019,7 @@ WIDTH="100%" >
const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.37 2002/04/26 17:23:29 swa Exp $";
+>const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.38 2002/04/29 02:20:31 hal9 Exp $";
 /*********************************************************************
  *
  * File        :  $Source$
@@ -2097,7 +2097,7 @@ WIDTH="100%"
 CLASS="PROGRAMLISTING"
 >#ifndef _FILENAME_H
 #define _FILENAME_H
-#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.37 2002/04/26 17:23:29 swa Exp $"
+#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.38 2002/04/29 02:20:31 hal9 Exp $"
 /*********************************************************************
  *
  * File        :  $Source$
diff --git a/doc/webserver/developer-manual/copyright.html b/doc/webserver/developer-manual/copyright.html
index a69c4245..8e46d9a8 100644
--- a/doc/webserver/developer-manual/copyright.html
+++ b/doc/webserver/developer-manual/copyright.html
@@ -78,7 +78,7 @@ CLASS="SECT2"
 >
11.1. Copyright
11.2. History
$Id: developer-manual.sgml,v 1.37 2002/04/26 17:23:29 swa Exp $
$Id: developer-manual.sgml,v 1.38 2002/04/29 02:20:31 hal9 Exp $
8.3. Uploading and Releasing Your Package
8.4. After the Release
11.1. Copyright
11.2. History
8.3. Uploading and Releasing Your Package
      After the package is ready, it is time to upload it 
+      to SourceForge, and go through the release steps. The upload 
+      is done via FTP:
+    
      

+    
     Once this done go to http://sourceforge.net/project/admin/editpackages.php?group_id=11118, 
+     making sure you are logged in. Find your target platform in the 
+     second column, and click Add Release. You will 
+     then need to create a new release for your package, using the format 
+     of $VERSION ($CODE_STATUS), e.g. 2.9.14
+     (beta).
+    
     Now just follow the prompts. Be sure to add any appropriate Release
+     notes. You should see your freshly uploaded packages in 
+     "Step 2. Add Files To This Release". Check the 
+     appropriate box(es). Remember at each step to hit the 
+     "Refresh/Submit" buttons! You should now see your 
+     file(s) listed in Step 3. Fill out the forms with the appropriate 
+     information for your platform, being sure to hit "Update"
+     for each file. If anyone is monitoring your platform, check the 
+     "email" box at the very bottom to notify them of 
+     the new package. This should do it!
+    
     If you have made errors, or need to make changes, you can go through 
+     essentially the same steps, but select Edit Release, 
+     instead of Add Release.
+    
8.3. After the Release8.4. After the Release
      When all (or: most of the) packages have been uploaded and made available,
diff --git a/doc/webserver/faq/configuration.html b/doc/webserver/faq/configuration.html
index 24a16533..45bfeacf 100644
--- a/doc/webserver/faq/configuration.html
+++ b/doc/webserver/faq/configuration.html
@@ -121,7 +121,7 @@ CLASS="APPLICATION"
 >Privoxy might take, are configured. 
  Typically, you would define a set of default actions that apply 
- to all URLs, then add exceptions to these defaults.
 Actions can be defined on a per site basis, or for groups of sites. Actions
  can also be grouped together and then applied to one or more sites. There
@@ -135,17 +135,6 @@ CLASS="APPLICATION"
 CLASS="QUOTE"
 >"actions" file.
 Privoxy comes with several default
- actions files, with varying degrees 
- of filtering and blocking, as starting points for your own 
- configuration (see below).
 These are all explained in the 
  user-manual.
@@ -176,7 +165,7 @@ CLASS="SECT2"
 >
3.4. How are actions files configured? What is the easiest
 way to do this?
Edit the actions listView & change the current configuration"
  from the selection list. You can also do this by editing the appropriate 
  file with a text editor.
 Please see the 
  user-manual for a
@@ -213,8 +202,53 @@ CLASS="SECT2"
 >
3.5. There are several different "actions" files. What are
+the differences?
 As of Privoxy v2.9.15, three actions files 
+ are being included, to be used for 
+ different purposes. These are 
+ default.action, standard.action, 
+ and user.action. Please see 
+ the User Manual 
+ for an explanation of each.
 Earlier versions included three different versions
+ default.action files. The new scheme allows for 
+ greater flexibility of local configuration, and for browser based 
+ configuration.
3.5. Why can I change the configuration with a
+>3.6. Why can I change the configuration with a
 browser? Does that not raise security issues?
3.6. What is 3.7. What is "default.filter"? The "default.filter" file is used to  file is where "filters"
+ are defined, which are used to "filter" any
@@ -309,16 +347,17 @@ CLASS="FILENAME"
  but you can disable/enable various sections of the included default 
  file with the "Actions List Editor" from your browser.
"View & change the current configuration" from
+ your browser. 
3.7. How can I set up 3.8. How can I set up Privoxy to act as a proxy for my 
@@ -370,39 +409,57 @@ CLASS="SECT2"
 >
3.8. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.3.9. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.
 This is a configuration option for images that
  Privoxy is stopping. You have the choice   of a checkerboard
- pattern, a transparent 1x1 GIF image (aka  is stopping. You have the choice of a
+ checkerboard pattern, a transparent 1x1 GIF image (aka "blank"), or a custom
- URL of your choice. Note that to fit this category, the URL must match both 
- the ),
+ or a custom URL of your choice. Note that to fit this category, the URL must
+ match both the "+image" and "+handle-as-image"
+ and 
+ "+block" actions.
 If you want to see nothing, then change the  If you want to see nothing, then change the 
+ "+image-blocker" 
+>"+set-image-blocker"
  action to "+image-blocker{blank}". This can be done from the 
  "Edit Actions List""View & change the current configuration" selection at 
  banner, can be moved to the "+image-blocker""+set-image-blocker" section for the
  same reason, but there are some limits and risks to this (see below).
3.9. Why would anybody want to see a checkerboard pattern?3.10. Why would anybody want to see a checkerboard pattern?
 This can be helpful for troubleshooting problems. It might also be good 
@@ -448,8 +505,8 @@ CLASS="SECT2"
 >
3.10. I see large red banners on some pages that say 
+NAME="AEN335"
+>3.11. I see large red banners on some pages that say 
 "Blocked"Privoxy's block actions (+block). It is meant
- to be a warning so that you know something has been blocked and an easy way
- for you to see why. These are handled differently than what has been defined
- explicitly as  block actions 
+ ("+block").
+ It is meant to be a warning so that you know something has been blocked and
+ an easy way for you to see why. These are handled differently than what has
+ been defined explicitly as "images" (e.g. ad banners). Depending on the 
- URL itself, it is sometimes hard for  (e.g. ads that are GIF image
+ files). Depending on the URL itself, it is sometimes hard for
+ Privoxy to 
- really know whether there is indeed an ad image there or not. And there are
- limitations as to what  to really know whether there is indeed an
+ ad image there or not. And there are limitations as to what
+ Privoxy can do to 
-  can do to "fool" the browser.
 the
+ browser.
 For instance, if the ad is in a frame, then it is embedded in the separate
  HTML page used for the frame. In this case, you cannot just substitute an
- aribitray image (like we would for a "blank" image), for an HTML
  page. The browser is expecting an HTML page, and that is what it must have
- for frames. So this situation can be a little trickier to deal with, and 
+ for frames. Such situations can be a little trickier to deal with, and 
  Privoxy will use the  may show the "Blocked" page.
 page,
+ despite your best efforts.
 If you want these to be treated as if they were images, so that they can be
  made invisible, you can try moving the offending URL from the
@@ -552,7 +619,7 @@ CLASS="APPLICATION"
 > is blocking the frame, and 
  diable this. Then let the "+image-blocker""+set-image-blocker" action 
  handle the ad that is embedded in the frame's HTML page. 
3.11. I cannot see all of the 3.12. I cannot see all of the "Blocked" page banner. All I
-see is a bright red square. page banner. Help.
 There is not enough space to fit the entire page. Try right clicking on the
- visible, red portion, and select  There is not enough available space to fit the entire Blocked page. Try right
+ clicking on the visible portion, and select "Show Frame", or equivalent.
- This will usually allow you to see the entire Privoxy ,
+ or equivalent. This will usually allow you to see the entire Privoxy
+ "Blocked"
- page, and from there you can see just what is being blocked, and why.
 page, and from there you can see just what is being
+ blocked, and why.
 As of Privoxy 2.9.14, the Blocked banner page is re-sizeable, and tries
+ to adjust to the allotted space. There may be occassions where there 
+ just isn't enough room to display much of anything useful though. 
3.12. Can 3.13. Can Privoxy run as a service 
@@ -618,7 +689,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 >3.13. How can I make 3.14. How can I make Privoxy work with other 
@@ -629,7 +700,7 @@ CLASS="APPLICATION"
 >
 This can be done. See the user manual, 
diff --git a/doc/webserver/faq/copyright.html b/doc/webserver/faq/copyright.html
index 9d457478..3a57b946 100644
--- a/doc/webserver/faq/copyright.html
+++ b/doc/webserver/faq/copyright.html
@@ -72,7 +72,7 @@ CLASS="SECT2"
 >
8.1. Copyright
8.2. History
See the Troubleshooting section below.)
$Id: faq.sgml,v 1.51 2002/04/26 17:24:31 swa Exp $
$Id: faq.sgml,v 1.52 2002/04/29 03:08:43 hal9 Exp $
3.4. How are actions files configured? What is the easiest
 way to do this?
3.5. There are several different "actions" files. What are
+the differences?
3.6. Why can I change the configuration with a
 browser? Does that not raise security issues?
3.6. 3.7. What is "default.filter"?
3.7. 3.8. How can I set up Privoxy
3.8. 3.9. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.
3.9. 3.10. Why would anybody want to see a checkerboard pattern?
3.10. 3.11. I see large red banners on some pages that say 
 . Why and how do I get rid of this?
3.11. 3.12. I cannot see all of the "Blocked" page banner. All I
-see is a bright red square. page banner. Help.
3.12. 3.13. Can 
3.13. 3.14. How can I make 
4.1. How much does Privoxy
4.7. Can Privoxy
4.8. Might some things break because header information is
 being altered?
4.9. Can Privoxy
4.10. What about as a firewall? Can Privoxy
4.11. The Privoxy
4.12. I have large empty spaces now where ads used to be. 
 Why?
4.13. How can Privoxy
4.14. Privoxy
5.1. I just upgraded and am getting "connection refused"
5.2. I just added a new rule, but the steenkin ad is 
 still getting through. How?
5.3. One of my favorite sites does not work with Privoxy.
 What can I do?
5.4. What time is it?
8.1. Copyright
8.2. History
4.1. How much does Privoxy
Using the default filtering configuration, I noticed considerable delays in
-page requests compared to the old Junkbuster. Loading pages with large contents
-seemed to take forever, then suddenly delivering all the content at once.
+>The entire page content must be loaded into memory in order for the filtering 
+mechanism to work, and nothing is sent to the browser during this time. The
+loading time does not really change in real numbers, but the feeling is
+different, because most browsers are able to start rendering incomplete
+content, giving the user a feeling of "it works". 
  
The whole content must be loaded in order to filter, and nothing is is
-sent to the browser during this time. The loading time does not really
-change in real numbers, but the feeling is different, because most
-browsers are able to start rendering incomplete content, giving the
-user a feeling of "it works". 
- 
To modify the content of a page (i.e. make frames resizeable again, etc.) and
-not just replace ads,  To modify the content of a page (i.e. make frames resizeable again, etc.) and
+ not just replace ads, Privoxy needs to download the
-entire page first, do its content magic and then send the page to the browser.
 needs to download
+ the entire page first, do its content magic and then send the page to the
+ browser.
4.7. Can Privoxy
4.8. Might some things break because header information is
 being altered?
4.9. Can Privoxy
4.10. What about as a firewall? Can Privoxy
4.11. The Privoxy
4.12. I have large empty spaces now where ads used to be. 
 Why?
4.13. How can Privoxy
4.14. Privoxy
5.1. I just upgraded and am getting "connection refused"
5.2. I just added a new rule, but the steenkin ad is 
 still getting through. How?
5.3. One of my favorite sites does not work with Privoxy"Toggle Privoxy On or Off", then disable it. Now try that 
- page again. It's probably a good idea to flush the browser cache as well.
Shift+Reload to flush caches.
 If still a problem, go to http://p.p/ and paste
  the full URL of the page in question into the prompt. See which actions are
- being applied to the URL. Now, armed with this information, go to "Edit
- the actions list""View & change the current configuration". Here you should see various sections that have
  various "fragile" which
  disables most actions. Now re-try the page. There might be some trial and
- error involved. This is discussed in a little more detail in the user-manual appendix"actions" file.
5.4. What time is it?
 Time for you to go!
Privoxy, 
- with slightly different purposes.  (as of 
+ version 2.9.15), with differing purposes:
+ 
  
  •       standard.action - is used by the web based editor, 
+      to set various pre-defined sets of rules for the default actions section
+      in default.action sets
- the default policies. . These have increasing levels of
+      aggressiveness. It is not recommend to edit this file.
+    
  •      standard.action is used by 
- default.action - is the primary action file 
+     that sets the initial values for all actions. It is intended to 
+     provide a base level of functionality for
+     Privoxy and the web based editor to set 
- pre-defined values (and normally should not be edited). Local exceptions 
- are best done in Privoxy's array of features. So it is 
+     a set of broad rules that should work reasonably well for users everywhere.
+     This is the file that the developers are keeping updated, and making 
+     available to users.
+    
  •      user.action. The content of these 
+> - is intended to be for local site 
+     preferences and exceptions. As an example, if your ISP or your bank
+     has specific requirements, and need special handling, this kind of 
+     thing should go here. This file will not be upgraded.
+    

+ 
 The list of actions files to be used are defined in the main configuration 
+ file, and are processed in the order they are defined. The content of these
  can all be viewed and edited from http://config.privoxy.org/show-status.
- 
 
- Anything you want can be blocked, including ads, banners, or just some obnoxious
- URL that you would rather not see is done here. Cookies can be accepted or rejected, or
- accepted only during the current browser session (i.e. not written to disk),
- content can be modified, JavaScripts tamed, user-tracking fooled, and much more.
- See below for a complete list of available actions.
.
 An actions file typically has sections. Near the top, ), then the default set of rules
  which will apply universally to all sites and pages. And then below that,
  exceptions to the defined universal policies. 
 
+ Actions can be used to block anything you want, including ads, banners, or
+ just some obnoxious URL that you would rather not see. Cookies can be accepted
+ or rejected, or accepted only during the current browser session (i.e. not
+ written to disk), content can be modified, JavaScripts tamed, user-tracking
+ fooled, and much more. See below for a complete list of actions.
9.1. Finding the Right Mix
9.2. How to Edit
9.3. How Actions are Applied to URLs
9.4. Patterns
9.4.1. The Domain Pattern
9.4.2. The Path Pattern
9.5.21. Summary
 }

  www.my-isp-example.com/logo[0-9].gif

 

+

 # Say the site where you do your homebanking needs to open

 # popup windows, but you have chosen to kill popups by

 # default. This will allow it for your-example-bank.com:

@@ -3296,6 +3333,7 @@ TARGET="_top"
 > }

  .my-example-bank.com

 

+

 # This site is delicate, and requires kid-glove 

 # treatment.

  { fragile }

diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html
index 66cd90dc..1172917e 100644
--- a/doc/webserver/user-manual/appendix.html
+++ b/doc/webserver/user-manual/appendix.html
@@ -751,7 +751,7 @@ CLASS="SECT2"
 >
15.2. Privoxy
   Short cuts. Turn off, then on: 
   
13.1. Copyright
10.1. The +filter
$Id: user-manual.sgml,v 1.99 2002/04/28 16:59:05 swa Exp $
$Id: user-manual.sgml,v 1.100 2002/04/29 03:05:55 hal9 Exp $