Important bug fixes and improvements by Axel Naumann. All changes are obviously backwards compatible: Nothing _needs_ to be changed in one's documentation (but a lot could be). Bugfixes and improvements:
Important bug fixes and improvements by Axel Naumann.
All changes are obviously backwards compatible:
Nothing _needs_ to be changed in one's documentation (but a lot could be).
Bugfixes and improvements:

Bugfixes:
* sometimes THtml wasn't able to identify a method of namespace'd classes in
source files,
* namespaced classes as return types are now correctly identified,
* global enums are known as classes to CINT although they don't have the
ClassDef macro. If such an enum showed up in a source file it resulted in a
link to their - non-existent - documentation page (as CINT returned a class
info), but as they don't have DeclFile / ImplFile no documentation is
generated for them. I resolved that by only generating a link for globals
only if the class info has a decl file specified. Thus gROOT still points to
TROOT.html, but kChildFrame doesn't point to EFrameType. Bug found by Thomas
Bretz.
* fXWho was set in the code. Now the env var Root.Html.XWho is read in; if
it's not set, the old value is used.
* unused var "funcName" in ClassDescription removed (there was one with
local scope & another one with method scope of the same name, one of them
was unused)
* gROOT is not asked anymore if "const" is a global object each time a
"const" shows up in the source file. Takes too much time.

Improvements:
* documentation (of the class responsible for self-documenting...).
* Authors: multiple authors can be given (comma separated list), custom HTML
link can be specified after each author name in <...>.
* some char strings were far too short and resulted in out-of-bounds memory
writes. Author, copyright, update and "nextLine" are changed (some from 80)
to 1024 chars now.
* Not documented: Doc++ compatible comments outside of methods. To enable it
the env var "Root.Html.DescriptionStyle" has to be set to "Doc++". THtml's
new ability does not influence anything else, it's completely independent.
Thomas Bretz and I have tested this for a while. But I'm not sure if
allowing multiple documentation styles is a good thing. So we could just
keep that a secret...


git-svn-id: ecbadac9c76e8cf640a0bca86f6bd796c98521e3@2891 27541ba8-7e3a-0410-8455-c3a389f83636

dawehner/root,bbannier/ROOT,dawehner/root,bbannier/ROOT,dawehner/root,bbannier/ROOT,dawehner/root,bbannier/ROOT,dawehner/root,dawehner/root,dawehner/root,bbannier/ROOT,bbannier/ROOT,dawehner/root,bbannier/ROOT