X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Ffaq%2Fcontact.html;h=13215a02571a829c84ba325e9a14a8c2eb0af7e3;hp=5ae45f29a5663ffe6e96eebcd54117236966f92b;hb=a5b4d31ab5ad2ed24cdb53ffa92679411b4176b0;hpb=6d810395712f0337682205c4ea304009c86c128f diff --git a/doc/webserver/faq/contact.html b/doc/webserver/faq/contact.html index 5ae45f29..13215a02 100644 --- a/doc/webserver/faq/contact.html +++ b/doc/webserver/faq/contact.html @@ -1,406 +1,218 @@ - + - - - - Contacting the developers, Bug Reporting and Feature Requests - - - - - - - - - - - -
-

- 6. Contacting the developers, Bug Reporting and - Feature Requests -

-

- We value your feedback. In fact, we rely on it to improve Privoxy and its configuration. However, - please note the following hints, so we can provide you with the best - support: -

-
-

- 6.1. Get Support -

-

- For casual users, our support forum at SourceForge is probably best - suited: http://sourceforge.net/tracker/?group_id=11118&atid=211118 -

-

- All users are of course welcome to discuss their issues on the users mailing list, where the developers also - hang around. -

-

- Please don't sent private support requests to individual Privoxy - developers, either use the mailing lists or the support trackers. -

-

- If you have to contact a Privoxy developer directly for other - reasons, please send a real mail and do not bother with - SourceForge's messaging system. Answers to SourceForge messages are - usually bounced by SourceForge's mail server in which case the - developer wasted time writing a response you don't get. From your - point of view it will look like your message has been completely - ignored, so this is frustrating for all parties involved. -

-

- Note that the Privoxy mailing lists are moderated. Posts from - unsubscribed addresses have to be accepted manually by a moderator. - This may cause a delay of several days and if you use a subject - that doesn't clearly mention Privoxy or one of its features, your - message may be accidentally discarded as spam. -

-

- If you aren't subscribed, you should therefore spend a few seconds - to come up with a proper subject. Additionally you should make it - clear that you want to get CC'd. Otherwise some responses will be - directed to the mailing list only, and you won't see them. -

-
-
-

- 6.2. Reporting Problems -

-

- "Problems" for our purposes, come in two - forms: -

- -
-

- 6.2.1. Reporting Ads or Other Configuration - Problems -

-

- Please send feedback on ads that slipped through, innocent images - that were blocked, sites that don't work properly, and other - configuration related problem of default.action file, to http://sourceforge.net/tracker/?group_id=11118&atid=460288, - the Actions File Tracker. -

-

- New, improved default.action files may - occasionally be made available based on your feedback. These will - be announced on the ijbswa-announce list and available from our the - files section of our project page. -

-
-
-

- 6.2.2. Reporting Bugs -

-

- Please report all bugs through our bug tracker: http://sourceforge.net/tracker/?group_id=11118&atid=111118. -

-

- Before doing so, please make sure that the bug has not already been - submitted and observe the additional hints at the top - of the submit form. If already submitted, please feel - free to add any info to the original report that might help to - solve the issue. -

-

- Please try to verify that it is a Privoxy bug, and not a browser or site bug - or documented behaviour that just happens to be different than - what you expected. If unsure, try toggling off Privoxy, - and see if the problem persists. -

-

- If you are using your own custom configuration, please try the - stock configs to see if the problem is configuration related. If - you're having problems with a feature that is disabled by - default, please ask around on the mailing list if others can - reproduce the problem. -

-

- If you aren't using the latest Privoxy version, the bug may have - been found and fixed in the meantime. We would appreciate if you - could take the time to upgrade to the latest version (or even the latest CVS - snapshot) and verify that your bug still exists. -

-

- Please be sure to provide the following information: -

-

-

