How do I create a symbols file?

2011-08-24 Thread Paul Elliott

lintian -I says I should create a symbols file.

But Debian Library Packaging guide nor Debian New Maintainers' Guide
tells me exactly how to create such a file or how to name it.

Neither does UsingSymbolsFiles
http://wiki.debian.org/UsingSymbolsFiles
it just says be carefull about it!

I am packaging this library for the first time and I am probably the first to 
build it with libtool. So I probably don't have to worry about previous 
versions. But some day my work will be the previous version, so I want to do 
this correctly.

The .c files proably have some global symbols that are not in the public 
interface. The inteface includes global varriables. (I did not write this 
program.)

What should I do?

-- 
Paul Elliott   1(512)837-1096
pelli...@blackpatchpanel.com   PMB 181, 11900 Metric Blvd Suite J
http://www.free.blackpatchpanel.com/pme/   Austin TX 78758-3117


signature.asc
Description: This is a digitally signed message part.


Re: How do I create a symbols file?

2011-08-24 Thread Jakub Wilk

* Paul Elliott pelli...@blackpatchpanel.com, 2011-08-24, 04:57:

lintian -I says I should create a symbols file.


What lintian actually says is:

I: no-symbols-control-file
N:
N:   Although the package includes a shared library, the package does not
N:   have a symbols control file.
N:   
N:   dpkg can use symbols files in order to generate more accurate library

N:   dependencies for applications, based on the symbols from the library
N:   that are actually used by the application.
N:   
N:   Refer to the dpkg-gensymbols(1) manual page and

N:   http://wiki.debian.org/UsingSymbolsFiles for details.
N:   
N:   Severity: wishlist, Certainty: certain
N:   
N:   Check: shared-libs, Type: binary, udeb

N:

This is hardly a should.


But Debian Library Packaging guide


You should really not read this document. It consists of things that are 
either:

1) irrelevant or
1) vague or
2) simply wrong or
3) already covered by the Debian Policy.

nor Debian New Maintainers' Guide tells me exactly how to create such a 
file or how to name it.


The New Maintainer's Guide is about packaging basics, so certainly not 
about packaging libraries.


--
Jakub Wilk


--
To UNSUBSCRIBE, email to debian-mentors-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/20110824101217.ga6...@jwilk.net



Re: How do I create a symbols file?

2011-08-24 Thread Rodolfo kix Garcia

On Wed, 24 Aug 2011 04:57:45 -0500, Paul Elliott wrote:

lintian -I says I should create a symbols file.

But Debian Library Packaging guide nor Debian New Maintainers' Guide
tells me exactly how to create such a file or how to name it.

Neither does UsingSymbolsFiles
http://wiki.debian.org/UsingSymbolsFiles
it just says be carefull about it!

I am packaging this library for the first time and I am probably the
first to
build it with libtool. So I probably don't have to worry about 
previous
versions. But some day my work will be the previous version, so I 
want to do

this correctly.

The .c files proably have some global symbols that are not in the 
public
interface. The inteface includes global varriables. (I did not write 
this

program.)

What should I do?


Hi Paul,

take a look in the dpkg-gensymbols manpage. Is very clear.

dpkg-gensymbols -ppackage

Probably you could make some changes, like the output file, the ~ 
character, ...


Regards.

kix
--
||// //\\// Rodolfo kix Garcia
||\\// //\\ http://www.kix.es/


--
To UNSUBSCRIBE, email to debian-mentors-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/1f67f31dcbd57a519f299245260d3...@kix.es