chiark / gitweb /
Update and simplify list of architectures. Thanks Karl Goetz. Closes: #567234
[developers-reference.git] / resources.dbk
index 1ff6c940082df90ba64d48ac4f13a48a53e918ea..57b3824f18faf2c02783c0a0f65be812ea79f1bd 100644 (file)
@@ -335,18 +335,13 @@ Send mail to &email-debian-devel; if you have any questions.
 If you need to use a Version Control System for any of your Debian work,
 you can use one the existing repositories hosted on Alioth or you can
 request a new project and ask for the VCS repository of your choice.
-Alioth supports CVS (alioth.debian.org), Subversion
+Alioth supports CVS (cvs.alioth.debian.org/cvs.debian.org), Subversion
 (svn.debian.org), Arch (tla/baz, both on arch.debian.org), Bazaar
 (bzr.debian.org), Darcs (darcs.debian.org), Mercurial (hg.debian.org) and Git
 (git.debian.org).  Checkout <ulink url="&url-alioth-pkg;" /> if you plan
 to maintain packages in a VCS repository. See <xref linkend="alioth"/> for
 information on the services provided by Alioth.
 </para>
-<para>
-Historically, Debian first used <literal>cvs.debian.org</literal> to host
-CVS repositories. But that service is deprecated in favor of Alioth.
-Only a few projects are still using it.
-</para>
 </section>
 
 <section id="dchroot">
@@ -429,9 +424,8 @@ url="&url-debian-db-mail-gw;"></ulink>.
 <title>The Debian archive</title>
 <para>
 The &debian-formal; distribution consists of a lot of packages
-(<filename>.deb</filename>'s, currently around
-&number-of-pkgs;) and a few additional files (such as
-documentation and installation disk images).
+(currently around &number-of-pkgs; source packages) and a few additional
+files (such as documentation and installation disk images).
 </para>
 <para>
 Here is an example directory tree of a complete Debian archive:
@@ -531,32 +525,23 @@ Nowadays, these exist only in the Section header fields of packages.
 <para>
 In the first days, the Linux kernel was only available for Intel i386 (or
 greater) platforms, and so was Debian.  But as Linux became more and more
-popular, the kernel was ported to other architectures, too.
-</para>
-<para>
-The Linux 2.0 kernel supports Intel x86, DEC Alpha, SPARC, Motorola 680x0 (like
-Atari, Amiga and Macintoshes), MIPS, and PowerPC.  The Linux 2.2 kernel
-supports even more architectures, including ARM and UltraSPARC.  Since Linux
-supports these platforms, Debian decided that it should, too.  Therefore,
-Debian has ports underway; in fact, we also have ports underway to non-Linux
-kernels.  Aside from <literal>i386</literal> (our name for Intel x86), there
-is <literal>m68k</literal>, <literal>alpha</literal>,
-<literal>powerpc</literal>, <literal>sparc</literal>,
-<literal>hurd-i386</literal>, <literal>arm</literal>,
-<literal>ia64</literal>, <literal>hppa</literal>,
-<literal>s390</literal>, <literal>mips</literal>,
-<literal>mipsel</literal> and <literal>sh</literal> as of this writing.
+popular, the kernel was ported to other architectures and Debian started
+to support them. And as if supporting so much hardware was not enough,
+Debian decided to build some ports based on other Unix kernels, like
+<literal>hurd</literal> and <literal>kfreebsd</literal>.
 </para>
 <para>
-&debian-formal; 1.3 is only available as <literal>i386</literal>.  Debian
+&debian-formal; 1.3 was only available as <literal>i386</literal>.  Debian
 2.0 shipped for <literal>i386</literal> and <literal>m68k</literal>
-architectures.  Debian 2.1 ships for the <literal>i386</literal>,
+architectures.  Debian 2.1 shipped for the <literal>i386</literal>,
 <literal>m68k</literal>, <literal>alpha</literal>, and
-<literal>sparc</literal> architectures.  Debian 2.2 added support for the
-<literal>powerpc</literal> and <literal>arm</literal> architectures.
-Debian 3.0 added support of five new architectures: <literal>ia64</literal>,
-<literal>hppa</literal>, <literal>s390</literal>, <literal>mips</literal>
-and <literal>mipsel</literal>.
+<literal>sparc</literal> architectures.  Since then Debian has grown hugely.
+Debian 5 supports a total of twelve architectures: <literal>alpha</literal>,
+<literal>amd64</literal>, <literal>arm</literal>,
+<literal>armel</literal>, <literal>hppa</literal>,
+<literal>i386</literal>, <literal>ia64</literal>, <literal>mips</literal>,
+<literal>mipsel</literal>, <literal>powerpc</literal>,
+<literal>s390</literal>, <literal>sparc</literal>.
 </para>
 <para>
 Information for developers and users about the specific ports are available at
@@ -580,8 +565,10 @@ file or both an <filename>.orig.tar.gz</filename> and a
 <filename>.diff.gz</filename> file;</para></listitem>
 <listitem><para>with format “3.0 (quilt)”, it has a mandatory
 <filename>.orig.tar.{gz,bz2,lzma}</filename> upstream tarball,
-muliple optional <filename>.orig-<replaceable>component</replaceable>.tar.{gz,bz2,lzma}</filename> additional upstream tarballs</para> and a
-mandatory <filename>debian.tar.{gz,bz2,lzma} debian tarball</filename>;</listitem>
+multiple optional <filename>.orig-<replaceable>component</replaceable>.tar.{gz,bz2,lzma}</filename>
+additional upstream tarballs and a mandatory
+<filename>debian.tar.{gz,bz2,lzma}</filename> debian
+tarball;</para></listitem>
 <listitem><para>with format “3.0 (native)”, it has only
 a single <filename>.tar.{gz,bz2,lzma}</filename> tarball.</para></listitem>
 </itemizedlist>
@@ -1063,6 +1050,15 @@ override disparity for the section and/or the priority field).
 </listitem>
 </varlistentry>
 <varlistentry>
+<term><literal>buildd</literal></term>
+<listitem>
+<para>
+Build failures notifications sent by the network of build daemons, they contain
+a pointer to the build logs for analysis.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
 <term><literal>default</literal></term>
 <listitem>
 <para>
@@ -1257,6 +1253,11 @@ disparity, etc.)
 </listitem>
 <listitem>
 <para>
+<literal>buildd</literal>: build failures notifications from build daemons
+</para>
+</listitem>
+<listitem>
+<para>
 <literal>default</literal>: all the other mails (those which aren't automatic)
 </para>
 </listitem>
@@ -1529,10 +1530,10 @@ responsibility.
 </section>
 
 <section id="alioth">
-<title>Debian's GForge installation: Alioth</title>
+<title>Debian's FusionForge installation: Alioth</title>
 <para>
 Alioth is a Debian service based on a slightly modified version of the
-GForge software (which evolved from SourceForge). This software offers
+FusionForge software (which evolved from SourceForge and GForge). This software offers
 developers access to easy-to-use tools such as bug trackers, patch
 manager, project/task managers, file hosting services, mailing lists, CVS
 repositories etc.  All these tools are managed via a web interface.