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.16 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.16 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     Note that Privoxy log files may contain sensitive information so please don't
 413     submit any logfiles you didn't read first. You can mask sensitive information
 414     as long as it's clear that you removed something.
 415    </P
 416 ></LI
 417 ></UL
 418 ></P
 419 ><P
 420 > You don't have to tell us your actual name when filing a problem
 421  report, but if you don't, please use a nickname so we can differentiate
 422  between your messages and the ones entered by other "anonymous" users that
 423  may respond to your request if they have the same problem or already
 424  found a solution.</P
 425 ><P
 426 > Please also check the status of your request a few days after submitting
 427  it, as we may request additional information. If you use a SF id,
 428  you should automatically get a mail when someone responds to your request.</P
 429 ><P
 430 >  The <A
 431 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
 432 TARGET="_top"
 433 >appendix
 434   of the Privoxy User Manual</A
 435 > also has helpful information
 436   on understanding <TT
 437 CLASS="LITERAL"
 438 >actions</TT
 439 >, and <TT
 440 CLASS="LITERAL"
 441 >action</TT
 442 > debugging. </P
 443 ></DIV
 444 ></DIV
 445 ><DIV
 446 CLASS="SECT2"
 447 ><H2
 448 CLASS="SECT2"
 449 ><A
 450 NAME="CONTACT-FEATURE"
 451 >11.3. Request New Features</A
 452 ></H2
 453 ><P
 454 > You are welcome to submit ideas on new features or other proposals
 455  for improvement through our feature request tracker at
 456  <A
 457 HREF="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118"
 458 TARGET="_top"
 459 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
 460 >.</P
 461 ></DIV
 462 ><DIV
 463 CLASS="SECT2"
 464 ><H2
 465 CLASS="SECT2"
 466 ><A
 467 NAME="CONTACT-OTHER"
 468 >11.4. Other</A
 469 ></H2
 470 ><P
 471 >For any other issues, feel free to use the mailing lists. Technically interested users
 472 and people who wish to contribute to the project are also welcome on the developers list!
 473 You can find an overview of all <SPAN
 474 CLASS="APPLICATION"
 475 >Privoxy</SPAN
 476 >-related mailing lists,
 477 including list archives, at:
 478 <A
 479 HREF="http://sourceforge.net/mail/?group_id=11118"
 480 TARGET="_top"
 481 >http://sourceforge.net/mail/?group_id=11118</A
 482 >.</P
 483 ></DIV
 484 ></DIV
 485 ><DIV
 486 CLASS="NAVFOOTER"
 487 ><HR
 488 ALIGN="LEFT"
 489 WIDTH="100%"><TABLE
 490 SUMMARY="Footer navigation table"
 491 WIDTH="100%"
 492 BORDER="0"
 493 CELLPADDING="0"
 494 CELLSPACING="0"
 495 ><TR
 496 ><TD
 497 WIDTH="33%"
 498 ALIGN="left"
 499 VALIGN="top"
 500 ><A
 501 HREF="templates.html"
 502 ACCESSKEY="P"
 503 >Prev</A
 504 ></TD
 505 ><TD
 506 WIDTH="34%"
 507 ALIGN="center"
 508 VALIGN="top"
 509 ><A
 510 HREF="index.html"
 511 ACCESSKEY="H"
 512 >Home</A
 513 ></TD
 514 ><TD
 515 WIDTH="33%"
 516 ALIGN="right"
 517 VALIGN="top"
 518 ><A
 519 HREF="copyright.html"
 520 ACCESSKEY="N"
 521 >Next</A
 522 ></TD
 523 ></TR
 524 ><TR
 525 ><TD
 526 WIDTH="33%"
 527 ALIGN="left"
 528 VALIGN="top"
 529 >Privoxy's Template Files</TD
 530 ><TD
 531 WIDTH="34%"
 532 ALIGN="center"
 533 VALIGN="top"
 534 >&nbsp;</TD
 535 ><TD
 536 WIDTH="33%"
 537 ALIGN="right"
 538 VALIGN="top"
 539 >Privoxy Copyright, License and History</TD
 540 ></TR
 541 ></TABLE
 542 ></DIV
 543 ></BODY
 544 ></HTML
 545 >