Log of /trunk/html/src/TDocOutput.cxx
Parent Directory
Revision
44507 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Mon Jun 4 12:30:41 2012 UTC (2 years, 7 months ago) by
axel
File length: 92359 byte(s)
Diff to
previous 44322
Remove
using namespace std;
from Riostream.h, which has huge consequences for all of ROOT.
Riostream.h is now a simple wrapper for fstream, iostream, iomanip for backward compatibility; Riosfwd.h simply wraps iosfwd.
Because of templates and their inline functions, Riostream.h needed to be included in headers, too (e.g. TParameter.h), which violated the assumption that Riostream.h is not exposing its using namespace std to headers.
ROOT now requires R__ANSISTREAM, R__SSTREAM, which does not change the set of supported compilers.
Without "using namespace std", several identifiers are now prefixed by std::; e.g. roofit/* source files now have a using namespace std to keep their coding style.
TFile::MakeProject() now generates "using namespace std" to convert the CINT-style class names into C++ ones.
Revision
32774 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Thu Mar 25 20:09:04 2010 UTC (4 years, 10 months ago) by
axel
File length: 90170 byte(s)
Diff to
previous 31521
Copy module doc files that THtml does not process into the output directory. Allows doc/ with pictures, css, etc. Fixes memstat doc.
Revision
31121 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Thu Nov 12 11:51:30 2009 UTC (5 years, 2 months ago) by
axel
File length: 88766 byte(s)
Diff to
previous 31117
Rely on TDocOutput::AdjustSourcePath() to find the location of the header files linked in a #include expansion, instead of unconditionally setting "../".
Fixes links to header files in tutorials, e.g. in hist/h1draw.C.html
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: 88683 byte(s)
Diff to
previous 27562
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
27562 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Sat Feb 21 10:55:11 2009 UTC (5 years, 11 months ago) by
axel
File length: 88606 byte(s)
Diff to
previous 27561
Line numbers are now anchors: one can send them around and bookmark them to jump to a certain line.
They are now also copy&paste-able: for a file SrcFile.cxx and its line 123 the text will be "SrcFile.cxx:123", i.e. idea for setting a breakpoint e.g. in GDB.
Factor out the writing of line numbers (from TDocParser::Convert and TDocOutput).
Fix the href of the empty source file links for source-less classes.
Revision
27561 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Fri Feb 20 23:22:22 2009 UTC (5 years, 11 months ago) by
axel
File length: 87867 byte(s)
Diff to
previous 27531
Fix layout for classes with unknown source file (e.g. genvector): body's div was closed too early, descrhead alignment was messed up.
Use short template names (i.e. without default parameters) where possible. This drastically improves the readability of templates. It also revealed a bug in CINT wrt typedef autoloading; fixing that will make this improvement work for all cases.
Revision
27531 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Thu Feb 19 16:51:35 2009 UTC (5 years, 11 months ago) by
axel
File length: 87578 byte(s)
Diff to
previous 27492
When converting sources with line numbers (i.e. code) we cannot interpret directives as it would close any open <pre> which is fatal.
To better control what's happening inside convert's pre it is now contained in a div; both sue the new class listing.
Fixes display of the tutuorials.
Revision
27007 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Thu Dec 18 16:37:51 2008 UTC (6 years, 1 month ago) by
axel
File length: 87130 byte(s)
Diff to
previous 26944
Fix a severe issue with the documentation for the indices: the documentation in doc/ did not show up.
Fix a miscount of </div> tags around WriteTopLinks
Revision
26944 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Tue Dec 16 10:27:55 2008 UTC (6 years, 1 month ago) by
brun
File length: 87021 byte(s)
Diff to
previous 26867
From Axel and me:
patch calls $ROOTSYS/etc/html/saveScriptOutput.C for some
directories (gui,...). With that MakeTutorials finishes for almost all the
tutorials - a few are crashing, and a few need a restart
Revision
26867 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Fri Dec 12 10:59:58 2008 UTC (6 years, 1 month ago) by
axel
File length: 86209 byte(s)
Diff to
previous 26838
On Solaris we cannot use Anar's iterator interface for TIter, e.g. to insert all entries from a TList into a set. Revert to good old manual iteration instead.
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: 85742 byte(s)
Diff to
previous 26763
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
26734 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Mon Dec 8 16:35:16 2008 UTC (6 years, 1 month ago) by
axel
File length: 81735 byte(s)
Diff to
previous 26726
Put Canvases to the right of the code but at the top of the page.
Hovering switches the canvases to their original size.
Convert() now takes a bitmask: kInterpretedOutput interprets the file, kCompiledOutput uses ACLiC and if combined with kForceOutput existing PNGs are ignored.
Convert() now has a new parameter (context) which is written verbatim to the output file; useful e.g. for context links (up, next,...)
Revision
26726 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Mon Dec 8 11:40:35 2008 UTC (6 years, 1 month ago) by
axel
File length: 81854 byte(s)
Diff to
previous 26676
Convert: show canvases on top of script; show thumbnails on the left and full size on the right with links to canvases if more than one canvas is created
Revision
26675 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Fri Dec 5 13:56:08 2008 UTC (6 years, 1 month ago) by
axel
File length: 80923 byte(s)
Diff to
previous 26551
Add the ability to store PNGs of canvases created by files (e.g. tutorials) apssed to THtml::Convert().
If the new parameter includeOutput is set to true, THtml will run the file that it is supposed to convert to HTML and add a PNG next to the converted source.
These PNGs are only generated (and the script is thus only run) if the script is newer than the first PNG file (scriptname.C_0.png) - otherwise the existing PNG files are reused.
Revision
26551 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Mon Dec 1 16:01:18 2008 UTC (6 years, 1 month ago) by
axel
File length: 76641 byte(s)
Diff to
previous 23937
Shorten output file names by using two different approaches:
A: replace "A::X<A::Y>" by "A::X<-p0Y>",
"A::B::X<A::B::Y>" by "A::B::X<-p1Y>", etc,
i.e. reuse the enclosing scope for template parameters.
Example: ROOT__Math__PositionVector2D_-p1Cartesian2D_double__-p1DefaultCoordinateSystemTag_.html
instead of ROOT__Math__PositionVector2D_ROOT__Math__Cartesian2D_double__ROOT__Math__DefaultCoordinateSystemTag_.html
B: if the file name is still > 240 chars (ext2 has a max of 255) then
chop it off and patch a hash in (with a leading "this is a hash" tag).
So the name becomes "beginning_of_name"-h"hash"."extension".
Example: vector_ROOT__Math__DisplacementVector3D_ROOT__Math__CylindricalEta3D_double__ROOT__Math__DefaultCoordinateSystemTag__allocator_ROOT__Math__DisplacementVector3D_ROOT__Math__CylindricalEta3D_double__ROOT__Math__DefaultCoordinateSystem-hC3SnxD.html
This fixes Savannah #42815.
Revision
23933 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Tue May 20 14:35:44 2008 UTC (6 years, 8 months ago) by
axel
File length: 74360 byte(s)
Diff to
previous 23932
When the filesystem is uphappy about a file name (typedef name too long) skip that one typedef instead of giving all on all.
Revision
23932 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Tue May 20 14:01:07 2008 UTC (6 years, 8 months ago) by
axel
File length: 74358 byte(s)
Diff to
previous 23908
Add debug output for gDebug>0; silence TFileSysDir::Recurse()'s output a bit.
Make links within the converted modules' index.txt relative to "./", not "../".
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: 74210 byte(s)
Diff to
previous 23812
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
23812 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Tue May 13 08:56:07 2008 UTC (6 years, 8 months ago) by
axel
File length: 70098 byte(s)
Diff to
previous 23799
IsSelected() was broken because HaveSource() only tested for impl file name; now just tests for decl file name which also works for templated classes. SMatrix doc is now back.
Fix "does dot exist?" algo; was still esting for -1 instead of kDotUnknown
"Search documentation..." text now vanishes again when clicked.
Add a title to the "Search" button containing the search host used. Fixes Savannah #34509.
Fix include file determination (aka ".h5", "core/base/inc/TObject.h")
Use TPMERegexp; TRegexp with wildcard is broken anyway; TPMERegexp works nicely.
Do not find sources files of "math/mathcore/", "math/mathmore/", "math/genvector/", "math/minuit2/", "math/smatrix/", even though we can. They have their class doc in the header; but if THtml finds the source it needs the class doc to be in the source file. Will be improved at some point.
ViewCVS link was written even if no decl / impl file known; fixed.
Sort modules (and sub-modules) for writing the list of modules.
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: 69801 byte(s)
Diff to
previous 23595
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
22546 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Sat Mar 8 19:21:05 2008 UTC (6 years, 10 months ago) by
rdm
File length: 65227 byte(s)
Diff to
previous 22488
other bunch of gcc 4.3 warnings removed:
- warning: suggest a space before ; or explicit braces around empty body
in for statement
Revision
22488 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Thu Mar 6 16:04:47 2008 UTC (6 years, 10 months ago) by
rdm
File length: 65221 byte(s)
Diff to
previous 22419
remove first batch of warning reported by gcc 4.3:
- warning: suggest parentheses around && within ||
- warning: suggest explicit braces to avoid ambiguous if else
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: 65190 byte(s)
Diff to
previous 21544
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: 64254 byte(s)
Diff to
previous 19826
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: 63719 byte(s)
Diff to
previous 19443
* 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
19221 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Mon Jul 2 14:31:27 2007 UTC (7 years, 6 months ago) by
axel
File length: 63519 byte(s)
Diff to
previous 19216
Simplify the tracking of library dependencies - move them into new TLibraryDocInfo
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.
Revision
19216 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Mon Jul 2 09:34:36 2007 UTC (7 years, 6 months ago) by
axel
File length: 61279 byte(s)
Diff to
previous 18997
Allow "Search" field to use referer to determine the search site.
Fixes problems with the search engine finding pages that don't match the ROOT version currently looked at.
Revision
18997 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Mon Jun 11 14:09:06 2007 UTC (7 years, 7 months ago) by
axel
File length: 61145 byte(s)
Diff to
previous 18895
Report constness of function and parameter default values also in method doc if method is unique without overload resolution.
HTML-escape '"' in link tooltips.
Revision
18895 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Tue May 29 11:04:45 2007 UTC (7 years, 7 months ago) by
axel
File length: 61099 byte(s)
Diff to
previous 18338
Make library dependency left-right.
Look for func names in sources without leading ':'.
Guess source files also for mathcore, mathmore.
Set guessed source file only if it exists.
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: 60954 byte(s)
Diff to
previous 17973
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
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: 60936 byte(s)
Diff to
previous 17942
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
17942 -
(
view)
(
download)
(
as text)
(
annotate)
-
[select for diffs]
Modified
Tue Feb 13 20:22:06 2007 UTC (7 years, 11 months ago) by
axel
File length: 59382 byte(s)
Diff to
previous 17806
surround converted module doc by <pre></pre>;
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 "{};"
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: 58692 byte(s)
Diff to
previous 17771
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
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: 58580 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: 58554 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.