/[ddp]/manuals/trunk/developers-reference/pkgs.dbk
ViewVC logotype

Diff of /manuals/trunk/developers-reference/pkgs.dbk

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 4909 by debacle, Wed Jun 27 12:57:32 2007 UTC revision 4910 by debacle, Sat Jun 30 13:21:18 2007 UTC
# Line 1  Line 1 
1  <?xml version="1.0" encoding="utf-8"?>  <?xml version="1.0" encoding="utf-8"?>
2  <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"  <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3      "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">      "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4      <!ENTITY % commondata  SYSTEM "common.ent" > %commondata;
5    ]>
6  <chapter id="pkgs">  <chapter id="pkgs">
7  <title>Managing Packages</title>  <title>Managing Packages</title>
8  <para>  <para>
# Line 11  and porting packages. Line 13  and porting packages.
13  <title>New packages</title>  <title>New packages</title>
14  <para>  <para>
15  If you want to create a new package for the Debian distribution, you should  If you want to create a new package for the Debian distribution, you should
16  first check the <ulink url="http://www.debian.org/devel/wnpp/">Work-Needing and  first check the <ulink url="&url-wnpp;">Work-Needing and
17  Prospective Packages (WNPP)</ulink> list.  Checking the WNPP list ensures that  Prospective Packages (WNPP)</ulink> list.  Checking the WNPP list ensures that
18  no one is already working on packaging that software, and that effort is not  no one is already working on packaging that software, and that effort is not
19  duplicated.  Read the <ulink url="http://www.debian.org/devel/wnpp/">WNPP web  duplicated.  Read the <ulink url="&url-wnpp;">WNPP web
20  pages</ulink> for more information.  pages</ulink> for more information.
21  </para>  </para>
22  <para>  <para>
# Line 30  You should set the subject of the bug to Line 32  You should set the subject of the bug to
32  -- <replaceable>short description</replaceable>'', substituting the name of the  -- <replaceable>short description</replaceable>'', substituting the name of the
33  new package for <replaceable>foo</replaceable>.  The severity of the bug report  new package for <replaceable>foo</replaceable>.  The severity of the bug report
34  must be set to <emphasis>wishlist</emphasis>.  If you feel it's necessary, send  must be set to <emphasis>wishlist</emphasis>.  If you feel it's necessary, send
35  a copy to <email>debian-devel@lists.debian.org</email> by putting the address  a copy to <email>debian-devel@&lists-host;</email> by putting the address
36  in the <literal>X-Debbugs-CC:</literal> header of the message (no, don't use  in the <literal>X-Debbugs-CC:</literal> header of the message (no, don't use
37  <literal>CC:</literal>, because that way the message's subject won't indicate  <literal>CC:</literal>, because that way the message's subject won't indicate
38  the bug number).  the bug number).
# Line 87  of what is going on, and what is new, in Line 89  of what is going on, and what is new, in
89  </listitem>  </listitem>
90  </itemizedlist>  </itemizedlist>
91  <para>  <para>
92  Please see <ulink url="http://ftp-master.debian.org/REJECT-FAQ.html"></ulink>  Please see <ulink url="http://&ftp-master-host;/REJECT-FAQ.html"></ulink>
93  for common rejection reasons for a new package.  for common rejection reasons for a new package.
94  </para>  </para>
95  </section>  </section>
# Line 336  packages uninstallable, is strongly disc Line 338  packages uninstallable, is strongly disc
338  </para>  </para>
339  <para>  <para>
340  The Release Team (which can be reached at  The Release Team (which can be reached at
341  <email>debian-release@lists.debian.org</email>) will regularly evaluate the  <email>debian-release@&lists-host;</email>) will regularly evaluate the
342  uploads To <emphasis>stable-proposed-updates</emphasis> and decide if your  uploads To <emphasis>stable-proposed-updates</emphasis> and decide if your
343  package can be included in <emphasis>stable</emphasis>.  Please be clear (and  package can be included in <emphasis>stable</emphasis>.  Please be clear (and
344  verbose, if necessary) in your changelog entries for uploads to  verbose, if necessary) in your changelog entries for uploads to
# Line 367  section</link> for details. Line 369  section</link> for details.
369  <title>Uploading to <literal>ftp-master</literal></title>  <title>Uploading to <literal>ftp-master</literal></title>
370  <para>  <para>
371  To upload a package, you should upload the files (including the signed changes  To upload a package, you should upload the files (including the signed changes
372  and dsc-file) with anonymous ftp to <literal>ftp-master.debian.org</literal> in  and dsc-file) with anonymous ftp to <literal>&ftp-master-host;</literal> in
373  the directory <ulink  the directory <ulink
374  url="ftp://ftp-master.debian.org/pub/UploadQueue/">/pub/UploadQueue/</ulink>.  url="ftp://&ftp-master-host;&upload-queue;">&upload-queue;</ulink>.
375  To get the files processed there, they need to be signed with a key in the  To get the files processed there, they need to be signed with a key in the
376  debian keyring.  debian keyring.
377  </para>  </para>
# Line 511  file</emphasis>. Line 513  file</emphasis>.
513  To alter the actual section that a package is put in, you need to first make  To alter the actual section that a package is put in, you need to first make
514  sure that the <filename>debian/control</filename> file in your package is  sure that the <filename>debian/control</filename> file in your package is
515  accurate.  Next, send an email <email>override-change@debian.org</email> or  accurate.  Next, send an email <email>override-change@debian.org</email> or
516  submit a bug against <systemitem role="package">ftp.debian.org</systemitem>  submit a bug against <systemitem role="package">&ftp-debian-org;</systemitem>
517  requesting that the section or priority for your package be changed from the  requesting that the section or priority for your package be changed from the
518  old section or priority to the new one.  Be sure to explain your reasoning.  old section or priority to the new one.  Be sure to explain your reasoning.
519  </para>  </para>
# Line 519  old section or priority to the new one. Line 521  old section or priority to the new one.
521  For more information about <emphasis>override files</emphasis>, see  For more information about <emphasis>override files</emphasis>, see
522  <citerefentry> <refentrytitle>dpkg-scanpackages</refentrytitle>  <citerefentry> <refentrytitle>dpkg-scanpackages</refentrytitle>
523  <manvolnum>1</manvolnum> </citerefentry> and <ulink  <manvolnum>1</manvolnum> </citerefentry> and <ulink
524  url="http://www.debian.org/Bugs/Developer#maintincorrect"></ulink>.  url="&url-bts-devel;#maintincorrect"></ulink>.
525  </para>  </para>
526  <para>  <para>
527  Note that the <literal>Section</literal> field describes both the section as  Note that the <literal>Section</literal> field describes both the section as
528  well as the subsection, which are described in <xref  well as the subsection, which are described in <xref
529  linkend="archive-sections"/> .  If the section is main, it should be omitted.  linkend="archive-sections"/> .  If the section is main, it should be omitted.
530  The list of allowable subsections can be found in <ulink  The list of allowable subsections can be found in <ulink
531  url="http://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections"></ulink>.  url="&url-debian-policy;ch-archive.html#s-subsections"></ulink>.
532  </para>  </para>
533  </section>  </section>
534    
# Line 534  url="http://www.debian.org/doc/debian-po Line 536  url="http://www.debian.org/doc/debian-po
536  <title>Handling bugs</title>  <title>Handling bugs</title>
537  <para>  <para>
538  Every developer has to be able to work with the Debian <ulink  Every developer has to be able to work with the Debian <ulink
539  url="http://www.debian.org/Bugs/">bug tracking system</ulink>.  This includes  url="&url-bts;">bug tracking system</ulink>.  This includes
540  knowing how to file bug reports properly (see <xref linkend="submit-bug"/> ),  knowing how to file bug reports properly (see <xref linkend="submit-bug"/> ),
541  how to update them and reorder them, and how to process and close them.  how to update them and reorder them, and how to process and close them.
542  </para>  </para>
543  <para>  <para>
544  The bug tracking system's features are described in the <ulink  The bug tracking system's features are described in the <ulink
545  url="http://www.debian.org/Bugs/Developer">BTS documentation for  url="&url-bts-devel;">BTS documentation for
546  developers</ulink>.  This includes closing bugs, sending followup messages,  developers</ulink>.  This includes closing bugs, sending followup messages,
547  assigning severities and tags, marking bugs as forwarded, and other issues.  assigning severities and tags, marking bugs as forwarded, and other issues.
548  </para>  </para>
# Line 549  Operations such as reassigning bugs to o Line 551  Operations such as reassigning bugs to o
551  reports about the same issue, or reopening bugs when they are prematurely  reports about the same issue, or reopening bugs when they are prematurely
552  closed, are handled using the so-called control mail server.  All of the  closed, are handled using the so-called control mail server.  All of the
553  commands available on this server are described in the <ulink  commands available on this server are described in the <ulink
554  url="http://www.debian.org/Bugs/server-control">BTS control server  url="&url-bts-control;">BTS control server
555  documentation</ulink>.  documentation</ulink>.
556  </para>  </para>
557  <section id="bug-monitoring">  <section id="bug-monitoring">
558  <title>Monitoring bugs</title>  <title>Monitoring bugs</title>
559  <para>  <para>
560  If you want to be a good maintainer, you should periodically check the <ulink  If you want to be a good maintainer, you should periodically check the <ulink
561  url="http://www.debian.org/Bugs/">Debian bug tracking system (BTS)</ulink> for  url="&url-bts;">Debian bug tracking system (BTS)</ulink> for
562  your packages.  The BTS contains all the open bugs against your packages.  You  your packages.  The BTS contains all the open bugs against your packages.  You
563  can check them by browsing this page:  can check them by browsing this page:
564  <literal>http://bugs.debian.org/<replaceable>yourlogin</replaceable>@debian.org</literal>.  <literal>http://&bugs-host;/<replaceable>yourlogin</replaceable>@debian.org</literal>.
565  </para>  </para>
566  <para>  <para>
567  Maintainers interact with the BTS via email addresses at  Maintainers interact with the BTS via email addresses at
568  <literal>bugs.debian.org</literal>.  Documentation on available commands can be  <literal>&bugs-host;</literal>.  Documentation on available commands can be
569  found at <ulink url="http://www.debian.org/Bugs/"></ulink>, or, if you have  found at <ulink url="&url-bts;"></ulink>, or, if you have
570  installed the <systemitem role="package">doc-debian</systemitem> package, you  installed the <systemitem role="package">doc-debian</systemitem> package, you
571  can look at the local files <filename>/usr/share/doc/debian/bug-*</filename>.  can look at the local files <filename>/usr/share/doc/debian/bug-*</filename>.
572  </para>  </para>
# Line 575  open bugs against your packages: Line 577  open bugs against your packages:
577  </para>  </para>
578  <screen>  <screen>
579  # ask for weekly reports of bugs in my packages  # ask for weekly reports of bugs in my packages
580  0 17 * * fri   echo index maint <replaceable>address</replaceable> | mail request@bugs.debian.org  &cron-bug-report;
581  </screen>  </screen>
582  <para>  <para>
583  Replace <replaceable>address</replaceable> with your official Debian maintainer  Replace <replaceable>address</replaceable> with your official Debian maintainer
# Line 588  address. Line 590  address.
590  <para>  <para>
591  When responding to bugs, make sure that any discussion you have about bugs is  When responding to bugs, make sure that any discussion you have about bugs is
592  sent both to the original submitter of the bug, and to the bug itself (e.g.,  sent both to the original submitter of the bug, and to the bug itself (e.g.,
593  <email>123@bugs.debian.org</email>).  If you're writing a new mail and you  <email>123@&bugs-host;</email>).  If you're writing a new mail and you
594  don't remember the submitter email address, you can use the  don't remember the submitter email address, you can use the
595  <email>123-submitter@bugs.debian.org</email> email to contact the submitter  <email>123-submitter@&bugs-host;</email> email to contact the submitter
596  <emphasis>and</emphasis> to record your mail within the bug log (that means you  <emphasis>and</emphasis> to record your mail within the bug log (that means you
597  don't need to send a copy of the mail to <email>123@bugs.debian.org</email>).  don't need to send a copy of the mail to <email>123@&bugs-host;</email>).
598  </para>  </para>
599  <para>  <para>
600  If you get a bug which mentions FTBFS, this means Fails to build from source.  If you get a bug which mentions FTBFS, this means Fails to build from source.
# Line 601  Porters frequently use this acronym. Line 603  Porters frequently use this acronym.
603  <para>  <para>
604  Once you've dealt with a bug report (e.g.  fixed it), mark it as  Once you've dealt with a bug report (e.g.  fixed it), mark it as
605  <emphasis>done</emphasis> (close it) by sending an explanation message to  <emphasis>done</emphasis> (close it) by sending an explanation message to
606  <email>123-done@bugs.debian.org</email>.  If you're fixing a bug by changing  <email>123-done@&bugs-host;</email>.  If you're fixing a bug by changing
607  and uploading the package, you can automate bug closing as described in <xref  and uploading the package, you can automate bug closing as described in <xref
608  linkend="upload-bugfix"/> .  linkend="upload-bugfix"/> .
609  </para>  </para>
610  <para>  <para>
611  You should <emphasis>never</emphasis> close bugs via the bug server  You should <emphasis>never</emphasis> close bugs via the bug server
612  <literal>close</literal> command sent to  <literal>close</literal> command sent to
613  <email>control@bugs.debian.org</email>.  If you do so, the original submitter  <email>control@&bugs-host;</email>.  If you do so, the original submitter
614  will not receive any information about why the bug was closed.  will not receive any information about why the bug was closed.
615  </para>  </para>
616  </section>  </section>
# Line 619  will not receive any information about w Line 621  will not receive any information about w
621  As a package maintainer, you will often find bugs in other packages or have  As a package maintainer, you will often find bugs in other packages or have
622  bugs reported against your packages which are actually bugs in other packages.  bugs reported against your packages which are actually bugs in other packages.
623  The bug tracking system's features are described in the <ulink  The bug tracking system's features are described in the <ulink
624  url="http://www.debian.org/Bugs/Developer">BTS documentation for Debian  url="&url-bts-devel;">BTS documentation for Debian
625  developers</ulink>.  Operations such as reassigning, merging, and tagging bug  developers</ulink>.  Operations such as reassigning, merging, and tagging bug
626  reports are described in the <ulink  reports are described in the <ulink
627  url="http://www.debian.org/Bugs/server-control">BTS control server  url="&url-bts-control;">BTS control server
628  documentation</ulink>.  This section contains some guidelines for managing your  documentation</ulink>.  This section contains some guidelines for managing your
629  own bugs, based on the collective Debian developer experience.  own bugs, based on the collective Debian developer experience.
630  </para>  </para>
# Line 655  unacceptable, you (or the submitter) may Line 657  unacceptable, you (or the submitter) may
657  technical committee by reassigning the bug to <systemitem  technical committee by reassigning the bug to <systemitem
658  role="package">tech-ctte</systemitem> (you may use the clone command of the BTS  role="package">tech-ctte</systemitem> (you may use the clone command of the BTS
659  if you wish to keep it reported against your package).  Before doing so, please  if you wish to keep it reported against your package).  Before doing so, please
660  read the <ulink url="http://www.debian.org/devel/tech-ctte">recommended  read the <ulink url="&url-devel-docs;tech-ctte">recommended
661  procedure</ulink>.  procedure</ulink>.
662  </para>  </para>
663  </listitem>  </listitem>
# Line 664  procedure</ulink>. Line 666  procedure</ulink>.
666  If the bug is real but it's caused by another package, just reassign the bug to  If the bug is real but it's caused by another package, just reassign the bug to
667  the right package.  If you don't know which package it should be reassigned to,  the right package.  If you don't know which package it should be reassigned to,
668  you should ask for help on <link linkend="irc-channels">IRC</link> or  you should ask for help on <link linkend="irc-channels">IRC</link> or
669  on <email>debian-devel@lists.debian.org</email>.  Please make sure that the  on <email>debian-devel@&lists-host;</email>.  Please make sure that the
670  maintainer(s) of the package the bug is reassigned to know why you reassigned  maintainer(s) of the package the bug is reassigned to know why you reassigned
671  it.  it.
672  </para>  </para>
# Line 701  someone, the bug may be closed. Line 703  someone, the bug may be closed.
703  <para>  <para>
704  If the bug is related to the packaging, you just fix it.  If you are not able  If the bug is related to the packaging, you just fix it.  If you are not able
705  to fix it yourself, then tag the bug as <literal>help</literal>.  You can also  to fix it yourself, then tag the bug as <literal>help</literal>.  You can also
706  ask for help on <email>debian-devel@lists.debian.org</email> or  ask for help on <email>debian-devel@&lists-host;</email> or
707  <email>debian-qa@lists.debian.org</email>.  If it's an upstream problem, you  <email>debian-qa@&lists-host;</email>.  If it's an upstream problem, you
708  have to forward it to the upstream author.  Forwarding a bug is not enough, you  have to forward it to the upstream author.  Forwarding a bug is not enough, you
709  have to check at each release if the bug has been fixed or not.  If it has, you  have to check at each release if the bug has been fixed or not.  If it has, you
710  just close it, otherwise you have to remind the author about it.  If you have  just close it, otherwise you have to remind the author about it.  If you have
# Line 748  file, following a certain syntax, and th Line 750  file, following a certain syntax, and th
750  close the bugs for you.  For example:  close the bugs for you.  For example:
751  </para>  </para>
752  <screen>  <screen>
753  -cannon (3.1415) unstable; urgency=low  acme-cannon (3.1415) unstable; urgency=low
754    
755    * Frobbed with options (closes: Bug#98339)    * Frobbed with options (closes: Bug#98339)
756    * Added safety to prevent operator dismemberment, closes: bug#98765,    * Added safety to prevent operator dismemberment, closes: bug#98765,
# Line 782  If you happen to mistype a bug number or Line 784  If you happen to mistype a bug number or
784  don't hesitate to undo any damage the error caused.  To reopen wrongly closed  don't hesitate to undo any damage the error caused.  To reopen wrongly closed
785  bugs, send a <literal>reopen <replaceable>XXX</replaceable></literal> command  bugs, send a <literal>reopen <replaceable>XXX</replaceable></literal> command
786  to the bug tracking system's control address,  to the bug tracking system's control address,
787  <email>control@bugs.debian.org</email>.  To close any remaining bugs that were  <email>control@&bugs-host;</email>.  To close any remaining bugs that were
788  fixed by your upload, email the <filename>.changes</filename> file to  fixed by your upload, email the <filename>.changes</filename> file to
789  <email>XXX-done@bugs.debian.org</email>, where <replaceable>XXX</replaceable>  <email>XXX-done@&bugs-host;</email>, where <replaceable>XXX</replaceable>
790  is the bug number, and put Version: YYY and an empty line as the first two  is the bug number, and put Version: YYY and an empty line as the first two
791  lines of the body of the email, where <replaceable>YYY</replaceable> is the  lines of the body of the email, where <replaceable>YYY</replaceable> is the
792  first version where the bug has been fixed.  first version where the bug has been fixed.
# Line 793  first version where the bug has been fix Line 795  first version where the bug has been fix
795  Bear in mind that it is not obligatory to close bugs using the changelog as  Bear in mind that it is not obligatory to close bugs using the changelog as
796  described above.  If you simply want to close bugs that don't have anything to  described above.  If you simply want to close bugs that don't have anything to
797  do with an upload you made, do it by emailing an explanation to  do with an upload you made, do it by emailing an explanation to
798  <email>XXX-done@bugs.debian.org</email>.  Do <emphasis  <email>XXX-done@&bugs-host;</email>.  Do <emphasis
799  role="strong">not</emphasis> close bugs in the changelog entry of a version if  role="strong">not</emphasis> close bugs in the changelog entry of a version if
800  the changes in that version of the package don't have any bearing on the bug.  the changes in that version of the package don't have any bearing on the bug.
801  </para>  </para>
# Line 931  has become public. Line 933  has become public.
933  Security advisories are only issued for the current, released stable  Security advisories are only issued for the current, released stable
934  distribution, and <emphasis>not</emphasis> for testing or unstable.  When  distribution, and <emphasis>not</emphasis> for testing or unstable.  When
935  released, advisories are sent to the  released, advisories are sent to the
936  <email>debian-security-announce@lists.debian.org</email> mailing list and  <email>debian-security-announce@&lists-host;</email> mailing list and
937  posted on <ulink url="http://www.debian.org/security/">the security web  posted on <ulink url="http://&www-debian-org;/security/">the security web
938  page</ulink>.  Security advisories are written and posted by the security team.  page</ulink>.  Security advisories are written and posted by the security team.
939  However they certainly do not mind if a maintainer can supply some of the  However they certainly do not mind if a maintainer can supply some of the
940  information for them, or write part of the text.  Information that should be in  information for them, or write part of the text.  Information that should be in
# Line 1191  chapter gives guidelines on what to do i Line 1193  chapter gives guidelines on what to do i
1193  Sometimes a package will change its section.  For instance, a package from the  Sometimes a package will change its section.  For instance, a package from the
1194  `non-free' section might be GPL'd in a later version, in which case the package  `non-free' section might be GPL'd in a later version, in which case the package
1195  should be moved to `main' or `contrib'.<footnote><para> See the <ulink  should be moved to `main' or `contrib'.<footnote><para> See the <ulink
1196  url="http://www.debian.org/doc/debian-policy/">Debian Policy Manual</ulink> for  url="&url-debian-policy;">Debian Policy Manual</ulink> for
1197  guidelines on what section a package belongs in.  </para> </footnote>  guidelines on what section a package belongs in.  </para> </footnote>
1198  </para>  </para>
1199  <para>  <para>
1200  If you need to change the section for one of your packages, change the package  If you need to change the section for one of your packages, change the package
1201  control information to place the package in the desired section, and re-upload  control information to place the package in the desired section, and re-upload
1202  the package (see the <ulink  the package (see the <ulink
1203  url="http://www.debian.org/doc/debian-policy/">Debian Policy Manual</ulink> for  url="&url-debian-policy;">Debian Policy Manual</ulink> for
1204  details).  You must ensure that you include the  details).  You must ensure that you include the
1205  <filename>.orig.tar.gz</filename> in your upload (even if you are not uploading  <filename>.orig.tar.gz</filename> in your upload (even if you are not uploading
1206  a new upstream version), or it will not appear in the new section together with  a new upstream version), or it will not appear in the new section together with
# Line 1220  described in <xref linkend="override-fil Line 1222  described in <xref linkend="override-fil
1222  <para>  <para>
1223  If for some reason you want to completely remove a package (say, if it is an  If for some reason you want to completely remove a package (say, if it is an
1224  old compatibility library which is no longer required), you need to file a bug  old compatibility library which is no longer required), you need to file a bug
1225  against <literal>ftp.debian.org</literal> asking that the package be removed;  against <literal>&ftp-debian-org;</literal> asking that the package be removed;
1226  as all bugs, this bug should normally have normal severity.  Make sure you  as all bugs, this bug should normally have normal severity.  Make sure you
1227  indicate which distribution the package should be removed from.  Normally, you  indicate which distribution the package should be removed from.  Normally, you
1228  can only have packages removed from <emphasis>unstable</emphasis> and  can only have packages removed from <emphasis>unstable</emphasis> and
# Line 1253  maintainer. Line 1255  maintainer.
1255  <para>  <para>
1256  Further information relating to these and other package removal related topics  Further information relating to these and other package removal related topics
1257  may be found at <ulink url="http://wiki.debian.org/ftpmaster_Removals"></ulink>  may be found at <ulink url="http://wiki.debian.org/ftpmaster_Removals"></ulink>
1258  and <ulink url="http://qa.debian.org/howto-remove.html"></ulink>.  and <ulink url="&url-debian-qa;howto-remove.html"></ulink>.
1259  </para>  </para>
1260  <para>  <para>
1261  If in doubt concerning whether a package is disposable, email  If in doubt concerning whether a package is disposable, email
1262  <email>debian-devel@lists.debian.org</email> asking for opinions.  Also of  <email>debian-devel@&lists-host;</email> asking for opinions.  Also of
1263  interest is the <command>apt-cache</command> program from the <systemitem  interest is the <command>apt-cache</command> program from the <systemitem
1264  role="package">apt</systemitem> package.  When invoked as <literal>apt-cache  role="package">apt</systemitem> package.  When invoked as <literal>apt-cache
1265  showpkg <replaceable>package</replaceable></literal>, the program will show  showpkg <replaceable>package</replaceable></literal>, the program will show
1266  details for <replaceable>package</replaceable>, including reverse depends.  details for <replaceable>package</replaceable>, including reverse depends.
1267  Other useful programs include <literal>apt-cache rdepends</literal>,  Other useful programs include <literal>apt-cache rdepends</literal>,
1268  <command>apt-rdepends</command> and <command>grep-dctrl</command>.  Removal of  <command>apt-rdepends</command> and <command>grep-dctrl</command>.  Removal of
1269  orphaned packages is discussed on <email>debian-qa@lists.debian.org</email>.  orphaned packages is discussed on <email>debian-qa@&lists-host;</email>.
1270  </para>  </para>
1271  <para>  <para>
1272  Once the package has been removed, the package's bugs should be handled.  They  Once the package has been removed, the package's bugs should be handled.  They
# Line 1296  occur too often anyway. Line 1298  occur too often anyway.
1298  When you make a mistake naming your package, you should follow a two-step  When you make a mistake naming your package, you should follow a two-step
1299  process to rename it.  First, set your <filename>debian/control</filename> file  process to rename it.  First, set your <filename>debian/control</filename> file
1300  to replace and conflict with the obsolete name of the package (see the <ulink  to replace and conflict with the obsolete name of the package (see the <ulink
1301  url="http://www.debian.org/doc/debian-policy/">Debian Policy Manual</ulink> for  url="&url-debian-policy;">Debian Policy Manual</ulink> for
1302  details).  Once you've uploaded the package and the package has moved into the  details).  Once you've uploaded the package and the package has moved into the
1303  archive, file a bug against <literal>ftp.debian.org</literal> asking to remove  archive, file a bug against <literal>&ftp-debian-org;</literal> asking to remove
1304  the package with the obsolete name.  Do not forget to properly reassign the  the package with the obsolete name.  Do not forget to properly reassign the
1305  package's bugs at the same time.  package's bugs at the same time.
1306  </para>  </para>
# Line 1321  mirror network. Line 1323  mirror network.
1323  <para>  <para>
1324  If you can no longer maintain a package, you need to inform others, and see  If you can no longer maintain a package, you need to inform others, and see
1325  that the package is marked as orphaned.  You should set the package maintainer  that the package is marked as orphaned.  You should set the package maintainer
1326  to <literal>Debian QA Group &lt;packages@qa.debian.org&gt;</literal> and submit  to <literal>Debian QA Group &lt;&pts-host;&gt;</literal> and submit
1327  a bug report against the pseudo package <systemitem  a bug report against the pseudo package <systemitem
1328  role="package">wnpp</systemitem>.  The bug report should be titled <literal>O:  role="package">wnpp</systemitem>.  The bug report should be titled <literal>O:
1329  <replaceable>package</replaceable> -- <replaceable>short  <replaceable>package</replaceable> -- <replaceable>short
# Line 1329  description</replaceable></literal> indi Line 1331  description</replaceable></literal> indi
1331  orphaned.  The severity of the bug should be set to  orphaned.  The severity of the bug should be set to
1332  <emphasis>normal</emphasis>; if the package has a priority of standard or  <emphasis>normal</emphasis>; if the package has a priority of standard or
1333  higher, it should be set to important.  If you feel it's necessary, send a copy  higher, it should be set to important.  If you feel it's necessary, send a copy
1334  to <email>debian-devel@lists.debian.org</email> by putting the address in the  to <email>debian-devel@&lists-host;</email> by putting the address in the
1335  X-Debbugs-CC: header of the message (no, don't use CC:, because that way the  X-Debbugs-CC: header of the message (no, don't use CC:, because that way the
1336  message's subject won't indicate the bug number).  message's subject won't indicate the bug number).
1337  </para>  </para>
# Line 1342  description</replaceable></literal>.  <l Line 1344  description</replaceable></literal>.  <l
1344  <emphasis>Request For Adoption</emphasis>.  <emphasis>Request For Adoption</emphasis>.
1345  </para>  </para>
1346  <para>  <para>
1347  More information is on the <ulink url="http://www.debian.org/devel/wnpp/">WNPP  More information is on the <ulink url="&url-wnpp;">WNPP
1348  web pages</ulink>.  web pages</ulink>.
1349  </para>  </para>
1350  </section>  </section>
# Line 1351  web pages</ulink>. Line 1353  web pages</ulink>.
1353  <title>Adopting a package</title>  <title>Adopting a package</title>
1354  <para>  <para>
1355  A list of packages in need of a new maintainer is available in the <ulink  A list of packages in need of a new maintainer is available in the <ulink
1356  url="http://www.debian.org/devel/wnpp/">Work-Needing and Prospective Packages  url="&url-wnpp;">Work-Needing and Prospective Packages
1357  list (WNPP)</ulink>.  If you wish to take over maintenance of any of the  list (WNPP)</ulink>.  If you wish to take over maintenance of any of the
1358  packages listed in the WNPP, please take a look at the aforementioned page for  packages listed in the WNPP, please take a look at the aforementioned page for
1359  information and procedures.  information and procedures.
# Line 1369  package.  Complaints about maintainers s Line 1371  package.  Complaints about maintainers s
1371  mailing list.  If the discussion doesn't end with a positive conclusion, and  mailing list.  If the discussion doesn't end with a positive conclusion, and
1372  the issue is of a technical nature, consider bringing it to the attention of  the issue is of a technical nature, consider bringing it to the attention of
1373  the technical committee (see the <ulink  the technical committee (see the <ulink
1374  url="http://www.debian.org/devel/tech-ctte">technical committee web  url="&url-devel-docs;tech-ctte">technical committee web
1375  page</ulink> for more information).  page</ulink> for more information).
1376  </para>  </para>
1377  <para>  <para>
# Line 1400  different from the original architecture Line 1402  different from the original architecture
1402  package.  It is a unique and essential activity.  In fact, porters do most of  package.  It is a unique and essential activity.  In fact, porters do most of
1403  the actual compiling of Debian packages.  For instance, for a single  the actual compiling of Debian packages.  For instance, for a single
1404  <emphasis>i386</emphasis> binary package, there must be a recompile for each  <emphasis>i386</emphasis> binary package, there must be a recompile for each
1405  architecture, which amounts to 12 more builds.  architecture, which amounts to &number-of-arches; more builds.
1406  </para>  </para>
1407  <section id="kind-to-porters">  <section id="kind-to-porters">
1408  <title>Being kind to porters</title>  <title>Being kind to porters</title>
# Line 1445  If you can't set up a proper chroot, <co Line 1447  If you can't set up a proper chroot, <co
1447  assistance (see <xref linkend="dpkg-depcheck"/> ).  assistance (see <xref linkend="dpkg-depcheck"/> ).
1448  </para>  </para>
1449  <para>  <para>
1450  See the <ulink url="http://www.debian.org/doc/debian-policy/">Debian Policy  See the <ulink url="&url-debian-policy;">Debian Policy
1451  Manual</ulink> for instructions on setting build dependencies.  Manual</ulink> for instructions on setting build dependencies.
1452  </para>  </para>
1453  </listitem>  </listitem>
# Line 1453  Manual</ulink> for instructions on setti Line 1455  Manual</ulink> for instructions on setti
1455  <para>  <para>
1456  Don't set architecture to a value other than ``all'' or ``any'' unless you  Don't set architecture to a value other than ``all'' or ``any'' unless you
1457  really mean it.  In too many cases, maintainers don't follow the instructions  really mean it.  In too many cases, maintainers don't follow the instructions
1458  in the <ulink url="http://www.debian.org/doc/debian-policy/">Debian Policy  in the <ulink url="&url-debian-policy;">Debian Policy
1459  Manual</ulink>.  Setting your architecture to ``i386'' is usually incorrect.  Manual</ulink>.  Setting your architecture to ``i386'' is usually incorrect.
1460  </para>  </para>
1461  </listitem>  </listitem>
# Line 1646  tools; see the package documentation or Line 1648  tools; see the package documentation or
1648  <title>Mailing lists and web pages</title>  <title>Mailing lists and web pages</title>
1649  <para>  <para>
1650  Web pages containing the status of each port can be found at <ulink  Web pages containing the status of each port can be found at <ulink
1651  url="http://www.debian.org/ports/"></ulink>.  url="&url-debian-ports;"></ulink>.
1652  </para>  </para>
1653  <para>  <para>
1654  Each port of Debian has a mailing list.  The list of porting mailing lists can  Each port of Debian has a mailing list.  The list of porting mailing lists can
1655  be found at <ulink url="http://lists.debian.org/ports.html"></ulink>.  These  be found at <ulink url="&url-debian-port-lists;"></ulink>.  These
1656  lists are used to coordinate porters, and to connect the users of a given port  lists are used to coordinate porters, and to connect the users of a given port
1657  with the porters.  with the porters.
1658  </para>  </para>
# Line 1688  such as <command>andrea</command> and <c Line 1690  such as <command>andrea</command> and <c
1690  <para>  <para>
1691  Some of the data produced by <systemitem role="package">buildd</systemitem>  Some of the data produced by <systemitem role="package">buildd</systemitem>
1692  which is generally useful to porters is available on the web at <ulink  which is generally useful to porters is available on the web at <ulink
1693  url="http://buildd.debian.org/"></ulink>.  This data includes nightly updated  url="&url-buildd;"></ulink>.  This data includes nightly updated
1694  information from <command>andrea</command> (source dependencies) and  information from <command>andrea</command> (source dependencies) and
1695  <systemitem role="package">quinn-diff</systemitem> (packages needing  <systemitem role="package">quinn-diff</systemitem> (packages needing
1696  recompilation).  recompilation).
# Line 1744  In order to prevent autobuilders from ne Line 1746  In order to prevent autobuilders from ne
1746  it must be included in <filename>packages-arch-specific</filename>, a list used  it must be included in <filename>packages-arch-specific</filename>, a list used
1747  by the <command>wanna-build</command> script.  The current version is available  by the <command>wanna-build</command> script.  The current version is available
1748  as <ulink  as <ulink
1749  url="http://cvs.debian.org/srcdep/Packages-arch-specific?cvsroot=dak"></ulink>;  url="&url-cvsweb;srcdep/Packages-arch-specific?cvsroot=dak"></ulink>;
1750  please see the top of the file for whom to contact for changes.  please see the top of the file for whom to contact for changes.
1751  </para>  </para>
1752  </listitem>  </listitem>
# Line 1756  architectures: A porter or any other per Line 1758  architectures: A porter or any other per
1758  accidently upload it without noticing it doesn't work.  If in the past some  accidently upload it without noticing it doesn't work.  If in the past some
1759  binary packages were uploaded on unsupported architectures, request their  binary packages were uploaded on unsupported architectures, request their
1760  removal by filing a bug against <systemitem  removal by filing a bug against <systemitem
1761  role="package">ftp.debian.org</systemitem>  role="package">&ftp-debian-org;</systemitem>
1762  </para>  </para>
1763  </section>  </section>
1764    
# Line 2029  linkend="collaborative-maint"/> ). Line 2031  linkend="collaborative-maint"/> ).
2031  Unless you know the maintainer is still active, it is wise to check the package  Unless you know the maintainer is still active, it is wise to check the package
2032  to see if it has been orphaned.  The current list of orphaned packages which  to see if it has been orphaned.  The current list of orphaned packages which
2033  haven't had their maintainer set correctly is available at <ulink  haven't had their maintainer set correctly is available at <ulink
2034  url="http://qa.debian.org/orphaned.html"></ulink>.  If you perform an NMU on an  url="&url-debian-qa-orphaned;"></ulink>.  If you perform an NMU on an
2035  improperly orphaned package, please set the maintainer to ``Debian QA Group  improperly orphaned package, please set the maintainer to ``Debian QA Group
2036  &lt;packages@qa.debian.org&gt;''.  &lt;&pts-host;&gt;''.
2037  </para>  </para>
2038  </section>  </section>
2039    
# Line 2122  Add the co-maintainer's correct maintain Line 2124  Add the co-maintainer's correct maintain
2124  <filename>debian/control</filename> file.  <filename>debian/control</filename> file.
2125  </para>  </para>
2126  <screen>  <screen>
2127  : John Buzz &lt;jbuzz@debian.org&gt;, Adam Rex &lt;arex@debian.org&gt;  Uploaders: John Buzz &lt;jbuzz@debian.org&gt;, Adam Rex &lt;arex@debian.org&gt;
2128  </screen>  </screen>
2129  </listitem>  </listitem>
2130  <listitem>  <listitem>
# Line 2236  all the necessary criteria); Line 2238  all the necessary criteria);
2238  <para>  <para>
2239  To find out whether a package is progressing into testing or not, see the  To find out whether a package is progressing into testing or not, see the
2240  testing script output on the <ulink  testing script output on the <ulink
2241  url="http://www.debian.org/devel/testing">web page of the testing  url="&url-devel-docs;testing">web page of the testing
2242  distribution</ulink>, or use the program <command>grep-excuses</command> which  distribution</ulink>, or use the program <command>grep-excuses</command> which
2243  is in the <systemitem role="package">devscripts</systemitem> package.  This  is in the <systemitem role="package">devscripts</systemitem> package.  This
2244  utility can easily be used in a <citerefentry>  utility can easily be used in a <citerefentry>
# Line 2248  to keep yourself informed of the progres Line 2250  to keep yourself informed of the progres
2250  The <filename>update_excuses</filename> file does not always give the precise  The <filename>update_excuses</filename> file does not always give the precise
2251  reason why the package is refused; you may have to find it on your own by  reason why the package is refused; you may have to find it on your own by
2252  looking for what would break with the inclusion of the package.  The <ulink  looking for what would break with the inclusion of the package.  The <ulink
2253  url="http://www.debian.org/devel/testing">testing web page</ulink> gives some  url="&url-devel-docs;testing">testing web page</ulink> gives some
2254  more information about the usual problems which may be causing such troubles.  more information about the usual problems which may be causing such troubles.
2255  </para>  </para>
2256  <para>  <para>
# Line 2401  considered for update. Line 2403  considered for update.
2403  </para>  </para>
2404  <para>  <para>
2405  Currently, this requires some manual hinting from the release team.  Please  Currently, this requires some manual hinting from the release team.  Please
2406  contact them by sending mail to <email>debian-release@lists.debian.org</email>  contact them by sending mail to <email>debian-release@&lists-host;</email>
2407  if this happens to one of your packages.  if this happens to one of your packages.
2408  </para>  </para>
2409  </section>  </section>
# Line 2449  so important for you.) Line 2451  so important for you.)
2451  </para>  </para>
2452  <para>  <para>
2453  If you want to see more details, you can look it up on  If you want to see more details, you can look it up on
2454  merkel:/org/ftp.debian.org/testing/update_out/ (or there in  merkel:/org/&ftp-debian-org;/testing/update_out/ (or there in
2455  ~aba/testing/update_out to see a setup with a smaller packages file).  Via web,  ~aba/testing/update_out to see a setup with a smaller packages file).  Via web,
2456  it's at <ulink  it's at <ulink
2457  url="http://ftp-master.debian.org/testing/update_out_code/"></ulink>  url="http://&ftp-master-host;/testing/update_out_code/"></ulink>
2458  </para>  </para>
2459  <para>  <para>
2460  The hints are available via <ulink  The hints are available via <ulink
2461  url="http://ftp-master.debian.org/testing/hints/"></ulink>.  url="http://&ftp-master-host;/testing/hints/"></ulink>.
2462  </para>  </para>
2463  </section>  </section>
2464    
# Line 2475  Keep in mind that packages uploaded ther Line 2477  Keep in mind that packages uploaded ther
2477  have to go through the hands of the release manager.  So you'd better have a  have to go through the hands of the release manager.  So you'd better have a
2478  good reason to upload there.  In order to know what a good reason is in the  good reason to upload there.  In order to know what a good reason is in the
2479  release managers' eyes, you should read the instructions that they regularly  release managers' eyes, you should read the instructions that they regularly
2480  give on <email>debian-devel-announce@lists.debian.org</email>.  give on <email>debian-devel-announce@&lists-host;</email>.
2481  </para>  </para>
2482  <para>  <para>
2483  You should not upload to <emphasis>testing-proposed-updates</emphasis> when you  You should not upload to <emphasis>testing-proposed-updates</emphasis> when you
# Line 2533  and lower than in <emphasis>unstable</em Line 2535  and lower than in <emphasis>unstable</em
2535  <listitem>  <listitem>
2536  <para>  <para>
2537  After uploading and successful build on all platforms, contact the release team  After uploading and successful build on all platforms, contact the release team
2538  at <email>debian-release@lists.debian.org</email> and ask them to approve your  at <email>debian-release@&lists-host;</email> and ask them to approve your
2539  upload.  upload.
2540  </para>  </para>
2541  </listitem>  </listitem>

Legend:
Removed from v.4909  
changed lines
  Added in v.4910

  ViewVC Help
Powered by ViewVC 1.1.5