Privoxy Developer Manual

By: Privoxy Developers

$Id: developer-manual.sgml,v 1.10 2002/03/24 12:33:01 swa Exp $

The developer manual gives the users information on how to help the developer team. It provides guidance on coding, testing, documentation and other issues. Privoxy is a web proxy with advanced filtering capabilities for protecting privacy, filtering web page content, managing cookies, controlling access, and removing ads, banners, pop-ups and other obnoxious Internet Junk. Privoxy has a very flexible configuration and can be customized to suit individual needs and tastes. Privoxy has application for both stand-alone systems and multi-user networks.

You can find the latest version of the user manual at http://ijbswa.sourceforge.net/developer-manual/. Please see the Contact section in the user-manual if you want to contact the developers.


Table of Contents
1. Introduction
2. Quickstart to Privoxy Development
3. Documentation Guidelines
4. Coding Guidelines
4.1. Introduction
4.2. Using Comments
4.2.1. Comment, Comment, Comment
4.2.2. Use blocks for comments
4.2.3. Keep Comments on their own line
4.2.4. Comment each logical step
4.2.5. Comment All Functions Thoroughly
4.2.6. Comment at the end of braces if the content is more than one screen length
4.3. Naming Conventions
4.3.1. Variable Names
4.3.2. Function Names
4.3.3. Header file prototypes
4.3.4. Enumerations, and #defines
4.3.5. Constants
4.4. Using Space
4.4.1. Put braces on a line by themselves.
4.4.2. ALL control statements should have a block
4.4.3. Do not belabor/blow-up boolean expressions
4.4.4. Use white space freely because it is free
4.4.5. Don't use white space around structure operators
4.4.6. Make the last brace of a function stand out
4.4.7. Use 3 character indentions
4.5. Initializing
4.5.1. Initialize all variables
4.6. Functions
4.6.1. Name functions that return a boolean as a question.
4.6.2. Always specify a return type for a function.
4.6.3. Minimize function calls when iterating by using variables
4.6.4. Pass and Return by Const Reference
4.6.5. Pass and Return by Value
4.6.6. Names of include files
4.6.7. Provide multiple inclusion protection
4.6.8. Use `extern "C"` when appropriate
4.6.9. Where Possible, Use Forward Struct Declaration Instead of Includes
4.7. General Coding Practices
4.7.1. Turn on warnings
4.7.2. Provide a default case for all switch statements
4.7.3. Try to avoid falling through cases in a switch statement.
4.7.4. Use 'long' or 'short' Instead of 'int'
4.7.5. Don't mix size_t and other types
4.7.6. Declare each variable and struct on its own line.
4.7.7. Use malloc/zalloc sparingly
4.7.8. The Programmer Who Uses 'malloc' is Responsible for Ensuring 'free'
4.7.9. Add loaders to the `file_list' structure and in order
4.7.10. "Uncertain" new code and/or changes to exitinst code, use FIXME
4.8. Addendum: Template for files and function comment blocks:
5. Version Control Guidelines
6. Testing Guidelines
6.1. Testplan for releases
6.2. Test reports
7. Contact the developers
8. Copyright and History
9. See also

1. Introduction

To be filled.