chiark / gitweb /
fix examples
[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 "800">
15
16 <!ENTITY number-of-arches "12">
17
18 <!-- standard information -->
19 <!ENTITY fsf-addr "Free Software Foundation,
20   Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA">
21 <!ENTITY file-GPL "<file>/usr/share/common-licenses/GPL</file>">
22 <!ENTITY debian-formal "Debian GNU/Linux">
23
24 <!--
25      URLs, Debian
26   -->
27 <!ENTITY www-debian-org "www.debian.org">
28 <!ENTITY ftp-debian-org "ftp.debian.org">
29 <!ENTITY ftp-host "&ftp-debian-org;">
30 <!ENTITY www-host "&www-debian-org;">
31 <!ENTITY lists-host "lists.debian.org">
32 <!ENTITY archive-host "archive.debian.org">
33 <!ENTITY keyserver-host "keyring.debian.org">
34 <!ENTITY packages-host "packages.debian.org">
35 <!ENTITY bugs-host "bugs.debian.org">
36 <!ENTITY pts-host "packages.qa.debian.org">
37 <!ENTITY ftp-master-host "ftp-master.debian.org">
38 <!ENTITY non-us-host "non-us.debian.org">
39 <!ENTITY upload-queue "<ftppath>/pub/UploadQueue/</ftppath>">
40
41 <!ENTITY url-debian-policy "http://&www-debian-org;/doc/debian-policy/">
42 <!ENTITY url-perl-policy "http://&www-debian-org;/doc/packaging-manuals/perl-policy/">
43 <!ENTITY url-emacs-policy "http://&www-debian-org;/doc/packaging-manuals/debian-emacs-policy">
44 <!ENTITY url-java-policy "http://&www-debian-org;/doc/packaging-manuals/java-policy/">
45 <!ENTITY url-libpkg-guide "http://www.netfort.gr.jp/~dancer/column/libpkg-guide/">
46
47 <!ENTITY url-social-contract "http://&www-debian-org;/social_contract">
48 <!ENTITY url-constitution "http://&www-debian-org;/devel/constitution">
49 <!ENTITY url-dfsg "&url-social-contract;#guidelines">
50 <!ENTITY url-debian-lists "http://&www-debian-org;/MailingLists/">
51 <!ENTITY url-debian-lists-txt "http://&ftp-debian-org;/debian/doc/mailing-lists.txt">
52 <!ENTITY url-debian-lists-subscribe "http://&www-debian-org;/MailingLists/subscribe">
53 <!ENTITY url-debian-lists-new "http://&www-debian-org;/MailingLists/HOWTO_start_list">
54 <!ENTITY url-lists-archives "http://&lists-host;/">
55 <!ENTITY url-bts "http://&www-debian-org;/Bugs/">
56 <!ENTITY url-bts-report "&url-bts;Reporting">
57 <!ENTITY url-bts-devel "&url-bts;Developer">
58 <!ENTITY url-bts-control "&url-bts;server-control">
59 <!ENTITY url-debian-mirrors "http://&www-debian-org;/mirror/">
60 <!ENTITY url-debian-mirroring "&url-debian-mirrors;">
61 <!ENTITY url-debian-ports "http://&www-debian-org;/ports/">
62 <!ENTITY url-debian-port-lists "http://&lists-host;/ports.html">
63 <!ENTITY url-wnpp "http://&www-debian-org;/devel/wnpp/">
64 <!ENTITY url-devel-docs "http://&www-debian-org;/devel/">
65 <!ENTITY url-vote "http://&www-debian-org;/vote/">
66 <!ENTITY url-cvsweb "http://cvs.debian.org/">
67 <!ENTITY url-devel-machines "http://db.debian.org/machines.cgi">
68 <!ENTITY url-buildd "http://buildd.debian.org/">
69 <!ENTITY url-lintian "http://lintian.debian.org/">
70 <!ENTITY url-debian-qa "http://qa.debian.org/">
71 <!ENTITY url-debian-db "https://db.debian.org/">
72 <!ENTITY url-debian-db-login "https://db.debian.org/login.html">
73 <!ENTITY url-debian-db-mail-gw "http://db.debian.org/doc-mail.html">
74 <!ENTITY url-debian-db-doc "http://db.debian.org/doc-general.html">
75 <!ENTITY url-newmaint "http://&www-debian-org;/devel/join/newmaint">
76 <!ENTITY url-newmaint-checklist "http://&www-debian-org;/devel/join/nm-checklist">
77 <!ENTITY url-newmaint-db "http://nm.debian.org/">
78 <!ENTITY url-newmaint-advocate "http://&www-debian-org;/devel/join/nm-advocate">
79 <!ENTITY url-newmaint-amchecklist "http://&www-debian-org;/devel/join/nm-amchecklist">
80 <!ENTITY url-newmaint-apply "http://nm.debian.org/newnm.php">
81 <!ENTITY url-newmaint-id "http://&www-debian-org;/devel/join/nm-step2">
82 <!ENTITY url-newmaint-guide "http://&www-debian-org;/doc/maint-guide/">
83 <!ENTITY url-gpg-coord "http://nm.debian.org/gpg.php">
84 <!ENTITY url-debian-security-advisories "http://&www-debian-org;/security/">
85 <!ENTITY url-tech-ctte "http://&www-debian-org;/devel/tech-ctte">
86 <!ENTITY url-ddpo "http://qa.debian.org/developer.php">
87
88 <!ENTITY url-debian-keyring "http://&ftp-debian-org;/debian/doc/debian-keyring.tar.gz">
89 <!ENTITY url-readme-non-us "http://&ftp-debian-org;/debian/README.non-US">
90 <!ENTITY url-incoming "http://incoming.debian.org/">
91 <!ENTITY url-testing-maint "http://www.debian.org/devel/testing">
92 <!-- deprecated -->
93 <!ENTITY url-testing-faq "&url-testing-maint;">
94
95 <!ENTITY us-upload-dir "<file>/org/ftp.debian.org/incoming/</file>">
96 <!ENTITY non-us-upload-dir "<file>/org/non-us.debian.org/incoming/</file>">
97 <!ENTITY url-chiark-readme "ftp://ftp.chiark.greenend.org.uk/pub/debian/private/project/README.how-to-upload">
98 <!ENTITY url-upload-erlangen "ftp://ftp.uni-erlangen.de/pub/Linux/debian/UploadQueue/">
99 <!ENTITY url-upload-samosa "ftp://samosa.debian.org/pub/UploadQueue/">
100 <!ENTITY url-upload-jp "ftp://master.debian.or.jp/pub/Incoming/upload/">
101
102 <!ENTITY url-mentors "http://people.debian.org/~mpalmer/debian-mentors_FAQ.html">
103 <!ENTITY url-sponsors "http://www.internatif.org/bortzmeyer/debian/sponsor/">
104
105 <!ENTITY url-rules-files "http://arch.debian.org/arch/private/srivasta/">
106
107 <!ENTITY url-debconf-l10n-help "http://&www-debian-org;/intl/l10n/templates/hints">
108
109 <!ENTITY url-dmup "http://&www-debian-org;/devel/dmup">
110 <!ENTITY url-worldmap "http://&www-debian-org;/devel/developers.loc">
111
112 <!ENTITY url-i18n-doc-check "http://cvs.debian.org/boot-floppies/documentation/doc-check?rev=HEAD&amp;content-type=text/vnd.viewcvs-markup">
113
114 <!ENTITY url-eg-desc-upstream-info "http://&packages-host;/unstable/text/docbook-dsssl.html">
115
116 <!ENTITY url-alioth "http://alioth.debian.org/">
117
118 <!-- 
119      URLs, non-debian
120   -->
121 <!ENTITY url-gnu-manifesto "http://www.gnu.org/gnu/manifesto.html">
122 <!ENTITY url-gpl "http://www.gnu.org/copyleft/gpl.html">
123 <!ENTITY url-pgp-faq "http://www.cam.ac.uk.pgp.net/pgpnet/pgp-faq/">
124 <!ENTITY url-rfc2440 "http://www.gnupg.org/rfc2440.html">
125 <!ENTITY url-u.s.-export "http://www.bxa.doc.gov/Encryption/PubAvailEncSourceCodeNofify.html">
126 <!ENTITY url-notification-of-export "http://www.bxa.doc.gov/Encryption/">
127 <!ENTITY url-openprojects "http://www.freenode.net/">
128
129 <!-- Debian email addresses -->
130 <!ENTITY email-listmaster "<email>listmaster@&lists-host;</email>">
131 <!ENTITY email-debian-announce "<email>debian-announce@&lists-host;</email>">
132 <!ENTITY email-devel-ref "<email>developers-reference@&packages-host;</email>">
133 <!ENTITY email-debian-changes "<email>debian-changes@lists.debian.org</email>">
134 <!ENTITY email-debian-devel "<email>debian-devel@&lists-host;</email>">
135 <!ENTITY email-debian-devel-announce "<email>debian-devel-announce@&lists-host;</email>">
136 <!ENTITY email-debian-devel-changes "<email>debian-devel-changes@lists.debian.org</email>">
137 <!ENTITY email-debian-devel-req "<email>debian-devel-REQUEST@&lists-host;</email>">
138 <!ENTITY email-debian-mentors "<email>debian-mentors@&lists-host;</email>">
139 <!ENTITY email-debian-private "<email>debian-private@&lists-host;</email>">
140 <!ENTITY email-debian-project "<email>debian-project@&lists-host;</email>">
141 <!ENTITY email-debian-policy "<email>debian-policy@&lists-host;</email>">
142 <!ENTITY email-debian-user "<email>debian-user@&lists-host;</email>">
143 <!ENTITY orphan-address "&lt;packages@qa.debian.org&gt;">
144 <!ENTITY email-debian-qa "<email>debian-qa@&lists-host;</email>">
145 <!ENTITY email-debian-release "<email>debian-release@&lists-host;</email>">
146 <!ENTITY email-debian-email "<email>debian-email@&lists-host;</email>">
147 <!ENTITY email-debian-vote "<email>debian-vote@&lists-host;</email>">
148 <!ENTITY email-debian-security-announce "<email>debian-security-announce@&lists-host;</email>">
149 <!ENTITY email-debian-l10n-english "<email>debian-l10n-english@&lists-host;</email>">
150
151 <!ENTITY email-new-maintainer "<email>new-maintainer@debian.org</email>">
152 <!ENTITY email-debian-keyring "<email>keyring-maint@debian.org</email>">
153 <!ENTITY email-debian-admin "<email>debian-admin@debian.org</email>">
154 <!ENTITY email-ftpmaster "<email>ftpmaster@debian.org</email>">
155 <!ENTITY email-override "<email>override-change@debian.org</email>">
156 <!ENTITY email-wnpp "<email>wnpp@debian.org</email>">
157 <!ENTITY email-bts-control "<email>control@&bugs-host;</email>">
158 <!ENTITY email-security-team "<email>team@security.debian.org</email>">
159
160 <!-- misc Debian info -->
161 <!ENTITY file-mail-lists "<file>/usr/share/doc/debian/mailing-lists.txt</file>">
162 <!ENTITY file-bts-docs "<file>/usr/share/doc/debian/bug-*</file>">
163 <!ENTITY file-python-policy "<file>/usr/share/doc/python/python-policy.txt.gz</file>">
164 <!ENTITY file-ocaml-policy "<file>/usr/share/doc/ocaml/ocaml_packaging_policy.gz</file>">
165 <!ENTITY file-lisp-controller "<file>/usr/share/doc/common-lisp-controller/README.packaging</file>">
166 <!ENTITY file-debian-private-archive "~debian/archive/debian-private/">
167 <!ENTITY file-bpp-autotools "<file>/usr/share/doc/autotools-dev/README.Debian.gz</file>">
168
169 <!ENTITY cron-bug-report '0 17 * * fri   echo "index maint <var>address</var>" | mail request@&bugs-host;'>
170
171 <!ENTITY control-file-fields "<list compact>
172               <item><tt>Format</tt>
173               <item><tt>Date</tt>
174               <item><tt>Source</tt>
175               <item><tt>Binary</tt>
176               <item><tt>Architecture</tt>
177               <item><tt>Version</tt>
178               <item><tt>Distribution</tt>
179               <item><tt>Urgency</tt>
180               <item><tt>Maintainer</tt>
181               <item><tt>Description</tt>
182               <item><tt>Changes</tt>
183               <item><tt>Files</tt>
184             </list>">
185
186 <!--
187      misc, non-debian
188   -->
189 <!ENTITY pgp-keyserv "<tt>pgp5.ai.mit.edu</tt>">
190 <!ENTITY file-keyservs "<file>/usr/share/doc/pgp/keyserv.doc</file>">
191
192 <!ENTITY sample-dist-dirtree "<example>
193 dists/stable/main/
194 dists/stable/main/binary-i386/
195 dists/stable/main/binary-m68k/
196 dists/stable/main/binary-alpha/
197      ...
198 dists/stable/main/source/
199      ...
200 dists/stable/main/disks-i386/
201 dists/stable/main/disks-m68k/
202 dists/stable/main/disks-alpha/
203      ...
204
205 dists/stable/contrib/
206 dists/stable/contrib/binary-i386/
207 dists/stable/contrib/binary-m68k/
208 dists/stable/contrib/binary-alpha/
209      ...
210 dists/stable/contrib/source/
211
212 dists/stable/non-free/
213 dists/stable/non-free/binary-i386/
214 dists/stable/non-free/binary-m68k/
215 dists/stable/non-free/binary-alpha/
216      ...
217 dists/stable/non-free/source/
218
219 dists/testing/
220 dists/testing/main/
221      ...
222 dists/testing/contrib/
223      ...
224 dists/testing/non-free/
225      ...
226
227 dists/unstable
228 dists/unstable/main/
229      ...
230 dists/unstable/contrib/
231      ...
232 dists/unstable/non-free/
233      ...
234
235 pool/
236 pool/main/a/
237 pool/main/a/apt/
238      ...
239 pool/main/b/
240 pool/main/b/bash/
241      ...
242 pool/main/liba/
243 pool/main/liba/libalias-perl/
244      ...
245 pool/main/m/
246 pool/main/m/mailx/
247      ...
248 pool/non-free/n/
249 pool/non-free/n/netscape/
250      ...
251 </example>">
252
253 <!ENTITY example-pathfind '<example>pathfind() {
254     OLDIFS="$IFS"
255     IFS=:
256     for p in $PATH; do
257         if [ -x "$p/$*" ]; then
258             IFS="$OLDIFS"
259             return 0
260         fi
261     done
262     IFS="$OLDIFS"
263     return 1
264 }</example>'>