From d9060f32cf8e253537e8724ad203c6336c3a6412 Mon Sep 17 00:00:00 2001 From: aph Date: Tue, 4 May 1999 07:32:19 +0000 Subject: [PATCH] * Sec. "Architectures": correction on supported architecture in Linux 2.2, from Job Bogan * Sec. "Experimental": other reasons to use or not use the experiment archive "section", from comments by Guy Maor * Sec. "Being Kind to Porters": replace x86 with i386 (closes Bug#36485) * debian/rules: date printing protected from local l10n (closes Bug#36891) * Ch. "Mailing Lists, Servers, and Other Machines": renamed chapter; add intro paragraph * Sec. "Debian Servers": new, for talking about the standard servers, with intro; demoted server sections under that * Sec. "The FTP servers": was empty, removed * Sec. "The master server": fill in more info and cross-refs on how to report problems * Sec. "The CVS server": add some more detail which should be included when requesting cvs areas; mention the cvsweb URL * Sec. "Other Debian Machines": new section, list the machines for which a normal developer may have access. git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@812 313b444b-1b9f-4f58-a734-7bb04f332e8d --- debian/changelog | 22 ++++++ debian/rules | 2 +- developers-reference.sgml | 155 +++++++++++++++++++++++++++++++------- 3 files changed, 150 insertions(+), 29 deletions(-) diff --git a/debian/changelog b/debian/changelog index 5c286f7..395e15b 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,25 @@ +developers-reference (2.6.5) unstable; urgency=low + + * Sec. "Architectures": correction on supported architecture in Linux + 2.2, from Job Bogan + * Sec. "Experimental": other reasons to use or not use the experiment + archive "section", from comments by Guy Maor + * Sec. "Being Kind to Porters": replace x86 with i386 (closes Bug#36485) + * debian/rules: date printing protected from local l10n (closes Bug#36891) + * Ch. "Mailing Lists, Servers, and Other Machines": renamed chapter; add + intro paragraph + * Sec. "Debian Servers": new, for talking about the standard servers, + with intro; demoted server sections under that + * Sec. "The FTP servers": was empty, removed + * Sec. "The master server": fill in more info and cross-refs on how to + report problems + * Sec. "The CVS server": add some more detail which should be included + when requesting cvs areas; mention the cvsweb URL + * Sec. "Other Debian Machines": new section, list the machines for which + a normal developer may have access. + + -- Adam Di Carlo Tue, 4 May 1999 03:32:21 -0400 + developers-reference (2.6.4) unstable; urgency=low * debian/rules: hack 'byhand' file entries to include debian version diff --git a/debian/rules b/debian/rules index 6207e07..d9302e1 100755 --- a/debian/rules +++ b/debian/rules @@ -23,7 +23,7 @@ compress := gzip -9f # version abstraction DEB_VERSION := $(shell LC_ALL=C dpkg-parsechangelog | grep '^Version: ' | sed 's/^Version: *//') # pretty-print the date -DATE := $(shell date --date="`dpkg-parsechangelog | grep '^Date: ' | sed 's/^Date: *//'`" '+%d %B, %Y') +DATE := $(shell LC_ALL=C date --date="`dpkg-parsechangelog | grep '^Date: ' | sed 's/^Date: *//'`" '+%d %B, %Y') # source depends -- check if these packages are installed SRC_DEPENDS := debiandoc-sgml lout psutils diff --git a/developers-reference.sgml b/developers-reference.sgml index 6d10f25..e99f83d 100644 --- a/developers-reference.sgml +++ b/developers-reference.sgml @@ -286,7 +286,11 @@ to keyring-maint@debian.org. - Mailing Lists and Servers + Mailing Lists, Servers, and Other Machines +

+In this chapter you will find a very brief road map of the Debian +mailing lists, the main Debian servers, and other Debian machines +which may be available to you as a developer. Mailing lists

@@ -331,8 +335,22 @@ posting messages. Online archives of mailing lists are available at . + Debian servers +

+Debian servers are well known servers which serve critical functions +in the Debian project. Every developer should know what these servers +are and what they do. +

+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 . 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 for information on how +to submit bugs. - The master server + The master server

The master server, If you find a problem with debian-admin@debian.org. +debian-admin@debian.org. Problems with the Debian FTP +archive generally need to be reported as bugs against the +ftp.debian.org pseudo-package, but also see the +procedures in . - The FTP servers -

- - The WWW servers + The WWW servers

The main web server, . - The CVS server + + The CVS server

ssh. +developers, you can request a CVS area on the server. +

+Generally, ssh. Also, the CVS area can +be accessed read-only via the Web at .

To request a CVS area, send a request via email to -debian-admin@debian.org. +debian-admin@debian.org. Include the name of the +requested CVS area, what va.debian.org user account should +own the CVSROOT, and why you need it. - Mirrors of Debian servers + Mirrors of Debian servers

The web and FTP servers have several mirrors available. Please do not put heavy load on the canonical FTP or web servers. Ideally, the @@ -423,6 +447,70 @@ Please do not mirror off of Other Debian Machines +

+There are other Debian machines which may be made available to you. +You can use these for Debian-related purposes as you see fit. Please +be kind to system administrators, and do not use up tons and tons of +disk space, network bandwidth, or CPU without first getting the +approval of the local maintainers. Usually these machines are run by +volunteers. Generally, these machines are for porting activities. +

+Aside from the servers mentioned in , the +following machines are, or may be made, available to you. If an email +address is listed, generally that person is the party to contact about +issues on the machine. Otherwise, the machine is probably managed by +debian-admin@debian.org. + + + faure.debian.org + +An Alpha; if you have an account on master, you probably +already have an account here. + + kubrick.debian.org + +A SPARC; if you have an account on master, you probably +already have an account here. + + pandora.debian.org + +An i386; if you have an account on master, you probably +already have an account here. + + albert.debian.org + +An Alpha; you probably want to use faure instead, but you may +request an account from debian-admin@debian.org. + + powerpc.debian.org + +A PowerPC; also known as tervola.infodrom.north.de. You may +request an account from joey@debian.org or +koptein@debian.org. + + m68k.debian.org + +A Motorola 6800x0 machine; you may request an account from +joey@debian.org or james@nocrew.org. +Runs an autobuilder. + + alpha.debian.nl + +An Alpha; you may request an account from +debian@cistron.nl. + + xia0[123].kachinatech.com + +SPARC and UltraSPARC machines. xia0[12] are used for +automatic compilation; you can request an account on xia03 (an +UltraSPARC) from wdeng@kachinatech.com. + + + + + The Debian Archive Overview @@ -543,14 +631,14 @@ more and more popular, the kernel was ported to other architectures, too.

The Linux 2.0 kernel supports Intel x86, DEC Alpha, SPARC, Motorola -680x0 machines (like Atari, Amiga and Macintoshes), MIPS, and PowerPC. -Newer kernels support more architectures, including ARM, UltraSPARC, -and MIPS. 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 kernel. Aside from +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 kernel. Aside from i386 (our name for Intel x86), there is m68k, alpha, powerpc, sparc, hurd-i386, -and arm as of this writing. +and arm, as of this writing.

Debian GNU/Linux 1.3 is only available as i386. Debian 2.0 @@ -568,7 +656,6 @@ excepting perhaps the `base' subsection. Subsections exist simply to simplify the organization and browsing of available packages. Please check the current Debian distribution to see which sections are available. -

Packages @@ -686,10 +773,22 @@ could do grave damage to a system, it might be better to put it into For instance, an experimental encrypted file system should probably go -into experimental. A new, beta, version of some software which uses -completely different configuration might go into experimental at the -maintainer's discretion. New software which isn't likely to damage -your system can go into experimental. A new, beta, version of some software +which uses completely different configuration might go into +experimental at the maintainer's discretion. New software +which isn't likely to damage your system can go into +unstable. If you are working on an incompatible or complex +upgrade situation, you can also use experimental as a staging +area, so that testers can get early access. +

+However, using experimental as a personal staging area is not +always the best idea. You can't replace or upgrade the files in there +on your own (dinstall and the Debian archive maintainers +do that). Additionally, you'll have to remember to ask the archive +maintainers to delete the package one you have uploaded it to +unstable. Using your personal web space on +va.debian.org is generally a better idea, so that you put +less strain on the Debian archive maintainers. Release code names @@ -1324,7 +1423,7 @@ Porting is the act of building Debian packages for architectures which is different from the original architecture of the package maintainer's binary package. It is a unique and essential activity. In fact, porters do most of the actual compiling of Debian packages. -For instance, for one x86 binary package, there has to be a +For instance, for one i386 binary package, there has to be a recompile for each architecture, which is around five more builds. @@ -1352,7 +1451,7 @@ Don't set architecture to a value other than ``all'' or ``any'' unless you really mean it. In too many cases, maintainers don't follow the instructions in the . Setting your architecture to ``x86'' +name="Debian Packaging Manual">. Setting your architecture to ``i386'' is usually incorrect. Make sure your source package is correct. Do dpkg-source -x @@ -1628,7 +1727,7 @@ outlining all the open bugs against your packages: Replace maintainer-address with you official Debian maintainer address. - Submitting Bugs + Submitting Bugs

Often as a package maintainer, you find bugs in other packages or else have bugs reported to your packages which need to be reassigned. The -- 2.30.2