chiark / gitweb /
changes from Raphael Hertzog <hertzog@debian.org>, 25 Mar 2000
authoraph <aph@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Mon, 17 Apr 2000 02:24:28 +0000 (02:24 +0000)
committeraph <aph@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Mon, 17 Apr 2000 02:24:28 +0000 (02:24 +0000)
git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@943 313b444b-1b9f-4f58-a734-7bb04f332e8d

common.ent
constitution.en.html
developers-reference.sgml

index 612e8c88eccc8793c16888fd28e64e69a6748742..1e75a3c0493db3e08bdcd1615ab4c308897a7b94 100644 (file)
@@ -9,7 +9,7 @@
 
 <!-- volatile information -->
 
 
 <!-- volatile information -->
 
-<!entity number-of-pkgs "3300">
+<!entity number-of-pkgs "4500">
 <!entity number-of-maintainers "500">
 
 <!-- standard information -->
 <!entity number-of-maintainers "500">
 
 <!-- standard information -->
@@ -45,6 +45,9 @@
 <!entity url-devel-machines "http://www.debian.org/devel/machines">
 <!entity url-buildd "http://buildd.debian.org/">
 <!entity url-lintian "http://www.debian.org/lintian/">
 <!entity url-devel-machines "http://www.debian.org/devel/machines">
 <!entity url-buildd "http://buildd.debian.org/">
 <!entity url-lintian "http://www.debian.org/lintian/">
+<!entity url-debian-qa "http://qa.debian.org/">
+<!entity url-debian-db "https://db.debian.org/">
+<!entity url-debian-db-doc "http://db.debian.org/doc-general.html">
 
 <!entity url-debian-keyring "ftp://&ftp-debian-org;/debian/doc/debian-keyring.tar.gz">
 <!entity url-readme-non-us "ftp://&ftp-debian-org;/debian/README.non-US">
 
 <!entity url-debian-keyring "ftp://&ftp-debian-org;/debian/doc/debian-keyring.tar.gz">
 <!entity url-readme-non-us "ftp://&ftp-debian-org;/debian/README.non-US">
@@ -76,6 +79,9 @@
 <!entity email-debian-private "<email>debian-private@&lists-host;</email>">
 <!entity email-debian-policy "<email>debian-policy@&lists-host;</email>">
 <!entity email-debian-user "<email>debian-policy@&lists-host;</email>">
 <!entity email-debian-private "<email>debian-private@&lists-host;</email>">
 <!entity email-debian-policy "<email>debian-policy@&lists-host;</email>">
 <!entity email-debian-user "<email>debian-policy@&lists-host;</email>">
+<!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-new-maintainer "<email>new-maintainer@debian.org</email>">
 <!entity email-debian-keyring "<email>keyring-maint@debian.org</email>">
 
 <!entity email-new-maintainer "<email>new-maintainer@debian.org</email>">
 <!entity email-debian-keyring "<email>keyring-maint@debian.org</email>">
index adcd1930eeeef6780bfa86bc4f3f5dbc948adc99..2d76d3187c9d7d7575f93a580f22d8b6a1e8c3df 100644 (file)
 <meta name="Modified"  content="09-12-1998 22:36:32">
 </HEAD>
 <BODY text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" alink="#FF0000">
 <meta name="Modified"  content="09-12-1998 22:36:32">
 </HEAD>
 <BODY text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" alink="#FF0000">
-<TABLE border="0" cellpadding="3" cellspacing="0" width="100%">
-<TR>
-<TD>
-<IMG src="../Pics/logo-50.gif" border="0" hspace="0" vspace="0" alt="[Debian Logo]" width="33" height="50">
-<IMG src="../Pics/banner-blue.gif" border="0" hspace="0" vspace="0" alt="Debian GNU/Linux" width="310" height="29">
-</TD>
-</TR>
-<TR>
-<TD BGCOLOR="#DD0000">
-<A href="../"><IMG src="../Pics/home.en.gif" border="0" hspace="2" vspace="3" alt="Home" width="53" height="18"></A>
-<A href="../intro/about"><IMG src="../Pics/about.en.gif" border="0" hspace="2" vspace="3" alt="About&nbsp;Debian" width="107" height="18"></A>
-<A href="../News/"><IMG src="../Pics/news.en.gif" border="0" hspace="2" vspace="3" alt="News" width="50" height="18"></A>
-<A href="../distrib/"><IMG src="../Pics/distrib.en.gif" border="0" hspace="2" vspace="3" alt="Distribution" width="90" height="18"></A>
-<A href="../support"><IMG src="../Pics/support.en.gif" border="0" hspace="2" vspace="3" alt="Support" width="67" height="18"></A>
-<A href="../devel/"><IMG src="../Pics/devel.en.gif" border="0" hspace="2" vspace="3" alt="Developers&nbsp;Corner" width="105" height="18"></A>
-<A href="http://insite.verisim.com/search/debian/simple"><IMG src="../Pics/search.en.gif" border="0" hspace="2" vspace="3" alt="Search" width="61" height="18"></A>
-</TD>
-</TR>
-</TABLE>
 <H1>Debian Constitution</H1>
     <h1>Constitution for the Debian Project (v1.0)</h1>
     <h2>1. Introduction</h2>
 <H1>Debian Constitution</H1>
     <h1>Constitution for the Debian Project (v1.0)</h1>
     <h2>1. Introduction</h2>
     does not form part of the constitution. It may be used only to
     aid interpretation in cases of doubt. </cite>
 <HR>
     does not form part of the constitution. It may be used only to
     aid interpretation in cases of doubt. </cite>
 <HR>
