prepare 3.3.2

[developers-reference.git] / common.ent

<!-- common entities file

     Bits of text which are language independent.  In some cases it
     makes sense to break these out because repetitively maintaining
     them in different translations of the Developer's Reference is
     wasteful.  In other cases, the data is rather volatile and
     breaking it out make maintenance easier.
  -->

<!-- volatile information -->

<!entity number-of-pkgs "9000">
<!entity number-of-maintainers "800">

<!entity number-of-arches "12">

<!-- standard information -->
<!entity fsf-addr "Free Software Foundation,
  Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA">
<!entity file-GPL "<file>/usr/share/common-licenses/GPL</file>">
<!entity debian-formal "Debian GNU/Linux">

<!--
     URLs, Debian
  -->
<!entity www-debian-org "www.debian.org">
<!entity ftp-debian-org "ftp.debian.org">
<!entity ftp-host "&ftp-debian-org;">
<!entity www-host "&www-debian-org;">
<!entity lists-host "lists.debian.org">
<!entity archive-host "archive.debian.org">
<!entity keyserver-host "keyring.debian.org">
<!entity packages-host "packages.debian.org">
<!entity bugs-host "bugs.debian.org">
<!entity pts-host "packages.qa.debian.org">
<!entity ftp-master-host "ftp-master.debian.org">
<!entity non-us-host "non-us.debian.org">
<!entity upload-queue "<ftppath>/pub/UploadQueue/</ftppath>">

<!entity url-debian-policy "http://&www-debian-org;/doc/debian-policy/">
<!entity url-perl-policy "http://&www-debian-org;/doc/packaging-manuals/perl-policy/">
<!entity url-emacs-policy "http://&www-debian-org;/doc/packaging-manuals/debian-emacs-policy">
<!entity url-java-policy "http://&www-debian-org;/doc/packaging-manuals/java-policy/">
<!entity url-libpkg-guide "http://www.netfort.gr.jp/~dancer/column/libpkg-guide/">

<!entity url-social-contract "http://&www-debian-org;/social_contract">
<!entity url-constitution "http://&www-debian-org;/devel/constitution">
<!entity url-dfsg "&url-social-contract;#guidelines">
<!entity url-debian-lists "http://&www-debian-org;/MailingLists/">
<!entity url-debian-lists-txt "http://&ftp-debian-org;/debian/doc/mailing-lists.txt">
<!entity url-debian-lists-subscribe "http://&www-debian-org;/MailingLists/subscribe">
<!entity url-lists-archives "http://&lists-host;/">
<!entity url-bts "http://&www-debian-org;/Bugs/">
<!entity url-bts-report "&url-bts;Reporting">
<!entity url-bts-devel "&url-bts;Developer">
<!entity url-bts-control "&url-bts;server-control">
<!entity url-debian-mirrors "http://&www-debian-org;/mirror/">
<!entity url-debian-mirroring "&url-debian-mirrors;">
<!entity url-debian-ports "http://&www-debian-org;/ports/">
<!entity url-debian-port-lists "http://&lists-host;/ports.html">
<!entity url-wnpp "http://&www-debian-org;/devel/wnpp/">
<!entity url-devel-docs "http://&www-debian-org;/devel/">
<!entity url-vote "http://&www-debian-org;/vote/">
<!entity url-cvsweb "http://cvs.debian.org/">
<!entity url-devel-machines "http://db.debian.org/machines.cgi">
<!entity url-buildd "http://buildd.debian.org/">
<!entity url-lintian "http://lintian.debian.org/">
<!entity url-debian-qa "http://qa.debian.org/">
<!entity url-debian-db "https://db.debian.org/">
<!entity url-debian-db-login "https://db.debian.org/login.html">
<!entity url-debian-db-mail-gw "http://db.debian.org/doc-mail.html">
<!entity url-debian-db-doc "http://db.debian.org/doc-general.html">
<!entity url-newmaint "http://&www-debian-org;/devel/join/newmaint">
<!entity url-newmaint-checklist "http://&www-debian-org;/devel/join/nm-checklist">
<!entity url-newmaint-db "http://nm.debian.org/">
<!entity url-newmaint-advocate "http://&www-debian-org;/devel/join/nm-advocate">
<!entity url-newmaint-amchecklist "http://&www-debian-org;/devel/join/nm-amchecklist">
<!entity url-newmaint-apply "http://nm.debian.org/newnm.php">
<!entity url-newmaint-id "http://&www-debian-org;/devel/join/nm-step2">
<!entity url-newmaint-guide "http://&www-debian-org;/doc/maint-guide/">
<!entity url-gpg-coord "http://nm.debian.org/gpg.php">
<!entity url-debian-security-advisories "http://&www-debian-org;/security/">
<!entity url-tech-ctte "http://&www-debian-org;/devel/tech-ctte">
<!entity url-ddpo "http://qa.debian.org/developer.php">

