Rebuild for change-x-forwarded-for{} documentation.
authorFabian Keil <fk@fabiankeil.de>
Sun, 21 Sep 2008 15:19:31 +0000 (15:19 +0000)
committerFabian Keil <fk@fabiankeil.de>
Sun, 21 Sep 2008 15:19:31 +0000 (15:19 +0000)
doc/webserver/user-manual/actions-file.html
doc/webserver/user-manual/appendix.html
doc/webserver/user-manual/copyright.html
doc/webserver/user-manual/filter-file.html
doc/webserver/user-manual/index.html

index 68b4643..ab76a8e 100644 (file)
@@ -1997,8 +1997,104 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
+NAME="CHANGE-X-FORWARDED-FOR"
+>8.5.3. change-x-forwarded-for</A
+></H4
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>Typical use:</DT
+><DD
+><P
+>Improve privacy by not forwarding the source of the request in the HTTP headers.</P
+></DD
+><DT
+>Effect:</DT
+><DD
+><P
+>    Deletes the <SPAN
+CLASS="QUOTE"
+>"X-Forwarded-For:"</SPAN
+> HTTP header from the client request,
+    or adds a new one.
+   </P
+></DD
+><DT
+>Type:</DT
+><DD
+><P
+>Parameterized.</P
+></DD
+><DT
+>Parameter:</DT
+><DD
+><P
+></P
+><UL
+><LI
+><P
+><SPAN
+CLASS="QUOTE"
+>"block"</SPAN
+> to delete the header.</P
+></LI
+><LI
+><P
+>       <SPAN
+CLASS="QUOTE"
+>"add"</SPAN
+> to create the header (or append
+       the client's IP address to an already existing one).
+     </P
+></LI
+></UL
+></DD
+><DT
+>Notes:</DT
+><DD
+><P
+>    It is safe and recommended to use <TT
+CLASS="LITERAL"
+>block</TT
+>.
+   </P
+><P
+>    Forwarding the source address of the request may make
+    sense in some multi-user setups but is also a privacy risk.
+   </P
+></DD
+><DT
+>Example usage:</DT
+><DD
+><P
+>     <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>+change-x-forwarded-for{block}</PRE
+></TD
+></TR
+></TABLE
+>
+   </P
+></DD
+></DL
+></DIV
+></DIV
+><DIV
+CLASS="SECT3"
+><H4
+CLASS="SECT3"
+><A
 NAME="CLIENT-HEADER-FILTER"
->8.5.3. client-header-filter</A
+>8.5.4. client-header-filter</A
 ></H4
 ><P
 ></P
@@ -2098,7 +2194,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CLIENT-HEADER-TAGGER"
->8.5.4. client-header-tagger</A
+>8.5.5. client-header-tagger</A
 ></H4
 ><P
 ></P
@@ -2204,7 +2300,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CONTENT-TYPE-OVERWRITE"
->8.5.5. content-type-overwrite</A
+>8.5.6. content-type-overwrite</A
 ></H4
 ><P
 ></P
@@ -2366,7 +2462,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CRUNCH-CLIENT-HEADER"
->8.5.6. crunch-client-header</A
+>8.5.7. crunch-client-header</A
 ></H4
 ><P
 ></P
@@ -2500,7 +2596,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CRUNCH-IF-NONE-MATCH"
->8.5.7. crunch-if-none-match</A
+>8.5.8. crunch-if-none-match</A
 ></H4
 ><P
 ></P
@@ -2618,7 +2714,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CRUNCH-INCOMING-COOKIES"
->8.5.8. crunch-incoming-cookies</A
+>8.5.9. crunch-incoming-cookies</A
 ></H4
 ><P
 ></P
@@ -2741,7 +2837,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CRUNCH-SERVER-HEADER"
->8.5.9. crunch-server-header</A
+>8.5.10. crunch-server-header</A
 ></H4
 ><P
 ></P
@@ -2873,7 +2969,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="CRUNCH-OUTGOING-COOKIES"
->8.5.10. crunch-outgoing-cookies</A
+>8.5.11. crunch-outgoing-cookies</A
 ></H4
 ><P
 ></P
@@ -2989,7 +3085,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="DEANIMATE-GIFS"
->8.5.11. deanimate-gifs</A
+>8.5.12. deanimate-gifs</A
 ></H4
 ><P
 ></P
@@ -3079,7 +3175,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="DOWNGRADE-HTTP-VERSION"
->8.5.12. downgrade-http-version</A
+>8.5.13. downgrade-http-version</A
 ></H4
 ><P
 ></P
@@ -3155,7 +3251,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FAST-REDIRECTS"
->8.5.13. fast-redirects</A
+>8.5.14. fast-redirects</A
 ></H4
 ><P
 ></P
@@ -3337,7 +3433,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FILTER"
->8.5.14. filter</A
+>8.5.15. filter</A
 ></H4
 ><P
 ></P
@@ -4065,7 +4161,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FORCE-TEXT-MODE"
->8.5.15. force-text-mode</A
+>8.5.16. force-text-mode</A
 ></H4
 ><P
 ></P
@@ -4198,7 +4294,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FORWARD-OVERRIDE"
->8.5.16. forward-override</A
+>8.5.17. forward-override</A
 ></H4
 ><P
 ></P
@@ -4388,7 +4484,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HANDLE-AS-EMPTY-DOCUMENT"
->8.5.17. handle-as-empty-document</A
+>8.5.18. handle-as-empty-document</A
 ></H4
 ><P
 ></P
@@ -4512,7 +4608,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HANDLE-AS-IMAGE"
->8.5.18. handle-as-image</A
+>8.5.19. handle-as-image</A
 ></H4
 ><P
 ></P
@@ -4645,7 +4741,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HIDE-ACCEPT-LANGUAGE"
->8.5.19. hide-accept-language</A
+>8.5.20. hide-accept-language</A
 ></H4
 ><P
 ></P
@@ -4762,7 +4858,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HIDE-CONTENT-DISPOSITION"
->8.5.20. hide-content-disposition</A
+>8.5.21. hide-content-disposition</A
 ></H4
 ><P
 ></P
@@ -4883,7 +4979,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HIDE-IF-MODIFIED-SINCE"
->8.5.21. hide-if-modified-since</A
+>8.5.22. hide-if-modified-since</A
 ></H4
 ><P
 ></P
@@ -5008,77 +5104,6 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="HIDE-FORWARDED-FOR-HEADERS"
->8.5.22. hide-forwarded-for-headers</A
-></H4
-><P
-></P
-><DIV
-CLASS="VARIABLELIST"
-><DL
-><DT
->Typical use:</DT
-><DD
-><P
->Improve privacy by not forwarding the source of the request in the HTTP headers.</P
-></DD
-><DT
->Effect:</DT
-><DD
-><P
->    Deletes any existing <SPAN
-CLASS="QUOTE"
->"X-Forwarded-for:"</SPAN
-> HTTP header from client requests.
-   </P
-></DD
-><DT
->Type:</DT
-><DD
-><P
->Boolean.</P
-></DD
-><DT
->Parameter:</DT
-><DD
-><P
->    N/A
-   </P
-></DD
-><DT
->Notes:</DT
-><DD
-><P
->    It is safe and recommended to leave this on.
-   </P
-></DD
-><DT
->Example usage:</DT
-><DD
-><P
->     <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="90%"
-><TR
-><TD
-><PRE
-CLASS="SCREEN"
->+hide-forwarded-for-headers</PRE
-></TD
-></TR
-></TABLE
->
-   </P
-></DD
-></DL
-></DIV
-></DIV
-><DIV
-CLASS="SECT3"
-><H4
-CLASS="SECT3"
-><A
 NAME="HIDE-FROM-HEADER"
 >8.5.23. hide-from-header</A
 ></H4
@@ -6679,7 +6704,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4066"
+NAME="AEN4074"
 >8.5.34. Summary</A
 ></H3
 ><P
@@ -6978,7 +7003,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4129"
+NAME="AEN4137"
 >8.7.1. default.action</A
 ></H3
 ><P
@@ -7158,6 +7183,10 @@ CLASS="SCREEN"
 ##########################################################################
  { \
  +<A
+HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
+>change-x-forwarded-for{block}</A
+> \
+ +<A
 HREF="actions-file.html#DEANIMATE-GIFS"
 >deanimate-gifs</A
 > \
@@ -7178,10 +7207,6 @@ HREF="actions-file.html#FILTER-IE-EXPLOITS"
 >filter{ie-exploits}</A
 > \     
  +<A
-HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
->hide-forwarded-for-headers</A
-> \
- +<A
 HREF="actions-file.html#HIDE-FROM-HEADER"
 >hide-from-header{block}</A
 > \
@@ -7693,7 +7718,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4263"
+NAME="AEN4271"
 >8.7.2. user.action</A
 ></H3
 ><P
index ee9b769..62aeb89 100644 (file)
@@ -748,7 +748,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN5149"
+NAME="AEN5157"
 >14.2. Privoxy's Internal Pages</A
 ></H2
 ><P
@@ -794,7 +794,7 @@ CLASS="APPLICATION"
    Privoxy main page: 
   </P
 ><A
-NAME="AEN5163"
+NAME="AEN5171"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -827,7 +827,7 @@ CLASS="APPLICATION"
     editing of actions files:
   </P
 ><A
-NAME="AEN5171"
+NAME="AEN5179"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -847,7 +847,7 @@ TARGET="_top"
     Show the source code version numbers:
   </P
 ><A
-NAME="AEN5176"
+NAME="AEN5184"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -867,7 +867,7 @@ TARGET="_top"
    Show the browser's request headers:
   </P
 ><A
-NAME="AEN5181"
+NAME="AEN5189"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -887,7 +887,7 @@ TARGET="_top"
    Show which actions apply to a URL and why:
   </P
 ><A
-NAME="AEN5186"
+NAME="AEN5194"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -919,7 +919,7 @@ CLASS="QUOTE"
    place:
   </P
 ><A
-NAME="AEN5194"
+NAME="AEN5202"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -936,7 +936,7 @@ TARGET="_top"
 >   Short cuts. Turn off, then on: 
   </P
 ><A
-NAME="AEN5198"
+NAME="AEN5206"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -950,7 +950,7 @@ TARGET="_top"
    </P
 ></BLOCKQUOTE
 ><A
-NAME="AEN5201"
+NAME="AEN5209"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -1450,7 +1450,8 @@ CLASS="GUIBUTTON"
 >[ Edit ]</SPAN
 >
 
- {+deanimate-gifs {last}
+ {+change-x-forwarded-for{block}
+ +deanimate-gifs {last}
  +fast-redirects {check-decoded-url}
  +filter {refresh-tags}
  +filter {img-reorder}
@@ -1458,7 +1459,6 @@ CLASS="GUIBUTTON"
  +filter {webbugs}
  +filter {jumping-windows}
  +filter {ie-exploits}
- +hide-forwarded-for-headers
  +hide-from-header {block}
  +hide-referrer {forge}
  +session-cookies-only
@@ -1637,6 +1637,7 @@ CLASS="SCREEN"
  
  -add-header
  -block
+ +change-x-forwarded-for{block} 
  -client-header-filter{hide-tor-exit-notation}
  -content-type-overwrite
  -crunch-client-header
@@ -1678,7 +1679,6 @@ CLASS="SCREEN"
  -handle-as-image
  -hide-accept-language
  -hide-content-disposition
- +hide-forwarded-for-headers
  +hide-from-header {block}
  -hide-if-modified-since
  +hide-referrer {forge}
@@ -1823,6 +1823,7 @@ CLASS="GUIBUTTON"
 
  {-add-header 
   -block
+  +change-x-forwarded-for{block} 
   -client-header-filter{hide-tor-exit-notation}
   -content-type-overwrite
   -crunch-client-header
@@ -1864,7 +1865,6 @@ CLASS="GUIBUTTON"
   -handle-as-image 
   -hide-accept-language
   -hide-content-disposition  
-  +hide-forwarded-for-headers 
   +hide-from-header{block} 
   +hide-referer{forge} 
   -hide-user-agent 
index 2dc0ced..337c14d 100644 (file)
@@ -102,7 +102,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN4892"
+NAME="AEN4900"
 >12.1. License</A
 ></H2
 ><P
index 1a76ec0..b4c348e 100644 (file)
@@ -366,7 +366,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN4418"
+NAME="AEN4426"
 >9.1. Filter File Tutorial</A
 ></H2
 ><P
index 53a11c7..b5c3160 100644 (file)
@@ -50,7 +50,7 @@ TARGET="_top"
 ><BR></P
 ><P
 CLASS="PUBDATE"
->$Id: user-manual.sgml,v 2.86 2008/08/16 10:12:23 fabiankeil Exp $<BR></P
+>$Id: user-manual.sgml,v 2.87 2008/08/30 15:37:35 fabiankeil Exp $<BR></P
 ><DIV
 ><DIV
 CLASS="ABSTRACT"
@@ -574,105 +574,105 @@ HREF="actions-file.html#BLOCK"
 ></DT
 ><DT
 >8.5.3. <A
+HREF="actions-file.html#CHANGE-X-FORWARDED-FOR"
+>change-x-forwarded-for</A
+></DT
+><DT
+>8.5.4. <A
 HREF="actions-file.html#CLIENT-HEADER-FILTER"
 >client-header-filter</A
 ></DT
 ><DT
->8.5.4. <A
+>8.5.5. <A
 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
 >client-header-tagger</A
 ></DT
 ><DT
->8.5.5. <A
+>8.5.6. <A
 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
 >content-type-overwrite</A
 ></DT
 ><DT
->8.5.6. <A
+>8.5.7. <A
 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
 >crunch-client-header</A
 ></DT
 ><DT
->8.5.7. <A
+>8.5.8. <A
 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
 >crunch-if-none-match</A
 ></DT
 ><DT
->8.5.8. <A
+>8.5.9. <A
 HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
 >crunch-incoming-cookies</A
 ></DT
 ><DT
->8.5.9. <A
+>8.5.10. <A
 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
 >crunch-server-header</A
 ></DT
 ><DT
->8.5.10. <A
+>8.5.11. <A
 HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
 >crunch-outgoing-cookies</A
 ></DT
 ><DT
->8.5.11. <A
+>8.5.12. <A
 HREF="actions-file.html#DEANIMATE-GIFS"
 >deanimate-gifs</A
 ></DT
 ><DT
->8.5.12. <A
+>8.5.13. <A
 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
 >downgrade-http-version</A
 ></DT
 ><DT
->8.5.13. <A
+>8.5.14. <A
 HREF="actions-file.html#FAST-REDIRECTS"
 >fast-redirects</A
 ></DT
 ><DT
->8.5.14. <A
+>8.5.15. <A
 HREF="actions-file.html#FILTER"
 >filter</A
 ></DT
 ><DT
->8.5.15. <A
+>8.5.16. <A
 HREF="actions-file.html#FORCE-TEXT-MODE"
 >force-text-mode</A
 ></DT
 ><DT
->8.5.16. <A
+>8.5.17. <A
 HREF="actions-file.html#FORWARD-OVERRIDE"
 >forward-override</A
 ></DT
 ><DT
->8.5.17. <A
+>8.5.18. <A
 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
 >handle-as-empty-document</A
 ></DT
 ><DT
->8.5.18. <A
+>8.5.19. <A
 HREF="actions-file.html#HANDLE-AS-IMAGE"
 >handle-as-image</A
 ></DT
 ><DT
->8.5.19. <A
+>8.5.20. <A
 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
 >hide-accept-language</A
 ></DT
 ><DT
->8.5.20. <A
+>8.5.21. <A
 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
 >hide-content-disposition</A
 ></DT
 ><DT
->8.5.21. <A
+>8.5.22. <A
 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
 >hide-if-modified-since</A
 ></DT
 ><DT
->8.5.22. <A
-HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
->hide-forwarded-for-headers</A
-></DT
-><DT
 >8.5.23. <A
 HREF="actions-file.html#HIDE-FROM-HEADER"
 >hide-from-header</A
@@ -729,7 +729,7 @@ HREF="actions-file.html#SET-IMAGE-BLOCKER"
 ></DT
 ><DT
 >8.5.34. <A
-HREF="actions-file.html#AEN4066"
+HREF="actions-file.html#AEN4074"
 >Summary</A
 ></DT
 ></DL
@@ -748,12 +748,12 @@ HREF="actions-file.html#ACT-EXAMPLES"
 ><DL
 ><DT
 >8.7.1. <A
-HREF="actions-file.html#AEN4129"
+HREF="actions-file.html#AEN4137"
 >default.action</A
 ></DT
 ><DT
 >8.7.2. <A
-HREF="actions-file.html#AEN4263"
+HREF="actions-file.html#AEN4271"
 >user.action</A
 ></DT
 ></DL
@@ -769,7 +769,7 @@ HREF="filter-file.html"
 ><DL
 ><DT
 >9.1. <A
-HREF="filter-file.html#AEN4418"
+HREF="filter-file.html#AEN4426"
 >Filter File Tutorial</A
 ></DT
 ><DT
@@ -837,7 +837,7 @@ HREF="copyright.html"
 ><DL
 ><DT
 >12.1. <A
-HREF="copyright.html#AEN4892"
+HREF="copyright.html#AEN4900"
 >License</A
 ></DT
 ><DT
@@ -871,7 +871,7 @@ HREF="appendix.html#REGEX"
 ></DT
 ><DT
 >14.2. <A
-HREF="appendix.html#AEN5149"
+HREF="appendix.html#AEN5157"
 >Privoxy's Internal Pages</A
 ></DT
 ><DD