X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=blobdiff_plain;f=README-contrib;h=bd72459b4524bee259c7714720a5ac107d146120;hp=226b5a9c5a2235712993b9564638a3cc514b82b0;hb=ba2bcb2e74a7d5c03fc8e49c70016ac802ef822a;hpb=770042b07cc441a9a737efd52258c0845423f391 diff --git a/README-contrib b/README-contrib index 226b5a9..bd72459 100644 --- a/README-contrib +++ b/README-contrib @@ -3,16 +3,25 @@ The following 'make' targets exist for your convenience: make validate - validate the well-formedness of all SGML materials + validate the well-formedness of all XML materials - make all + make or make all (optional: VERSION=x.y.z PUBDATE=2007-07-01) build all languages in all formats - make developers-reference.sgml.validate - validate the well-formedness of the English manual + make index.html + build the English manual in HTML format - make developers-reference.html - build the English manual + 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 @@ -26,25 +35,35 @@ To contain the maintainers of this package, email 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 CVS sources, about which see below. +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 -cvs access for other reasons. +SVN access for other reasons. -* CVS +* 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 CVS pserver access. If you have already -access to the CVS server for other reasons, do not use it unless +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. -Instructions on how to get the CVS version of this software, including -how to get CVS access, can be found at -. +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 @@ -53,19 +72,5 @@ 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. -You should exploit CVS to see the diffs between when the document was -last translated and the latest version. Be sure to set the cvs-en-rev -entity as appropriate when you do update a translation. - -We have provided commands to help with this. To see the difference in -numbers between the latest translated version and the latest version, -do, for instance: - - ./translation-status fr - -To get the diff between the latest translated version and the latest -version: - - ./translation-status -d fr - - +The translation .po files are in po4a/fr/ and po4a/ja/ for French and +Japanese. We hope very much for more translations.