Re: maint-guide update (pbuilder, linda, orig.tar.gz etc.)

[joe@nahmias.net (Joseph Nahmias)]

Hi Osamu,

I found a number of corrections to make.  I have attached my version and
here is a wdiff from yours:

=================8<===============
9.3 The orig.tar.gz file

If you simply copy {+the+} contents of {+the+} debian/ directory from
{+the+} old package into {+the+} new upstream version of {+the+} source
tree and try to build package, you may end up with {+the+} unintended
result of creating a native source [-package-] {+package,+} which comes
without {+a+} diff.gz file.  This type of packaging is {+only+} allowed
for [-the packages-] {+software+} made [-only-] {+strictly+} for {+use
in+} Debian. [2]

[-Here,-] {+Otherwise,+} you must have the upstream [-tar ball-]
{+tarball+} as {+an+} orig.tar.gz file in the parent directory. Usually,
this [-tar ball-] {+tarball+} should untar to a source tree rooting from
a directory with [-a-] {+the+} name <packagename>-<upstream_version>/.
In this [-cases,-] {+case, the+} orig.tar.gz source file can be obtained
by simply [-rename-] {+renaming the+} upstream [-tar ball-] {+tarball+}
to [-the original file name-]
<packagename>_<upstream_version>.orig.tar.gz . Please note that [-the-]
2 changes exist between {+the+} source tree directory name and the tar
[-file name:-] {+filename:+}

    * Change {+the+} hyphen "-" {+between the package name and the version+} to {+an+} underscore "_"
    * [-Add "orig." before "tar.gz."-] {+Append ".orig.tar.gz"+}

The dh_make command usually takes care {+of the+} creation of {+the+} orig.tar.gz file. 
----------
[2]
Some people argue that, even for [-the-] Debian specific [-package,-]
{+packages,+} it is [-a-] {+still+} better practice to package the
contents of {+the+} debian/ directory [-residing not-] in [-the
orig.tar.gz-] {+a diff.gz+} file [-but-] {+rather than+} in the
[-diff.gz-] {+orig.tar.gz+} file.
=================>8===============

Feel free to ask any questions you have about my changes.

Hope this helps,
--Joe

9.3 The orig.tar.gz file

If you simply copy the contents of the debian/ directory from the old
package into the new upstream version of the source tree and try to build
package, you may end up with the unintended result of creating a native
source package, which comes without a diff.gz file.  This type of
packaging is only allowed for software made strictly for use in Debian. [2]

Otherwise, you must have the upstream tarball as an orig.tar.gz file in
the parent directory. Usually, this tarball should untar to a source tree
rooting from a directory with the name <packagename>-<upstream_version>/.
In this case, the orig.tar.gz source file can be obtained by simply
renaming the upstream tarball to
<packagename>_<upstream_version>.orig.tar.gz . Please note that 2 changes
exist between the source tree directory name and the tar filename:

    * Change the hyphen "-" between the package name and the version to an underscore "_"
    * Append ".orig.tar.gz"

The dh_make command usually takes care of the creation of the orig.tar.gz file. 
----------
[2]
Some people argue that, even for Debian specific packages, it is still
better practice to package the contents of the debian/ directory in a diff.gz
file rather than in the orig.tar.gz file.