README for libtagcoll

The package finally builds some API documentation using doxygen.  Not much of
the source code has useful comments yets, but since doxygen support is in
place, this situation is going to improve rapidly.

I'd still like to discuss design issues with interested people, and until when
the library will be used by a wider range of applications and will prove to be
sound enough for general use, the API is subject to changes.


Usage examples of libtagcoll other than the ones in the tests and
documentation, can be found in various tools that link this library, like
tagcoll, taggrep, tagcolledit, libdebtags, debtags and debtags-edit.

Tagcoll and taggrep are especially suited as examples because most of their
complexity resides in the library itself and they use it in a very
straightforward way.


Please get in touch with me if you start using libtagcoll in some projects:
I would like to involve library users in design discussions and API changes.


Project resources:

  Website:

    http://debtags.alioth.debian.org

  Mailing lists:
  
    debtags-devel@lists.alioth.debian.org
    http://lists.alioth.debian.org/mailman/listinfo/debtags-devel
      Development and usage discussions
  
    debtags-commits@lists.alioth.debian.org
    http://lists.alioth.debian.org/mailman/listinfo/debtags-commmits
      Postings of subversion logs

  Subversion repository:

    http://svn.debian.org/viewcvs/debtags/libtagcoll
      Browse online
    svn://svn.debian.org/debtags/libtagcoll
      Read-only access
    svn+ssh://alioth.debian.org/svn/debtags/libtagcoll
      Write access

  APT repository:

    deb http://debtags.alioth.debian.org/debian unstable main


The library uses GNU Libtool.  While this is very nice, it can be a pain when
trying to debug a program. For that reason, compilation of shared libraries can
be turned off by specifying the `--disable-shared' option to `configure'.


---
Enrico Zini <enrico@debian.org>