<!entity url-debian-keyring "http://&ftp-debian-org;/debian/doc/debian-keyring.tar.gz">
<!entity url-readme-non-us "http://&ftp-debian-org;/debian/README.non-US">
<!entity url-incoming "http://incoming.debian.org/">
<!entity url-testing-maint "http://www.debian.org/devel/testing">
<!-- deprecated -->
<!entity url-testing-faq "&url-testing-maint;">

<!entity us-upload-dir "<file>/org/ftp.debian.org/incoming/</file>">
<!entity non-us-upload-dir "<file>/org/non-us.debian.org/incoming/</file>">
<!entity url-chiark-readme "ftp://ftp.chiark.greenend.org.uk/pub/debian/private/project/README.how-to-upload">
<!entity url-upload-erlangen "ftp://ftp.uni-erlangen.de/pub/Linux/debian/UploadQueue/">
<!entity url-upload-samosa "ftp://samosa.debian.org/pub/UploadQueue/">
<!entity url-upload-jp "ftp://master.debian.or.jp/pub/Incoming/upload/">

<!entity url-sponsors "http://www.internatif.org/bortzmeyer/debian/sponsor/">

<!entity url-rules-files "http://people.debian.org/~srivasta/rules/">

<!entity url-debconf-l10n-help "http://&www-debian-org;/intl/l10n/templates/hints">

<!entity url-dmup "http://&www-debian-org;/devel/dmup">
<!entity url-worldmap "http://&www-debian-org;/devel/developers.loc">

<!entity url-i18n-doc-check CDATA "http://cvs.debian.org/boot-floppies/documentation/doc-check?rev=HEAD&content-type=text/vnd.viewcvs-markup">

<!entity url-eg-desc-upstream-info "http://&packages-host;/unstable/text/docbook-dsssl.html">

<!-- 
     URLs, non-debian
  -->
<!entity url-gnu-manifesto "http://www.gnu.org/gnu/manifesto.html">
<!entity url-gpl "http://www.gnu.org/copyleft/gpl.html">
<!entity url-pgp-faq "http://www.cam.ac.uk.pgp.net/pgpnet/pgp-faq/">
<!entity url-rfc2440 "http://www.gnupg.org/rfc2440.html">
<!entity url-u.s.-export "http://www.bxa.doc.gov/Encryption/PubAvailEncSourceCodeNofify.html">
<!entity url-notification-of-export "http://www.bxa.doc.gov/Encryption/">
<!entity url-openprojects "http://www.freenode.net/">

<!-- Debian email addresses -->
<!entity email-listmaster "<email>listmaster@&lists-host;</email>">
<!entity email-debian-announce "<email>debian-announce@&lists-host;</email>">
<!entity email-devel-ref "<email>developers-reference@&packages-host;</email>">
<!entity email-debian-changes "<email>debian-changes@lists.debian.org</email>">
<!entity email-debian-devel "<email>debian-devel@&lists-host;</email>">
<!entity email-debian-devel-announce "<email>debian-devel-announce@&lists-host;</email>">
<!entity email-debian-devel-changes "<email>debian-devel-changes@lists.debian.org</email>">
<!entity email-debian-devel-req "<email>debian-devel-REQUEST@&lists-host;</email>">
<!entity email-debian-mentors "<email>debian-mentors@&lists-host;</email>">
<!entity email-debian-private "<email>debian-private@&lists-host;</email>">
<!entity email-debian-project "<email>debian-project@&lists-host;</email>">
<!entity email-debian-policy "<email>debian-policy@&lists-host;</email>">
<!entity email-debian-user "<email>debian-user@&lists-host;</email>">
<!entity orphan-address "&lt;packages@qa.debian.org&gt;">
<!entity email-debian-qa "<email>debian-qa@&lists-host;</email>">
<!entity email-debian-release "<email>debian-release@&lists-host;</email>">
<!entity email-debian-email "<email>debian-email@&lists-host;</email>">
<!entity email-debian-vote "<email>debian-vote@&lists-host;</email>">
<!entity email-debian-security-announce "<email>debian-security-announce@&lists-host;</email>">
<!entity email-debian-l10n-english "<email>debian-l10n-english@&lists-host;</email>">

