X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=blobdiff_plain;f=developers-reference.sgml;h=0b0de53fac9614ff1b7301e56bd6819a400ff0e0;hp=af972e7fc7ae67b7b5508c071192ec50b7277b37;hb=d8f60cb36cd4fd22d02851d4465749f4233391da;hpb=eb93665f453f3dbb7e8813a722cc2c3f7099a578 diff --git a/developers-reference.sgml b/developers-reference.sgml index af972e7..0b0de53 100644 --- a/developers-reference.sgml +++ b/developers-reference.sgml @@ -5,7 +5,7 @@ %commondata; - + @@ -928,7 +928,7 @@ better feel of what is going on, and what is new, in the project. Changes that you make to the package need to be recorded in the debian/changelog. These changes should provide a concise description of what was changed, why (if it's in doubt), and note if -any bugs were closed. They also record when the packages was +any bugs were closed. They also record when the package was completed. This file will be installed in /usr/share/doc/package/changelog.Debian.gz, or /usr/share/doc/package/changelog.gz for native @@ -937,14 +937,14 @@ packages. The debian/changelog file conform to a certain structure, with a number of different fields. One field of note, the distribution, is described in . More -information about the structure structure of this file can be found in +information about the structure of this file can be found in the Debian Policy section titled "debian/changelog".

Changelog entries can be used to automatically close Debian bugs when the package is installed into the archive. See .

-It is conventional that the changelog entry notating that the package +It is conventional that the changelog entry notating of a package that contains a new upstream version of the software looks like this: * new upstream version @@ -1149,7 +1149,7 @@ directory on ftp-master and then move them to

Note: Do not upload to ftp-master packages containing software that is patent-restricted by the United States -government, any cryptographic packages which belong in +government, nor any cryptographic packages which belong to contrib or non-free. If you can't upload it to ftp-master, then neither can you upload it to the overseas upload queues on chiark or erlangen. Uploads of @@ -1162,7 +1162,7 @@ You may also find the Debian packages dupload or dput useful when uploading packages. These handy program are distributed with defaults for uploading via ftp to ftp-master, -chiark, and erlangen. It can also be configured to +chiark, and erlangen. They can also be configured to use ssh or rsync. See , and for more information. @@ -1194,8 +1194,8 @@ restriction has been waived for software which is already available outside the U.S. Therefore, any cryptographic software which belongs in the main section of the Debian archive and does not depend on any package outside of main (e.g., does not depend on -anything in non-US/main) can be uploaded to ftp-master or its -queues, described above. +anything in non-US/main) can be uploaded to ftp-master +or its queues, described above.

Debian policy does not prevent upload to non-US by U.S. residents or citizens, but care should be taken in doing so. It is recommended that @@ -2235,7 +2235,7 @@ favor of debhelper. However, it's not a bug to use

yada is another packaging helper tool. It uses a debian/packages file to auto-generate -debian/rules other necessary files in the +debian/rules and other necessary files in the debian/ subdirectory.

Note that yada is called "essentially unmaintained" @@ -2306,7 +2306,7 @@ The debootstrap package and script allows you to By "base system", we mean the bare minimum of packages required to operate and install the rest of the system.

-Having a system link this can be useful in many ways. For instance, +Having a system like this can be useful in many ways. For instance, you can chroot into it if you want to test your build depends. Or, you can test how your package behaves when installed into a bare base system.