Bug#490693: dpkg-source: Clarifications in the man page

[Benjamin Mesing-2]

Package: dpkg-dev
Version: 1.14.20
Severity: minor
File: /usr/bin/dpkg-source


I've noted the following things when studying the man page of
dpkg-source
      * In the section "Building" of the description of 3.0 (quilt) it
        is stated:
        "The  updated  debian  directory  and  the  list of modified
        binaries is then used to regenerate the debian tarball."
        Why is it "regenerate" instead of "generate" here? I believe, it
        is not uncommon, that no debian tarball exists before.
      * In the same section there is a note:
        "Note: dpkg-source expects the source tree to have all patches
        applied when you generate the  source package.  This is not the
        case when the source tree has been obtained by unpacking a
        source package using the Format: 1.0 for instance."
        However, from my understanding unpacking format 1.0 packages
        does lead to a tree with the main ".diff" applied, and
        thus a fully patched source unless a patch system is used.

Please review the thread on debian-mentors about those points [1].

Btw. the manpage of dpkg-source is very well written, and gives a lot
of valuable information! Those are only minor points of confusion.

Best regards

Ben

[1] http://lists.debian.org/debian-mentors/2008/07/msg00279.html


-- no debconf information




--
To UNSUBSCRIBE, email to debian-dpkg-bugs-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Raphael Hertzog-3]

Hi,

On Sun, 13 Jul 2008, Benjamin Mesing wrote:
> I've noted the following things when studying the man page of
> dpkg-source
>       * In the section "Building" of the description of 3.0 (quilt) it
>         is stated:
>         "The  updated  debian  directory  and  the  list of modified
>         binaries is then used to regenerate the debian tarball."
>         Why is it "regenerate" instead of "generate" here? I believe, it
>         is not uncommon, that no debian tarball exists before.

Right.

>       * In the same section there is a note:
>         "Note: dpkg-source expects the source tree to have all patches
>         applied when you generate the  source package.  This is not the
>         case when the source tree has been obtained by unpacking a
>         source package using the Format: 1.0 for instance."
>         However, from my understanding unpacking format 1.0 packages
> does lead to a tree with the main ".diff" applied, and
> thus a fully patched source unless a patch system is used.

I'm referring to "quilt patches" aka patches listed debian/patches/series
here.

I fixed this in the git repo:
http://git.debian.org/?p=dpkg/dpkg.git;a=commitdiff;h=77e9ff0a2dd78d36772dcc88aeb337d862b45490

Thanks for the feedback!
--
Raphaël Hertzog

Le best-seller français mis à jour pour Debian Etch :
http://www.ouaza.com/livre/admin-debian/




--
To UNSUBSCRIBE, email to debian-dpkg-bugs-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...