/**

\mainpage GNU Cygnal

\section s_Introduction Introduction

	Documentation for the source code of GNU Cygnal.
	
\section s_Code_Organization Code Organization

	The code is organized into a set of modules:
	- \ref ACT.  
		Asynchronous Computation Task.  
		The multitasking foundation of the system.
	- \ref IO. 
		Input/Output.
		ACT-enabled I/O infrastructure.
		Provides scattered buffering and the conversion of asynchronous block I/O into an asynchronous stream abstraction.
	- Net.
		Network I/O.
		ACT-enabled network primitives.
	- HTTP.
		HTTP syntax and protocol behavior.

\section s_Running_Doxygen Running Doxygen [EH as of 2007-07-05]

	Doxygen doesn't deal so well with code that makes heavy use of templates.
	Here's a <a href="http://bugzilla.gnome.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=template&product=doxygen&long_desc_type=substring&long_desc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDINFO&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailqa_contact2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Bug+Number&field0-0-0=noop&type0-0-0=noop&value0-0-0=">search for doxygen template defects</a>.
	While it would be a good thing for doxygen to run without errors, that's not happening now.
	The two most common defects seem to be these:
		- No recognition of explicit template instantiation: http://bugzilla.gnome.org/show_bug.cgi?id=331519.
		- Conflation of members in template specifications: http://bugzilla.gnome.org/show_bug.cgi?id=406027.
	There are a couple of other errors doxygen spits out.
	I haven't located them in the doxygen issue tracker.

 */