-
    -
  • -

    - The exact Privoxy version - you are using (if you got the source from CVS, please also - provide the source code revisions as shown in http://config.privoxy.org/show-version). -

    -
  • -
  • -

    - The operating system and versions you run Privoxy on, (e.g. Windows XP SP2), if you are using a Unix - flavor, sending the output of "uname - -a" should do, in case of GNU/Linux, please also name - the distribution. -

    -
  • -
  • -

    - The name, platform, and version of the browser you were using (e.g. Internet Explorer v5.5 for Mac). -

    -
  • -
  • -

    - The URL where the problem occurred, or some way for us to - duplicate the problem (e.g. http://somesite.example.com/?somethingelse=123). -

    -
  • -
  • -

    - Whether your version of Privoxy is one supplied by the Privoxy developers via - SourceForge, or if you got your copy somewhere else. -

    -
  • -
  • -

    - Whether you are using Privoxy in tandem with another proxy - such as Tor. If so, please - temporary disable the other proxy to see if the symptoms - change. -

    -
  • -
  • -

    - Whether you are using a personal firewall product. If so, - does Privoxy work without - it? -

    -
  • -
  • -

    - Any other pertinent information to help identify the problem - such as config or log file excerpts (yes, you should have log - file entries for each action taken). To get a meaningful - logfile, please make sure that the logfile - directive is being used and the following debug - options are enabled: -

    -

    - debug     1 # Log the destination for each request Privoxy let through. See also debug 1024.
    - - debug     2 # show each connection status
    - - debug     4 # show I/O status
    - - debug     8 # show header parsing
    - - debug   128 # debug redirects
    - - debug   256 # debug GIF de-animation
    + + Contacting the developers, Bug Reporting and Feature Requests + + + + + + + + +

    +
    +

    6. Contacting the developers, Bug Reporting and Feature + Requests

    +

    We value your feedback. In fact, we rely on it to improve Privoxy and its + configuration. However, please note the following hints, so we can provide you with the best support.

    +
    +

    6.1. Please provide sufficient + information

    +

    A lot of support requests don't contain enough information and can't be solved without a lot of back and forth + which causes unnecessary delays. Reading this section should help to prevent that.

    +

    Before contacting us to report a problem, please try to verify that it is a Privoxy problem, and not a browser or site problem or documented behaviour that just happens + to be different than what you expected. If unsure, try toggling off Privoxy, and see if the problem persists.

    +

    If you are using your own custom configuration, please try the default configuration to see if the problem is + configuration related. If you're having problems with a feature that is disabled by default, please ask around on + the mailing list if others can reproduce the problem.

    +

    If you aren't using the latest Privoxy version, the problem may have been found and fixed in the meantime. We + would appreciate if you could take the time to upgrade to the latest version and verify that the problem still exists.

    +

    Please be sure to provide the following information when reporting problems or requesting support:

    +
      +
    • +

      The exact Privoxy version you are using.

      +
    • +
    • +

      The operating system and versions you run Privoxy on, e.g. Windows XP SP2.

      +
    • +
    • +

      The name, platform, and version of the browser you were using (e.g. + Internet Explorer v5.5 for Mac).

      +
    • +
    • +

      The URL where the problem occurred, or some way for us to duplicate the problem (e.g. http://somesite.example.com/?somethingelse=123).

      +
    • +
    • +

      Whether your version of Privoxy is one supplied by the Privoxy developers, or if you got your copy somewhere else.

      +
    • +
    • +

      Whether you are using Privoxy together with another proxy such as + Tor. If so, please temporary disable the other proxy to see if the symptoms + change.

      +
    • +
    • +

      Whether you are using a personal firewall product. If so, does Privoxy + work without it?

      +
    • +
    • +

      Any other pertinent information to help identify the problem such as config or log file excerpts (yes, you + should have log file entries for each action taken). To get a meaningful logfile, please make sure that the + logfile directive is being used and the + following debug options are enabled (all of + them):

      +

      + debug     1 # Log the destination for each request Privoxy let through.
      - debug   512 # Common Log Format
      +             #   See also debug 1024.
      - debug  1024 # Log the destination for requests Privoxy didn't let through, and the reason why.
      + debug     2 # show each connection status
      + debug     4 # show tagging-related messages
      + debug     8 # show header parsing
      + debug   128 # debug redirects
      + debug   256 # debug GIF de-animation
      + debug   512 # Common Log Format
      + debug  1024 # Log the destination for requests Privoxy didn't let through,
      - debug  4096 # Startup banner and warnings.
      +             #   and the reason why.
      - debug  8192 # Non-fatal errors -

      - If you are having trouble with a filter, please additionally - enable -

      - debug    64 # debug regular expression filters -

      - If you are using Privoxy 3.0.17 or later and suspect that it - interprets the request or the response incorrectly, please - enable -

      - debug 32768 # log all data read from the network -

      - Note that Privoxy log files may contain sensitive information - so please don't submit any logfiles you didn't read first. You - can mask sensitive information as long as it's clear that you - removed something.
      -
    • -
    - -

    - You don't have to tell us your actual name when filing a problem - report, but if you don't, please use a nickname so we can - differentiate between your messages and the ones entered by other - "anonymous" users that may respond to your request if they have - the same problem or already found a solution. Note that due to - spam the trackers may not always allow to post without being - logged into SourceForge. If that's the case, you are still free - to create a login that isn't directly linked to your name, - though. -

    -

    - Please also check the status of your request a few days after - submitting it, as we may request additional information. If you - use a SF id, you should automatically get a mail when someone - responds to your request. Please don't bother to add an email - address when using the tracker. If you prefer to communicate - through email, just use one of the mailing lists directly. -

    -

    - The appendix of the Privoxy User Manual also has - helpful information on understanding actions, and action - debugging. -

    -
    -
    -
    -

    - 6.3. Request New Features -

    -

    - You are welcome to submit ideas on new features or other proposals - for improvement through our feature request tracker at http://sourceforge.net/tracker/?atid=361118&group_id=11118. -

    + debug  4096 # Startup banner and warnings.
    + debug  8192 # Non-fatal errors
    + debug 65536 # Log applying actions

    +

    If you are having trouble with a filter, please additionally enable

    +

    + debug    64 # debug regular expression filters

    +

    If you suspect that Privoxy interprets the request or the response incorrectly, please enable

    +

    + debug 32768 # log all data read from the network

    +

    It's easy for us to ignore log messages that aren't relevant but missing log messages may make it + impossible to investigate a problem. If you aren't sure which of the debug directives are relevant, please + just enable all of them and let us worry about it.

    +

    Note that Privoxy log files may contain sensitive information so please don't submit any logfiles you + didn't read first. You can mask sensitive information as long as it's clear that you removed something.

    +
  • +
+

You don't have to tell us your actual name when filing a problem report, but if you don't, please use a + nickname so we can differentiate between your messages and the ones entered by other "anonymous" users that may + respond to your request if they have the same problem or already found a solution. Note that due to spam the + trackers may not always allow to post without being logged into SourceForge. If that's the case, you are still + free to create a login that isn't directly linked to your name, though.

+

Please also check the status of your request a few days after submitting it, as we may request additional + information. If you use a SF id, you should automatically get a mail when someone responds to your request. + Please don't bother to add an email address when using the tracker. If you prefer to communicate through email, + just use one of the mailing lists directly.

+

The appendix of the + Privoxy User Manual also has helpful information on understanding actions, and + action debugging.

+
+
+

6.2. Get Support

+

All users are welcome to discuss their issues on the users mailing list, where the + developers also hang around.

+

Please don't send private support requests to individual Privoxy developers, either use the mailing lists or + the support trackers.

+

If you have to contact a Privoxy developer directly for other reasons, please send a real mail and do not + bother with SourceForge's messaging system. Answers to SourceForge messages are usually bounced by SourceForge's + mail server in which case the developer wasted time writing a response you don't get. From your point of view it + will look like your message has been completely ignored, so this is frustrating for all parties involved.

+

Note that the Privoxy mailing lists are moderated. Posts from unsubscribed addresses have to be accepted + manually by a moderator. This may cause a delay of several days and if you use a subject that doesn't clearly + mention Privoxy or one of its features, your message may be accidentally discarded as spam.

+

If you aren't subscribed, you should therefore spend a few seconds to come up with a proper subject. + Additionally you should make it clear that you want to get CC'd. Otherwise some responses will be directed to the + mailing list only, and you won't see them.

+
+
+

6.3. Reporting Problems

+

"Problems" for our purposes, come in two forms:

+
    +
  • +

    Configuration issues, such as ads that slip through, or sites that don't function properly due to one + Privoxy "action" or another being turned + "on".

    +
  • +
  • +

    "Bugs" in the programming code that makes up Privoxy, such as that might cause a crash. Documentation issues, for example spelling + errors and unclear descriptions, are bugs, too.

    +
  • +
+
+

6.3.1. Reporting Ads or Other Configuration + Problems

+

Please send feedback on ads that slipped through, innocent images that were blocked, sites that don't work + properly, and other configuration related problem of default.action file, to https://sourceforge.net/p/ijbswa/actionsfile-feedback/, the Actions File Tracker.

-
-

- 6.4. Mailing Lists -

-

- If you prefer to communicate through email, instead of using a web - interface, feel free to use one of the mailing lists. To discuss - issues that haven't been completely diagnosed yet, please use the - Privoxy users list. Technically interested users and people who - wish to contribute to the project are always welcome on the - developers list. You can find an overview of all Privoxy-related mailing lists, including list - archives, at: http://sourceforge.net/mail/?group_id=11118. -

+
+

6.3.2. Reporting Bugs

+

Before reporting bugs, please make sure that the bug has not + already been submitted and observe the additional hints at the top of the submit form. If already submitted, please feel free + to add any info to the original report that might help to solve the issue.

- + + -