[Build-common-hackers] Bug#485069: cdbs: suggested text to be referenced from README.source

Jay Berkenbilt qjb at debian.org
Sun Jun 8 01:20:53 UTC 2008


Package: cdbs
Version: 0.4.52
Severity: wishlist


I have created a README.source file for one of my packages that uses
cdbs with tarball.mk and simple-patchsys.mk so that I can go ahead and
update the standards version to 3.8.0.  I'm offering this text here in
case the cdbs maintainers wish to use any of it for a file to be
installed in /usr/share/doc/cdbs that other packages may reference in
their README.source files.  Please feel free to use any of this for
ideas or to reject it.  I'm offering it just in case it's helpful. :-)
Presumably, you will eventually offer such a file, in which case I can
replace my README.source file with one that says, "This package uses
cdbs with tarball.mk and simple-patchsys.mk.  Please see
/usr/share/doc/cdbs/whatever.txt for additional notes."

----------------------------------------------------------------------

This package includes the original upstream source tarball inside its
orig.tar.gz file.  It uses the "cdbs" package for its rules file and
the "tarball.mk" and "simple-patchsys.mk" rule for managing the source
and patches.  The rest of this file describes standard procedures for
packages that use cdbs in this way (so you don't have to read it if
you are already familiar with that technique).

To produce the full source of the package in a form
that is ready for editing, please run

./debian/rules patch

from the extracted package directory.  You can then find the original
sources with debian patches applied in the "build-tree" directory.

To remove patches that have already been applied, run

./debian/rules reverse-patches

If you need to make additional modifications, you will need to save
the original file and create a patch.  Do this as follows:

cd build-tree/package-name
cp somedir/somefile.c somedir/somefile.c.orig
(edit somedir/somefile.c)
diff -u somedir/somefile.c.orig somedir/somefile.c > ../../debian/patches/patchname.patch

You may include multiple changes in the same patch file, and you may
create multiple patch files as needed.  Please ensure that your patch
files are named in such a way that applying them in lexical order will
work.  You should test your patches by starting with a clean extract
of the source package (using dpkg-source -x package.dsc) and applying
the patches with ./debian/rules patch.

----------------------------------------------------------------------


-- System Information:
Debian Release: lenny/sid
  APT prefers testing
  APT policy: (500, 'testing'), (200, 'experimental'), (200, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 2.6.24-1-686 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages cdbs depends on:
ii  debhelper                     7.0.9      helper programs for debian/rules

Versions of packages cdbs recommends:
ii  autotools-dev                 20080123.1 Update infrastructure for config.{

-- no debconf information





More information about the Build-common-hackers mailing list