| 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> |
| 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> |
| 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). |
| 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> |
| 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 |
| 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> |
| 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> |
| 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 |
|
|
| 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> |
| 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> |
| 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 |
| 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. |
| 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> |
| 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> |
| 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> |
| 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> |
| 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 |
| 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, |
| 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. |
| 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> |
| 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 |
| 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 |
| 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 |
| 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 |
| 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> |
| 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 <packages@qa.debian.org></literal> and submit |
to <literal>Debian QA Group <&pts-host;></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 |
| 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> |
| 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> |
| 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. |
| 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> |
| 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> |
| 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> |
| 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> |
| 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> |
| 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). |
| 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> |
| 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 |
|
|
| 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 |
<packages@qa.debian.org>''. |
<&pts-host;>''. |
| 2037 |
</para> |
</para> |
| 2038 |
</section> |
</section> |
| 2039 |
|
|
| 2124 |
<filename>debian/control</filename> file. |
<filename>debian/control</filename> file. |
| 2125 |
</para> |
</para> |
| 2126 |
<screen> |
<screen> |
| 2127 |
: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org> |
Uploaders: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org> |
| 2128 |
</screen> |
</screen> |
| 2129 |
</listitem> |
</listitem> |
| 2130 |
<listitem> |
<listitem> |
| 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> |
| 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> |
| 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> |
| 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 |
|
|
| 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 |
| 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> |