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"></HEAD
  21 ><BODY
  22 CLASS="SECT1"
  23 BGCOLOR="#EEEEEE"
  24 TEXT="#000000"
  25 LINK="#0000FF"
  26 VLINK="#840084"
  27 ALINK="#0000FF"
  28 ><DIV
  29 CLASS="NAVHEADER"
  30 ><TABLE
  31 SUMMARY="Header navigation table"
  32 WIDTH="100%"
  33 BORDER="0"
  34 CELLPADDING="0"
  35 CELLSPACING="0"
  36 ><TR
  37 ><TH
  38 COLSPAN="3"
  39 ALIGN="center"
  40 >Privoxy Developer Manual</TH
  41 ></TR
  42 ><TR
  43 ><TD
  44 WIDTH="10%"
  45 ALIGN="left"
  46 VALIGN="bottom"
  47 ><A
  48 HREF="webserver-update.html"
  49 ACCESSKEY="P"
  50 >Prev</A
  51 ></TD
  52 ><TD
  53 WIDTH="80%"
  54 ALIGN="center"
  55 VALIGN="bottom"
  56 ></TD
  57 ><TD
  58 WIDTH="10%"
  59 ALIGN="right"
  60 VALIGN="bottom"
  61 ><A
  62 HREF="copyright.html"
  63 ACCESSKEY="N"
  64 >Next</A
  65 ></TD
  66 ></TR
  67 ></TABLE
  68 ><HR
  69 ALIGN="LEFT"
  70 WIDTH="100%"></DIV
  71 ><DIV
  72 CLASS="SECT1"
  73 ><H1
  74 CLASS="SECT1"
  75 ><A
  76 NAME="CONTACT"
  77 >8. Contacting the developers, Bug Reporting and Feature Requests</A
  78 ></H1
  79 ><P
  80 > We value your feedback. In fact, we rely on it to improve
  81  <SPAN
  82 CLASS="APPLICATION"
  83 >Privoxy</SPAN
  84 > and its configuration.
  85  However, please note the following hints, so we can
  86  provide you with the best support:</P
  87 ><DIV
  88 CLASS="SECT2"
  89 ><H2
  90 CLASS="SECT2"
  91 ><A
  92 NAME="CONTACT-SUPPORT"
  93 >8.1. Get Support</A
  94 ></H2
  95 ><P
  96 > For casual users, our
  97  <A
  98 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
  99 TARGET="_top"
 100 >support forum at SourceForge</A
 101 >
 102  is probably best suited:
 103  <A
 104 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=211118"
 105 TARGET="_top"
 106 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</A
 107 ></P
 108 ><P
 109 > All users are of course welcome to discuss their issues on the <A
 110 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-users"
 111 TARGET="_top"
 112 >users
 113  mailing list</A
 114 >, where the developers also hang around.</P
 115 ><P
 116 > Note that the Privoxy mailing lists are moderated. Posts from unsubscribed
 117  addresses have to be accepted manually by a moderator. This may cause a
 118  delay of several days and if you use a subject that doesn't clearly
 119  mention Privoxy or one of its features, your message may be accidentally
 120  discarded as spam.</P
 121 ><P
 122 > If you aren't subscribed, you should therefore spend a few seconds
 123  to come up with a proper subject. Additionally you should make it clear
 124  that you want to get CC'd. Otherwise some responses will be directed to
 125  the mailing list only, and you won't see them.</P
 126 ></DIV
 127 ><DIV
 128 CLASS="SECT2"
 129 ><H2
 130 CLASS="SECT2"
 131 ><A
 132 NAME="REPORTING"
 133 >8.2. Reporting Problems</A
 134 ></H2
 135 ><P
 136 ><SPAN
 137 CLASS="QUOTE"
 138 >"Problems"</SPAN
 139 > for our purposes, come in two forms:</P
 140 ><P
 141 ></P
 142 ><UL
 143 ><LI
 144 ><P
 145 >    Configuration issues, such as ads that slip through, or sites that
 146     don't function properly due to one <SPAN
 147 CLASS="APPLICATION"
 148 >Privoxy</SPAN
 149 >
 150     <SPAN
 151 CLASS="QUOTE"
 152 >"action"</SPAN
 153 > or another being turned <SPAN
 154 CLASS="QUOTE"
 155 >"on"</SPAN
 156 >.
 157    </P
 158 ></LI
 159 ><LI
 160 ><P
 161 >    <SPAN
 162 CLASS="QUOTE"
 163 >"Bugs"</SPAN
 164 > in the programming code that makes up
 165     <SPAN
 166 CLASS="APPLICATION"
 167 >Privoxy</SPAN
 168 >, such as that might cause a crash.
 169    </P
 170 ></LI
 171 ></UL
 172 ><DIV
 173 CLASS="SECT3"
 174 ><H3
 175 CLASS="SECT3"
 176 ><A
 177 NAME="CONTACT-ADS"
 178 >8.2.1. Reporting Ads or Other Configuration Problems</A
 179 ></H3
 180 ><P
 181 > Please send feedback on ads that slipped through, innocent images that were
 182  blocked, sites that don't work properly, and other configuration related problem of
 183  <TT
 184 CLASS="FILENAME"
 185 >default.action</TT
 186 > file, to
 187  <A
 188 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288"
 189 TARGET="_top"
 190 > http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
 191 >,
 192  the Actions File Tracker.</P
 193 ><P
 194 > New, improved <TT
 195 CLASS="FILENAME"
 196 >default.action</TT
 197 > files may occasionally be made
 198  available based on your feedback. These will be announced on the <A
 199 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce"
 200 TARGET="_top"
 201 >ijbswa-announce</A
 202 >
 203  list and available from our the <A
 204 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
 205 TARGET="_top"
 206 >files section</A
 207 > of
 208  our <A
 209 HREF="http://sf.net/projects/ijbswa/"
 210 TARGET="_top"
 211 >project page</A
 212 >.</P
 213 ></DIV
 214 ><DIV
 215 CLASS="SECT3"
 216 ><H3
 217 CLASS="SECT3"
 218 ><A
 219 NAME="CONTACT-BUGS"
 220 >8.2.2. Reporting Bugs</A
 221 ></H3
 222 ><P
 223 > Please report all bugs through our bug tracker:
 224  <A
 225 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=111118"
 226 TARGET="_top"
 227 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</A
 228 >. </P
 229 ><P
 230 >  Before doing so, please make sure that the bug has <SPAN
 231 CLASS="emphasis"
 232 ><I
 233 CLASS="EMPHASIS"
 234 >not already been submitted</I
 235 ></SPAN
 236 >
 237   and observe the additional hints at the top of the <A
 238 HREF="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
 239 TARGET="_top"
 240 >submit
 241   form</A
 242 >. If already submitted, please feel free to add any info to the
 243   original report that might help to solve the issue.</P
 244 ><P
 245 >  Please try to verify that it is a <SPAN
 246 CLASS="APPLICATION"
 247 >Privoxy</SPAN
 248 > bug,
 249   and not a browser or site bug or documented behaviour that just happens
 250   to be different than what you expected. If unsure,
 251   try <A
 252 HREF="http://config.privoxy.org/toggle?set=disable"
 253 TARGET="_top"
 254 >toggling
 255   off</A
 256 > <SPAN
 257 CLASS="APPLICATION"
 258 >Privoxy</SPAN
 259 >, and see if the problem persists.</P
 260 ><P
 261 >  If you are using your own custom configuration, please try
 262   the stock configs to see if the problem is configuration related.
 263   If you're having problems with a feature that is disabled by default,
 264   please ask around on the mailing list if others can reproduce the problem.</P
 265 ><P
 266 >  If you aren't using the latest Privoxy version, the bug may have been found
 267   and fixed in the meantime. We would appreciate if you could take the time
 268   to <A
 269 HREF="http://www.privoxy.org/user-manual/installation.html"
 270 TARGET="_top"
 271 >upgrade
 272   to the latest version</A
 273 > (or  even the latest CVS snapshot) and verify
 274   that your bug still exists.</P
 275 ><P
 276 >Please be sure to provide the following information:</P
 277 ><P
 278 > <P
 279 ></P
 280 ><UL
 281 ><LI
 282 ><P
 283 >    The exact <SPAN
 284 CLASS="APPLICATION"
 285 >Privoxy</SPAN
 286 > version you are using
 287     (if you got the source from CVS, please also provide the source code revisions
 288      as shown in <A
 289 HREF="http://config.privoxy.org/show-version"
 290 TARGET="_top"
 291 >http://config.privoxy.org/show-version</A
 292 >).
 293    </P
 294 ></LI
 295 ><LI
 296 ><P
 297 >    The operating system and versions you run
 298     <SPAN
 299 CLASS="APPLICATION"
 300 >Privoxy</SPAN
 301 > on, (e.g. <SPAN
 302 CLASS="APPLICATION"
 303 >Windows
 304     XP SP2</SPAN
 305 >), if you are using a Unix flavor,
 306     sending the output of <SPAN
 307 CLASS="QUOTE"
 308 >"uname -a"</SPAN
 309 > should do,
 310     in case of GNU/Linux, please also name the distribution.
 311    </P
 312 ></LI
 313 ><LI
 314 ><P
 315 >    The name, platform, and version of the <SPAN
 316 CLASS="APPLICATION"
 317 >browser</SPAN
 318 >
 319     you were using (e.g. <SPAN
 320 CLASS="APPLICATION"
 321 >Internet Explorer v5.5</SPAN
 322 > for Mac).
 323    </P
 324 ></LI
 325 ><LI
 326 ><P
 327 >    The URL where the problem occurred, or some way for us to duplicate the
 328     problem (e.g. <TT
 329 CLASS="LITERAL"
 330 >http://somesite.example.com/?somethingelse=123</TT
 331 >).
 332    </P
 333 ></LI
 334 ><LI
 335 ><P
 336 >    Whether your version of <SPAN
 337 CLASS="APPLICATION"
 338 >Privoxy</SPAN
 339 > is one supplied
 340     by the <SPAN
 341 CLASS="APPLICATION"
 342 >Privoxy</SPAN
 343 > developers via SourceForge,
 344     or if you got your copy somewhere else.
 345    </P
 346 ></LI
 347 ><LI
 348 ><P
 349 >    Whether you are using <SPAN
 350 CLASS="APPLICATION"
 351 >Privoxy</SPAN
 352 > in tandem with
 353     another proxy such as <SPAN
 354 CLASS="APPLICATION"
 355 >Tor</SPAN
 356 >. If so, please
 357     temporary disable the other proxy to see if the symptoms change.
 358    </P
 359 ></LI
 360 ><LI
 361 ><P
 362 >    Whether you are using a personal firewall product. If so, does
 363     <SPAN
 364 CLASS="APPLICATION"
 365 >Privoxy</SPAN
 366 > work without it?
 367    </P
 368 ></LI
 369 ><LI
 370 ><P
 371 >    Any other pertinent information to help identify the problem such as config
 372     or log file excerpts (yes, you should have log file entries for each
 373     action taken).
 374    </P
 375 ></LI
 376 ></UL
 377 ></P
 378 ><P
 379 > You don't have to tell us your actual name when filing a problem
 380  report, but please use a nickname so we can differentiate between
 381  your messages and the ones entered by other "anonymous" users that
 382  may respond to your request if they have the same problem or already
 383  found a solution.</P
 384 ><P
 385 > Please also check the status of your request a few days after submitting
 386  it, as we may request additional information. If you use a SF id,
 387  you should automatically get a mail when someone responds to your request.</P
 388 ><P
 389 >  The <A
 390 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
 391 TARGET="_top"
 392 >appendix
 393   of the Privoxy User Manual</A
 394 > also has helpful information
 395   on understanding <TT
 396 CLASS="LITERAL"
 397 >actions</TT
 398 >, and <TT
 399 CLASS="LITERAL"
 400 >action</TT
 401 > debugging. </P
 402 ></DIV
 403 ></DIV
 404 ><DIV
 405 CLASS="SECT2"
 406 ><H2
 407 CLASS="SECT2"
 408 ><A
 409 NAME="CONTACT-FEATURE"
 410 >8.3. Request New Features</A
 411 ></H2
 412 ><P
 413 > You are welcome to submit ideas on new features or other proposals
 414  for improvement through our feature request tracker at
 415  <A
 416 HREF="http://sourceforge.net/tracker/?atid=361118&group_id=11118"
 417 TARGET="_top"
 418 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
 419 >.</P
 420 ></DIV
 421 ><DIV
 422 CLASS="SECT2"
 423 ><H2
 424 CLASS="SECT2"
 425 ><A
 426 NAME="CONTACT-OTHER"
 427 >8.4. Other</A
 428 ></H2
 429 ><P
 430 >For any other issues, feel free to use the mailing lists. Technically interested users
 431 and people who wish to contribute to the project are also welcome on the developers list!
 432 You can find an overview of all <SPAN
 433 CLASS="APPLICATION"
 434 >Privoxy</SPAN
 435 >-related mailing lists,
 436 including list archives, at:
 437 <A
 438 HREF="http://sourceforge.net/mail/?group_id=11118"
 439 TARGET="_top"
 440 >http://sourceforge.net/mail/?group_id=11118</A
 441 >.</P
 442 ></DIV
 443 ></DIV
 444 ><DIV
 445 CLASS="NAVFOOTER"
 446 ><HR
 447 ALIGN="LEFT"
 448 WIDTH="100%"><TABLE
 449 SUMMARY="Footer navigation table"
 450 WIDTH="100%"
 451 BORDER="0"
 452 CELLPADDING="0"
 453 CELLSPACING="0"
 454 ><TR
 455 ><TD
 456 WIDTH="33%"
 457 ALIGN="left"
 458 VALIGN="top"
 459 ><A
 460 HREF="webserver-update.html"
 461 ACCESSKEY="P"
 462 >Prev</A
 463 ></TD
 464 ><TD
 465 WIDTH="34%"
 466 ALIGN="center"
 467 VALIGN="top"
 468 ><A
 469 HREF="index.html"
 470 ACCESSKEY="H"
 471 >Home</A
 472 ></TD
 473 ><TD
 474 WIDTH="33%"
 475 ALIGN="right"
 476 VALIGN="top"
 477 ><A
 478 HREF="copyright.html"
 479 ACCESSKEY="N"
 480 >Next</A
 481 ></TD
 482 ></TR
 483 ><TR
 484 ><TD
 485 WIDTH="33%"
 486 ALIGN="left"
 487 VALIGN="top"
 488 >Update the Webserver</TD
 489 ><TD
 490 WIDTH="34%"
 491 ALIGN="center"
 492 VALIGN="top"
 493 >&nbsp;</TD
 494 ><TD
 495 WIDTH="33%"
 496 ALIGN="right"
 497 VALIGN="top"
 498 >Privoxy Copyright, License and History</TD
 499 ></TR
 500 ></TABLE
 501 ></DIV
 502 ></BODY
 503 ></HTML
 504 >