Contents of the @PVER@-dbg package
-------------------------------------

For debugging python and extension modules, you may want to add the contents
of /usr/share/doc/@PVER@/gdbinit to your ~/.gdbinit file.

@PVER@-dbg contains two sets of packages:

 - debugging symbols for the standard @PVER@ build. When this package
   is installed, gdb will automatically load up the debugging symbols
   from it when debugging @PVER@ or one of the included extension
   modules.

 - a separate @PVER@-dbg binary, configured --with-pydebug, enabling the
   additional debugging code to help debug memory management problems.

For the latter, all extension modules have to be recompiled to
correctly load with an pydebug enabled build. The standard python path
(sys.path) for the @PVER@ binary has been modified:

- The directory
      /usr/lib/@PVER@/lib-dynload/debug
  replaces
      /usr/lib/@PVER@/lib-dynload.

- The directory
      /usr/lib/@PVER@/site-packages/debug
  is inserted before
      /usr/lib/@PVER@/site-packages

- The directory
      /usr/local/lib/@PVER@/site-packages/debug
  is inserted before
      /usr/local/lib/@PVER@/site-packages