-<P>Back to the <A href="../">Debian GNU/Linux homepage</A>.
-<HR>
-<SMALL>See the Debian <a href="../contact">contact page</a> for information on contacting us.</SMALL><P>
-<SMALL>Last Modified: Thu, Dec 10 03:36:32 UTC 1998<BR>
-Copyright &copy; 1997-1999 <a href="http://www.spi-inc.org/">SPI</a>; See <a href="../license">license terms</A> </SMALL>
+<SMALL>Copyright &copy; 1997-1999 <a href="http://www.spi-inc.org/">SPI</a>; See <a href="http://www.debian.org/license">license terms</A> </SMALL>
 </BODY>
 </HTML>
 </BODY>
 </HTML>
index 40e198746cabc6c1d055a1c4a68eece2b8e07e7a..21efdba90a06f0d0153083ee39cec7c2023f83cf 100644 (file)
@@ -5,7 +5,7 @@
   <!-- common, language independant entities -->
   <!entity % commondata  SYSTEM "common.ent" > %commondata;
   <!-- CVS revision of this document -->
   <!-- common, language independant entities -->
   <!entity % commondata  SYSTEM "common.ent" > %commondata;
   <!-- CVS revision of this document -->
-  <!entity cvs-rev "$Revision: 1.37 $">
+  <!entity cvs-rev "$Revision: 1.38 $">
 
   <!-- if you are translating this document, please notate the RCS
        revision of the developers reference here -->
 
   <!-- if you are translating this document, please notate the RCS
        revision of the developers reference here -->
@@ -258,7 +258,22 @@ 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.
 
 
 post to that list and an experienced developer will volunteer to help.
 
 
-    <chapt id="user-maint">Maintaining Your Debian Information
+    <chapt id="developer-duties">Debian Developer's Duties
+
+      <sect id="user-maint">Maintaining Your Debian Information
+       <p>
+There's a LDAP database containing many informations concerning all
+developers, you can access it at <url id="&url-debian-db;">. You can
+update your password (this password is propagated to most of the machines
+that are accessible to you), your adress, your country, the latitude and
+longitude from the point where you live, phone and fax numbers, your
+preferred shell, your IRC nickname, your web page and the email that
+you're using as alias for your debian.org email. Most of the information
+is not accessible to the public, for more details about this
+database, please read its online documentation that you can find
+here : <url id="&url-debian-db-doc;">.
+       <p>
+You have to keep the information available there up to date.
 
       <sect id="key-maint">Maintaining Your Public Key
        <p>
 
       <sect id="key-maint">Maintaining Your Public Key
        <p>
@@ -276,6 +291,67 @@ routines discussed in <ref id="registering"> apply.
 You can find a more in-depth discussion of Debian key maintenance in
 the documentation for the <package>debian-keyring</package> package.
 
 You can find a more in-depth discussion of Debian key maintenance in
 the documentation for the <package>debian-keyring</package> package.
 
