doc/webserver/faq/contact.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Contacting the developers, Bug Reporting and Feature Requests</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
   9 REL="HOME"
  10 TITLE="Privoxy Frequently Asked Questions"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Troubleshooting"
  14 HREF="trouble.html"><LINK
  15 REL="NEXT"
  16 TITLE="Privoxy Copyright, License and History"
  17 HREF="copyright.html"><LINK
  18 REL="STYLESHEET"
  19 TYPE="text/css"
  20 HREF="../p_doc.css"><META
  21 HTTP-EQUIV="Content-Type"
  22 CONTENT="text/html;
  23 charset=ISO-8859-1"></HEAD
  24 ><BODY
  25 CLASS="SECT1"
  26 BGCOLOR="#EEEEEE"
  27 TEXT="#000000"
  28 LINK="#0000FF"
  29 VLINK="#840084"
  30 ALINK="#0000FF"
  31 ><DIV
  32 CLASS="NAVHEADER"
  33 ><TABLE
  34 SUMMARY="Header navigation table"
  35 WIDTH="100%"
  36 BORDER="0"
  37 CELLPADDING="0"
  38 CELLSPACING="0"
  39 ><TR
  40 ><TH
  41 COLSPAN="3"
  42 ALIGN="center"
  43 >Privoxy Frequently Asked Questions</TH
  44 ></TR
  45 ><TR
  46 ><TD
  47 WIDTH="10%"
  48 ALIGN="left"
  49 VALIGN="bottom"
  50 ><A
  51 HREF="trouble.html"
  52 ACCESSKEY="P"
  53 >Prev</A
  54 ></TD
  55 ><TD
  56 WIDTH="80%"
  57 ALIGN="center"
  58 VALIGN="bottom"
  59 ></TD
  60 ><TD
  61 WIDTH="10%"
  62 ALIGN="right"
  63 VALIGN="bottom"
  64 ><A
  65 HREF="copyright.html"
  66 ACCESSKEY="N"
  67 >Next</A
  68 ></TD
  69 ></TR
  70 ></TABLE
  71 ><HR
  72 ALIGN="LEFT"
  73 WIDTH="100%"></DIV
  74 ><DIV
  75 CLASS="SECT1"
  76 ><H1
  77 CLASS="SECT1"
  78 ><A
  79 NAME="CONTACT"
  80 >6. Contacting the developers, Bug Reporting and Feature Requests</A
  81 ></H1
  82 ><P
  83 > We value your feedback. In fact, we rely on it to improve
  84  <SPAN
  85 CLASS="APPLICATION"
  86 >Privoxy</SPAN
  87 > and its configuration.
  88  However, please note the following hints, so we can
  89  provide you with the best support:</P
  90 ><DIV
  91 CLASS="SECT2"
  92 ><H2
  93 CLASS="SECT2"
  94 ><A
  95 NAME="CONTACT-SUPPORT"
  96 >6.1. Get Support</A
  97 ></H2
  98 ><P
  99 > For casual users, our
 100  <A
 101 HREF="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118"
 102 TARGET="_top"
 103 >support forum at SourceForge</A
 104 >
 105  is probably best suited:
 106  <A
 107 HREF="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118"
 108 TARGET="_top"
 109 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</A
 110 ></P
 111 ><P
 112 > All users are of course welcome to discuss their issues on the <A
 113 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-users"
 114 TARGET="_top"
 115 >users
 116  mailing list</A
 117 >, where the developers also hang around.</P
 118 ><P
 119 > Please don't sent private support requests to individual Privoxy
 120  developers, either use the mailing lists or the support trackers.</P
 121 ><P
 122 > If you have to contact a Privoxy developer directly for other reasons,
 123  please send a real mail and do not bother with SourceForge's messaging
 124  system. Answers to SourceForge messages are usually bounced by SourceForge's
 125  mail server in which case the developer wasted time writing a response you
 126  don't get. From your point of view it will look like your message has
 127  been completely ignored, so this is frustrating for all parties involved.</P
 128 ><P
 129 > Note that the Privoxy mailing lists are moderated. Posts from unsubscribed
 130  addresses have to be accepted manually by a moderator. This may cause a
 131  delay of several days and if you use a subject that doesn't clearly
 132  mention Privoxy or one of its features, your message may be accidentally
 133  discarded as spam.</P
 134 ><P
 135 > If you aren't subscribed, you should therefore spend a few seconds
 136  to come up with a proper subject. Additionally you should make it clear
 137  that you want to get CC'd. Otherwise some responses will be directed to
 138  the mailing list only, and you won't see them.</P
 139 ></DIV
 140 ><DIV
 141 CLASS="SECT2"
 142 ><H2
 143 CLASS="SECT2"
 144 ><A
 145 NAME="REPORTING"
 146 >6.2. Reporting Problems</A
 147 ></H2
 148 ><P
 149 ><SPAN
 150 CLASS="QUOTE"
 151 >"Problems"</SPAN
 152 > for our purposes, come in two forms:</P
 153 ><P
 154 ></P
 155 ><UL
 156 ><LI
 157 ><P
 158 >    Configuration issues, such as ads that slip through, or sites that
 159     don't function properly due to one <SPAN
 160 CLASS="APPLICATION"
 161 >Privoxy</SPAN
 162 >
 163     <SPAN
 164 CLASS="QUOTE"
 165 >"action"</SPAN
 166 > or another being turned <SPAN
 167 CLASS="QUOTE"
 168 >"on"</SPAN
 169 >.
 170    </P
 171 ></LI
 172 ><LI
 173 ><P
 174 >    <SPAN
 175 CLASS="QUOTE"
 176 >"Bugs"</SPAN
 177 > in the programming code that makes up
 178     <SPAN
 179 CLASS="APPLICATION"
 180 >Privoxy</SPAN
 181 >, such as that might cause a crash.
 182    </P
 183 ></LI
 184 ></UL
 185 ><DIV
 186 CLASS="SECT3"
 187 ><H3
 188 CLASS="SECT3"
 189 ><A
 190 NAME="CONTACT-ADS"
 191 >6.2.1. Reporting Ads or Other Configuration Problems</A
 192 ></H3
 193 ><P
 194 > Please send feedback on ads that slipped through, innocent images that were
 195  blocked, sites that don't work properly, and other configuration related problem of
 196  <TT
 197 CLASS="FILENAME"
 198 >default.action</TT
 199 > file, to
 200  <A
 201 HREF="http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288"
 202 TARGET="_top"
 203 > http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
 204 >,
 205  the Actions File Tracker.</P
 206 ><P
 207 > New, improved <TT
 208 CLASS="FILENAME"
 209 >default.action</TT
 210 > files may occasionally be made
 211  available based on your feedback. These will be announced on the <A
 212 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce"
 213 TARGET="_top"
 214 >ijbswa-announce</A
 215 >
 216  list and available from our the <A
 217 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
 218 TARGET="_top"
 219 >files section</A
 220 > of
 221  our <A
 222 HREF="http://sf.net/projects/ijbswa/"
 223 TARGET="_top"
 224 >project page</A
 225 >.</P
 226 ></DIV
 227 ><DIV
 228 CLASS="SECT3"
 229 ><H3
 230 CLASS="SECT3"
 231 ><A
 232 NAME="CONTACT-BUGS"
 233 >6.2.2. Reporting Bugs</A
 234 ></H3
 235 ><P
 236 > Please report all bugs through our bug tracker:
 237  <A
 238 HREF="http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118"
 239 TARGET="_top"
 240 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</A
 241 >. </P
 242 ><P
 243 >  Before doing so, please make sure that the bug has <SPAN
 244 CLASS="emphasis"
 245 ><I
 246 CLASS="EMPHASIS"
 247 >not already been submitted</I
 248 ></SPAN
 249 >
 250   and observe the additional hints at the top of the <A
 251 HREF="http://sourceforge.net/tracker/?func=add&#38;group_id=11118&#38;atid=111118"
 252 TARGET="_top"
 253 >submit
 254   form</A
 255 >. If already submitted, please feel free to add any info to the
 256   original report that might help to solve the issue.</P
 257 ><P
 258 >  Please try to verify that it is a <SPAN
 259 CLASS="APPLICATION"
 260 >Privoxy</SPAN
 261 > bug,
 262   and not a browser or site bug or documented behaviour that just happens
 263   to be different than what you expected. If unsure,
 264   try <A
 265 HREF="http://config.privoxy.org/toggle?set=disable"
 266 TARGET="_top"
 267 >toggling
 268   off</A
 269 > <SPAN
 270 CLASS="APPLICATION"
 271 >Privoxy</SPAN
 272 >, and see if the problem persists.</P
 273 ><P
 274 >  If you are using your own custom configuration, please try
 275   the stock configs to see if the problem is configuration related.
 276   If you're having problems with a feature that is disabled by default,
 277   please ask around on the mailing list if others can reproduce the problem.</P
 278 ><P
 279 >  If you aren't using the latest Privoxy version, the bug may have been found
 280   and fixed in the meantime. We would appreciate if you could take the time
 281   to <A
 282 HREF="http://www.privoxy.org/user-manual/installation.html"
 283 TARGET="_top"
 284 >upgrade
 285   to the latest version</A
 286 > (or  even the latest CVS snapshot) and verify
 287   that your bug still exists.</P
 288 ><P
 289 >Please be sure to provide the following information:</P
 290 ><P
 291 > <P
 292 ></P
 293 ><UL
 294 ><LI
 295 ><P
 296 >    The exact <SPAN
 297 CLASS="APPLICATION"
 298 >Privoxy</SPAN
 299 > version you are using
 300     (if you got the source from CVS, please also provide the source code revisions
 301      as shown in <A
 302 HREF="http://config.privoxy.org/show-version"
 303 TARGET="_top"
 304 >http://config.privoxy.org/show-version</A
 305 >).
 306    </P
 307 ></LI
 308 ><LI
 309 ><P
 310 >    The operating system and versions you run
 311     <SPAN
 312 CLASS="APPLICATION"
 313 >Privoxy</SPAN
 314 > on, (e.g. <SPAN
 315 CLASS="APPLICATION"
 316 >Windows
 317     XP SP2</SPAN
 318 >), if you are using a Unix flavor,
 319     sending the output of <SPAN
 320 CLASS="QUOTE"
 321 >"uname -a"</SPAN
 322 > should do,
 323     in case of GNU/Linux, please also name the distribution.
 324    </P
 325 ></LI
 326 ><LI
 327 ><P
 328 >    The name, platform, and version of the <SPAN
 329 CLASS="APPLICATION"
 330 >browser</SPAN
 331 >
 332     you were using (e.g. <SPAN
 333 CLASS="APPLICATION"
 334 >Internet Explorer v5.5</SPAN
 335 > for Mac).
 336    </P
 337 ></LI
 338 ><LI
 339 ><P
 340 >    The URL where the problem occurred, or some way for us to duplicate the
 341     problem (e.g. <TT
 342 CLASS="LITERAL"
 343 >http://somesite.example.com/?somethingelse=123</TT
 344 >).
 345    </P
 346 ></LI
 347 ><LI
 348 ><P
 349 >    Whether your version of <SPAN
 350 CLASS="APPLICATION"
 351 >Privoxy</SPAN
 352 > is one supplied
 353     by the <SPAN
 354 CLASS="APPLICATION"
 355 >Privoxy</SPAN
 356 > developers via SourceForge,
 357     or if you got your copy somewhere else.
 358    </P
 359 ></LI
 360 ><LI
 361 ><P
 362 >    Whether you are using <SPAN
 363 CLASS="APPLICATION"
 364 >Privoxy</SPAN
 365 > in tandem with
 366     another proxy such as <SPAN
 367 CLASS="APPLICATION"
 368 >Tor</SPAN
 369 >. If so, please
 370     temporary disable the other proxy to see if the symptoms change.
 371    </P
 372 ></LI
 373 ><LI
 374 ><P
 375 >    Whether you are using a personal firewall product. If so, does
 376     <SPAN
 377 CLASS="APPLICATION"
 378 >Privoxy</SPAN
 379 > work without it?
 380    </P
 381 ></LI
 382 ><LI
 383 ><P
 384 >    Any other pertinent information to help identify the problem such as config
 385     or log file excerpts (yes, you should have log file entries for each
 386     action taken). To get a meaningful logfile, please make sure that the
 387     <A
 388 HREF="../user-manual/config.html#LOGFILE"
 389 TARGET="_top"
 390 >logfile directive</A
 391 >
 392     is being used and the following <A
 393 HREF="../user-manual/config.html#DEBUG"
 394 TARGET="_top"
 395 >debug options</A
 396 > are enabled:
 397     <P
 398 CLASS="LITERALLAYOUT"
 399 >debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1&nbsp;#&nbsp;Log&nbsp;the&nbsp;destination&nbsp;for&nbsp;each&nbsp;request&nbsp;Privoxy&nbsp;let&nbsp;through.&nbsp;See&nbsp;also&nbsp;debug&nbsp;1024.<br>
 400 debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;2&nbsp;#&nbsp;show&nbsp;each&nbsp;connection&nbsp;status<br>
 401 debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4&nbsp;#&nbsp;show&nbsp;I/O&nbsp;status<br>
 402 debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8&nbsp;#&nbsp;show&nbsp;header&nbsp;parsing<br>
 403 debug&nbsp;&nbsp;&nbsp;128&nbsp;#&nbsp;debug&nbsp;redirects<br>
 404 debug&nbsp;&nbsp;&nbsp;256&nbsp;#&nbsp;debug&nbsp;GIF&nbsp;de-animation<br>
 405 debug&nbsp;&nbsp;&nbsp;512&nbsp;#&nbsp;Common&nbsp;Log&nbsp;Format<br>
 406 debug&nbsp;&nbsp;1024&nbsp;#&nbsp;Log&nbsp;the&nbsp;destination&nbsp;for&nbsp;requests&nbsp;Privoxy&nbsp;didn't&nbsp;let&nbsp;through,&nbsp;and&nbsp;the&nbsp;reason&nbsp;why.<br>
 407 debug&nbsp;&nbsp;4096&nbsp;#&nbsp;Startup&nbsp;banner&nbsp;and&nbsp;warnings.<br>
 408 debug&nbsp;&nbsp;8192&nbsp;#&nbsp;Non-fatal&nbsp;errors</P
 409 >
 410     If you are having trouble with a filter, please additionally enable
 411     <P
 412 CLASS="LITERALLAYOUT"
 413 >debug&nbsp;&nbsp;&nbsp;&nbsp;64&nbsp;#&nbsp;debug&nbsp;regular&nbsp;expression&nbsp;filters</P
 414 >
 415     If you are using Privoxy 3.0.17 or later and suspect that it interprets the
 416     request or the response incorrectly, please enable
 417     <P
 418 CLASS="LITERALLAYOUT"
 419 >debug&nbsp;32768&nbsp;#&nbsp;log&nbsp;all&nbsp;data&nbsp;read&nbsp;from&nbsp;the&nbsp;network</P
 420 >
 421     Note that Privoxy log files may contain sensitive information so please don't
 422     submit any logfiles you didn't read first. You can mask sensitive information
 423     as long as it's clear that you removed something.
 424    </P
 425 ></LI
 426 ></UL
 427 ></P
 428 ><P
 429 > You don't have to tell us your actual name when filing a problem
 430  report, but if you don't, please use a nickname so we can differentiate
 431  between your messages and the ones entered by other "anonymous" users that
 432  may respond to your request if they have the same problem or already
 433  found a solution. Note that due to spam the trackers may not always
 434  allow to post without being logged into SourceForge. If that's the
 435  case, you are still free to create a login that isn't directly linked
 436  to your name, though.</P
 437 ><P
 438 > Please also check the status of your request a few days after submitting
 439  it, as we may request additional information. If you use a SF id,
 440  you should automatically get a mail when someone responds to your request.
 441  Please don't bother to add an email address when using the tracker.
 442  If you prefer to communicate through email, just use one of the mailing
 443  lists directly.</P
 444 ><P
 445 >  The <A
 446 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
 447 TARGET="_top"
 448 >appendix
 449   of the Privoxy User Manual</A
 450 > also has helpful information
 451   on understanding <TT
 452 CLASS="LITERAL"
 453 >actions</TT
 454 >, and <TT
 455 CLASS="LITERAL"
 456 >action</TT
 457 > debugging. </P
 458 ></DIV
 459 ></DIV
 460 ><DIV
 461 CLASS="SECT2"
 462 ><H2
 463 CLASS="SECT2"
 464 ><A
 465 NAME="CONTACT-FEATURE"
 466 >6.3. Request New Features</A
 467 ></H2
 468 ><P
 469 > You are welcome to submit ideas on new features or other proposals
 470  for improvement through our feature request tracker at
 471  <A
 472 HREF="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118"
 473 TARGET="_top"
 474 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
 475 >.</P
 476 ></DIV
 477 ><DIV
 478 CLASS="SECT2"
 479 ><H2
 480 CLASS="SECT2"
 481 ><A
 482 NAME="MAILING-LISTS"
 483 >6.4. Mailing Lists</A
 484 ></H2
 485 ><P
 486 >If you prefer to communicate through email, instead of using a web interface,
 487 feel free to use one of the mailing lists.
 488 To discuss issues that haven't been completely diagnosed yet, please use the Privoxy
 489 users list. Technically interested users and people who wish to contribute to
 490 the project are always welcome on the developers list.
 491 You can find an overview of all <SPAN
 492 CLASS="APPLICATION"
 493 >Privoxy</SPAN
 494 >-related mailing lists,
 495 including list archives, at:
 496 <A
 497 HREF="http://sourceforge.net/mail/?group_id=11118"
 498 TARGET="_top"
 499 >http://sourceforge.net/mail/?group_id=11118</A
 500 >.</P
 501 ></DIV
 502 ></DIV
 503 ><DIV
 504 CLASS="NAVFOOTER"
 505 ><HR
 506 ALIGN="LEFT"
 507 WIDTH="100%"><TABLE
 508 SUMMARY="Footer navigation table"
 509 WIDTH="100%"
 510 BORDER="0"
 511 CELLPADDING="0"
 512 CELLSPACING="0"
 513 ><TR
 514 ><TD
 515 WIDTH="33%"
 516 ALIGN="left"
 517 VALIGN="top"
 518 ><A
 519 HREF="trouble.html"
 520 ACCESSKEY="P"
 521 >Prev</A
 522 ></TD
 523 ><TD
 524 WIDTH="34%"
 525 ALIGN="center"
 526 VALIGN="top"
 527 ><A
 528 HREF="index.html"
 529 ACCESSKEY="H"
 530 >Home</A
 531 ></TD
 532 ><TD
 533 WIDTH="33%"
 534 ALIGN="right"
 535 VALIGN="top"
 536 ><A
 537 HREF="copyright.html"
 538 ACCESSKEY="N"
 539 >Next</A
 540 ></TD
 541 ></TR
 542 ><TR
 543 ><TD
 544 WIDTH="33%"
 545 ALIGN="left"
 546 VALIGN="top"
 547 >Troubleshooting</TD
 548 ><TD
 549 WIDTH="34%"
 550 ALIGN="center"
 551 VALIGN="top"
 552 >&nbsp;</TD
 553 ><TD
 554 WIDTH="33%"
 555 ALIGN="right"
 556 VALIGN="top"
 557 >Privoxy Copyright, License and History</TD
 558 ></TR
 559 ></TABLE
 560 ></DIV
 561 ></BODY
 562 ></HTML
 563 >