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.

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.