+      <sect id="inform-vacation">Going On Vacation Gracefully
+       <p>
+Most of the developers take vacation, usually this means that they can't
+work for Debian and they can't be reached by email if any problem occurs.
+The other developers need to know that you're on vacation so that they'll
+do whatever is needed when such a problem occurs. Usually this means that
+other developers are allowed to NMU your package if a big problem (release
+critical bugs, security update, ...) occurs while you're on vacation.
+       <p>
+In order to inform the other developers, there's two things that you should do.
+First send a mail to &email-debian-private; giving the period of time when
+you will be on vacation, you can also give some special instructions on what to
+do if any problem occurs. Next you should update your information
+available in the Debian LDAP database and mark yourself as « on vacation »
+(this information is only accessible to debian developers). Don't forget
+to remove the « on vacation » flag when you come back.
+
+      <sect id="upstream-coordination">Coordination With Upstream Developers
+       <p>
+A big part of your job as Debian maintainer will be to stay in contact
+with the upstream developers since you'll have to share information that
+you get from the Bug Tracking System. It's not your job to fix non-Debian
+specific bugs so you have to forward the bugs to the upstream developers
+(of course, if you are able to fix them, you can ...). This way the bug
+may be corrected when the next upstream version comes out. From time to
+time, you may get a patch attached to a bug report, you have to send the
+patch upstream and make sure that it gets included (if the authors accept
+the proposed fix). If you need to modify the upstream sources in order to
+build a policy conformant package, then you should propose a nice fix 
+to the upstream developers which can be included so that you won't have to
+modify the sources of the next upstream version. Whatever changes you
+need, always try not to fork from the upstream sources.
+
+      <sect id="rc-bugs">Managing Release Critical Bugs
+        <p>
+Release Critical Bugs (RCB) are the bugs of severity «&nbsp;critical&nbsp;», 
+«&nbsp;grave&nbsp;» and «&nbsp;important&nbsp;». Those bugs can delay
+the Debian release and/or can justify the removal of a package at freeze
+time. That's why those bugs needs to be corrected as fast as possible.
+You must be aware that some developers who are part of the <url
+id="&url-debian-qa;" name="Debian Quality Assurance"> effort are following
+those bugs and try to help you each time they can. But if you can't
+fix such bugs within 2 weeks, you should either ask for help by sending a
+mail to the Quality Assurance (QA) group (&email-debian-qa;) or 
+justify yourself and gives your plan to fix it by sending a mail to the
+concerned bug report. Otherwise people from the QA group may want to do a
+Non Maintainer Upload (NMU) after trying to contact you (they might wait
+not as long as usually before they do their NMU if they have seen no
+recent activity from you on the BTS).
+
+      <sect id="qa-effort">Quality Assurance Effort
+       <p>
+Even if there is a dedicated group of people for Quality Assurance, QA is
+not reserved to them. You can participate to this effort by keeping your
+packages as bug free as possible, as lintian-clean (see <ref
+id="lintian-reports">) as possible. If you think that it's quite impossible,
+then you should consider orphaning (see <ref id="orphaning">) some of your
+packages so that you can do a good job with the other packages that you
+maintain. Alternatively you may ask the help of other people in order to
+catch up the backlog of bugs that you have (you can ask for help on
+&email-debian-qa; or &email-debian-devel;).
 
       <sect>Retiring Gracefully
        <p>
 
       <sect>Retiring Gracefully
        <p>
@@ -332,6 +408,11 @@ As such, it is a low volume list, and users are urged not to use
 &email-debian-private; unless it is really necessary.  Moreover, do
 <em>not</em> forward email from that list to anyone.
        <p>
 &email-debian-private; unless it is really necessary.  Moreover, do
 <em>not</em> forward email from that list to anyone.
        <p>
+&email-debian-email; is a special mailing list used as a grab-bag 
+for Debian related correspondence such as contacting upstream authors
+about licenses, bugs, etc. or discussing the project with others where it
+might be useful to have the discussion archived somewhere.
+       <p>
 As ever on the net, please trim down the quoting of articles you're
 replying to.  In general, please adhere to the usual conventions for
 posting messages.
 As ever on the net, please trim down the quoting of articles you're
 replying to.  In general, please adhere to the usual conventions for
 posting messages.
