Bug#105535: debian-policy should not be concerned with the internal structure of a source package
package: debian-policy version: 3.5.5.0 -- C.4 Unpacking a Debian source package without dpkg-source dpkg-source -x is the recommended way to unpack a Debian source package. However, if it is not available it is possible to unpack a Debian source archive as follows: 1. Untar the tarfile, which will create a .orig directory. 2. Rename the .orig directory to package-version. 3. Create the subdirectory debian at the top of the source tree. 4. Apply the diff using patch -p0. 5. Untar the tarfile again if you want a copy of the original source code alongside the Debianised version. It is not possible to generate a valid Debian source archive without using dpkg-source. In particular, attempting to use diff directly to generate the .diff.gz file will not work. -- Very many(most?) source packages do NOT unpack their .orig.tar.gz to foo-ver.orig/. Also, the above paragraph does not consider debian-native packages. This paragraph also does not allow the internal format of a src pkg to be changed, which would make a new format more difficult to work with. I would prefer to see this section removed, tbh.
Bug#105538: section C.2.3(in html format) has an incorrectly formated changelog example
package: debian-policy version: 3.5.5.0 -- That format is a series of entries like this: package (version) distribution(s); urgency=urgency * change details more change details * even more change details -- maintainer name and email address date package and version are the source package name and version number. -- The proper format, with proper spacing, is: package (version) distribution(s); urgency=urgency [optional blank line(s), stripped] changelog details [blank line(s), included in output of dpkg-parsechangelog] changelog details [optional blank line(s), stripped] -- maintainer name and email address[2 spaces]date Again, I am not sure how details -policy should be about things, as it makes changing them difficult(for extension purposes)
Bug#105535: debian-policy should not be concerned with the internal structure of a source package
Adam Heath wrote: > C.4 Unpacking a Debian source package without dpkg-source > >dpkg-source -x is the recommended way to unpack a Debian source >package. However, if it is not available it is possible to unpack a >Debian source archive as follows: > 1. Untar the tarfile, which will create a .orig directory. > 2. Rename the .orig directory to package-version. > 3. Create the subdirectory debian at the top of the source tree. > 4. Apply the diff using patch -p0. > 5. Untar the tarfile again if you want a copy of the original source >code alongside the Debianised version. > >It is not possible to generate a valid Debian source archive without >using dpkg-source. In particular, attempting to use diff directly to >generate the .diff.gz file will not work. > -- > > Very many(most?) source packages do NOT unpack their .orig.tar.gz to > foo-ver.orig/. Also, the above paragraph does not consider debian-native > packages. > > This paragraph also does not allow the internal format of a src pkg to be > changed, which would make a new format more difficult to work with. I would > prefer to see this section removed, tbh. This section used to be part of the debian packaging manual. Having documentation available to allow by-hand unpacking of a source package is pretty important from a security and general utility point of view. It does not, of course, belong in policy. -- see shy jo
Bug#105535: debian-policy should not be concerned with the internal structure of a source package
> "Joey" == Joey Hess <[EMAIL PROTECTED]> writes: Joey> This section used to be part of the debian packaging Joey> manual. Having documentation available to allow by-hand Joey> unpacking of a source package is pretty important from a Joey> security and general utility point of view. It does not, of Joey> course, belong in policy. I agree the text does not belong in policy, but I believe that we should as a matter of policy adopt a particular source and binary packaging format and that format should be documented somewhere. We could alternatively say that whatever dpkg-dev handles is by definition a Debian source package. The disadvantage of doing this is that then we don't have an interface from which to write other tools that manipulate source packages.
Bug#105535: debian-policy should not be concerned with the internal structure of a source package
On Mon, Jul 16, 2001 at 05:54:18AM -0500, Adam Heath wrote: > package: debian-policy > version: 3.5.5.0 > > -- > C.4 Unpacking a Debian source package without dpkg-source Please read the general caveat at the beginning of the appendices: these are taken verbatim from the old packaging manual and are provided as a service until they can generally be incorporated effectively, correctly and appropriately into the body of the policy document. They do not carry any weight of policy, and policy supersedes them when in conflict. Julian -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Julian Gilbey, Dept of Maths, Queen Mary, Univ. of London Debian GNU/Linux Developer, see http://people.debian.org/~jdg Donate free food to the world's hungry: see http://www.thehungersite.com/
