web: Get rid of doxygen. Doxygen is an additional dependency, and it's total overkill for a small project like osl. The self-contained gendoc.m4 script does everything we need, and is much faster. This patch converts osl.h.in to gendoc syntax and removes all traces of doxygen. Since gendoc.m4 relies on features of gnu-m4 we run it with -g to enable gnu extensions. This has been tested on FreeBSD and NetBSD which ship different m4 implementations, both of which understand -g.
Improve documentation of osl_rbtree_loop(). Mention that E_OSL_LOOP is the only possible error. Fix a few trivial whitespace issues and a typo while at it.
Add explanation about lifetime of table description.
osl_get_nth_row(): Always initialize result pointer. We buy into Postel's prescription and try to be liberal in what we accept, and conservative in what we send. This patch makes sure the result pointer is set to NULL on failure, and documents this fact.
Mention that OSL_RBTREE implies OSL_UNIQUE. Also print a warning when a table is opened or created which contains a column description with OSL_RBTREE set but OSL_UNIQUE unset. Future versions of osl might reject such table descriptions. But in order to not break existing applications, we can not make such a change without a deprecation period. So a warning has to suffice for now.
Minor API documentation improvements. A couple of spelling and punctuation fixes, and some language improvements.
Update URLs and email addresses. The project has been moved from systemlinux.org to people.tuebingen.mpg.de. This commit updates all links and email addresses.
Improve documentation of the data_size field. Make it clear that for objects of type OSL_FIXED_SIZE, the size has to be specified in number of bytes.
Clarify documentation of osl_table_description->dir.
osl.h.in: Minor documentation improvements.
Change copyright year to 2009.
Merge commit 'meins/master'
Remove osl_hash_compare(). API change, but as the code is not yet publically available..
Fix two doxygen warnings.
osl.h.in: Always include inttypes.h
Change type of struct osl_column_description->storage_{type,flags}. These values get stored in the table index header as 16 bit quantities, so it does not make sense to use a different size for the structure.
Change type of struct osl_table_description->flags to uint8_t. We reserve only one byte in the index header of the table, so it does not make sense to have this field of type enum. Fixes: fsck.c:815: warning: dereferencing type-punned pointer will break strict-aliasing rules
Cosmetics.
Move documentation of exported osl functions from osl.c to osl.h.in. It's better to have this information in osl.h as this is the file which is visible to the users.
osl.h.in cleanups and improvments. - Add visibility pragmas - More documentation - Kill compare function pointers.