Release notes on conf changes

Conf: Explain impossibility of section sharing

Conf: Decoupled cf_stack_done() from committing

The conditional commit machinery and grouping of configuration files
have been made independent on the stack and moved to conf-input.c.

Also, stack is now initialized and destroyed in parse_fastbuf(),
so unterminated braces are reported properly, including the name
of the file.

Conf: Renamed cf_free_context() to cf_delete_context()

This way, it is consistent with the other LibUCW modules.

Conf: Cleaned up use of journal

Introduced a new function cf_revert() for reverting the configuration
to its pristine state. It is automatically called upon cf_free_context().

Also, everything except cf_reload() now should work with journalling
disabled. In this case, nothing is ever rolled back.

Conf: Updated conf-test

Conf: Config documentation

Conf: Introduced cf_open_group() and cf_close_group()

All grouping inside cf_getopt() uses it, too.

Conf: Split off everything related to cf_getopt()

<ucw/getopt.h> now contains only cf_getopt() and related settings.
All high-level configuration functions have been moved to <ucw/conf.h>.

Conf: Introduced cf_set_journalling()

Conf: Removed a debugging relic

Conf: Made the default context static

This involves some bits of magic with constructor priorities
and a hack, which forces linking of conf-context.c.

Conf: Revive cf_def_file and cf_env_file

They are tightly coupled to cf_getopt(), which is not reentrant
anyway, so let us leave them global to keep backward compatibility.

Conf: Obsolete references to cf_def_file

Conf: Removed declarations of cf_def_file and cf_env_file

Conf: Moved the list of dirty sections to cf_context

Conf: Rewritten configuration parser to support multiple contexts (step 1)

Some parts remain, most notably the handling of dirty sections
in conf-section.c.

Fastbufs: Fixed broken seeking in fbbuf.

CRC: Added inclusion guards

CRC: Added crc32_hash_buffer()

CRC: Documentation

CRC: Added tests

CRC: Added a module for calculating CRC32

Mempools: Implemented mp_str_from_mem()

Changed default configuration to include LibUCW and utils only

The debug configuration however enables everything.

Maint: Added a script for uploading online documentation

Doc: Updated web pages

Doc: Updated license

Web: Moved one directory up

Doc: Fixed a typo

Release notes: 5.0 is no longer WIP

Sorter: Make sort-test a part of the test suite

Release notes: Remark on fastbuf implementation

logoutput: Clean up --help message

logoutput: More control over verbosity

Patch by Tomas Ebenlendr.

Atomic Fastbuf: Fixed assertion error in unit test.

Sorter: Another timer.h -> time.h.

Sorter: Ah, fixed wrong include of time.h.

Sorter: Added missing include.

Updated TODO

Updated README for the public release

Maint: Added release machinery

This is derived from release.pm used for pciutils, but extensively
changed to support Git-based workflow.

Needs more work.

README: Trying variable substitution

Updated TODO

Removed obsolete lfs-test

Removed ancient scripts for making library releases

Moved web pages to a top-level directory

Exampled moved to a top-level directory

Config: Support "LibUCW only" mode

Configure: Update copyrights

Configure: Removed references to SHERLOCK_VERSION

Configure: Simplified radix sorter configuration

Originally, we guessed based on CPU model, but as I have ripped out
model detection, we cannot do that any longer; besides, it was very
much out of date.

Now, we use simple heuristics: anybody caring about performance
runs on amd64 and all amd64 processors have large enough L1 cache
to use 12-bit bucket width.

Configure: Moved LibUCW specific Darwin hacks to the right place

Config: Enable CONFIG_EXACT_CPU in debugging configuration

Configure: Replaced dark magic in CPU detection by use of -march=native

check-configs: Enable CONFIG_LOCAL, otherwise tests cannot work

check-configs: Check configurations without CONFIG_DEBUG, too

lib.h: Added ASSERT_READABLE and ASSERT_WRITEABLE

Time: Added a module for parsing timeouts

Time: Documented the header splitoff

Time: Timing functions separated out to <ucw/time.h>

Updated all references and wrote documentation.

Charset: compile cs2cs

Sorter tests: get rid of sherlock.h

Use #include <ucw/...> instead of "ucw/..." (and similarly for the other libs)

Fastbuf: Get rid of ->is_fastbuf typechecking hack

... it breaks C99 aliasing rules and GCC rightfully warns about it.

If we ever want to do such type checking, we might use

#define CAST(f) ((f)->is_fastbuf, (struct xxxx *)(f))

but I guess it is of little use anyway, so I am removing it.

Base64: Made thread-safe

Config: Use CONFIG_LOCAL in debugging configuration

Timer: Use monotonic clock on Linux

Doc: Release notes about timestamp_t

Main: Use get_timestamp() for main_now

Main: Decouple main_now from system time, remove main_now_seconds

Timer: get_timer() adds a random offset to catch misuse of timestamp_t

Redefined timestamp_t and removed ucw_time_t

timestamp_t is no longer tied to the wall clock time (so it can be
read from CLOCK_MONOTONIC or any other clock)

ucw_time_t was an obsolete hack

Config: Updated check-configs

Config: CONFIG_UCW_FAKE_ELTPOOL

Can be set by the user if needed, not referenced in any config scripts.

Gary: GARY_INIT_OR_RESIZE got broken by introduction of zeroing

Config: Regularized configuration of regex libs

Config: Updated UCW_VERSION and ..._CODE

Config: Removed reference to MAX_WORD_(BYTES|CHARS)

We do not ship Sherlock liblang any longer.

Config: Update the filtering rules for autoconf.h

Config: Split CONFIG_UCW_DEBUG off CONFIG_DEBUG

CONFIG_DEBUG controls the build system,
CONFIG_UCW_DEBUG gets embedded in the library.

Turning CONFIG_DEBUG in programs using LibUCW can influence
ASSERTs and other debugging constructs in the headers, but
not presence of debugging code in the library.

Config: One more reference to CONFIG_LARGE_FILES

Config: Moved CONFIG_LARGE_FILES to UCW namespace, removed CONFIG_LFS

Config: CONFIG_OWN_GETOPT moved to UCW namespace

Config: CONFIG_DIRECT_IO moved to UCW namespace

Conf: DEFAULT_CONFIG and ENV_VAR_CONFIG got a CONFIG_UCW_ prefix

URL: Removed CONFIG_URL_ESCAPE_COMPAT

Doc: Updated release notes

Updated TODO

Sighandler removed from public API

It is still used internally by lizard-safe, so I am not removing it yet.

Lizard: Removed comments which are already part of the docs

Doc: Typos in the index

Doc: Typos and clarifications in unicode.h

Doc: lib.h is already fully documented

(In fact, the parts that were not, were moved to other header files.)

Doc: Describe general rules for reentrancy

Removed str_start_with() and str_end_with()

They were already present in dev-trans under different names.

Docs: Removed obsolete remarks about automatic tying of fastbufs

Trans: Moved FIXMEs to global TODO

Merge branch 'dev-trans'

Conflicts:
ucw/Makefile
ucw/string.h

Tester: Do not be picky about final newlines