ucw docs: List of undocumented modules

Only first shot, still needs some sorting

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

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.

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.

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

ucw docs: Documented mempools

There were many comments in the header file, reusing them,
adding only a little bit and reformatting.

ucw docs: Some more in conf system

Documented something about loading the configuration by functions in
ucw/getopt.h.

Doc. system: Properly extract multiline definitions

Doc. system: escape apostrophes in def list

Asciidoc takes 'quoted' text as italic. Escape when part of the
definition.

ucw docs: preprocess conf.h

Reused some comments in ucw/conf.h for documentation, created structure
in the file. Some things still need to be documented in this header
file.

Doc. system: fix detection of pointer variables

The * before variable name stopped it from matching.

Doc. system: detect function typedefs

things like
typedef function(void)
were considered functions, not types.

Doc. system: stop pointer marks from boldifying

Sometimes two pointer asterisks in the definition made some part of it
bold, removing the asterisks. Escape them all.

ucw docs: configuration parser (example)

Just an example how to use it. The thorough documentation of the headers
and functions to follow.

Document the documentation system syntax

Maybe put it to a better place?

Doc. system: add support for typedefs

And a little cleanup/code compression at the occasion.

ucw docs: hashfunc reflects the syntax change

ucw docs: basecode reflects the syntax change

ucw docs: fastbufs reflect the syntax change

Change function() to @function() when a link should be created.

Doc. system: use @function() for function links

<<function()>> works too, this is just replacement of the old implicit
function(), which caused problems (the system wanted to put the links
everywhere).

Removed some hacks around the old problems, which are no longer needed.

ucw docs: fix function quoting

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

ucw. docs: Update hash documentation

More info about non-crypto hashes
Better links inside the page

Doc. system: Fix inline functions in description

They had { }, if it was on the first line.

Simpler handling of definitions.

Doc. system: deflists have different formatting

The asciidoc definition lists are used, the items are aligned in two
columns.

CGI.pm: More improvements to the cookie mechanism.

I am trying to make the parameters as close as possible to the
new standard (they make better sense and I want to keep the function
compatible with older versions of CGI.pm).

It also handles options with no values more gracefully.

CGI.pm: Cope with corrupted cookie headers.

Doc. system: Add type sections to definition list

The definitions, grouped by type, have section captions (Enums, Structs,
etc).

Doc. system: Definition list has visible name

The link is just the symbol name, the one-line header is bellow it now.

Doc. system: fix semicolons

They were sometimes missing at the end of one-line headers.

Doc. system: No body to func. header

Do not include body of inline functions even if the body is in the
single line.

Doc. system: use better anchors

The anchor names are based on the name and type of identifier, not a
dull nothing telling number.

Doc. system: fix ... in function parameters

Asciidoc tries to convert all ... strings into ellipsis character, which
is wrong in function parameters (it is 3 separate chars in reality,
besides this caused problems with xrefs, links, etc).

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

CGI.pm: Make cookie setting headers backwards-compatible.

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

Doc. system: depend on build scripts

So when a script or configuration changes, all parts of documentation
are updated.

CGI.pm: Export URL and parameter de-escaping functions.

ucw docs: more hash functions

I will add more when I find where they live

A couple of fixes to hash function documentation.

Doc. system: recognize typedefs of structs

Recognize patterns like this as a struct. Similar for enum.

typedef struct {
  something;
} name;

ucw docs: Hash routines

MD5 and SHA1 hashes.

ucw docs: update basecode

ASCII is only 7bits, this uses all 8.
Referencing a comment at the top of .c file.

Doc. system: fix definition duplicities

They were caused by appending to a deflist instead of overwriting. If
the original file was changed and documentation recompiled, new
definitions were added to the old ones.

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.