diff options
author | Lisandro Damián Nicanor Pérez Meyer <perezmeyer@gmail.com> | 2015-05-12 15:29:41 -0300 |
---|---|---|
committer | Lisandro Damián Nicanor Pérez Meyer <perezmeyer@gmail.com> | 2015-05-12 15:29:41 -0300 |
commit | 888ded47f48942fb1f0efdc201d4fda1c999b2a7 (patch) | |
tree | e4f4a79a85635c3b3249006a5bf05d759ff993a7 | |
parent | 36fe33331225256d84abecdd6df40475c338ab5d (diff) | |
download | pkg-kde-tools-888ded47f48942fb1f0efdc201d4fda1c999b2a7.tar.gz |
Revert "Add man pages for pkgkde-gensymbols and pkgkde-symbolshelper (Closes: #782866)"
This reverts commit 36fe33331225256d84abecdd6df40475c338ab5d.
I pushed this commit to the experimental branch.
-rw-r--r-- | debian/changelog | 8 | ||||
-rw-r--r-- | man1/pkgkde-gensymbols.1 | 117 | ||||
-rw-r--r-- | man1/pkgkde-symbolshelper.1 | 98 |
3 files changed, 0 insertions, 223 deletions
diff --git a/debian/changelog b/debian/changelog index fe1a77c..199f689 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,11 +1,3 @@ -pkg-kde-tools (0.15.16) UNRELEASED; urgency=medium - - [ Diane Trout ] - * Add man pages for pkgkde-gensymbols and pkgkde-symbolshelper - (Closes: #782866) - - -- Diane Trout <diane@ghic.org> Fri, 24 Apr 2015 21:06:02 -0700 - pkg-kde-tools (0.15.15) unstable; urgency=medium * The fix for #744173 required to convert non-anchored regexps to anchored diff --git a/man1/pkgkde-gensymbols.1 b/man1/pkgkde-gensymbols.1 deleted file mode 100644 index cd0ea55..0000000 --- a/man1/pkgkde-gensymbols.1 +++ /dev/null @@ -1,117 +0,0 @@ -.TH PKGKDE\-GENSYMBOLS 1 "2015-04-18" "0.15" "Debian KDE dpkg-gensymbols wrapper" -.SH NAME -.B pkgkde\-gensymbols -\- a helper tool for Debian pkg-kde symbols files. -.SH SYNOPSIS -.B pkgkde\-gensymbols -[\fB -.P -.SH DESCRIPTION -.B pkgkde-gensymbols -is a wrapper around dpkg-gensymbols that provides additional support -for tracking C++ symbols such as template instantiated symbols. -See -.BR dpkg\-gensymbols (1) -for more information about maintaining symbols files. -.P -.SH OPTIONS -.TP -.BI \-P package-build-dir -Scan \fIpackage-build-dir\fR instead of debian/tmp. -.TP -.BI \-p package -Define the package name. Required if more than one binary package is listed in -debian/control (or if there's no debian/control file). -.TP -.BI \-v version -Define the package version. Defaults to the version extracted from -debian/changelog. Required if called outside of a source package tree. -.TP -.BI \-e library-file -Only analyze libraries explicitly listed instead of finding all public -libraries. You can use shell patterns used for pathname expansions (see -the \fBFile::Glob\fP(3perl) manual page for details) in \fIlibrary-file\fR -to match multiple libraries with a single argument (otherwise you need -multiple \fB\-e\fR). -.TP -.BI \-I filename -Use \fIfilename\fR as reference file to generate the symbols file -that is integrated in the package itself. -.TP -.BR \-O [\fIfilename\fP] -Print the generated symbols file to standard output or to \fIfilename\fR -if specified, rather than to -.B debian/tmp/DEBIAN/symbols -(or -.IB package-build-dir /DEBIAN/symbols -if -.B \-P -was used). If \fIfilename\fR 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. -.TP -.BI \-t -Write the symbol file in template mode rather than the format compatible with -\fBdeb\-symbols\fP(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 -\fBdeb\-symbols\fP(5) file (according to the tag processing rules) while all -symbols are always written to the symbol file template. -.TP -.BI \-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 -.BR DPKG_GENSYMBOLS_CHECK_LEVEL . -.TP -.BI \-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 \fB\-c\fP option). -.TP -.BI \-a arch -Assume \fIarch\fR 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. -.TP -.BI \-d -Enable debug mode. Numerous messages are displayed to explain what -.B dpkg\-gensymbols -does. -.TP -.BI \-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. -.TP -.BR \-? ", " \-\-help -Show the usage message and exit. -.TP -.BR \-\-version -Show the version and exit. -.SH NOTES -This man page was based on the pkg-kde symbols file help page and -the -.BR dpkg-gensymbols (1) -man page. -.SH SEE ALSO -.BR http://pkg-kde.alioth.debian.org/symbolfiles.html -.br -.BR https://people.redhat.com/drepper/symbol\-versioning -.br -.BR https://people.redhat.com/drepper/goodpractice.pdf -.br -.BR https://people.redhat.com/drepper/dsohowto.pdf -.br -.BR dpkg\-gensymbols (1), -.BR deb\-symbols (5), -.BR dpkg\-shlibdeps (1). diff --git a/man1/pkgkde-symbolshelper.1 b/man1/pkgkde-symbolshelper.1 deleted file mode 100644 index ee8356e..0000000 --- a/man1/pkgkde-symbolshelper.1 +++ /dev/null @@ -1,98 +0,0 @@ -.TH PKGKDE\-SYMBOLSHELPER 1 "2015-04-18" "0.15" "Debian KDE symbols helper" -.SH NAME -.B pkgkde\-symbolshelper -\- a tool to help simplify managing C++ symbols files for the KDE project. -.SH SYNOPSIS -.B pkgkde\-symbolshelper -\fBcreate\fR | \fBpatch\fR | \fBbatchpatch\fR | \fBrewrite\fR -.P -.SH DESCRIPTION -.B pkgkde-symbolshelper -provides helps to automate the process of managing your -.BR deb\-symbols (5) -files. -.P -There are four commands, create, patch, batchpatch, and rewrite. -.P -.SH CREATING SYMBOLS FILE -To create the symbols file for a library package libfoo1 whose version -is 1.7 -.nf -.RS -\f(CW -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 -\fR -.RE -.ni -.P -The above commands should be invoked from the top level directory of -your package's source after having built the package before cleaning, -so that debian/libfoo1/usr/lib/libfoo.so.1 exists). -.P -"symbols.amd64" is the filename of the intermediate symbols file that -will be generated by pkgkde-gensymbols. This filename must be in the -format "name.architecture" or "name_architecture" where "architecture" -is the cpu architecture on which you have built this package. -.SH UPDATING A SYMBOLS FILE FOR A NEW LIBRARY VERSION -After 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. -.BR pkgkde-symbolshelper -can read the build log to find this diff, to save the build log one may want -to do: -.nf -.RS -\f(CW -dpkg-buildpackage | tee buildlog -pkgkde-symbolshelper patch -p libfoo1 -v 1.8 < buildlog -\fR -.RE -.fi -.PP -.SH UPDATING MULTIPLE SYMBOLS FILES AT ONCE -For source packages that provide multiple binary library packages, it is -useful to have a method to patch all the symbol files at once, -.BR pkgkde-symbolshelper -offers a way to do this using the -.BR batchpatch command. For example: -.nf -.RS -\f(CW -pkgkde-symbolshelper batchpatch -v 1.8 < buildlog -\fR -.RE -.fi -.PP -.BR batchpatch -can also be of use when one wants to update symbol files for multiple -architectures at once. There is an additional command -.BR pkgkde\-getbuildlogs -that will download the build logs for multiple architectures from -Debian's build servers. -.nf -.RS -\f(CW -pkgkde-getbuildlogs -pkgkde-symbolshelper batchpatch -v 1.8 foo_unstable_logs/foo_1.8-1*.build -\fR -.RE -.fi -.PP -.SH NOTES -This man page was based text written by others from the pkg-kde -symbols file help page. -.SH SEE ALSO -.BR http://pkg-kde.alioth.debian.org/symbolfiles.html -.br -.BR https://people.redhat.com/drepper/symbol\-versioning -.br -.BR https://people.redhat.com/drepper/goodpractice.pdf -.br -.BR https://people.redhat.com/drepper/dsohowto.pdf -.br -.BR dpkg\-gensymbols (1), -.BR deb\-symbols (5), -.BR dpkg\-shlibdeps (1). |