[root] Log of /trunk/html/src/TDocDirective.cxx

Revision 28845 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Jun 8 13:53:44 2009 UTC (5 years, 7 months ago) by rdm
File length: 29219 byte(s)
Diff to previous 27897

changes needed to be able to compile with Solaris CC5 and stlport4 STL
library. Backward compatible with old CC5 STL and other platforms.

Revision 27897 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Mar 20 13:27:04 2009 UTC (5 years, 10 months ago) by axel
File length: 29199 byte(s)
Diff to previous 27568

Improve speed of THtml, e.g. by caching the ClassEdit results and allowing the fClasses hash list to rehash, or using a THashList for the class's functions instead of a TList.
Fix the directive handling for module indexes; now works for tutorials (aka Convert), class doc, module indices, source files.
Fix several issues wrt documenting non-ROOT libraries, e.g. reported by Nick, e.g. determine the module name given an input path from the last subdir part of the input path ("../a" will be module "a").
Don't set ViewCVS to root.cern.ch if we're not documenting ROOT.
Work around a bug in CINT: ignore namespaces that are unknown (CINT can bogus create typedefs e.g. in ROOT::Math::ROOT::Math during template instantiation).
Improve the layout of the tutorials (hover link color was wrong).

There is still an issue with TClass changing the capitalization of the decl file name of classes on windows.

Revision 27568 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Feb 23 08:15:59 2009 UTC (5 years, 11 months ago) by axel
File length: 29172 byte(s)
Diff to previous 27541

Protect CreateLatex from the impossible: "new TCanvas" failing in the interpreter.

Revision 27541 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Feb 20 09:13:36 2009 UTC (5 years, 11 months ago) by axel
File length: 29056 byte(s)
Diff to previous 26807

Write source in Convert, never comment (i.e. directive output)
Rename pre.code to pre.listing to not clash with inline code's pre.
Always parse directives - they are needed e.g. for the class doc even when generating the source output.
Set bg for tabbed code to white.

Revision 26807 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Wed Dec 10 17:47:42 2008 UTC (6 years, 1 month ago) by axel
File length: 29053 byte(s)
Diff to previous 26677

Reset interpreter after executing macros in Convert().
Less interpreter invocations to do gClient calls.
if !gClient fall back to saving TCanvases only.
Convert() source as code.

Revision 26677 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Dec 5 14:28:08 2008 UTC (6 years, 1 month ago) by axel
File length: 29033 byte(s)
Diff to previous 23908

From Christian Holm Christensen and me:
After THtml::SetBatch() is called, BEGIN_MACRO(GUI) directives are skipped, i.e. the graphics system is not initialized. This is useful when creating the doc as part of a headless, automated build.

Revision 23908 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon May 19 15:25:29 2008 UTC (6 years, 8 months ago) by axel
File length: 28842 byte(s)
Diff to previous 23799

Fix coding converntion violations: structs end on "_t".
Document typedef-to-class on a separate page per typedef (as in TMatrixD.html);
mention the existing typedefs for a class (extremely useful for 350 character templates).
TDocParser::Context() was returning the top of an empty stack when it was not parsing but only decorating keywords.
Fix a few issues found by the W3C validator: a stray </div>, methods' toggle/signal/... abbr was a shorttag and wasn't meant to be (obviously).
Also reference templated types.
Also reference typedefs in a different scope than the global scope.
Replace printf by a call to Info().
Bail out of a doc directive wants GUI but we cannot switch to non-batch.
Also allow scopes and templates as return types for the type eval of an expression like "a.b()->".

Revision 23799 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon May 12 13:10:34 2008 UTC (6 years, 8 months ago) by axel
File length: 28627 byte(s)
Diff to previous 22419

Support new dir structure - support any dir structure, actually.
Allow THtml to find files even if they are only known as "include/TObject.h": THtml now parses all subdirs of the input path. Req by Gerhard Brandt, Fons.
Structure THtml's 1000 configuration vars a bit.
Implemented traits-like objects that allow the user to define modules, where to find files, etc, by deriving from the base classes used by THtml. 
Improve the doc search: add the top links box to all pages; add the search in there; make search ignore src/, examples/ subdirs of the output dir (i.e. only look at the doc itself) - req by Diego C.
Add info for methods' signal / menu / etc setting - req by Valeri O.
Print both last modified (source file change date) and last generated (html generation date) - suggested by Ornella.
Silence directive parser when encountering unknown directives - req by Rene.

Open issues remaining: typedef-to-class need separate page, forwarding to class's page. (req by Vassili Maroussov, Katharina Ehrhardt), TMath doc a bit broken.

Revision 22419 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Mar 3 00:25:01 2008 UTC (6 years, 10 months ago) by rdm
File length: 27797 byte(s)
Diff to previous 21328

