Gary: GARY_PUSH and GARY_POP have lost the 2nd argument

Having to tell "yessir, just one element" on each call was just too
inconvenient.

Gary: Remove unused gary_free()

Prepared for release of Libucw 6.0

Opt: Added missing reference

Opt: Forgot to describe help columns

Merge branch 'dev-opt'

Opt: Documented opt and its interaction with conf

Doc: Newer versions of AsciiDoc require [footer-text]

Opt: State of opt-conf moved to opt_context

It gives a better feeling to get rid of magical static variables
in functions :)

Opt: OPT_HELP_OPTION does not need passing pointer to current definitions

I have introduced a new flag OPT_INTERNAL / OPT_HOOK_INTERNAL, which
can be used by internal handlers and hooks to get the pointer to the
current opt_context.

Let <ucw/lib.h> include <stdbool.h> automatically

Opt: TODO cleared

Opt: opt_failure() is public, opt_usage() not so

Opt: Generalization of hooks

Hooks can specify a subset of events they wish to receive.
Helps to get rid of lots of special-casing.

In particular, the end of parsing is also an event, so that we
can load configuration if it has not been loaded yet. (This was
a bug in the original implementation, which never turned up,
because opt-test has mandatory arguments.)

Opt: Cleaned up opt-conf

First of all, the names of configuration options are no longer
fixed. Each of these options has its own handler and as long as
OPT_CONF_HOOK is used, the caller is free to define configuration
options with the names and help texts of his choice.

The same applies to --help.

To achieve these goals, the OPT_BEFORE_CONFIG flag has been
introduced.

Opt: Make OPT_LAST_ARG actually work and document interface of opt_parse()

Opt: Split to three separate modules

One handles parsing, one displaying of help, and one interfaces
with conf.

Opt: Rewritten formatting of help

Previous implementation of opt_help() had several drawbacks:
First, it formatted each section separately, so the columns
did not aligh. Second, it did produced incorrect output for
options which possess only the short form.

I hope that the new implementation is cleaner and easier to extend.

Opt: exit() does not return, no need to call va_end() afterwards

Opt: Simpified and corrected processing of OPT_SINGLE

OPT_SINGLE is now checked in opt_parse_value(). Previously, short,
long, and positional options had their own checks.

OPT_CL_SWITCH did not allow changing the value of the switch once
it is set, although documentation in opt.h claimed quite the opposite.
Changes are currently allowed unless OPT_SINGLE is set.

Test cases have been updated accordingly.

Opt: Fix bug introduced by my cleanups

Opt: Improved reporting of errors

Introduced opt_name() and THIS_OPT, which can be used in error
messages whenever you have a pointer to struct opt_precomputed ready.

Opt: Streamlined opt_parse_value()

Opt: Streamlined parsing of long options

Also, in error messages, we call them options, not arguments.

Opt: Accept arguments for short options even in bundles

Traditional getopt() seems to support this, so we should, too.

Opt: Updated test case

Printing non-ASCII characters for positional arguments is a little
bit crazy, I will hopefully clean it up later.

Opt: Streamlined opt_shortopt()

Also, we reject non-ASCII short options, which enabled us to lower
OPT_POSITIONAL_TAIL to 128 and thus save memory.

Opt: Start of positional arguments is not hard-wired

Opt: Checking of required arguments simplified

Opt: Cosmetics

Opt: Streamlined setting of default options

OPT_ADD_DEFAULT_FLAGS has been replaced by a function,
OPT_ITEM_FLAGS is gone.

Opt: Updated symbol renames

Opt: Simplified preprocessing of options

Replaced OPT_TRAVERSE_SECTIONS by proper recursion.

oc->opts now contains struct opt_precomputed's directly instead
of pointers to them, so that we need not allocate each struct
separately (and leak memory).

Counting of each OPT_CL_BOOL option twice has been removed, I hope
it is not necessary any longer as the "no-" prefix does not need
its own entry.

