From: aph Date: Sun, 8 Nov 1998 02:12:17 +0000 (+0000) Subject: correct new maintainer instructions pretty heavily (see changelog) X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=commitdiff_plain;h=908492c3397cfd4c11fd5d08f6e7accddd1b27ad correct new maintainer instructions pretty heavily (see changelog) red-pen corrections git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@696 313b444b-1b9f-4f58-a734-7bb04f332e8d --- diff --git a/developers-reference.sgml b/developers-reference.sgml index 16732d2..401e56e 100644 --- a/developers-reference.sgml +++ b/developers-reference.sgml @@ -7,9 +7,9 @@ @@ -19,9 +19,10 @@ Adam P. Harris, current maintainer Christian Schwarz Ian Jackson version &version;, &date; + ver. &version;, &date; +

Copyright ©1998 Adam P. Harris. Copyright ©1997,1998 Christian Schwarz.

@@ -67,11 +68,10 @@ It should be clear that this reference does not discuss the details of the Debian package or how to generate Debian packages; that is discussed in the . Nor is this reference intended to -give details on standards for how Debian software must behave, which -is documented in the . +name="Debian Packaging Manual">. Neither does this reference detail +the standards to which Debian software must comply; that information +can be found in the . Applying to Become a Maintainer @@ -86,7 +86,7 @@ the Project?

Firstly, subscribe to . @@ -128,13 +128,17 @@ application: Your name. Your preferred login name on Can anyone clarify for me why logins on master -cannot be eight characters? ), as well as the email address -at which you'd prefer to be subscribed to +lessIt is not clear to the author why logins on +master cannot be eight characters or greater. If anyone can +clarify why, I would appreciate it.), as well as the email +address at which you'd prefer to be subscribed to debian.org address). -A phone number where we can call you. +A phone number where we can call you. Remember that the new +maintainer team usually calls during evening hours to save on long +distance tolls. Please do not give a work number, unless you are +generally there in the evening. A statement of intention, that is, what package(s) you intend to work on, which Debian port you will be assisting, or how you intend to @@ -164,17 +168,23 @@ a birth certificate, national ID card, U.S. Driver's License, etc.). If emailed, please sign the mail with your PGP key. +

If you do not have a PGP key yet, generate one. Every developer needs a PGP key in order to sign and verify package uploads. You should read the PGP manual, since it has much important information which is critical to its security. Many more security failures are due to human error than to software failure or high-powered spy techniques.

+Our standard is to use pgp version 2.x. You can use + Your PGP key must be at least 1024 bits long. There is no reason to use a smaller key, and doing so would be much less secure. Your key must be signed with at least your own user ID. This prevents user ID -tampering. You can do it by executing `pgp -ks -'. +tampering. You can do it by executing pgp -ks +.

If your PGP key isn't on public PGP key servers such as pgp.net, please read the documentation available locally @@ -200,31 +210,33 @@ Once you have all your information ready, and your public key is available on public key servers, send a message to pgp --kxa in the case of PGP; note that pgp +-kxa in the case of PGP) for the database of keys which is +distributed from /pub/debian/doc/debian-keyring.tar.gz, or the - Once this information is received and processed, you should be contacted with information about your new Debian maintainer account. -If you don't hear anything within 7-14 days, please re-send your -original message--the new-maintainer volunteers are typically -overworked, and mistakes do occasionally happen. +If you don't hear anything within 7-14 days, please send a followup +message asking if your original application was received. Do not +re-send your original application, that will just confuse the +new-maintainer team. Please be patient, especially near release +points; mistakes do occasionally happen, and people do sometimes run +out of volunteer time. Debian Mentors

-There is a mailing list called for details). +A mailing list called for +details).

-Those who prefer one-on-one help (e.g., via private emails) should +Those who prefer one-on-one help (e.g., via private email) should also post to that list and an experienced developer will volunteer to help. @@ -280,7 +292,7 @@ id="http://www.debian.org/Lists-Archives/">.

The master server, . +package uploads go to this server; see .

. More information concerning mirrors can be found at . This useful page includes +id="http://www.debian.org/devel/mirror/">. 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.

@@ -411,7 +423,7 @@ non-free/source/

As you can see, the top-level directory of the distribution contains three directories, namely main, contrib, and -non-free. These directories are called sections. +pnon-free. These directories are called sections.

In each section, there is a directory with the source packages (source), a directory for each supported architecture (binary-i386, @@ -452,9 +464,9 @@ Packages in the -(The contains a more exact definition of the three -sections. The above discussion is just an introduction.) +sections. The above discussion is just an introduction.

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