<!-- include version information so we don't have to hard code it
within the document -->
<!entity % versiondata SYSTEM "version.ent"> %versiondata;
- <!entity number-of-pkgs "2250">
- <!entity number-of-maintainers "400">
+ <!-- common, language independant entities -->
+ <!entity % commondata SYSTEM "common.ent" > %commondata;
+ <!-- CVS revision of this document -->
+ <!entity cvs-rev "$Revision: 1.34 $">
+
+ <!-- if you are translating this document, please notate the RCS
+ revision of the developers reference here -->
+ <!--
+ <!entity cvs-en-rev "X.YY">
+ -->
]>
<debiandoc>
<!--
<file>/usr/doc/copyright/GPL</file> in the Debian GNU/Linux
distribution or on the World Wide Web at <url
id="http://www.gnu.org/copyleft/gpl.html" name="the GNU website">.
-You can also obtain it by writing to the Free Software Foundation,
-Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+You can also obtain it by writing to the &fsf-addr;.
<toc detail="sect2">
<p>
It should be clear that this reference does not discuss the technical
details of the Debian package nor how to generate Debian packages;
-that information is discussed in the <url
-id="http://www.debian.org/doc/packaging-manuals/packaging.html/"
+that information is discussed in the <url id="&url-pkg-manual;"
name="Debian Packaging Manual">. Nor does this reference detail the
standards to which Debian software must comply; that information can
-be found in the <url id="http://www.debian.org/doc/debian-policy/"
-name="Debian Policy Manual">.
+be found in the <url id="&url-debian-policy;" name="Debian Policy
+Manual">.
<p>
Furthermore, this document is <em>not an expression of formal
policy</em>. It contains documentation for the Debian system, and
<sect id="registering">Registering as a Debian developer
<p>
Before you decide to register with the Debian Project, you will need
-to read the <url id="http://www.debian.org/social_contract"
-name="Debian Social Contract">. Registering as a developer means that
-you agree with and pledge to uphold the Debian Social Contract; it is
-very important that maintainers are in accord with the essential ideas
-behind Debian GNU/Linux. Reading the <url
-id="http://www.gnu.org/gnu/manifesto.html" name="GNU Manifesto"> would
-also be a good idea.
+to read the <url id="&url-social-contract;" name="Debian Social
+Contract">. Registering as a developer means that you agree with and
+pledge to uphold the Debian Social Contract; it is very important that
+maintainers are in accord with the essential ideas behind Debian
+GNU/Linux. Reading the <url id="&url-gnu-manifesto;" name="GNU
+Manifesto"> would also be a good idea.
<p>
The process of registering as a developer is a process of verifying
your identity and intentions. As the number of people working on
<var>your_userid</var></tt>.
<p>
If your PGP key isn't on public key servers such as
-<tt>pgp5.ai.mit.edu</tt>, please read the documentation available
+&pgp-keyserv;, please read the documentation available
locally <tt>/usr/doc/pgp/keyserv.doc</tt>. That document contains
instructions on how to put your key on the public key servers. The
New Maintainer Group will put your public key on the servers if it
<tt>subscribe</tt> in the <em>Subject</em> to subscribe to the list or
<tt>unsubscribe</tt> to unsubscribe. More detailed instructions on
how to subscribe and unsubscribe to the mailing lists can be found at
-<url id="http://www.debian.org/MailingLists/subscribe">, <url
-id="ftp://ftp.debian.org/debian/doc/mailing-lists.txt"> or locally in
-<file>/usr/doc/debian/mailing-lists.txt</file> if you have the
-<package>doc-debian</package> package installed.
+<url id="&url-debian-lists-subscribe;">, <url id="&url-debian-lists;">
+or locally in <file>/usr/doc/debian/mailing-lists.txt</file> if you
+have the <package>doc-debian</package> package installed.
<p>
When replying to messages on the mailing list, please do not send a
carbon copy (<tt>CC</tt>) to the original poster unless they explicitly
<email>debian-announce@lists.debian.org</email>, or
<email>debian-devel-announce@lists.debian.org</email>. Additional
mailing lists are available for special purposes; see <url
-id="http://www.debian.org/MailingLists/subscribe">. Cross-posting
+id="&url-debian-lists-subscribe;">. Cross-posting
(sending the same message to multiple lists) is discouraged.
<p>
<email>debian-private@lists.debian.org</email> is a special mailing
posting messages.
<p>
Online archives of mailing lists are available at <url
-id="http://www.debian.org/Lists-Archives/">.
+id="&url-debian-list-archives;">.
<sect id="server-machines">Debian servers
<p>
If you have a problem with the operation of Debian server, and you
think that the system operators need to be notified of this problem,
please find the contact address for the particular role at <url
-id="http://www.debian.org/devel/maintainer_contacts">. If you have a
-non-operating problems (such as packages to be remove, suggestions for
-the web site, etc.), generally you'll report a bug against a
-``pseudo-package''. See <ref id="submit-bug"> for information on how
-to submit bugs.
+id="&url-debian-contacts;">. If you have a non-operating problems
+(such as packages to be remove, suggestions for the web site, etc.),
+generally you'll report a bug against a ``pseudo-package''. See <ref
+id="submit-bug"> for information on how to submit bugs.
<sect1 id="servers-master">The master server
<p>
submit a bug against the pseudo-package,
<package>www.debian.org</package>. First check whether or not someone
else has already reported the problem on the <url
-id="http://www.debian.org/Bugs/db/pa/lwww.debian.org.html" name="Bug
-Tracking System">.
+id="&url-bts;db/pa/lwww.debian.org.html" name="Bug Tracking System">.
<sect1 id="servers-cvs">The CVS server
<p>
The main web page listing the available public FTP (and, usually,
HTTP) servers can be found at <url
-id="http://www.debian.org/distrib/ftplist">. More information
+id="&url-debian-mirrors">. More information
concerning Debian mirrors can be found at <url
-id="http://www.debian.org/mirror">. This useful page includes
+id="&url-debian-mirroring">. This useful page includes
information and tools which can be helpful if you are interested in
setting up your own mirror, either for internal or public access.
<p>
<p>
Here is an example directory tree of a complete Debian distribution:
<p>
-<example>
-main/
-main/binary-all/
-main/binary-all/admin/
-main/binary-all/base/
-main/binary-all/comm/
-main/binary-all/devel/
- ...
-main/binary-i386/
-main/binary-i386/admin/
-main/binary-i386/base/
- ...
-main/binary-m68k
-main/binary-m68k/admin/
-main/binary-m68k/base/
- ...
-main/source/
-main/source/admin/
-main/source/base/
- ...
-main/disks-i386/
-main/disks-m68k/
- ...
-
-contrib/
-contrib/binary-all/
-contrib/binary-i386/
-contrib/binary-m68k/
- ...
-contrib/source/
-
-non-free/
-non-free/binary-all/
-non-free/binary-i386/
-non-free/binary-m68k/
- ...
-non-free/source/
-</example>
+&sample-dist-dirtree;
<p>
As you can see, the top-level directory of the distribution contains
three directories, namely <em>main</em>, <em>contrib</em>, and
sections do not, to different degrees; as such, they are not
officially part of Debian.
<p>
-Every package in the main section must fully comply with the <!-- work
-around quoting of fragment idendifiers bug <url
-id="http://www.debian.org/social_contract#guidelines" name="Debian
-Free Software Guidelines"> --> <url
-id="http://www.debian.org/social_contract" name="Debian Free Software
-Guidelines"> (DFSG) and with all other policy requirements as
-described in the <url id="http://www.debian.org/doc/debian-policy/"
-name="Debian Policy Manual">. The DFSG is our definition of ``free
-software.'' Check out the Debian Policy Manual for details.
+Every package in the main section must fully comply with the <url
+id="&url-dfsg;" name="Debian Free Software Guidelines"> (DFSG) and
+with all other policy requirements as described in the <url
+id="&url-debian-policy;" name="Debian Policy Manual">. The DFSG is
+our definition of ``free software.'' Check out the Debian Policy
+Manual for details.
<p>
The packages which do not apply to the DFSG are placed in the
<em>non-free</em> section. These packages are not considered as part
but may fail other requirements. For instance, they may depend on
non-free packages.
<p>
-The <url id="http://www.debian.org/doc/debian-policy/" name="Debian
-Policy Manual"> contains a more exact definition of the three
-sections. The above discussion is just an introduction.
+The <url id="&url-debian-policy;" name="Debian Policy Manual">
+contains a more exact definition of the three sections. The above
+discussion is just an introduction.
<p>
The separation of the three sections at the top-level of the archive
is important for all people who want to distribute Debian, either via
created when the older <em>unstable</em> is moved to <em>frozen</em>.
Another wrinkle is that when the <em>frozen</em> distribution is
offically released, the old stable distribution is completely removed
-from the Debian archives (although you can still find it from servers
-which serve up older, obsolete distributions).
+from the Debian archives (although they do live on at
+<tt>archive-host;</tt>).
<p>
In summary, there is always a <em>stable</em> and an <em>unstable</em>
distribution available, and the <em>frozen</em> distribution shows up
~ianmdlvl / developers-reference.git / blobdiff