[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