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