<!entity email-new-maintainer "<email>new-maintainer@debian.org</email>">
<!entity email-debian-keyring "<email>keyring-maint@debian.org</email>">
<!entity email-debian-admin "<email>debian-admin@debian.org</email>">
<!entity email-ftpmaster "<email>ftpmaster@debian.org</email>">
<!entity email-override "<email>override-change@debian.org</email>">
<!entity email-wnpp "<email>wnpp@debian.org</email>">
<!entity email-bts-control "<email>control@&bugs-host;</email>">
<!entity email-security-team "<email>team@security.debian.org</email>">

<!-- misc Debian info -->
<!entity file-mail-lists "<file>/usr/share/doc/debian/mailing-lists.txt</file>">
<!entity file-bts-docs "<file>/usr/share/doc/debian/bug-*</file>">
<!entity file-python-policy "<file>/usr/share/doc/python/python-policy.txt.gz</file>">
<!entity file-ocaml-policy "<file>/usr/share/doc/ocaml/ocaml_packaging_policy.gz</file>">
<!entity file-lisp-controller "<file>/usr/share/doc/common-lisp-controller/README.packaging</file>">
<!entity file-debian-private-archive "~debian/archive/debian-private/">
<!entity file-bpp-autotools "<file>/usr/share/doc/autotools-dev/README.Debian.gz</file>">

<!entity cron-bug-report '0 17 * * fri   echo "index maint <var>address</var>" | mail request@&bugs-host;'>

<!entity control-file-fields "<list compact>
              <item><tt>Format</tt>
              <item><tt>Date</tt>
              <item><tt>Source</tt>
              <item><tt>Binary</tt>
              <item><tt>Architecture</tt>
              <item><tt>Version</tt>
              <item><tt>Distribution</tt>
              <item><tt>Urgency</tt>
              <item><tt>Maintainer</tt>
              <item><tt>Description</tt>
              <item><tt>Changes</tt>
              <item><tt>Files</tt>
            </list>">

<!--
     misc, non-debian
  -->
<!entity pgp-keyserv "<tt>pgp5.ai.mit.edu</tt>">
<!entity file-keyservs "<file>/usr/share/doc/pgp/keyserv.doc</file>">

<!entity sample-dist-dirtree "<example>
dists/stable/main/
dists/stable/main/binary-i386/
dists/stable/main/binary-m68k/
dists/stable/main/binary-alpha/
     ...
dists/stable/main/source/
     ...
dists/stable/main/disks-i386/
dists/stable/main/disks-m68k/
dists/stable/main/disks-alpha/
     ...

dists/stable/contrib/
dists/stable/contrib/binary-i386/
dists/stable/contrib/binary-m68k/
dists/stable/contrib/binary-alpha/
     ...
dists/stable/contrib/source/

dists/stable/non-free/
dists/stable/non-free/binary-i386/
dists/stable/non-free/binary-m68k/
dists/stable/non-free/binary-alpha/
     ...
dists/stable/non-free/source/

dists/testing/
dists/testing/main/
     ...
dists/testing/contrib/
     ...
dists/testing/non-free/
     ...

dists/unstable
dists/unstable/main/
     ...
dists/unstable/contrib/
     ...
dists/unstable/non-free/
     ...

pool/
pool/main/a/
pool/main/a/apt/
     ...
pool/main/b/
pool/main/b/bash/
     ...
pool/main/liba/
pool/main/liba/libalias-perl/
     ...
pool/main/m/
pool/main/m/mailx/
     ...
pool/non-free/n/
pool/non-free/n/netscape/
     ...
</example>">

<!entity example-pathfind '<example>pathfind() {
    OLDIFS="$IFS"
    IFS=:
    for p in $PATH; do
        if [ -x "$p/$*" ]; then
            IFS="$OLDIFS"
            return 0
        fi
    done
    IFS="$OLDIFS"
    return 1
}</example>'>