X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fcontact.html;h=af8a9b5b65a13fd4078c9decee0a32d2b93326d9;hp=9b3bc0cf0025f74ca7ec19fb0a6a9a5c114f586e;hb=f8dbc81f51ddf04121644ad5da727f94f3ad11a5;hpb=900ef1d91632a70d1bbb4c3117e9027509b35d7e diff --git a/doc/webserver/user-manual/contact.html b/doc/webserver/user-manual/contact.html index 9b3bc0cf..af8a9b5b 100644 --- a/doc/webserver/user-manual/contact.html +++ b/doc/webserver/user-manual/contact.html @@ -1,84 +1,186 @@ - - - Contacting the Developers, Bug Reporting and Feature Requests - + - + - - - + -

11. 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:

- + the following hints, so we can provide you with the best support.

-

11.1. +

11.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 via SourceForge, 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. 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
    + + debug   512 # Common Log Format
    + + debug  1024 # Log the destination for requests Privoxy didn't let through, and the reason why.
    + + 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.

+

If you are new to reporting problems, you might be interested in + How to Report Bugs Effectively.

+

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

+

+
+

11.2. 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 +

All users are 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 +

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 @@ -86,26 +188,21 @@ body { 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.

-
-

11.2. Reporting +

11.3. Reporting Problems

-

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

-
  • Configuration issues, such as ads that slip through, or sites @@ -113,214 +210,53 @@ body { "APPLICATION">Privoxy "action" or another being turned "on".

  • -
  • "Bugs" in the programming code that makes up Privoxy, such as that - might cause a crash.

    + might cause a crash. Documentation issues, for example spelling + errors and unclear descriptions, are bugs, too.

-
-

11.2.1. +

11.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 http://sourceforge.net/tracker/?group_id=11118&atid=460288, + "_top">https://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.

-
-

11.2.2. +

11.3.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 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.

- -

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
    - - debug   512 # Common Log Format
    - - debug  1024 # Log the destination for requests Privoxy didn't let through, and the reason why.
    - - debug  4096 # Startup banner and warnings.
    - - 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.

- -

If you are new to reporting problems, you might be interested in - How to Report Bugs Effectively.

- -

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

-
-

11.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.

+

11.4. Reporting security problems

+

If you discovered a security problem or merely suspect that a bug + might be a security issue, please mail Fabian Keil + <fk@fabiankeil.de> (OpenPGP fingerprint: 4F36 C17F 3816 9136 54A1 + E850 6918 2291 8BA2 371C).

+

Usually you should get a response within a day, otherwise it's + likely that either your mail or the response didn't make it. If that + happens, please mail to the developer list to request a status + update.

-
-

11.4. +

11.5. 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 @@ -328,33 +264,40 @@ body { 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.

+ archives, at: https://lists.privoxy.org/mailman/listinfo. The lists + hosted on privoxy.org have been created in 2016, the previously-used + lists hosted at SourceForge are deprecated but the archives may still + be useful: https://sourceforge.net/mail/?group_id=11118.

+

+
+

11.6. + SourceForge support trackers

+

The SourceForge support trackers may be used as well, but + have various technical problems that are unlikely to be fixed anytime + soon. If you don't get a timely response, please try the mailing list + as well.

-