From Andrew Savchenko:
ROOT can not be compiled with gcc-4.3.
Some ROOT source files doesn't contain required #include directives,
for example, they use strlen(), but #include <string.h> is missed or
malloc() is used and #include <stdlib.h> is missed. 

Earlier versions of gcc allowed some headers to be included implicitly,
but issued a warning (-Wimplicit-function-declaration). Newer one,
gcc-4.3 denies such silly behaviour: all required headers must be explicitly
included. 

Attached patch fixes this. Also it fixes another issue, which disallows
ROOT to compile under gcc-4.3: C functions don't belong to namespace std,
so expressions like std::memcpy() are no longer valid and plain memcpy()
should be used instead.

Revision 20882 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Nov 19 11:31:26 2007 UTC (7 years, 2 months ago) by rdm
File length: 25595 byte(s)
Diff to previous 19593

Set property svn:eol-style LF on all source and Makefiles. This should avoid
problems with Win32 line endings ending up in the repository. All MS tools
support LF eols fine.

Revision 19593 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Aug 10 13:01:33 2007 UTC (7 years, 5 months ago) by axel
File length: 25595 byte(s)
Diff to previous 18437

* 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.

Revision 18437 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Mar 30 07:55:27 2007 UTC (7 years, 9 months ago) by rdm
File length: 24998 byte(s)
Diff to previous 18338

From Bertrand:
make sure that InitalizeGraphics() is properly called.

Revision 18338 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Mar 19 10:59:41 2007 UTC (7 years, 10 months ago) by axel
File length: 24961 byte(s)
Diff to previous 18302

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

Revision 18302 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Mar 16 18:07:07 2007 UTC (7 years, 10 months ago) by axel
File length: 24960 byte(s)
Diff to previous 18293

Work-around MSVC7.1 bug

Revision 18293 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Mar 16 15:25:55 2007 UTC (7 years, 10 months ago) by axel
File length: 24952 byte(s)
Diff to previous 18136

* fix func doc div containing a directive
* 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

Revision 18136 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Mar 2 10:24:14 2007 UTC (7 years, 10 months ago) by brun
File length: 23586 byte(s)
Diff to previous 18079

From Bertrand:
Fix graphics libraries loading/initialization.

Revision 18079 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Feb 23 17:42:32 2007 UTC (7 years, 11 months ago) by axel
File length: 23584 byte(s)
Diff to previous 17976

Fix missing empty lines in directives
Rewind dictionary after doc macro execution
Make sure class table gets rebuilt after call to THtml::SetSourceDir()
Embed img inside span to be xhtml compliant even in pre
Load graphic libs if needed, before a macro triggers it and we rewind CINT after the macro
Find module doc when pwd!=ROOTSYS
Find doc macros when pwd!=ROOTSYS or macro file name has (relative) path
Specify full path to mathcore/... sources (to find their doc/ when pwd!=ROOTSYS)
Allow determination of product==ROOT even for BOOTLIBS
Fix THtml's doc
Allow lines in doc macros to be hidden from source tab: must end on *HIDE*

Revision 17976 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Feb 15 20:31:21 2007 UTC (7 years, 11 months ago) by brun
File length: 22439 byte(s)
Diff to previous 17971

Fix a compilation error on Solaris.

Revision 17971 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Feb 15 17:32:32 2007 UTC (7 years, 11 months ago) by axel
File length: 22432 byte(s)
Diff to previous 17827

Generate product doc, re-group code for re-use in module/product doc
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

Revision 17827 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Feb 9 13:59:29 2007 UTC (7 years, 11 months ago) by axel
File length: 22331 byte(s)
Diff to previous 17806

Work-around for X11 sync problem when processing a macro in non-batch mode;
strlen fix for comment-consistes-of-identical-chars test

Revision 17806 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Feb 8 22:56:06 2007 UTC (7 years, 11 months ago) by axel
File length: 22129 byte(s)
Diff to previous 17780

Don't display classes in index that are "foreign", i.e. have no local sources
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

Revision 17780 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Feb 8 10:25:00 2007 UTC (7 years, 11 months ago) by brun
File length: 21166 byte(s)
Diff to previous 17771

From Axel:
workaround a silly MSVC bug.

Revision 17771 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Feb 8 05:50:25 2007 UTC (7 years, 11 months ago) by brun
File length: 21159 byte(s)
Diff to previous 17762

From Axel:
bounds check for same-char-line determination, fix offset for
pre-is-open check.
>From Maarten: fix test whether dot dir is specified.

Revision 17762 - (view) (download) (as text) (annotate) - [select for diffs]
Added Wed Feb 7 20:40:39 2007 UTC (7 years, 11 months ago) by brun
File length: 21144 byte(s)

From Axel:
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  :-)

This form allows you to request diffs between any two revisions of this file. For each of the two "sides" of the diff, enter a numeric revision.

Links to HEAD:	(view) (download) (as text) (annotate)
Sticky Revision: