/usr/share/doc/developers-reference/README-contrib is in developers-reference 3.4.11.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 | * 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
<developers-reference@packages.debian.org>.
* 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 <http://bugs.debian.org/278267>)
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.
* Writing style
Please use gender-neutral formulations. This means avoiding
pronouns like he/she when referring to a role (like "maintainer")
whose gender is unknown. Instead of you should use the
plural form (singular they [1]).
[1] http://en.wikipedia.org/wiki/Singular_they
* 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
<http://www.debian.org/doc/cvs>.
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/po/, we hope very much for more
translations.
|