chiark / gitweb /
added a note in the w-b sect about release team's w-b doc. Fixes 516375.
[developers-reference.git] / common.ent
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!-- common entities file
3
4      Bits of text which are language independent.  In some cases it
5      makes sense to break these out because repetitively maintaining
6      them in different translations of the Developer's Reference is
7      wasteful.  In other cases, the data is rather volatile and
8      breaking it out make maintenance easier.
9   -->
10
11 <!-- volatile information -->
12
13 <!ENTITY number-of-pkgs "9000">
14 <!ENTITY number-of-maintainers "900">
15
16 <!ENTITY number-of-arches "12">
17
18 <!-- standard information -->
19 <!ENTITY fsf-addr "Free Software Foundation, Inc.,
20   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA">
21 <!ENTITY file-GPL "<filename>/usr/share/common-licenses/GPL</filename>">
22 <!ENTITY debian-formal "Debian GNU/Linux">
23
24 <!--
25      URLs, Debian
26   -->
27 <!ENTITY master-host "master.debian.org">
28 <!ENTITY www-debian-org "www.debian.org">
29 <!ENTITY ftp-debian-org "ftp.debian.org">
30 <!ENTITY lists-host "lists.debian.org">
31 <!ENTITY archive-host "archive.debian.org">
32 <!ENTITY keyserver-host "keyring.debian.org">
33 <!ENTITY packages-host "packages.debian.org">
34 <!ENTITY bugs-host "bugs.debian.org">
35 <!ENTITY pts-host "packages.qa.debian.org">
36 <!ENTITY ftp-master-host "ftp-master.debian.org">
37 <!ENTITY ftp-master-mirror "merkel.debian.org">
38 <!ENTITY upload-queue "/pub/UploadQueue/">
39
40 <!ENTITY url-debian-policy "http://&www-debian-org;/doc/debian-policy/">
41 <!ENTITY url-perl-policy "http://&www-debian-org;/doc/packaging-manuals/perl-policy/">
42 <!ENTITY url-emacs-policy "http://&www-debian-org;/doc/packaging-manuals/debian-emacs-policy">
43 <!ENTITY url-java-policy "http://&www-debian-org;/doc/packaging-manuals/java-policy/">
44 <!ENTITY url-libpkg-guide "http://www.netfort.gr.jp/~dancer/column/libpkg-guide/">
45
46 <!ENTITY url-social-contract "http://&www-debian-org;/social_contract">
47 <!ENTITY url-constitution "http://&www-debian-org;/devel/constitution">
48 <!ENTITY url-dfsg "&url-social-contract;#guidelines">
49 <!ENTITY url-debian-lists "http://&www-debian-org;/MailingLists/">
50 <!ENTITY url-debian-lists-new "&url-debian-lists;HOWTO_start_list">
51 <!ENTITY url-bts "http://&www-debian-org;/Bugs/">
52 <!ENTITY url-bts-report "&url-bts;Reporting">
53 <!ENTITY url-bts-devel "&url-bts;Developer">
54 <!ENTITY url-bts-control "&url-bts;server-control">
55 <!ENTITY url-debian-mirrors "http://&www-debian-org;/mirror/">
56 <!ENTITY url-debian-ports "http://&www-debian-org;/ports/">
57 <!ENTITY url-debian-port-lists "http://&lists-host;/ports.html">
58 <!ENTITY url-wnpp "http://&www-debian-org;/devel/wnpp/">
59 <!ENTITY url-devel-docs "http://&www-debian-org;/devel/">
60 <!ENTITY url-vote "http://&www-debian-org;/vote/">
61 <!ENTITY url-cvsweb "http://cvs.debian.org/">
62 <!ENTITY url-devel-machines "http://db.debian.org/machines.cgi">
63 <!ENTITY url-buildd "http://buildd.debian.org/">
64 <!ENTITY url-release-wb "http://release.debian.org/wanna-build.txt">
65 <!ENTITY url-lintian "http://lintian.debian.org/">
66 <!ENTITY url-debian-qa "http://qa.debian.org/">
67 <!ENTITY url-debian-qa-orphaned "&url-debian-qa;orphaned.html">
68 <!ENTITY url-debian-db "https://db.debian.org/">
69 <!ENTITY url-debian-db-login "&url-debian-db;login.html">
70 <!ENTITY url-debian-db-mail-gw "http://db.debian.org/doc-mail.html">
71 <!ENTITY url-debian-db-doc "http://db.debian.org/doc-general.html">
72 <!ENTITY url-newmaint "&url-devel-docs;join/newmaint">
73 <!ENTITY url-newmaint-db "http://nm.debian.org/">
74 <!ENTITY url-newmaint-advocate "&url-devel-docs;join/nm-advocate">
75 <!ENTITY url-newmaint-amchecklist "&url-devel-docs;join/nm-amchecklist">
76 <!ENTITY url-newmaint-apply "http://nm.debian.org/newnm.php">
77 <!ENTITY url-newmaint-id "http://&www-debian-org;/devel/join/nm-step2">
78 <!ENTITY url-newmaint-guide "http://&www-debian-org;/doc/maint-guide/">
79 <!ENTITY url-gpg-coord "http://nm.debian.org/gpg.php">
80 <!ENTITY url-debian-security-advisories "http://&www-debian-org;/security/">
81 <!ENTITY url-tech-ctte "http://&www-debian-org;/devel/tech-ctte">
82 <!ENTITY url-ddpo "http://qa.debian.org/developer.php">
83 <!ENTITY url-dcg "http://people.debian.org/~enrico/dcg/">
84 <!ENTITY url-rt "https://rt.debian.org/">
85 <!ENTITY url-wiki-dm "http://wiki.debian.org/Maintainers">
86
87 <!ENTITY url-incoming "http://incoming.debian.org/">
88 <!ENTITY url-testing-maint "http://www.debian.org/devel/testing">
89 <!ENTITY url-low-threshold-nmu "http://wiki.debian.org/LowThresholdNmu">
90 <!ENTITY url-orphaned-not-qa "http://qa.debian.org/orphaned.html">
91
92 <!-- deprecated -->
93
94 <!ENTITY url-mentors "http://people.debian.org/~mpalmer/debian-mentors_FAQ.html">
95
96 <!ENTITY url-rules-files "http://arch.debian.org/arch/private/srivasta/">
97
98 <!ENTITY url-dmup "http://&www-debian-org;/devel/dmup">
99 <!ENTITY url-worldmap "http://&www-debian-org;/devel/developers.loc">
100
101 <!ENTITY url-i18n-doc-check "http://cvs.debian.org/boot-floppies/documentation/doc-check?rev=HEAD&amp;content-type=text/vnd.viewcvs-markup">
102
103 <!ENTITY url-eg-desc-upstream-info "http://&packages-host;/unstable/web/wml">
104
105 <!ENTITY url-alioth "http://alioth.debian.org/">
106 <!ENTITY url-alioth-pkg "http://wiki.debian.org/Alioth/PackagingProject">
107 <!ENTITY url-alioth-wiki "http://wiki.debian.org/Alioth">
108 <!ENTITY url-alioth-faq "http://wiki.debian.org/Alioth/FAQ">
109
110 <!-- 
111      URLs, non-debian
112   -->
113 <!ENTITY url-gnu-manifesto "http://www.gnu.org/gnu/manifesto.html">
114 <!ENTITY url-gpl "http://www.gnu.org/copyleft/gpl.html">
115 <!ENTITY url-pgp-faq "http://www.cam.ac.uk.pgp.net/pgpnet/pgp-faq/">
116 <!ENTITY url-rfc2440 "http://www.rfc-editor.org/rfc/rfc2440.txt">
117 <!ENTITY url-openprojects "http://www.freenode.net/">
118 <!ENTITY url-oftc "http://www.oftc.net/oftc/">
119
120 <!-- Debian email addresses -->
121 <!ENTITY email-listmaster "<email>listmaster@&lists-host;</email>">
122 <!ENTITY email-devel-ref "<email>developers-reference@&packages-host;</email>">
123 <!ENTITY email-debian-changes "<email>debian-changes@lists.debian.org</email>">
124 <!ENTITY email-debian-devel "<email>debian-devel@&lists-host;</email>">
125 <!ENTITY email-debian-devel-announce "<email>debian-devel-announce@&lists-host;</email>">
126 <!ENTITY email-debian-devel-changes "<email>debian-devel-changes@lists.debian.org</email>">
127 <!ENTITY email-debian-devel-req "<email>debian-devel-REQUEST@&lists-host;</email>">
128 <!ENTITY email-debian-i18n "<email>debian-i18n@&lists-host;</email>">
129 <!ENTITY email-debian-mentors "<email>debian-mentors@&lists-host;</email>">
130 <!ENTITY email-debian-private "<email>debian-private@&lists-host;</email>">
131 <!ENTITY email-debian-project "<email>debian-project@&lists-host;</email>">
132 <!ENTITY email-debian-policy "<email>debian-policy@&lists-host;</email>">
133 <!ENTITY orphan-address "&lt;packages@qa.debian.org&gt;">
134 <!ENTITY email-debian-qa "<email>debian-qa@&lists-host;</email>">
135 <!ENTITY email-debian-release "<email>debian-release@&lists-host;</email>">
136 <!ENTITY email-debian-email "<email>debian-email@&lists-host;</email>">
137 <!ENTITY email-debian-vote "<email>debian-vote@&lists-host;</email>">
138 <!ENTITY email-debian-security-announce "<email>debian-security-announce@&lists-host;</email>">
139 <!ENTITY email-debian-l10n-english "<email>debian-l10n-english@&lists-host;</email>">
140 <!ENTITY email-mia "<email>mia@qa.debian.org</email>">
141
142 <!ENTITY email-rt-dsa "<email>admin@rt.debian.org</email>">
143 <!ENTITY email-ftpmaster "<email>ftpmaster@debian.org</email>">
144 <!ENTITY email-override "<email>override-change@debian.org</email>">
145 <!ENTITY email-bts-control "<email>control@&bugs-host;</email>">
146 <!ENTITY email-security-team "<email>team@security.debian.org</email>">
147
148 <!-- misc Debian info -->
149 <!ENTITY file-bts-docs "<filename>/usr/share/doc/debian/bug-*</filename>">
150 <!ENTITY file-python-policy "<filename>/usr/share/doc/python/python-policy.txt.gz</filename>">
151 <!ENTITY file-ocaml-policy "<filename>/usr/share/doc/ocaml/ocaml_packaging_policy.gz</filename>">
152 <!ENTITY file-lisp-controller "<filename>/usr/share/doc/common-lisp-controller/README.packaging</filename>">
153 <!ENTITY file-debian-private-archive "~debian/archive/debian-private/">
154 <!ENTITY file-bpp-autotools "<filename>/usr/share/doc/autotools-dev/README.Debian.gz</filename>">
155
156 <!ENTITY cron-bug-report '0 17 * * fri   echo "index maint <replaceable>address</replaceable>" | mail request@&bugs-host;'>
157
158 <!--
159      misc, non-debian
160   -->
161 <!ENTITY pgp-keyserv "<literal>subkeys.pgp.net</literal>">
162
163 <!ENTITY sample-dist-dirtree "<screen>dists/stable/main/
164 dists/stable/main/binary-i386/
165 dists/stable/main/binary-m68k/
166 dists/stable/main/binary-alpha/
167      ...
168 dists/stable/main/source/
169      ...
170 dists/stable/main/disks-i386/
171 dists/stable/main/disks-m68k/
172 dists/stable/main/disks-alpha/
173      ...
174
175 dists/stable/contrib/
176 dists/stable/contrib/binary-i386/
177 dists/stable/contrib/binary-m68k/
178 dists/stable/contrib/binary-alpha/
179      ...
180 dists/stable/contrib/source/
181
182 dists/stable/non-free/
183 dists/stable/non-free/binary-i386/
184 dists/stable/non-free/binary-m68k/
185 dists/stable/non-free/binary-alpha/
186      ...
187 dists/stable/non-free/source/
188
189 dists/testing/
190 dists/testing/main/
191      ...
192 dists/testing/contrib/
193      ...
194 dists/testing/non-free/
195      ...
196
197 dists/unstable
198 dists/unstable/main/
199      ...
200 dists/unstable/contrib/
201      ...
202 dists/unstable/non-free/
203      ...
204
205 pool/
206 pool/main/a/
207 pool/main/a/apt/
208      ...
209 pool/main/b/
210 pool/main/b/bash/
211      ...
212 pool/main/liba/
213 pool/main/liba/libalias-perl/
214      ...
215 pool/main/m/
216 pool/main/m/mailx/
217      ...
218 pool/non-free/n/
219 pool/non-free/n/netscape/
220      ...</screen>">
221
222 <!ENTITY example-uu "<programlisting>uuencode-file:
223     perl -ne 'print(pack &quot;u&quot;, $$_);' $(file) &gt; $(file).uuencoded
224
225 uudecode-file:
226     perl -ne 'print(unpack &quot;u&quot;, $$_);' $(file).uuencoded &gt; $(file)</programlisting>">
227
228 <!ENTITY example-pathfind '<programlisting>pathfind() {
229     OLDIFS="$IFS"
230     IFS=:
231     for p in $PATH; do
232         if [ -x "$p/$*" ]; then
233             IFS="$OLDIFS"
234             return 0
235         fi
236     done
237     IFS="$OLDIFS"
238     return 1
239 }</programlisting>'>