* Useful Makefile targets The following 'make' targets exist for your convenience: make validate validate the well-formedness of all XML materials make or make all (optional: VERSION=x.y.z PUBDATE=2007-07-01) build all languages in all formats make index.html build the English manual in HTML format make fr/developers-reference.pdf build the French manual in PDF format make ja/developers-reference.txt build the Japanese manual in text format make pot generate .pot files from .dbk sources make updatepo LINGUA=xx (with xx=language code) update .po files for language xx * Contacting To contain the maintainers of this package, email . * Contributing If you want to contribute to the Developer's Reference, it's best to first submit a few patches as bug reports. Writing patches for existing bugs are also always appreciated. You may wish to make patches against the SVN sources, about which see below. When making changes, please try to use short lines of text (< 64 characters). This makes it easier to use 'diff' to see the differences. (See discussion in ) Do not commit patches to the developers reference yourself unless authorized to do so. Patches need to be finalized and common opinion before they are applied. This is even true if you happen to have SVN access for other reasons. * SVN If you're interested in ongoing maintenance, once you've shown that you've mastered the style of the manual with a couple accepted patches, you can be given SVN access. If you already have access to the SVN server for other reasons, do not use it unless authorized to do so. This manual is a part of the Debian Documentation Project (DDP). Information about SVN access for DDP can be found at . If you just want to check out the current SVN version of this manual to create patches against, you can use the following command to do so: svn co svn://svn.debian.org/ddp/manuals/trunk/developers-reference * Translators We have tried to keep language-independant bits of text in common.ent. Feel free to truck stuff out of the English manual into common.ent if it's useful, or else report the problem. The translation .po files are in po4a/fr/ and po4a/ja/ for French and Japanese. We hope very much for more translations.