Add a description of extract-doc.pl script

Documentation system: file xrefs

<<file:link>> and <<file:link,text>> links to other files work now.

Documentation system: null-macro not needed

It is done by replacement, no need for a macro definition

Documentation system: <<f()>> links

The <:f()> function links were replaced by ones more similar to existing
cross-reference links.

<<f(params)>> -- link to function
<<f(params),text>> -- with user-provided link text
<<file:f(params)>>,<<file:f(params),text>> -- link to a function in
  different file

Furtheremore, the documentation config was split into backend specific
(xhtml at this moment only) and backend independent parts.

Doc: NULL is now detected and typeset properly.

Less complicated syntax of function references

<file:function(params)>
<file:function(params):link text>
<:funciton(params)>
<:function(params):link text>

NULL detection (turned to be <tt>ed)

Configure: Fixed a bug in error handling.

Update documentation of fastbufs.

The back-ends should be fully covered now, the front-ends still remain
documented very sparsely.

Documentation of fb-atomic has been moved from the source to the header
file and asciidoc'ed.

I have also added a simple menu with links to all sections.

Documentation system: manual function links

Things like this now works
>>f>:function(parameters)<<< - link to function in local file
>>f>:function(parameters):custom link text<<< - similar, named
>>f>file:function(parameters)<<< - into different file
>>f>file:function(parameters):custom text<<<

File is written without suffix (eg. no file.html, just file).

Documentation system: generate anchors/ids for functions

When a function documentation is found, a fun_name_of_the_function
anchor (id html attribute) is added to it so links can jump there.

Documentation system: detect functions by name()

Functions are detected, set in <tt> font and turned to links.

Libucw: Documentation of more fastbuf headers.

Libucw: documentation of fastbuf.h

Documentation system: Structures are input verbatim.

Enhanced documentation system.

Comments are now

/**
 * Function comment.
 **/
void function(void);

or void function(void); /** Function comment **/

/***
 * Verbatim comment.
 ***/

or /*** Verbatim comment ***/

@param marks a function parameter.

It understands structures (to level 1, nested functions are flattened.
Is it needed?).

Created documentation system.

`make docs' compiles documentation.

It uses asciidoc and is enriched by taking data directly from source code.
Some tests are done with ucw/doc/fastbuf.txt and ucw/fastbuf.h.

Created documentation is saved into the obj dir.

Fixed a comment.

Update MAX_WORD_xxx in the lib-only customization.

Build system: -soname should contain SONAME_SUFFIX.

Libucw: Cleaned up logging in fb-atomic.

Original patch by Michal, slightly changed by me.

Libucw: Get rid of a warning during test.

(Unused argc)

Configure: Determine /var and related installation paths automatically.

Build: Let genconf expand variables recursively.

This is useful for example when filling in installation paths in configuration
files.

Configure: Avoid dashes in names of variables.

Libucw: Split ff-string.c.

Stk strings now have their own file (ff-stkstring.c).

Libucw: Added tests of the URL module.

Mostly merging of relative paths.

Libucw: Update path parameter handling of URL to current RFC (2396).

Previous RFC had path parameters as separate component. With current RFC,
each path element can contain own path parameters.

When merging absolute/relative url, path parameters are taken as parts of
the elements, making special handling unnecessary.

Libucw: Update URL escaping to current RFC (2396).

Add new reserved characters: '$', '+', ','
Add new allowed character: '~'

Changed NCC_xxx defines to an enum.

Libucw: A test for mmap fastbufs.

Libucw: Coding conventions fix

Libucw: Replace obsolete log calls by msg.

Libucw: A test for fastbufs on static buffers.

Libucw: Tests for some fastbufs which already have test main.

Libucw: Added str_count_char().

Libucw: Add ROR (bitwise ROtation to Right)

Libucw: Prime numbers moved from lib.h to prime.h.

Rewrite #include "..." to #include <...> when installing.

Removed an obsolete comment.

Libucw: Split ucw/fb-temp.c.

Moved the low-level temporary file functions that do not depend on fastbufs
to ucw/tempfile.c.

Libucw: Better configuration of temporary directories.

I have split the directory name from the file name prefix.
Also, I have fixed a couple of bugs in my previous merge
of Michal's patches.

Libucw: Change sh_ prefix to ucw_.

And update all uses across the tree.

Macros:
sh_fdatasync -> ucw_fdatasync
sh_fstat -> ucw_fstat
sh_ftruncate -> ucw_ftruncate
sh_mmap -> ucw_mmap
sh_open -> ucw_open
sh_pread -> ucw_pread
sh_pwrite -> ucw_pwrite
sh_seek -> ucw_seek
sh_stat -> ucw_stat

Functions:
sh_file_size -> ucw_file_size

File types:
sh_off_t -> ucw_off_t
sh_sighandler_t -> ucw_sighandler_t
sh_stat_t -> ucw_stat_t
sh_time_t -> ucw_time_t

Internals:
sh_getopt -> ucw_getopt
sh_getopt_long -> ucw_getopt_long
sh_getopt_longonly -> ucw_getopt_longonly
sh_optarg -> ucw_optarg
sh_opterr -> ucw_opterr
sh_optind -> ucw_optind
sh_optopt -> ucw_optopt
sh_xfree -> ucw_xfree
sh_xmalloc -> ucw_xmalloc
sh_xrealloc -> ucw_xrealloc

Libucw: Use the new temp file logic for semaphores.

(picked from Michal's dev-vorner branch)

Libucw: Be able to use public tmp directory.

If Tempfiles.Prefix is not set, temp_file_name() now uses the public tmp directory
pointed to by $TMPDIR. The new Tempfiles.PublicDir switch controls the naming

Added open_tmp() which creates a temporary file in a race-free way.

The changes were picked from Michal's dev-vorner branch, mine are only renames
of function parameters and coding-style cleanups, and also the doc.

Libucw: added bopen_fd_name()

(picked from Michal's dev-vorner tree)

Libucw: url byte -> char

The rest of tree has to be updated to it (does not compile, all kinds
of warnings...).

Libucw: remove dmalloc support

Libucw: Remove lists.{h,c}

All remaining references to it replaced by clists.

Move pagecache from libucw to libsherlock

Move db system from Libucw to Libsherlock

(Needed for move of pagecache there)

Move context matching to libgather

Libucw: unicode.h - Remove macros with the same functionality as functions.

All uses of macros across the tree replaced.

Libucw: fix extention (.test -> .t)

Libucw: basecode would break while decoding and '--prefix='

It wouldn't skip the newlines properly if prefix was set to empty string
(eg "", not NULL).

Remember to enable CONFIG_LOCAL in the library example.

The big move. Step #2: Updated all other references to lib/.

The big move. Step #1: Move whole lib/ to ucw/.

All references within the libucw itself have been updated.

Readding line of makefile lost in merge

Libucw: basecode utility and its tests.

(Several Michal's commits flattened to one.)

Libucw: Changing md5 module interface to match sha1.

All uses in tree update to reflect the change.
Uses ucw types.

Libucw: wildmatch uses char * instead of byte * for strings.

Needs to be typecasted to unsigned char when indexing arrays.
Expects chars to be 8-bit.

Libucw: Test for redblack.h

Use existing test.

Libucw: Test for binheap.h

Use existing test, just run it with other tests.

Libucw: Test for arraysort.h

Modified existing benchmark to return 1 as return code on failure.
Added a .t file to run from `make tests'.