@@ -825,12 +906,16 @@ put `stable unstable' in the <file>changelog</file>'s
 <tt>Distribution</tt> field.  Or, if Debian has been frozen, and you
 want to get a bug-fix release into <em>frozen</em>, you would set the
 distribution to `frozen unstable'.  (See <ref id="upload-frozen"> for
 <tt>Distribution</tt> field.  Or, if Debian has been frozen, and you
 want to get a bug-fix release into <em>frozen</em>, you would set the
 distribution to `frozen unstable'.  (See <ref id="upload-frozen"> for
-more information on when to upload to <em>frozen</em>.)  Note that
-setting the distribution to `stable' means that the package will be
-placed into the <tt>proposed-updates</tt> directory of the Debian
-archive for further testing before it is actually included in
-<em>stable</em>.  Also note that it never makes sense to combine the
-<em>experimental</em> distribution with anything else.
+more information on when to upload to <em>frozen</em>.)  Note that it
+never makes sense to combine the <em>experimental</em> distribution with
+anything else.  Also note that setting the distribution to `stable' means
+that the package will be placed into the <tt>proposed-updates</tt>
+directory of the Debian archive for further testing before it is actually
+included in <em>stable</em>. The Release Team (which can be reached at
+&email-debian-release;) will decide if your package can be included in
+stable, therefore if your changelog entry is not clear enough, you may
+want to explain them why you uploaded your package to stable by sending 
+them a short explication.
          <p>
 The first time a version is uploaded which corresponds to a particular
 upstream version the original source tar file should be uploaded and
          <p>
 The first time a version is uploaded which corresponds to a particular
 upstream version the original source tar file should be uploaded and
@@ -953,7 +1038,10 @@ defaults for uploading via <prgn>ftp</prgn> to <tt>master</tt>,
 <tt>chiark</tt>, and <tt>erlangen</tt>.  It can also be configured to
 use <prgn>ssh</prgn>.  See <manref name="dupload" section="1"> and
 <manref name="dupload" section="5"> for more information.
 <tt>chiark</tt>, and <tt>erlangen</tt>.  It can also be configured to
 use <prgn>ssh</prgn>.  See <manref name="dupload" section="1"> and
 <manref name="dupload" section="5"> for more information.
-
+         <p>
+After uploading your package, you can check how dinstall will
+process it by running dinstall on your changes file:
+<example>~maor/dinstall/dinstall -n foo.changes</example>
 
        <sect1 id="upload-non-us">Uploading to <tt>pandora</tt> (non-us)
          <p>
 
        <sect1 id="upload-non-us">Uploading to <tt>pandora</tt> (non-us)
          <p>
@@ -967,7 +1055,11 @@ same account which works on <tt>master</tt>.
 The program <prgn>dupload</prgn> comes with support for uploading to
 <tt>pandora</tt>; please refer to the documentation that comes with
 the program for details.
 The program <prgn>dupload</prgn> comes with support for uploading to
 <tt>pandora</tt>; please refer to the documentation that comes with
 the program for details.
-
+         <p>
+Just as for an upload to master, you can check your upload with :
+<example>/org/non-us.debian.org/scripts/dinstall/dinstall -n foo.changes
+</example>
+      
        <sect1>Uploads via <tt>chiark</tt>
          <p>
 If you have a slow network connection to <tt>master</tt>, there are
        <sect1>Uploads via <tt>chiark</tt>
          <p>
 If you have a slow network connection to <tt>master</tt>, there are
@@ -1031,22 +1123,25 @@ anonymous FTP to <url id="&url-upload-jp;">.
       <sect id="upload-announce">Announcing package uploads
        <p>
 When a package is uploaded an announcement should be posted to one of
       <sect id="upload-announce">Announcing package uploads
        <p>
 When a package is uploaded an announcement should be posted to one of
-the ``debian-changes'' lists. The announcement should give the
-(source) package name and version number, and a very short summary of
-the changes, in the <em>Subject</em> field, and should contain the
-PGP-signed <tt>.changes</tt> file.  Some additional explanatory text
-may be added before the start of the <tt>.changes</tt> file.
+the ``debian-changes'' lists. This is now done automatically by dinstall
+when it runs (usually once a day), you just need to use a recent
+<package>dpkg-dev</package> (&gt;= 1.4.1.2). Before that, 
+<prgn>dupload</prgn> was used to send those announcements, please make
+sure that you configured your <prgn>dupload</prgn> to no more send those
+announcements (check its documentation and look for dinstall_runs). The
+mail generated by dinstall will contain the PGP/GPG signed .changes files
+that you uploaded with your package.
        <p>
 If a package is released with the <tt>Distribution:</tt> set to
 `stable', the announcement is sent to &email-debian-changes;.  If a
 package is released with <tt>Distribution:</tt> set to `unstable',
        <p>
 If a package is released with the <tt>Distribution:</tt> set to
 `stable', the announcement is sent to &email-debian-changes;.  If a
 package is released with <tt>Distribution:</tt> set to `unstable',
-`experimental', or `frozen' (when present), the announcement should be
+`experimental', or `frozen' (when present), the announcement will be
 posted to &email-debian-devel-changes; instead.
        <p>
 On occasion, it is necessary to upload a package to both the
 <em>stable</em> and <em>unstable</em> distributions; this is done by
 putting both distributions in the <tt>Distribution:</tt> line.  In
 posted to &email-debian-devel-changes; instead.
        <p>
 On occasion, it is necessary to upload a package to both the
 <em>stable</em> and <em>unstable</em> distributions; this is done by
 putting both distributions in the <tt>Distribution:</tt> line.  In
-such a case the upload announcement should go to both of the above
+such a case the upload announcement will go to both of the above
 mailing lists.
        <p>
 The <prgn>dupload</prgn> program is clever enough to determine for itself
 mailing lists.
        <p>
 The <prgn>dupload</prgn> program is clever enough to determine for itself