NAME

       pkgkde-gensymbols - a helper tool for Debian pkg-kde symbols files.

SYNOPSIS

       pkgkde-gensymbols [

DESCRIPTION

       pkgkde-gensymbols  is  a wrapper around dpkg-gensymbols that provides additional support for tracking C++
       symbols such as template  instantiated  symbols.   See  dpkg-gensymbols(1)  for  more  information  about
       maintaining symbols files.

OPTIONS

       -Ppackage-build-dir
              Scan package-build-dir instead of debian/tmp.

       -ppackage
              Define  the package name. Required if more than one binary package is listed in debian/control (or
              if there's no debian/control file).

       -vversion
              Define the package version. Defaults to the version extracted from debian/changelog.  Required  if
              called outside of a source package tree.

       -elibrary-file
              Only  analyze  libraries  explicitly  listed  instead of finding all public libraries. You can use
              shell patterns used for pathname expansions (see the File::Glob(3perl) manual page for details) in
              library-file to match multiple libraries with a single argument (otherwise you need multiple -e).

       -Ifilename
              Use filename as reference file to generate the symbols file that  is  integrated  in  the  package
              itself.

       -O[filename]
              Print  the  generated  symbols file to standard output or to filename if specified, rather than to
              debian/tmp/DEBIAN/symbols (or package-build-dir/DEBIAN/symbols if -P was  used).  If  filename  is
              pre-existing,  its  contents  are  used as basis for the generated symbols file.  You can use this
              feature to update a symbols file so that it matches a newer upstream version of your library.

       -t     Write the symbol file in template mode rather than the format compatible with deb-symbols(5).  The
              main  difference  is that in the template mode symbol names and tags are written in their original
              form contrary to the post-processed symbol names with tags stripped  in  the  compatibility  mode.
              Moreover,  some symbols might be omitted when writing a standard deb-symbols(5) file (according to
              the tag processing rules) while all symbols are always written to the symbol file template.

       -c[0-4]
              Define the checks to do when comparing the generated symbols file with the template file  used  as
              starting point. By default the level is 1. Increasing levels do more checks and include all checks
              of  lower  levels.  Level  0  never fails. Level 1 fails if some symbols have disappeared. Level 2
              fails if some new symbols have been introduced. Level 3 fails if some libraries have  disappeared.
              Level 4 fails if some libraries have been introduced.

              This value can be overridden by the environment variable DPKG_GENSYMBOLS_CHECK_LEVEL.

       -q     Keep  quiet and never generate a diff between generated symbols file and the template file used as
              starting point or show any warnings about new/lost libraries or new/lost symbols. This option only
              disables informational output but not the checks themselves (see -c option).

       -aarch Assume arch as host architecture when processing symbol files.  Use  this  option  to  generate  a
              symbol file or diff for any architecture provided its binaries are already available.

       -d     Enable debug mode. Numerous messages are displayed to explain what dpkg-gensymbols does.

       -V     Enable  verbose  mode.  The  generated  symbols  file  contains  deprecated  symbols  as comments.
              Furthermore in template mode, pattern symbols are followed by comments listing real  symbols  that
              have matched the pattern.

       -?, --help
              Show the usage message and exit.

       --version
              Show the version and exit.

NOTES

       This man page was based on the pkg-kde symbols file help page and the dpkg-gensymbols(1) man page.

SEE ALSO

       https://qt-kde-team.pages.debian.net/symbolfiles.html
       https://people.redhat.com/drepper/symbol-versioning
       https://people.redhat.com/drepper/goodpractice.pdf
       https://people.redhat.com/drepper/dsohowto.pdf
       dpkg-gensymbols(1), deb-symbols(5), dpkg-shlibdeps(1).

0.15                                               2015-04-18                               PKGKDE-GENSYMBOLS(1)