--- abi-compliance-checker-1.6.orig/debian/manpages +++ abi-compliance-checker-1.6/debian/manpages @@ -0,0 +1 @@ +debian/abi-compliance-checker.1 --- abi-compliance-checker-1.6.orig/debian/changelog +++ abi-compliance-checker-1.6/debian/changelog @@ -0,0 +1,28 @@ +abi-compliance-checker (1.6-1) unstable; urgency=low + + [ Ryan Niebur ] + * New Upstream Version + * improve short description from to meet devrefs suggestions + * Debian Policy 3.8.3 + * reqiure debhelper 7.0.50 + * adjustements to the manpage to fix man errors + * fix hyphen minus signs in manpage + * s/This/abi-compliance-checker/ in long description + + [ Paul Sladen ] + * Include handwritten manpage + + Remove help2man dependency + * debian/watch: Case insentisve match (WikiMedia CamelCasing) + * debian/copyright: + + add copyright year + + expand "RAS" to Russian Academy of Sciences + + add email address for upstream maintainer + * debian/control: tweak Description: + + -- Ryan Niebur Wed, 02 Sep 2009 17:29:18 -0700 + +abi-compliance-checker (1.1-1) unstable; urgency=low + + * Initial release (Closes: #540247) + + -- Ryan Niebur Thu, 06 Aug 2009 14:43:30 -0700 --- abi-compliance-checker-1.6.orig/debian/dirs +++ abi-compliance-checker-1.6/debian/dirs @@ -0,0 +1 @@ +usr/bin --- abi-compliance-checker-1.6.orig/debian/watch +++ abi-compliance-checker-1.6/debian/watch @@ -0,0 +1,2 @@ +version=3 +http://ispras.linux-foundation.org/index.php/ABI_compliance_checker_Downloads .*/[Aa]bi-compliance-checker-(.*).tar.gz --- abi-compliance-checker-1.6.orig/debian/rules +++ abi-compliance-checker-1.6/debian/rules @@ -0,0 +1,8 @@ +#!/usr/bin/make -f + +%: + dh $@ + +override_dh_auto_install: + cp abi-compliance-checker.pl debian/$(shell dh_listpackages)/usr/bin/abi-compliance-checker + --- abi-compliance-checker-1.6.orig/debian/abi-compliance-checker.1 +++ abi-compliance-checker-1.6/debian/abi-compliance-checker.1 @@ -0,0 +1,184 @@ +.\" -*- nroff -*- +.TH ABI-COMPLIANCE-CHECKER 1 "7 August 2009" abi-compliance-checker + +.SH "NAME" +abi-compliance-checker \- Compare ABI/binary compatibility for C/C++ shared library +.SH "SYNOPSIS" +\fBabi-compliance-checker\fR \fB\-d\fR +.br +\fBabi-compliance-checker\fR \fB\-l\fR \fI\fI \fB\-d1\fR \fI\fR \fB\-d2\fR \fI\fR [\fB\-fast\fR] + +.br +.SH "DESCRIPTION" +Compare backward binary compatibility of shared C/C++ libraries. + +This can be used to help reduce the possibility of an application +crashing when the shared libraries it links against have changed. +Signatures and data type definations from two separate versions of a +library are compared by examining the shared objects (.so) files +themselves, and by analysing the header files (.h) provided for the +two versions of the library and their dependencies. + +Shared developers trying to strive for binary compatibility between releases may also use +this tool to detect if an any accidental application binary interface (ABI) +changes have been introduced. + +.br +.SH "GETTING STARTED" +Two XML descriptors must be generated and passed to the tool. These +configuration files inform \fIabi-compliance-checker\fR where to look +for the actual data to compare. + +.br +.SH "OPTIONS" +.TP +\fB-help\fR +Help message and examples (similar to this man page). +.TP +\fB\-d\fR +Spit out example template files named \fBlib_descriptor.v1\fR and +\fBlib_descriptor.v2\fR in the current directory. The two template +files are identical and will both require customising. Any existing files of the same names will be \fIoverwritten without warning\fR. +.TP +\fB\-l \fIlibraryname\fR +Library name. +.TP +\fB\-d1 \fIdescriptor.xml\fR +Path to descriptor of 1st library version (described in \fBDATAFILES\fR below). +.TP +\fB\-d2 \fIdescriptor.xml\fR +Path to descriptor of 2nd library version. +.TP +\fB\-fast\fR +Compiling of all headers together for speed. (Note that this is very +fast, but any compiler errors shown for one header may affect files +others). + +.br +.SH "DATAFILES" +.TP +Library descriptor XML format: + + + /* Library version */ +.br + + + +.br + /* The list of header paths or directories, one per line */ +.br + + + +.br + /* The list of shared object paths or directories, one per line */ +.br + + + +.br + /* The list of directories to be searched for header files needed for compiling of library headers, one per line */ +.br + /* This section is not necessary */ +.br + + + +.br + /* Addition gcc options, one per line */ +.br + /* This section is not necessary */ +.br + + + +.br + /* The list of types that should be skipped while checking, one per line */ +.br + /* This section is not necessary */ +.br + + + +.br + /* The list of functions that should be skipped while checking, one mangled name per line */ +.br + /* This section is not necessary */ +.br + +.br + + +.br + /* The list of headers that will be included before each analyzed header */ +.br + /* For example, it is a tree.h for libxml2 and ft2build.h for freetype2 */ +.br + /* This section is not necessary */ +.br + /* This section is useless when \-fast option selected */ +.br + + +.br +.SH "EXAMPLES" +.TP +Command lines: + +abi-compliance-checker \-l glib \-d1 descriptor_glib_2.20.3 \-d2 descriptor_glib_2.20.4 +.br +abi-compliance-checker \-l gtk2 \-d1 descriptor_gtk2_2.16.4 \-d2 descriptor_gtk2_2.17.3 + +.TP +Library descriptor example: + +2.26.0 +.br + +.br + /usr/local/librsvg/librsvg-2.26.0/include +.br + +.br + +.br + /usr/local/librsvg/librsvg-2.26.0/lib +.br + +.br + +.br + /usr/include/glib-2.0 +.br + /usr/include/gtk-2.0 +.br + /usr/include/atk-1.0 +.br + /usr/include/cairo +.br + /usr/include/pango-1.0 +.br + /usr/include/pixman-1 +.br + /usr/include/freetype2 +.br + /usr/include/libpng12 +.br + + +.br +.SH "BUGS" +Upstream bug reports for \fIabi-compliance-checker\fR should be emailed to . + +.SH "AUTHOR" +.TP +Andrey Ponomarenko - Institute for System Programming, Russian Academy of Sciences and the The Linux Foundation. Distributed under the terms of the GNU General Public License version 3 or later. +.TP +This manual page was written for Debian/Ubuntu by Paul Sladen and is hereby also distributed under the GPLv3 or later. + +.br +.SH "SEE ALSO" +Website: +.BR http://ispras.linux-foundation.org/index.php/ABI_compliance_checker + --- abi-compliance-checker-1.6.orig/debian/copyright +++ abi-compliance-checker-1.6/debian/copyright @@ -0,0 +1,32 @@ +Format-Specification: + http://wiki.debian.org/Proposals/CopyrightFormat?action=recall&rev=196 +Upstream-Maintainer: Andrey Ponomarenko +Upstream-Source: http://ispras.linux-foundation.org/index.php/ABI_compliance_checker_Downloads +Upstream-Name: ABI compliance checker + +Files: * +Copyright: Copyright 2009, The Linux Foundation + Copyright 2009, Institute for System Programming, Russian Academy of Sciences +License: GPL-3+ + +Files: debian/* +Copyright: 2009, Ryan Niebur +License: GPL-3+ + +Files: debian/abi-compliance-checker.1 +Copyright: 2009, Paul Sladen +License: GPL-3+ + +License: GPL-3+ + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + . + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + . + The complete text of the GPL version 3 can be found in + '/usr/share/common-licenses/GPL-3' on Debian systems. --- abi-compliance-checker-1.6.orig/debian/compat +++ abi-compliance-checker-1.6/debian/compat @@ -0,0 +1 @@ +7 --- abi-compliance-checker-1.6.orig/debian/control +++ abi-compliance-checker-1.6/debian/control @@ -0,0 +1,29 @@ +Source: abi-compliance-checker +Section: devel +Priority: optional +Build-Depends: debhelper (>= 7.0.50) +Maintainer: Ryan Niebur +DM-Upload-Allowed: yes +Standards-Version: 3.8.3 +Homepage: http://ispras.linux-foundation.org/index.php/ABI_compliance_checker +Vcs-Git: git://git.ryan52.info/git/abi-compliance-checker +Vcs-Browser: http://git.ryan52.info/?p=abi-compliance-checker;a=summary + +Package: abi-compliance-checker +Architecture: all +Depends: ${perl:Depends}, ${misc:Depends}, gcc, binutils +Description: tool to compare ABI compatibility of shared C/C++ library versions + abi-compliance-checker can be used to help reduce the possibility of + an application crashing when the shared libraries it links against + have changed. Signatures and data type definations from two separate + versions of a library are compared by examining the shared objects + (.so) files themselves, and by analysing the header files (.h) + provided for the two versions of the library and their dependencies. + . + Shared library developers trying to strive for binary compatibility + between releases may also use this tool to detect if an any + accidental application binary interface (ABI) changes have been + introduced. + . + The checker may also be used for assessing binary compatibility + between different Linux distributions.