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).
 380    </P
 381 ></LI
 382 ></UL
 383 ></P
 384 ><P
 385 > You don't have to tell us your actual name when filing a problem
 386  report, but please use a nickname so we can differentiate between
 387  your messages and the ones entered by other "anonymous" users that
 388  may respond to your request if they have the same problem or already
 389  found a solution.</P
 390 ><P
 391 > Please also check the status of your request a few days after submitting
 392  it, as we may request additional information. If you use a SF id,
 393  you should automatically get a mail when someone responds to your request.</P
 394 ><P
 395 >  The <A
 396 HREF="http://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
 397 TARGET="_top"
 398 >appendix
 399   of the Privoxy User Manual</A
 400 > also has helpful information
 401   on understanding <TT
 402 CLASS="LITERAL"
 403 >actions</TT
 404 >, and <TT
 405 CLASS="LITERAL"
 406 >action</TT
 407 > debugging. </P
 408 ></DIV
 409 ></DIV
 410 ><DIV
 411 CLASS="SECT2"
 412 ><H2
 413 CLASS="SECT2"
 414 ><A
 415 NAME="CONTACT-FEATURE"
 416 >8.3. Request New Features</A
 417 ></H2
 418 ><P
 419 > You are welcome to submit ideas on new features or other proposals
 420  for improvement through our feature request tracker at
 421  <A
 422 HREF="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118"
 423 TARGET="_top"
 424 >http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</A
 425 >.</P
 426 ></DIV
 427 ><DIV
 428 CLASS="SECT2"
 429 ><H2
 430 CLASS="SECT2"
 431 ><A
 432 NAME="CONTACT-OTHER"
 433 >8.4. Other</A
 434 ></H2
 435 ><P
 436 >For any other issues, feel free to use the mailing lists. Technically interested users
 437 and people who wish to contribute to the project are also welcome on the developers list!
 438 You can find an overview of all <SPAN
 439 CLASS="APPLICATION"
 440 >Privoxy</SPAN
 441 >-related mailing lists,
 442 including list archives, at:
 443 <A
 444 HREF="http://sourceforge.net/mail/?group_id=11118"
 445 TARGET="_top"
 446 >http://sourceforge.net/mail/?group_id=11118</A
 447 >.</P
 448 ></DIV
 449 ></DIV
 450 ><DIV
 451 CLASS="NAVFOOTER"
 452 ><HR
 453 ALIGN="LEFT"
 454 WIDTH="100%"><TABLE
 455 SUMMARY="Footer navigation table"
 456 WIDTH="100%"
 457 BORDER="0"
 458 CELLPADDING="0"
 459 CELLSPACING="0"
 460 ><TR
 461 ><TD
 462 WIDTH="33%"
 463 ALIGN="left"
 464 VALIGN="top"
 465 ><A
 466 HREF="webserver-update.html"
 467 ACCESSKEY="P"
 468 >Prev</A
 469 ></TD
 470 ><TD
 471 WIDTH="34%"
 472 ALIGN="center"
 473 VALIGN="top"
 474 ><A
 475 HREF="index.html"
 476 ACCESSKEY="H"
 477 >Home</A
 478 ></TD
 479 ><TD
 480 WIDTH="33%"
 481 ALIGN="right"
 482 VALIGN="top"
 483 ><A
 484 HREF="copyright.html"
 485 ACCESSKEY="N"
 486 >Next</A
 487 ></TD
 488 ></TR
 489 ><TR
 490 ><TD
 491 WIDTH="33%"
 492 ALIGN="left"
 493 VALIGN="top"
 494 >Update the Webserver</TD
 495 ><TD
 496 WIDTH="34%"
 497 ALIGN="center"
 498 VALIGN="top"
 499 >&nbsp;</TD
 500 ><TD
 501 WIDTH="33%"
 502 ALIGN="right"
 503 VALIGN="top"
 504 >Privoxy Copyright, License and History</TD
 505 ></TR
 506 ></TABLE
 507 ></DIV
 508 ></BODY
 509 ></HTML
 510 >