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