const redundant (warning from icc).


git-svn-id: http://root.cern.ch/svn/root/trunk@22676 27541ba8-7e3a-0410-8455-c3a389f83636

* allow several classes in one source file with doc for each. Documentation in front of a class' ClassImp() invocation will be used; if there is none, the first one in the file will be taken (see e.g. TH1F etc: shared doc for all classes).
* convert the class doc parsing into a state machine which fixes a few cases where THtml was "forgetting" to write the class doc.
* fix a span for namespaces.
* Strip() now also removes newlines.
* clear un-used comments; fixes rare problem with misinterpreted comments.


git-svn-id: http://root.cern.ch/svn/root/trunk@21326 27541ba8-7e3a-0410-8455-c3a389f83636

git-svn-id: http://root.cern.ch/svn/root/trunk@19826 27541ba8-7e3a-0410-8455-c3a389f83636

git-svn-id: http://root.cern.ch/svn/root/trunk@19825 27541ba8-7e3a-0410-8455-c3a389f83636

git-svn-id: http://root.cern.ch/svn/root/trunk@19712 27541ba8-7e3a-0410-8455-c3a389f83636

* The info box in the class doc page is now only shown if javascript is created; this makes the reference guide more suitable for e.g. TGHtml but also links/lynx etc. Achieved by writing the info box with javascript.
* With !=1 as the third argument to THtml::MakeAll(), THtml will use a thread pool when generating the documentation. Added the necessary locks. Threads cannot create TCanvases which is a problem for TDocDirective; this remains to be fixed. As in: WARNING: don't pass numthreads != 1 if you have a TDocMacroDirective or TDocLatexDirective!
* Fix constness of a few functions.
* Don't put $ROOTSYS in front of module's source path
* Fix a string index ==-1 problem in TDocParser::LocateMethodInCurrentLine() discovered with TMath
* TDocDirective: don't delete returned objects if gPad has changed - it might be part of the TCanvas and thus deleted when deleting gPad.
* Add a few gVirtualX->Update()s to reduce the amount of X11 errros.
* Use ':' as the macro path delimiter, even on Windows.
* Only initialize the graphics libs if needed.
* Hack to change the new DeclFileName()s for ROOT from include/Whatever.h to module/inc/Whatever.h, so ViewCVS can display it.
* Hack of hack to fix the DeclFileName() for TMVA.
* Increase the font size of pre blocks; they were too small with TTF on linux.


git-svn-id: http://root.cern.ch/svn/root/trunk@19593 27541ba8-7e3a-0410-8455-c3a389f83636

* Add THtml::IncludePath(): remove parts of DeclFileName() for the class info box (e.g. "include/" for ROOT), instead of using BaseName(). Fixes problem with e.g. MathCore's Whatever.h instead of the proper Math/GenVector/Whatever.h.
* Add static THtml::LoadAllLibs(): load all libraries for all classes known via rootmaps, without re-loading dependent libraries. Handy for generating doc for all classes.
* Clean THtml.cxx include files.


git-svn-id: http://root.cern.ch/svn/root/trunk@19494 27541ba8-7e3a-0410-8455-c3a389f83636

Allow invocation of all graphjviz tools, e.g. fdp.
library dependencies: use fdp, cleaner layout by skipping A->C if A->B->C exists, too.


git-svn-id: http://root.cern.ch/svn/root/trunk@19221 27541ba8-7e3a-0410-8455-c3a389f83636

Report constness of function and parameter default values also in method doc if method is unique without overload resolution.
HTML-escape '"' in link tooltips.


git-svn-id: http://root.cern.ch/svn/root/trunk@18997 27541ba8-7e3a-0410-8455-c3a389f83636

Extract one-line C comments properly
Don't output class description (again) after first method has been written
Fix module name extraction: skip leading "./"
Set src files for reflex
Fix check for internal classes


git-svn-id: http://root.cern.ch/svn/root/trunk@18717 27541ba8-7e3a-0410-8455-c3a389f83636

