X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fdeveloper-manual%2Fdocumentation.html;h=86a725ac493d906b18e87b1b73c5b30982059d04;hp=8bee4e34789334edf1d0f999fc68acfc60119f0a;hb=46471693916537291afcf7eadd40e6b93277bfaa;hpb=ef2fe2beb361222adde485877b5f72d04709b5a4 diff --git a/doc/webserver/developer-manual/documentation.html b/doc/webserver/developer-manual/documentation.html index 8bee4e34..86a725ac 100644 --- a/doc/webserver/developer-manual/documentation.html +++ b/doc/webserver/developer-manual/documentation.html @@ -27,7 +27,7 @@

3. Documentation Guidelines

All formal documents are maintained in Docbook SGML and located in the doc/source/* directory. You will need doc/source/* directory. You will need Docbook, the Docbook DTD's and the Docbook modular stylesheets (or comparable alternatives), and either jade or openjade (recommended) installed in order to build docs from source. Currently there is config requires some special handling. The reason it is maintained this way is so that the extensive comments in the file mirror those in user-manual. But the conversion process requires going from SGML to HTML to text to special formatting required for the embedded comments. Some of this - does not survive so well. Especially some of the examples that are longer than 80 characters. The build process for - this file outputs to config.new, which should be reviewed for errors and mis-formatting. - Once satisfied that it is correct, then it should be hand copied to config.

+ does not survive so well. Especially some of the examples that are longer than 80 characters.

Other, less formal documents (e.g. LICENSE) are maintained as plain text files in the top-level source directory.

Packagers are encouraged to include this documentation. For those without the ability to build the docs locally, @@ -63,7 +61,7 @@

  • Run make webserver which copies all files from doc/webserver to the sourceforge webserver via scp.

    + "COMPUTEROUTPUT">doc/webserver to the sourceforge webserver via ssh.

  • Finished docs should be occasionally submitted to Git (doc/webserver/*/*.html) so that @@ -209,7 +207,7 @@

    -

    3.3. Privoxy Custom Entities

    +

    3.3. Privoxy Custom Entities

    Privoxy documentation is using a number of customized "entities" to facilitate documentation maintenance.

    We are using a set of "boilerplate" files with generic text, that is used by