> what you MUST do, is download the tarball and see if the maintainer
> included any helpfull files to help you understand how to use
> the library, one of those helpfull files is test-libglade.c, a full
> fledged example of all the uses of libglade.

I haven't been following this thread all too closely, but it seems to me that 
there are three use cases of a library;

One is people who wish to to use a program that requires the library (it's 
unusual for someone to want to load the library on its own ;) ).  This need 
only be the pre-compiled library, any support files, copyright, etc.  Not much 
in the way of documentation is needed at all, except possibly some errata and 
notes on how the package differs in configuration and/or installation from that 
recommended by the author...

The next is the case of people wishing to develop software that uses the 
library.  This should have API documentation and examples, pkg-config data, and 
such.  May as well call it a -doc package, because the standard pre-compiled 
library package should do just fine here too.  There generally needn't be any 
compiled code here.

Lastly is the case of people wanting to modify/bugfix/etc. the library itself.  
If provided as a package, this should probably have at least a version of the 
library with debugging symbols.  But then, those who need this are likely 
already well-equipped to go download the original source tarball themselves, or 
even just go direct to CVS.  If no package is provided for this case, a short 
note in the -doc package would be enough to point people at where they can get 
the full thing.

I personally don't think someone should have to go download the entire source 
tarball for API documentation, including example use code which IS 
documentation in its own right, after all.  Especially since glade is pushing 
the use of libglade as THE way to incorporate glade-produced layouts into 
applications, libglade should be packaged so as to encourage just that.  Not 
make it hard for application developers to figure out how to use it.  If it 
were just some random lib that only a handful of people will ever use, then who 
cares.  But that's not really the case with libglade.

In any case, this is more an issue for the package maintainer, than the author 
(assuming, of course, that they're different people).  If the author puts out a 
tarball of everything, then it's the package maintainers job to divide it up 
appropriately.


Anyhow...  Just my 0.00000002c worth...  :)


Fredderic

_______________________________________________
Join Excite! - http://www.excite.com
The most personalized portal on the Web!


_______________________________________________
gtk-app-devel-list mailing list
gtk-app-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list

Reply via email to