#1 How access doxygen documentation from ClaraDiagram

[Alejandro Xalabarder]

The feature of ClaraDiagram of finding doxygen documentation of a class
is limited and, by the way, not well documented. I'll try to explain here
it in more detail.

The functionality only works properly with documentation
generated from an old doxygen version

----- OLD DOXYGEN OUTPUT DOCUMENTATION FORMAT
In this format the generated htmls for the classes by doxygen had the
following convention

class<name>.html (for c++ and java)
or
interface<name>.html (for java interfaces)

for example, if you had somewhere a class named Test.java and you ran
doxygen in order to generate the documentation in C:\tempDocu the
documentation for the class would be placed on C:\tempDocu\classTest.html

---- TO GET IT WORKING WITH ClaraDiagram
Still would be necessary to configure something in ClaraDiagram that it is
also not documented.
Following configuration has to be added, either in the language
Configuration file (Clara menu : Options/Edit Current language)
or directly into the clara.ROM file (then it will work for all language
configurations)

---- For windows

<ExeNavigatDocum>
"cmd /C start"

<DocuPaths_base>
<DocuPaths_exclude>
<DocuPaths_include>
c:\tempDocu

---- For linux (I am not sure about the standard navigator in linux!)

<ExeNavigatDocum>
"netscape"

<DocuPaths_base>
<DocuPaths_exclude>
<DocuPaths_include>
/tempDocu

After changing the configuration, reload it or just start again ClaraDiagram
and test it

---- FUTURE SOLUTION

I plan a new release of ClaraDiagram (March 2007 ?) much more powerful. In this
new release I think that the solution for the doxygen documentation will be to
generate "on the fly" a temporal doxygen documentation just for the current class
(done by ClaraDiagram, of course), which is a fast process and show it into the
internet navigator. Pros: avoids the necessity of having generated doxygen documentation
or having it up to date. Cons: Obviously the links of doxygen will not work.