Doc: Improved the title page.

Merge branch 'dev-free' into dev-lib

Conflicts:

ucw/doc/Makefile

LibUCW: Reverted the config.h hack.

Unfortunately, the public version of config.h prepared in obj/ucw/
gets included by private source files as well, which leads to inclusion
of the public autoconf.h and so to invisibility of private symbols.

Split cf/library to cf/libucw and cf/libsherlock.

Each part is installed together in the respective library's install target.

LibUCW: Export version of the libraries as well as of Sherlock.

LibUCW: Entrust generation of ucw/autoconf.h to the configure machinery.

This is much nicer than the sed script invoked from ucw/Makefile.

Configure: Enabled strict mode and localized @cpu.

Configure: Replaced debPrint() by DebugDump().

Configure: Fixed a silly typo.

Configure: Introduce AtWrite hooks and handle autoconf.h by them.

Update references to autoconf.cfg.

Configure: Added a mechanism for registering post-config hooks.

Added cpp-parseable version string to autoconf.h.

Filter config.h and autoconf.h in the public API.

This tries to avoid leaking private symbols to autoconf.h which is a part
of the public API.

Two more references to CONFIG_PARTMAP_IS_MMAP.

Moved *_IS_MMAP to CONFIG_UCW_* namespace.

BTW, PARTMAP_IS_MMAP was broken for a long time: the configure script
was setting PARTMAP_IS_MMAP, while partmap.c expected CONFIG_PARTMAP_IS_MMAP.

Better installation of ucw/autoconf.h.

The autoconf header should be installed in the install-libucw target,
I do not see any need for handling it separately.

Removed default-install from the generic build system.

The default-install target is very specific for Sherlock and nobody
else seems to use build/install. I have therefore moved this target
back to the top-level Makefile as it was when the world was young.

However, if we compile only the libraries (CONFIG_SHERLOCK is unset),
we use the standard install target identical the one in free/libs/Makefile.

Slightly better names for configuration modules.

ucw docs: Mainloop

* May still need an example
* File descriptors need to be described

ucw docs: Intro in index.html

Get rid of the "new" C++ keywords in ucwlib headers.

update_adler32 -> adler32_update (similar to {md5,sha1}_update)

default_thread_stack_size -> ucwlib_thread_stack_size

identify_protocol -> url_identify_protocol

Added missing ifdef guards to ucw/*.h.

Just renamed hash_block()'s `str' parameter to `buf'.

Fixed few typos.

Fixed a typo in configuration example.

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

short_opts[] should be chars, not bytes

doc system: fix "struct name;"

It was considered as a variable.

Shortened the code a little bit on the way.

Improved the bbcopy()'s documentation once more :)

Slightly simplified bbcopy's documentation.

Documented the meaning of ~0U parameter in bbcopy().

ucw/semaphore.h doesn't compile with gcc-4.0; the fix is trivial

ucw docs: Operation names, link to config

ucw docs: fix spacing in config.html

ucw docs: parser units

docs: anchors in config.txt

ucw docs: cf_pool

Implemented mp_restore_fast().

Assert that we called mp_printf_append() on a zero-terminated buffer.

ucw docs: config.h -- journal & sections

ucw docs: tweaks in conf.html

ucw docs: CF_STRING and CF_LOOKUP types

ucw docs: init and commit hooks described in-place

ucw docs: multiple configuration items

arrays and lists of configuration items.

README: Spell API in capitals.

README: Fixed a typo.

UCW doc: Fixed a typo.

UCW doc: minor fixes to the introduction to config parsing

ucw docs: complete conf.h api documentation

The macros for describing configuration structure were not documented
yet.

ucw docs: complete getopt api docs

Doc. system: Fix one-line structs & enums

When a struct or enum started and ended on the same line
(eg. struct { som items; }), the extractor did not recognize it as an
end.

ucw docs: factual error about custom parsers

The cf_journal_block is already called when the system calls the user
parser function, no need to call it again.

ucw docs: tweaks in conf.txt

ucw docs: Section about advanced uses of config

Describes custom parsers, reloading and hooks. Still some API
documentation needs to be done.

Nicer variable name

Put configuration value to better place

Remove useless debug print

Better variable name

UCW_LOCAL_INCLUDES could be misleading

Better detection of .a/.so

There is a variable for the suffix.

Fix installation of autoconf.h

Change configure scripts to modules

Move UCW perl modules to their directory

This way they can be found from the source directory (needed for
configure)

Free dist: update README

It now mentions new documentation.

Free dist.: Update installation documentation

Mention installation of the library

Cleanup libucw installation

Install libs-only config files

Libimages installs

Libcharset installs

libsh installs

Libucw supports installation

* Perl modules not installed, what to do with them?
* Need to teach other libraries to install

Doc. system: link docs under run directory

They are divided into modules, stored in run/doc/modulename. Only ucw
module exists now.

Split autoconf.cfg

Some programs may want to use the configure & build system from libucw,
but not libucw itself. Splitting it allows such programs not detect
internal libucw thinks like page sizes.

Free docs: Removed unneeded deps from install.txt

There were many which are needed only for sherlock, not for libucw or
other libraries alone.

Free docs: slight tweaks in configure

free docs: explain where the variables come from

The variables in configuration preprocessing (the compile time ones from
configure script)

Move hex to debug/

Installation documentation for libucw

Based on doc/install from sherlock, stripped of irrelevant information.

libucw documentation: Fix links

They are not to anchors, but to files (<<symbol:>>, not <<symbol>>).

Update the configure documentation

libucw will be built alone, therefore ucw/doc/configure describes
stand-alone building. Sherlock configure is described in doc/configure.

libucw documentation: slight language tweak

libucw dist: condition to turn off other libs

Compilation of other libraries (libsh, liblang, ...) can be turned off
by CONFIG_UCW_ONLY

Some sherlock independent docs put into libucw

The originals are kept in place, need to decide what to do with them.

Made translatable by asciidoc

ucw docs: Mempool examples

Added three examples of how a mempool can be used:
* string trie
* rollback an action which may fail
* loading whole stdin

Doc. system: fix makefile, docs is phony target

Doc. system: fix build in libsonly distribution

For some reason, the DOCDIR variable did not work in runtree generation,
had to move it above it.

Doc. system: link docs under run directory

They are divided into modules, stored in run/doc/modulename. Only ucw
module exists now.

ucw docs: Mempool struct internals are private

Tells the user not to dig inside.

ucw docs: fix language error

Formatted has two "t"s.

ucw docs: fix language error

Monospace, not monoscope

Renamed cf_write_item() to cf_modify_item().

The old name was somewhat counter-intuitive.

More play: Added indirect heapsort.

Just for fun: Added heapsort to the sorting benchmark.

Forgot to adapt retros.c to the new MD5 interface.

Fix the fix of compilation

The LIKE_MALLOC flag should not be in the middle of return type.

Fix compilation after writing docs

TODO about documentation