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