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