NAMEpkgkde-symbolshelper - a tool to help simplify managing C++ symbols files for the KDE project.
SYNOPSISpkgkde-symbolshelper create | patch | batchpatch | rewrite
DESCRIPTIONpkgkde-symbolshelper provides helps to automate the process of managing your deb-symbols(5) files. There are four commands, create, patch, batchpatch, and rewrite.
CREATING SYMBOLS FILETo create the symbols file for a library package libfoo1 whose version is 1.7
- pkgkde-gensymbols -plibfoo1 -v1.7 -Osymbols.amd64 -edebian/libfoo1/usr/lib/libfoo.so.1 pkgkde-symbolshelper create -o debian/libfoo1.symbols -v 1.7 symbols.amd64
UPDATING A SYMBOLS FILE FOR A NEW LIBRARY VERSIONAfter building a new version of the library (for instance 1.8 of our libfoo1 library from above), symbols may have been added or removed, and in both cases one must check and update the symbols file. During the build, a diff between the current symbols file and the one based on the current built library will printed in the output. pkgkde-symbolshelper can read the build log to find this diff, to save the build log one may want to do:
- dpkg-buildpackage | tee buildlog pkgkde-symbolshelper patch -p libfoo1 -v 1.8 < buildlog
UPDATING MULTIPLE SYMBOLS FILES AT ONCEFor source packages that provide multiple binary library packages, it is useful to have a method to patch all the symbol files at once, pkgkde-symbolshelper offers a way to do this using the batchpatchcommand.Forexample:
- pkgkde-symbolshelper batchpatch -v 1.8 < buildlog
batchpatch can also be of use when one wants to update symbol files for multiple architectures at once. There is an additional command pkgkde-getbuildlogs that will download the build logs for multiple architectures from Debian's build servers.
- pkgkde-getbuildlogs pkgkde-symbolshelper batchpatch -v 1.8 foo_unstable_logs/foo_1.8-1*.build
NOTESThis man page was based text written by others from the pkg-kde symbols file help page.
dpkg-gensymbols(1), deb-symbols(5), dpkg-shlibdeps(1).