Data-formatting xsl-fo module taken out of zorba's core
Fixed the compilation error caused by the latest String API changes.
I have added the correct categories for the modules that appear as part of the left menu tree of the XQDoc documentation. I have also update the external modules as well.
changes in the c++ api regarding functions
XQDoc rework.
Now zorba and each external module have two build targets: xqdoc-xml and xqdoc. 
xqdoc-xml is to generate the xml from xqdoc information.
xqdoc target is to generate the final html from the intermediary xml.
Zorba's xqdoc depends on the xqdoc-xml from zorba and all external modules.
You can also build the xqdoc target for a specific external module, and generate only its documentation. If the external module is built in zorba project, then the zorba internal modules' xqdoc is always generated.
cleanup of the structure of the xqdoc generated documentation
new DECLARE_ZORBA_MODULE macro for all external modules + version 1.0 for all modules
Added DECLARE_ZORBA_SCHEMA() and cut over internal and external modules to
use it. Enhancements to DECLARE_ZORBA_MODULE(), including better API with
explicit parameters, and shorter target names to help Windows 260-character
path limitations.
Fixed some typos in the modules under 'xqdoc' and 'data processing' categories.
Restructure DECLARE_ZORBA_MODULE()/DECLARE_ZORBA_SCHEMA() to not create a ton
of mini-targets, to help clean up MSVC projects. Required introduction of
DONE_DECLARING_ZORBA_URIS() which is added to all module projects and Zorba.
- s/error_list.h/diagnostic_list.h because it also contains warnings
- warning_list.h was an obsolete file. All warnings were already generated in the previously existing error_list.h file
Numerous changes from Juan for 0-configuration on Windows and Windows
installer issues. Also some tweaks from me for install path issues.
Removing stale INSTALL directives from external modules.
XQuery version changes:
- Added XQuery version declarations for all the modules (part of the Zorba core or not).
- fixed the test "moduleDocumentation" that checks if all the modules are well documented:
  - this test used to check only the Zorba core modules: now it also checks the external modules.
  - added a new rule that makes sure all modules have a XQuery version declarations.

XQDoc changes:
- documented some XQDoc variables, params and return values that were missing.
- added support for XQuery version and Encoding in the Zorba XQDoc.
- added a new part called "XQuery version and Encoding for this module:" as the last lines in the module description of the XQDoc documentation.
fixes for Mantis bug 0000090
adapted try-catch to latest w3c working draft (14 June 2011)

$err:code, $err:description, $err:value, $err:module, $err:line-number, and $err:column-number are implicilty bound
fixed a strange typo in the xsl-fo module
- improved the speed of "make xqdoc" such that we can add xqdoc as a test
- fixed SF bug #3375604 "Built target cxxdocs" hangs
- make xqdoc does not search the filesystem, instead creates the documentation *only* for the modules that are compiled in the Zorba version used (based on the ZorbaManifest.xml in the build folder)
- implemented the 2 issues that Dana asked for in the email from @coders "core and non-core Zorba modules"
- fixed the link crawler issues in XQDoc reported by Daniel (except the link to xqdoc.org)
documentation and errors for the xsl-fo module (provided by William)
- removed file module dependency from xsl-fo module
- fixed query admin.xq (adapted to new annotations and scripting draft). The test was still marked as expected to fail although it was fixed already.