git-svn-id: http://root.cern.ch/svn/root/trunk@18419 27541ba8-7e3a-0410-8455-c3a389f83636

Fix typo in THtml::SetMdouleDocPath()
More sleeping for GUI macro directives (now 1sec)
Fix title for product doc's class hierarchy


git-svn-id: http://root.cern.ch/svn/root/trunk@18338 27541ba8-7e3a-0410-8455-c3a389f83636

* fix <pre></pre> parsing
* fix graphics initialization
* strip macro name for directive
* handle macro param for directive
* convert the macro source
* fix tags (=file names) for directive-generated imgs
* fix class doc search in headers
* remove leading ///// in comment
* add some padding in front of method args


git-svn-id: http://root.cern.ch/svn/root/trunk@18293 27541ba8-7e3a-0410-8455-c3a389f83636

Add all gEnv configs also as setters/getters; use gEnv in THtml c'tor, afterwards only getters
write search link on each page
shorten the class inh dot diagrams for complex hierarchies
Allow trailing stuff in ViewCVS link
remove spurious empty lines in directive output
fix latex column chopping (one char missing at end)
Rename a few internal funcs
Create unique directive output GIFs
update THtml doc
Add special handling for smatrix "source" dir
Skip empty sourceinfos (author,...) in footer


git-svn-id: http://root.cern.ch/svn/root/trunk@17971 27541ba8-7e3a-0410-8455-c3a389f83636

