From b8dfa4da38b239a0e100f924ff39c0bc09dcd6fe Mon Sep 17 00:00:00 2001 From: aba Date: Sun, 5 Sep 2004 19:12:54 +0000 Subject: [PATCH] fix 235213 git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@2563 313b444b-1b9f-4f58-a734-7bb04f332e8d --- debian/changelog | 5 +- developers-reference.sgml | 152 ++++++++++++++++---------------------- 2 files changed, 66 insertions(+), 91 deletions(-) diff --git a/debian/changelog b/debian/changelog index eae153a..1bfb1d1 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,10 +1,13 @@ developers-reference (3.3.5) unstable; urgency=low + * Andreas Barth + - uploads to more than one dist are not possible. + - updated upload queues. Closes: #235213 * Matt Zimmerman - Security uploads get urgency=high - Be even more explicit about not uploading security updates - -- Matt Zimmerman Sat, 12 Jun 2004 09:34:32 -0700 + -- Andreas Barth Sun, 5 Sep 2004 12:48:32 -0600 developers-reference (3.3.4) unstable; urgency=low diff --git a/developers-reference.sgml b/developers-reference.sgml index dc01e2a..b3e967b 100644 --- a/developers-reference.sgml +++ b/developers-reference.sgml @@ -6,7 +6,7 @@ %commondata; - + @@ -1676,11 +1676,8 @@ Actually, there are two other possible distributions: `stable-security' and `testing-security', but read for more information on those.

-It is technically possible to upload a package into several distributions -at the same time but it usually doesn't make sense to use that feature -because the dependencies of the package may vary with the distribution. -In particular, it never makes sense to combine the experimental -distribution with anything else (see ). +It is not possible to upload a package into several distributions +at the same time. Special case: uploads to the stable distribution @@ -1746,25 +1743,17 @@ the authorization of the release manager before. Uploading to ftp-master

-To upload a package, you need a personal account on -&ftp-master-host;, which you should have as an -official maintainer. If you use scp or rsync -to transfer the files, place them into &us-upload-dir;; -if you use anonymous FTP to upload, place them into -&upload-queue;. -

-If you want to use the feature described in , -you'll have to upload to ftp-master. It is the only upload -point that supports delayed incoming. +To upload a package, you should upload the files (including the signed +changes and dsc-file) with anonymous ftp to +&ftp-master-host; in the directory &upload-queue;. +To get the files processed there, they need to be signed with a key in the +debian keyring.

Please note that you should transfer the changes file last. Otherwise, your upload may be rejected because the archive maintenance software will parse the changes file and see that not -all files have been uploaded. If you don't want to bother with transferring -the changes file last, you can simply copy your files to a temporary -directory on ftp-master and then move them to -&us-upload-dir;. -

+all files have been uploaded. +

