FESA3 Class Documentation

In the design of a FESA3 class many elements can have description tags. These tags are used as input for generation an HTML page per FESA3 class. This can be achieved by generating a so-called xmldoc page per design document (gendoc.png "Generate Documentation"-Button on the FESA toolbar). In this document a general description of the purpose of the FESA3 class may be entered. The FESA toolbar provides for xmldoc-documents the (gendoc.png"Generate HTML Documentation"-button). An HTML page named like the FESA class will be generated and displayed in the FESA Browser View. The location of the resulting HTML page within a FESA3 class project is <FESA3 class name>/docs/<FESA3 class name>.html .
<chapters>
  <caption1>
    <title name="Introduction"/>
    <para>
  <text>
      Explain the purpose of this class
  </text>
  </para>
... 

It is possible to extend the documentation for FESA3 classes with HTML code, e.g. for links to external documents, tables, extended format options etc. This can be achieved by adding a section to the FESA3 classes xmldoc-document named <html>...</html> to enter HTML code in between. Example :

<chapters>
<caption1>
<title name="Introduction"/>
<para>
<text>
Explain the purpose of this class
</text>
</para>
<para>
<text>HTML test</text>
<html><br/><b>fat</b><br/></html>
<html><i>italic</i><br/></html>
<html><u>underlined</u><br/></html>
<html><s>strike-through</s><br/><strike>strike-through</strike><br/></html>
<html><sup>upper</sup><br/></html>
<html><sub>lower</sub><br/></html>
<html><a href="www.gsi.de">www.gsi.de</a><br/></html>
<html><br/><br/><i>FAIR: <br/><a href="www.fair-center.eu">www.fair-center.eu</a></i>
</html>
</para>
</caption1>

Documentation for operational FESA3 classes

For operational (productive) FESA3 classes documentation is strongly recommended. During delivery / release the existing HTML documentation will be copied to the webdav server and can be accessed via http://www-acc.gsi.de/data/fesa/classes/<NameOfTheFESA3Class>.html within the acc.gsi.de cluster or with an ACC account.

Alternativley the FESA class documentation may be uploaded to the webdav server using the toolbar button (uploaddocumentation.png, plug-in >=2.5.3).

Visualization

Since FESA3 3.0.0: During documentation generation two graphs are generated in the docs folder. One of the graphs is visualizing the class interface, the other one is visualizing the internal relations such es events, scheduling units, actions etc.

-- SolveighMatthies - 28 Aug 2014
Topic revision: r4 - 17 Dec 2015, SolveighMatthies
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback