From bc45b6e681d4472cb8e7fe7550834c27687f00a1 Mon Sep 17 00:00:00 2001 From: "Siegfried-Angel Gevatter Pujals (RainCT)" Date: Mon, 17 Dec 2007 00:24:59 +0100 Subject: [PATCH] Add manpage for check-symbols. General QA --- AUTHORS | 1 + debian/changelog | 5 ++++ debian/control | 10 ++++---- debian/copyright | 2 ++ doc/check-symbols.1 | 62 +++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 75 insertions(+), 5 deletions(-) create mode 100644 doc/check-symbols.1 diff --git a/AUTHORS b/AUTHORS index 2e57cd2..205458f 100644 --- a/AUTHORS +++ b/AUTHORS @@ -1,3 +1,4 @@ +Albert Damen Albin Tonnerre Daniel Holbach Jamin W. Collins diff --git a/debian/changelog b/debian/changelog index eef8fb4..701b439 100644 --- a/debian/changelog +++ b/debian/changelog @@ -4,6 +4,11 @@ ubuntu-dev-tools (0.23ubuntu1) UNRELEASED; urgency=low - Print a list of files that have been modified outside debian/ - Add -h and -q options - Add proper exit values + * debian/control: + - Bump standards version to 3.7.3 + - Move python-central to Build-Depends-Indep + - Rename XS-Vcs-* fields to Vcs-* + - Bump minimum cdbs version to 0.4.49 -- Siegfried-Angel Gevatter Pujals (RainCT) Sun, 09 Dec 2007 18:03:27 +0100 diff --git a/debian/control b/debian/control index c9ab65f..81137f7 100644 --- a/debian/control +++ b/debian/control @@ -2,13 +2,13 @@ Source: ubuntu-dev-tools Section: devel Priority: optional Maintainer: Ubuntu MOTU Developers -XS-Vcs-Bzr: https://launchpad.net/ubuntu-dev-tools/ -XS-Vcs-Browser: http://codebrowse.launchpad.net/~ubuntu-dev/ubuntu-dev-tools/trunk/changes -Build-Depends: cdbs (>= 0.4.43), debhelper (>= 5), python-central (>= 0.5), python-all-dev (>= 2.4) -Build-Depends-Indep: docbook2x +Vcs-Bzr: https://launchpad.net/ubuntu-dev-tools/ +Vcs-Browser: http://codebrowse.launchpad.net/~ubuntu-dev/ubuntu-dev-tools/trunk/changes +Build-Depends: cdbs (>= 0.4.49), debhelper (>= 5), python-all-dev (>= 2.4) +Build-Depends-Indep: docbook2x, python-central (>= 0.5) XS-Python-Version: all Homepage: https://launchpad.net/ubuntu-dev-tools/ -Standards-Version: 3.7.2 +Standards-Version: 3.7.3 Package: ubuntu-dev-tools Architecture: all diff --git a/debian/copyright b/debian/copyright index 6b60181..d8674d5 100644 --- a/debian/copyright +++ b/debian/copyright @@ -2,6 +2,7 @@ This package was re-debianized by Daniel Holbach on Fri, 01 Jun 2007 11:30:08 +0200. Upstream Author: + Albert Damen Albin Tonnerre Daniel Holbach Jamin W. Collins @@ -19,6 +20,7 @@ Upstream Author: Copyright: Copyright 2006-2007 (C) Canonical Ltd. + Albert Damen 2007 Albin Tonnerre 2006-2007 Daniel Holbach 2006-2007 Luke Yelavich 2006-2007 diff --git a/doc/check-symbols.1 b/doc/check-symbols.1 new file mode 100644 index 0000000..84857aa --- /dev/null +++ b/doc/check-symbols.1 @@ -0,0 +1,62 @@ +.\" Title: check-symbols +.\" Author: Albert Damen +.\" Contact details: albrt@gmx.net +.\" +.\" Copyright (C), 2007, Albert Damen +.\" +.\" Permission is granted to copy, distribute and/or modify this document under +.\" the terms of the GNU General Public License version 2. +.\" +.TH "CHECK\-SYMBOLS" "1" "December 9, 2007" "ubuntu-dev-tools" +.SH "NAME" +check\-symbols \- verify symbols exported by a new library version +.\" +.SH "SYNOPSIS" +\fBcheck\-symbols\fP <\fIsource\-package\fR\> [\fIDEBDIR\fR] +.\" +.SH "DESCRIPTION" +To verify the symbols exported by a new library version, run +\fBcheck-symbols\fP with the name of the source package as argument. +\fBcheck-symbols\fP will first determine the symbols exported by the existing +and installed libary version, then install the new library and compare the +symbols exported by the new library version with the symbols exported +by the old version. For each of the symbols found, \fBcheck-symbols\fP +will list if the symbol is new, unchanged or has been removed in the +new library version. +.PP +In case the source package contains multiple binary library packages, +all library files in each of the binary packages will be verified. +.PP +\fBcheck\-symbols\fP uses \fBnm\fP -D to determine +the exported symbols of the libraries. +.PP +If no value is given for DEBDIR, the script will assume the new library +deb files are stored in /var/cache/pbuilder/result. +.\" +.SH "EXAMPLES" +.TP +\fBcheck\-symbols\fP telepathy-glib . +.TP +This will: +.RS 2 +.TP 2 +\(bu Use \fBnm\fP -D to determine the exported symbols of the old, +installed versions of the libraries provided by telepathy\-glib. +.TP 2 +\(bu Install the binary libaries provided by the new version of +telepathy\-glib. +.TP 2 +\(bu Compare the output of \fBnm\fP -D of the new libraries with the +output of the old version. +.TP 2 +\(bu List the result in diff format. +.RE +.\" +.SH "BUGS" +.nf +Please report bugs on: +https://bugs.launchpad.net/ubuntu/+source/ubuntu\-dev\-tools/ +.fi +.\" +.SH "SEE ALSO" +.BR nm (1)