Note: Do not upload to ftp-master cryptographic packages which belong to contrib or non-free. Uploads of such software should go to non-us (see ftp-master; depending on the case they may still be uploaded to non-US/non-free (it's in non-free because of distribution issues and not because of the license of the software). If you can't upload it to -ftp-master, then neither can you upload it to the overseas upload -queues on chiark or erlangen. If you are not sure +ftp-master, then neither can you upload it to backup +queues that finally also end up on ftp-master. If you are not sure whether U.S. patent controls or cryptographic controls apply to your package, post a message to &email-debian-devel; and ask.

You may also find the Debian packages or useful -when uploading packages. These handy programs help automate the +when uploading packages. These handy programs help automate the process of uploading packages into Debian.

-After uploading your package, you can check how the archive -maintenance software will process it by running dinstall -on your changes file: -dinstall -n foo.changes -

-Note that dput can do this for you automatically. +For removing packages, please see the README file in that ftp directory, +and the Debian package . Uploading to non-US

-As discussed above, export controlled software should not be uploaded -to ftp-master. Instead, upload the package to -non-us.debian.org, placing the files in -&non-us-upload-dir; (again, both and can do this for you if invoked properly). By default, -you can use the same account/password that works on -ftp-master. If you use anonymous FTP to upload, place the -files into &upload-queue;. +Note: non-us is currently not processed any more.

-You can check your upload the same way it's done on ftp-master, -with: -dinstall -n foo.changes +As discussed above, export controlled software should not be uploaded +to ftp-master. Instead, upload the package with anonymous FTP +to non-us.debian.org, placing the files in +&upload-queue; (again, both and can do this for you if invoked properly).

Note that U.S. residents or citizens are subject to restrictions on export of cryptographic software. As of this writing, U.S. citizens @@ -1834,64 +1814,50 @@ advice. Again, it is strongly recommended that U.S. citizens and residents consult a lawyer before doing uploads to non-US. - Uploads via chiark -

-If you have a slow network connection to ftp-master, there are -alternatives. One is to upload files to Incoming via a -upload queue in Europe on chiark. For details connect to -. -

-Note: Do not upload packages containing software that is -export-controlled by the United States government to the queue on -chiark. Since this upload queue goes to ftp-master, the -prescription found in applies here as well. + Delayed uploads

-The program dupload comes with support for uploading to -chiark; please refer to the documentation that comes with the -program for details. - - - Uploads via erlangen +Delayed uploads are done for the moment via the delayed queue at +gluck. The upload-directory is +gluck:~tfheen/DELAYED/[012345678]-day. +0-day is uploaded approximately one hour before dinstall runs.

-Another upload queue is available in Germany: just upload the files -via anonymous FTP to . -

-The upload must be a complete Debian upload, as you would put it into -ftp-master's Incoming, i.e., a .changes files -along with the other files mentioned in the .changes. The -queue daemon also checks that the .changes is correctly -signed with GnuPG or OpenPGP by a Debian developer, so that no bogus files can find -their way to ftp-master via this queue. Please also make sure that -the Maintainer field in the .changes contains -your e-mail address. The address found there is used for all -replies, just as on ftp-master. -

-There's no need to move your files into a second directory after the -upload, as on chiark. And, in any case, you should get a -mail reply from the queue daemon explaining what happened to your -upload. Hopefully it should have been moved to ftp-master, but in -case of errors you're notified, too. +With a fairly recent dput, this section + +[tfheen_delayed] +method = scp +fqdn = gluck.debian.org +incoming = ~tfheen + +in ~/.dput.cf should work fine for uploading to the DELAYED queue.

-Note: Do not upload packages containing software that is -export-controlled by the United States government to the queue on -erlangen. Since this upload queue goes to ftp-master, the +Note: +Since this upload queue goes to ftp-master, the prescription found in applies here as well. -

-The program dupload comes with support for uploading to -erlangen; please refer to the documentation that comes with -the program for details. + Security uploads +

+Do NOT upload a package to the security upload queue (oldstable-security, +stable-security, etc.) without prior authorization from the security +team. If the package does not exactly meet the team's requirements, it +will cause many problems and delays in dealing with the unwanted upload. +For details, please see section . Other upload queues

-Another upload queue is available which is based in the US, and is a -good backup when there are problems reaching ftp-master. You can -upload files, just as in erlangen, to . +The scp queues on ftp-master, non-us and security are mostly unuseable +due to the login restrictions on those hosts.

-An upload queue is available in Japan: just upload the files via -anonymous FTP to . - +The anonymous queues on ftp.uni-erlangen.de and ftp.uk.debian.org are +currently down. Work is underway to resurrect those. +

+The queues on master.debian.org, samosa.debian.org, master.debian.or.jp +and ftp.chiark.greenend.org.uk are down permanently and will not be +resurrected. The queue in Japan will be replaced with a new queue on +hp.debian.or.jp some day. +

+For the time being, the anonymous ftp queue on auric.debian.org (the +former ftp-master) works, but it is deprecated and will be removed at +some point in the future. Notification that a new package has been installed @@ -4425,6 +4391,12 @@ check the GnuPG signature and checksums before uploading, and the possibility of running dinstall in dry-run mode after the upload. + + dcut +

+The dcut script (part of the package ) +helps in removing files from the ftp upload directory. + -- 2.30.2