Merge branch 'master' into dev-lib

Merged the dev-admin changes through mainline. Conflicts solved manually:

filter/filter.h
filter/tries.c
lib/Makefile

Merge branch 'dev-admin'

Enable automatic tests for byte-bases tries.

Implemented byte-bases trie.

Implemented {mp,ep}_total_size().

Hidden one possible compilation warning in KMP.

Merge branch 'master' into dev-admin

Libucw: Spelling.

Libucw: Added an implementation of HMAC-SHA1.

Adapt to CF_LOOKUP constification.

UCW: Constified the lookup table for CF_LOOKUP and CF_BITMAP_LOOKUP.

Libucw: Added sha1.t to the automatic tests.

Libucw: Added a SHA-1 module.

Configure: Better extraction of settings in PkgConfig() and TrivConfig()

TrivConfig() now allows to specify a list of options to ask for.
The naming of the configuration variables has been changed from
CFLAGS_PKG to PKG_CFLAGS to bring everything related to the PKG
together.

Configure: better guard against undef's returned by backticks.

Tests for the string module.

The libucw Makefile no longer installs cf/library automatically.

Fixed a bug in str_unesc() and added a testsuite.

Prior to this fix, the first character after an octal escape
sequence was copied literally.

Replaced the md5hex module by the hexdumper.

It turned out to necessary to teach the hexdumper to produce
uppercase output, so I have changed the separator to general
flags.

str_hexdump() now uses the new hexdumper.

Hexdumping functions can also use separators.

Added a simple module for making and parsing hexdumps.

Renamed str-test to hashfunc-test, because that's what it is.

Move chartype functions to lib/char-*.c.

The names str_*.c were very misleading.

Moved matching and splitting functions to lib/str-*.c.

More moves of string functions out of lib/lib.h.

match_pattern* has been renamed to str_match_pattern*,
(word|sep)split has been renamed to str_(word|sep)split,
all of them have been moved to lib/string.h.

md5_to_hex() and hex_to_md5() have been moved to lib/string.h,
but MD5_SIZE and MD5_HEX_SIZE to lib/md5.h. The conversion
functions will be replaced by a generic hexdumper soon.

Moved regex functions to lib/regex.h.

Introduced new header "lib/string.h".

Started moving string functions from lib.h there. The first ones
are those from string.c.

Also split off the unescaping functions to str-esc.c.

Build system: Substitute installation paths in .pc files if needed.

Revert "Configure: Set installation paths based on PREFIX."

This reverts commit 6c6d5d754582421419bc9e8d5c36036b7cfc1143,
which should have belonged to the dev-lib branch instead.

Configure: Set installation paths based on PREFIX.

Configure: Set installation paths based on PREFIX.

Allow the name of the config file directory to be overridden.

Makefiles: implement a symlink-alias macro.

Makefiles: Allow a prefix and suffix of installed libraries to be specified.

Configure: Partial support for CONFIG_LOCAL and PREFIX.

The configure script sets up INSTALL_PREFIX properly, but it is not
used anywhere yet.

Choose soname embedded in the shared libraries differently for a local
and global installation.

Configure: Remember PKG_CONFIG_PATH used for building.