==== Building the debug "flavours" of PySide ====

Since its 1.0.9-2 release, the pyside Debian source package doesn't build the
"debug" flavours of PySide anymore. This README.source documents how one can
build them if needed anyway.

== What they are ==

What are the "debug" flavours ? There are two types:

a) standard build debugging symbols: those are stripped out of the binary and
   are put in the python-pyside-dbg and python3-pyside-dbg packages, in the
   /usr/lib/debug file hierarchy.

b) "python debug" builds: those are full PySide builds against the python-dbg
  libraries, also living in python-pyside-dbg and python3-pyside-dbg packages.

== How to build them ==

Thie packaging keeps the needed pieces together, you need to do three steps:

1) Re-create debian/control
  (this will add the needed Build-Depends and package stanzas to debian/control)

	DEB_BUILD_OPTIONS="debug" debian/rules update-control

2) Increment the version

	dch --local debug -m "Build with debug flavours enabled."

3) Build the package with your usual tools, e.g.

	debuild

== WARNING ==

Building the -dbg flavours will `at least` double the compilation time and
create huge packages: python-pyside-dbg is ~ 300 MiB compressed and ~ 800 Mio
uncompressed, python3-pyside-dbg is similar.

