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).