fix libdep calculation;
simplify libdep graph (no libCore dependencies, no need to loop over all of lib's classes);
fix classdescr and module doc prob discovered with mathcore;
protect chars from being signed when invoking isspace;
don't write comment of directive ate it;
Replace special hcars for index chars;
take all doc for doc++ style method doc until we see one of "{};"


git-svn-id: http://root.cern.ch/svn/root/trunk@17942 27541ba8-7e3a-0410-8455-c3a389f83636

make rule checker happy
Allow user setting of etc dir (defaults to $ROOTSYS/etc/html)
GUI macro output must be saved as GIF
Fix macro's pwd determination if no current class
Fix X11 crash saving macro output
Fix removal of surrounding "//" in "// doc //"
New THtml::CreateAuxiliaryFiles() takes care of CSS, js, HELP page


git-svn-id: http://root.cern.ch/svn/root/trunk@17806 27541ba8-7e3a-0410-8455-c3a389f83636

Added functionality:
* Begin_Macro/End_Macro, Begin_Latex/End_Latex (generate images, see
TDocParser's doc for now)
* module documentation (e.g. html/doc/index.html)
* help on help (savannah bug #20755)

Separate parser and output generator; public interface stays in THtml.
Create a "hook" for directives like Begin_Html/End_Html etc, to make it
easily expandable.
New layout, bug fix (savannah #20472).
Missing: lots of doc. Rule checker fixes  :-)


git-svn-id: http://root.cern.ch/svn/root/trunk@17762 27541ba8-7e3a-0410-8455-c3a389f83636

git-svn-id: http://root.cern.ch/svn/root/trunk@17345 27541ba8-7e3a-0410-8455-c3a389f83636

New class charts if www.Graphviz.org's dot is available. Fix detection
of comments indented with tabs. Fix update dependency tracking of files.


git-svn-id: http://root.cern.ch/svn/root/trunk@16318 27541ba8-7e3a-0410-8455-c3a389f83636

Don't write beautified text in "Begin_Html"/"End_Html" block when
Converting. Don't rebuild the list of classes if the same filter is
used. Don't empty parse stack if we only have one element on it.


git-svn-id: http://root.cern.ch/svn/root/trunk@16076 27541ba8-7e3a-0410-8455-c3a389f83636

* when within Begin/End_Html, don't use beautified but original line as
comment
* state if a member is static
* allow method signatures and docs for data members to span multiple
lines, but indent additional lines.
* fix what THtml thinks is an enum (see e.g.
http://root.cern.ch/root/html/THtml.html#THtml:fDocContext)
* prepend enums with "enum", always (see e.g.
http://root.cern.ch/root/html/THtml.html#THtml:kUp)
* initialize some state vars - first class being documented didn't have
proper links (see http://root.cern.ch/root/html/ColorStruct_t.html)
* update THtml's documentation
* clean THtml.h's #includes
* remove exposed typedef

The first 5 changes might warrant all docs to be regenerated, but only
next week.


git-svn-id: http://root.cern.ch/svn/root/trunk@16069 27541ba8-7e3a-0410-8455-c3a389f83636

Document private members, too (oops). Update THtml's doc (part 1). Make
CreateStyleSheet() and CreateJavascript() public. Fix treatment of <pre>
</pre> tags.


git-svn-id: http://root.cern.ch/svn/root/trunk@16052 27541ba8-7e3a-0410-8455-c3a389f83636

get THtml::Convert back on its feet. Allow to specify a relative path on
the server, so we can create the proper links. Coding convention.


git-svn-id: http://root.cern.ch/svn/root/trunk@15922 27541ba8-7e3a-0410-8455-c3a389f83636

Show inherited data members; same layout and options as for func
members. Don't show hidden funcs. Separate display of enums. Avoid empty
pre blocks. Fix JS so it also works on IE(7), use local vars, find CSS
rules case insensitive.


git-svn-id: http://root.cern.ch/svn/root/trunk@15916 27541ba8-7e3a-0410-8455-c3a389f83636

Fix comments inside comments after strings (aka TH1::Rebin) by using a
parse context _stack_. Show base classes' methods if requested. Reformat
method list. Display options (inherited methods? non-public methods?)
are stored in a cookie. We now also have a javascript file. Disable
method sorting on Solaris until they implement a sort-with-predicate.
Again, some chunks of code come from my FNAL/CMS/CD job.

Builds on Solaris CC5 and Win MSVC8.


git-svn-id: http://root.cern.ch/svn/root/trunk@15904 27541ba8-7e3a-0410-8455-c3a389f83636

New doc type XHTML 1.0 transitional; w3c validator now happy (except for
what's in BEGIN/END_HTML)
Escape func names for href targets
Anchors can now be created during all passes: can now jump to inline
methods, too.
When looking for method impl, don't look behind '{'
Reduce method overload count properly (don't erase name before using it)
Fix removal of same-char doc lines ("//+++++++++++++")
Same-char doc lines are class descr tag
Fix removal of trailing */
Fix state reset of kCComment
Introduce line no (do we want them in the doc?)
Close ClassDecl div if no decl found
For globals doc link to their type in ListOfTypes, not their name
Allow '~' as part of name (IsWord, IsName) for d'tors
Fix rootdev email address
"This page has been automatically generated" is no address


git-svn-id: http://root.cern.ch/svn/root/trunk@15863 27541ba8-7e3a-0410-8455-c3a389f83636

* Properly close method / class description blocks.
* inline methods which are real "one liners", as in
  { foo(); }
  will now have their code shown.
* keywords now black, non-bold.
* add a ViewCVS link, if Root.Html.ViewCVS is set to e.g.
http://root.cern.ch/viewcvs/ (note the trailing "/"!) - thanks to Matevs
for the suggestion.
* move some code into new funcs to avoid code duplication and to clarify
what's happening.
* shorter anchors

Still to come: MENU, SIGNAL comments.


git-svn-id: http://root.cern.ch/svn/root/trunk@15771 27541ba8-7e3a-0410-8455-c3a389f83636

git-svn-id: http://root.cern.ch/svn/root/trunk@15768 27541ba8-7e3a-0410-8455-c3a389f83636

New version fixing a problem with comments of pure virtual functions.


git-svn-id: http://root.cern.ch/svn/root/trunk@15741 27541ba8-7e3a-0410-8455-c3a389f83636

a few days later than expected, but here it is: a major update for
THtml. I've re-used a large chunk of the code that I wrote at FNAL; so
kudos to them, too! I am positive that it's not perfect yet, still IMHO
the benefit is greater than the consequences of THtml's imperfections.

THtml now parses header files and source files for documentation, and it
beautifies sources and headers alike. THtml's internals (its code
intestine) have been pulled apart a bit and rewritten to a large extent
for better maintainability. Most of the char* are replaced by TStrings.
Copying headers is now a lot faster thanks to gSystem->CopyFile.

THtml is now relying on CSS for all pages; the beautification happens
purely with CSS (and is thus customizable, once more browsers finally
allow for a custom user CSS, like Opera does). The source beautification
and the method and class doc is revamped: keywords, comments, strings,
and CPP statements are now colored, links a fancier.

Another major enhancement is THtml's ability to pick up doc from
headers. By default, functions in source files have to be documented
as always:

void MyClass::Func()
{
// doc in source.cxx
}

Now, funcs in headers can also have doc in front of the function:


git-svn-id: http://root.cern.ch/svn/root/trunk@15739 27541ba8-7e3a-0410-8455-c3a389f83636

git-svn-id: http://root.cern.ch/svn/root/trunk@15061 27541ba8-7e3a-0410-8455-c3a389f83636

* allow to set custom impl, decl file names for a class for THtml
* for class [A::]B::C without decl and impl file name, automatically
check whether header b/inc/B/C.h, source b/src/C.cxx exist
* special treatment of Smatrix, mathcore classes, so they end up in the
proper module
* fix output of templated parameters


git-svn-id: http://root.cern.ch/svn/root/trunk@14914 27541ba8-7e3a-0410-8455-c3a389f83636

* nicer ClassIndex, MODULE_Index, TypeIndex
* short cuts to entries in the long list of classes
* create links to MODULE_Indexes in ClassIndex
* re-define what a root class is, and what a use class looks like - now
RooFit classes are root classes, too (even though they don't start witha
 "T")
* use style sheet, which is generated (and used) by MakeIndex
* Root.Html.Search instroduced,
* remove unused code


git-svn-id: http://root.cern.ch/svn/root/trunk@14845 27541ba8-7e3a-0410-8455-c3a389f83636

Use CreateListOfClasses to set up a consistent set of classes to be
documented.
Use uchar for isalnum etc
Only use TROOT::GetClass(...,true) when building the list of classes.


git-svn-id: http://root.cern.ch/svn/root/trunk@14591 27541ba8-7e3a-0410-8455-c3a389f83636

git-svn-id: http://root.cern.ch/svn/root/trunk@12624 27541ba8-7e3a-0410-8455-c3a389f83636

by Axel Naumann to generate a clickable class hierarchy in the class.html pages


git-svn-id: http://root.cern.ch/svn/root/trunk@8070 27541ba8-7e3a-0410-8455-c3a389f83636

THtml will replace a few new vars in the header template file
(Root.Html.Header):
%CLASS% -> class name,
%INCFILE% -> include file name, as given by TClass::GetDeclFileName()
%SRCFILE% -> source file name, as given by TClass::GetImplFileName()
All of them default to "" if the header is generated for a non-class
page. This allows e.g. linking in cvsweb.cgi pages.

Also includes minor bug fixes in THtml's documentation (e.g.
begin_html/end_html were sometimes not meant to be replaced) and some
fixes for wrong indentations.


git-svn-id: http://root.cern.ch/svn/root/trunk@7958 27541ba8-7e3a-0410-8455-c3a389f83636

This is necessary when THtml is included itself in some user code.


git-svn-id: http://root.cern.ch/svn/root/trunk@6133 27541ba8-7e3a-0410-8455-c3a389f83636

Inlined virtual destructor are known to cause problem with some compilers.  KCC, with exception enabled, is definitively one of them.  I solved the problem by moving the destructor to the implementation file.


git-svn-id: http://root.cern.ch/svn/root/trunk@6040 27541ba8-7e3a-0410-8455-c3a389f83636

git-svn-id: http://root.cern.ch/svn/root/trunk@6017 27541ba8-7e3a-0410-8455-c3a389f83636