From c861af93c7aaa3d683e6f8b922140e23a25164ed Mon Sep 17 00:00:00 2001 From: joy Date: Thu, 18 Oct 2001 00:38:35 +0000 Subject: [PATCH] reordered some subsections in the section about package uploads, it wasn't organized git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@1274 313b444b-1b9f-4f58-a734-7bb04f332e8d --- developers-reference.sgml | 111 +++++++++++++++++++------------------- 1 file changed, 56 insertions(+), 55 deletions(-) diff --git a/developers-reference.sgml b/developers-reference.sgml index f64955c..c5fb33c 100644 --- a/developers-reference.sgml +++ b/developers-reference.sgml @@ -5,7 +5,7 @@ %commondata; - + @@ -915,11 +915,38 @@ better feel of what is going on, and what is new, in the project. + Checking the package prior to upload +

+Before you upload your package, you should do basic testing on it. At +a minimum, you should try the following activities (you'll need to +have an older version of the same Debian package around): + + +Install the package and make sure the software works, or upgrade the +package from an older version to your new version if a Debian package +for it already exists. + +Run lintian over the package. You can run +lintian as follows: lintian -v +package-version.changes. This will check the source +package as well as the binary package. If you don't understand the +output that lintian generates, try adding the -i +switch, which will cause lintian to output a very verbose +description of the problem. +

+Normally, a package should not be uploaded if it causes lintian +to emit errors (they will start with E). +

+For more information on lintian, see . + +Downgrade the package to the previous version (if one exists) — this +tests the postrm and prerm scripts. + +Remove the package, then reinstall it. + - Uploading a package - - Generating the changes file + Generating the changes file

When a package is uploaded to the Debian FTP archive, it must be accompanied by a .changes file, which gives directions to the @@ -934,29 +961,10 @@ All of these fields are mandatory for a Debian upload. See the list of control fields in the for the contents of these fields. You can close bugs automatically using the Description field, see . Only the Distribution field is -discussed in this section, since it relates to the archive maintenance -policies. +id="upload-bugfix">. - Picking a distribution -

-Notably, the Distribution field, which originates from the -debian/changelog file, indicates which distribution the -package is intended for. There are four possible values for this -field: `stable', `unstable', `frozen', or `experimental'; these values -can also be combined. Or, if Debian has been frozen, and you -want to get a bug-fix release into frozen, you would set the -distribution to `frozen unstable'. (See for -more information on when to upload to frozen.) Note that it -never makes sense to combine the experimental distribution with -anything else. -

-You should avoid combining `stable' with others because of potential -problems with library dependencies (for your package and for the package -built by the build daemons for other architecture). -See for more information on when and how to -upload to stable. + The original source tarball

The first time a version is uploaded which corresponds to a particular upstream version, the original source tar file should be uploaded and @@ -979,6 +987,28 @@ is some reason why this is not the case, the new version of the original source should be uploaded, possibly by using the -sa flag. + + Picking a distribution +

+The Distribution field, which originates from the +debian/changelog file, indicates which distribution the +package is intended for. +

+There are four possible values for this +field: `stable', `unstable', `frozen', or `experimental'; these values +can also be combined. Or, if Debian has been frozen, and you +want to get a bug-fix release into frozen, you would set the +distribution to `frozen unstable'. (See for +more information on when to upload to frozen.) Note that it +never makes sense to combine the experimental distribution with +anything else. +

+You should avoid combining `stable' with others because of potential +problems with library dependencies (for your package and for the package +built by the build daemons for other architecture). +See for more information on when and how to +upload to stable. + Uploading to frozen

The Debian freeze is a crucial time for Debian. It is our chance to @@ -1058,36 +1088,7 @@ inclusion. - Checking the package prior to upload -

-Before you upload your package, you should do basic testing on it. At -a minimum, you should try the following activities (you'll need to -have an older version of the same Debian package around): - - -Install the package and make sure the software works, or upgrade the -package from an older version to your new version if a Debian package -for it already exists. - -Run lintian over the package. You can run -lintian as follows: lintian -v -package-version.changes. This will check the source -package as well as the binary package. If you don't understand the -output that lintian generates, try adding the -i -switch, which will cause lintian to output a very verbose -description of the problem. -

-Normally, a package should not be uploaded if it causes lintian -to emit errors (they will start with E). -

-For more information on lintian, see . - -Downgrade the package to the previous version (if one exists) — this -tests the postrm and prerm scripts. - -Remove the package, then reinstall it. - - + Uploading a package Uploading to ftp-master

-- 2.30.2