Opt: Fixed a test case

Build: Make sure that we link against the locally compiled dynamic libraries.

Merge branch 'master' into dev-opt

Packages: Install subset of UCW utilities to /usr/sbin instead of /usr/bin.

Trie: Improved Tom's warning about hell

Opt: Merged fixes from Gigamail.

Merge branch 'master' into dev-opt

Conflicts:
ucw/ff-varint.c
ucw/varint.c

Docs: Checked for problems with common var-len-arrays and alloca() (written by Tom).

LibUCW: Fixed a bug in fb-atomic.

LibUCW: Added missing includes in <ucw/io.h>

Packages: Fixed installation of obsolete ucw-daemon-helper.

PCRE regex: Fixed a harmless compilation warning.

varints: Fixed format strings.

Opt: ABI cleanup

Merge branch 'master' into dev-opt

Conflicts:
ucw/Makefile

LibUCW: Fixed a stupid typo in the UCW_DIE_BY_ABORT switch.

LibUCW: Implemented UCW_DIE_BY_ABORT environment switch.

Packages: install-ucw-sorter-api make target moved into install-libucw-api.

Packages: Do not forget to install sorter's API.

Packages: Removed customization of SONAME_SUFFIX to simplify Makefiles.

Packages: Fixes in custom versioning.

Packages: Created debian/tag-release script to easily tag new versions.

Packages: Unit tests must be run sequentially (make -j1 tests).

Packages: Fixed a typo in Makefile causing unnecessary dependencies.

Packages: Added missing dependencies.

Packages: Fixed static linking.

Packages: pkg-config dependencies moved to Requires.private.

Packages: Dependencies on external dynamic libraries are now in pkg-config's Libs.private.

Packages: We need to include SONAME symbolic links to shared libraries in packages.

Packages: Do not install picstatic version of libs.

But they are still not removed completely from Makefiles and pkgconfig.

Merge branch 'dev-api' into dev-package

Conflicts:
default.cfg

Debug: check-configs tries static linking, too

ABI: Fix string.h

ABI: Symbol renames for libimages

Images: Added missing include

Images: Clean up old-style function declarations

Tools: It's 2014 now :)

ABI: Manual tweaks for ff-binary.h

Function names are generated by macros, thus hidden to tools/map-symbols.

ABI: rename-symbols does not touch timestamps of unmodified files

ABI: Tables used by ucw/chartype.h are prefixed

Packages: Added a custom string to names of compiled libraries.

Packages: Split each UCW library to its own set of packages.

ABI: Manual tweaks for strtonum.h

Function names are generated by macros, thus hidden to tools/map-symbols.

ABI: ucwlib_ prefix is also safe

ABI: Rename internal tables of libcharset

ABI: Avoid macro re-definition

ABI: Symbol renames for libucw and libcharset

All of these have been generated by tools/rename-symbols. Some manual
tweaking will be needed.

Config: By default, debug configuration build shared libraries

Config: Added CONFIG_UCW_CLEAN_ABI

Added a list of exported symbols, which are subject to renaming

Tools: Added tools for symbol renaming and checking

Packages: Install also obsolete ucw-daemon-helper for now.

Clean up old-style function declarations split to multiple lines

LibUCW: Added fb-socket.h header to public API.

Packages: Simplified definition of install targets.

Packages: Improved installation of example configs.

Packages: Added some docs/examples.

Packages: Several fixes in debian packages and their versioning.

LibUCW: Added `ucw-' prefix to utils.

Libucw-images: Added `ucw-' prefix to utils.

Packages: Several fixes in debian packages.

Packages: First experiments with Debian packages.

Renamed shxml/* to xml/*.

Split install-lib* rules to runtime and dev parts.

Added libucw-* prefix to some forgotten places.

Added libucw-* prefix to all libraries (libcharset -> libucw-charset, etc.)

LibUCW: xrealloc(ptr, 0) should return NULL and not die.