Package naming convention and contents

[David Stacey <drstacey at tiscali dot co dot uk>]

I am preparing a library package called Poco. Whilst Marco gave me a 
GTG, both he and Ken were a little unsure about the package names that I 
had used. Please could some of you good folk give me a little guidance 
in this matter.

At the moment, I have tried to copy the naming convention used by our 
'boost' package, as Poco is similar in its layout and intended usage. I 
have a source package (poco-1.4.6p1-1.src.tar.bz2) that builds the 
following:


libpoco1.4.6
  - Several versioned libraries, e.g. cygPocoData_1_4_6.dll.
  - A couple of unversioned executables.

libpoco-devel
  - Header files and libs to link against Poco.

libpoco-doc
  - HTML documentation.

poco-debuginfo
  - Debug files, generated by cygport.


The contentious package is the first one. The point of having versioned 
library files is that you can have any number of them installed 
side-by-side (if you'll forgive the Microsoftism). In that way, some 
other package will always pull in the exact version of Poco that it was 
linked against. For that reason, the two unversioned executables don't 
belong here, and I should probably move them into a package simply 
called 'poco'. However, unless there's an API breakage, versioned 
libraries shouldn't be necessary.

Then there's the name of the package itself. This could have been 
'libpoco', 'libpoco1', or 'libpoco1.4'. The first of these is probably 
wrong, as there is some intention to release Poco 2.x at some point that 
will require a C++11 compliant compiler. Hence, we'll may want to 
support Poco 1.x for a while. Reading the change log, it appears that 
API changes can come in at any release.

So please could you advise on whether you think 'libpoco1.4.6' is a 
sensible name, or suggest an alternative if it is not to your taste. 
Also, should this package contain versioned libraries (of the form 
'cygPocoData_1_4_6.dll') or should the version number be stripped 
(leaving 'cygPocoData.dll').

I have to re-package this anyway (as an errant hyphen slipped its way 
into a package name), so whilst I'm doing that I want to make sure it's 
packaged in a way that everyone is happy with.

Many thanks in advance,

Dave.

PS: Apologies if this thread really belongs on the main cygwin list. 
I've submitted it to cygwin-apps as it is a packaging question.