ucw docs: base64 & base224

Documentation of base64 and base224 encoding. Describes the basecode
utility as well.

Merge branch 'dev-lib' of ssh://git.ucw.cz/projects/sherlock/GIT/sherlock into dev-lib

Doc. systems: definitions are grouped by type

They are grouped together by type. First are enums and structs, then
functions, then variables and preprocessor defines go last.

Doc. system: typo in warn message

b224 is deprecated by basecode

Move ucw utils to subdirectory

Doc. system: definitions are sorted

According to the symbol name.

Doc. system: export type and name do deflists

Doc. system: fix semicolon handling

No need for the hack in extracting loop, now put into formatting.

Fix the regexp in formatting part.

Doc. system: detect type of definition

Just heuristics, detects type of the symbol and the name of the symbol.

It is used to add semicolon to inline functions what do not have one,
but more use of the detection is expected.

ucw. docs: update to use doc. system features

* Automatic formatting of NULL
* use `word` instead of +word+
* use <<links>> instead of xrefs

UCW docs: split definitions off the main index

Doc. system: fix function anchors

Only last character of their name was used to create the anchor.

Moved some utils from utils/ to ucw/

Some of the utilities do not need sherlock (and are not anyhow related
to it), so they were moved to libucw:

    * b224 (base224 encoder/decoder)
    * daemon-helper (replacement for start-stop-daemon)
    * hex (hex dumper)
    * rotate-log (log rotator)
    * urltool (url manipulating tool)

Introduced a CONFIG_UCW_UTILS config switch which controls compilation
of these utilities.

Originally by Michal, with minor changes by MJ:

    * basecode.test is added to TESTS only if CONFIG_UCW_UTILS is set.
    * Changed the order of Makefile sections and Set statements to
      a more logical one.

Doc. system: Hack around Makefile inexpressiveness.

Doc. system: Renamed doc utilities to match local conventions.

First, we do not use filename extensions for scripts which are not "compiled"
(e.g., the scripts that are a part of the build system).

Second, we prefer to build the naming hierarchy from the opposite end.

Doc. system: Make doc target messages more similar to the others.

Doc. system: Avoid ":=" rules in makefiles.

Fixed a typo: indeces -> indices.

libucw documentation: index

Lists modules and definitions

Doc. system: build rules for indeces and deflists

Doc system: build system for deflists and indeces

Makefile rules for building documentation indeces

Doc. system: dependencies bug

They should be appended, not overwritten, this would trash all previous
dependencies

Doc. system: fix deflist asciidoc formatting

Collisions with automatic function references
Disallowed characters in captions which were needed

Doc. system: definition list formatter

Doc. system: links to files without anchors

<<filename:>> and <<filename:,caption>>

Doc. system: file names with more chars allowed

Filenames in <<file:id>> referencies could not contain characters like
'/' or '.'. Now they can contain quite anything.

Documentation system: teach extractor dump defs

If provided with another file name, it dumps all definitions with
filename, id number and text

Documentation system: @word@ is not func. param.

So leave it as is

Documentation: keep ; at the end of functions

And replace { at the end of inline functions with ;

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