Jump to: navigation, search

Difference between revisions of "EDT:EGLDoc"

(New page: == Overview == The EGLDoc component is similar to Javadoc - create a set of HTML documentation from source files. The HTML files will show relations between parts, structure breakdown, an...)
 
Line 1: Line 1:
== Overview ==
+
== Overview ==
  
The EGLDoc component is similar to Javadoc - create a set of HTML documentation from source files. The HTML files will show relations between parts, structure breakdown, any any detailed documentation that was written in the source code. For example the HTML for a program part would list its parameters, fields, and functions. If any of these elements had documentation written in the "egldoc" syntax then that information would be used as a description of that element. If no documentation was written for an element you will still see the API of the element.
+
The EGLDoc component is similar to Javadoc - create a set of HTML documentation from source files. The HTML files will show relations between parts, structure breakdown, any any detailed documentation that was written in the source code. For example the HTML for a program part would list its parameters, fields, and functions. If any of these elements had documentation written in the "egldoc" syntax then that information would be used as a description of that element. If no documentation was written for an element you will still see the API of the element.  
  
 +
<br>
  
 +
== EGLDoc spec  ==
  
 +
TBD<br>
  
 +
<br>
  
== EGLDoc spec ==
+
== Getting the code  ==
  
TBD
+
The code resides in CVS with the rest of the EDT code:&nbsp;:pserver:anonymous@dev.eclipse.org:/cvsroot/tools<br>
  
 +
Plug-ins:
  
 +
org.eclipse.edt/gen/org.eclipse.edt.gen.egldoc<br>org.eclipse.edt/ide/org.eclipse.edt.ide.egldoc<br>
  
 +
<br>
  
 +
== Running EGLDoc  ==
  
 
+
You can kick off EGLDoc generation by right-clicking on an EGL project &gt; '''Generate EGLDoc'''. This will generate HTML files for all *.egl files within the project, and the output will be placed inside '''&lt;project&gt;/egldoc/'''.  
 
+
== Getting the code ==
+
 
+
The code resides in CVS with the rest of the EDT code: :pserver:anonymous@dev.eclipse.org:/cvsroot/tools<br>
+
 
+
Plug-ins:
+
 
+
org.eclipse.edt/gen/org.eclipse.edt.gen.egldoc<br>org.eclipse.edt/ide/org.eclipse.edt.ide.egldoc
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
== Running EGLDoc ==
+
 
+
 
+
 
+
You can kick off EGLDoc generation by right-clicking on an EGL project &gt; '''Generate EGLDoc'''. This will generate HTML files for all *.egl files within the project, and the output will be placed inside '''&lt;project&gt;/egldoc/'''.
+
 
+
 
+
 
+
 
+
  
 
[[Category:EDT]]
 
[[Category:EDT]]

Revision as of 14:49, 9 July 2012

Overview

The EGLDoc component is similar to Javadoc - create a set of HTML documentation from source files. The HTML files will show relations between parts, structure breakdown, any any detailed documentation that was written in the source code. For example the HTML for a program part would list its parameters, fields, and functions. If any of these elements had documentation written in the "egldoc" syntax then that information would be used as a description of that element. If no documentation was written for an element you will still see the API of the element.


EGLDoc spec

TBD


Getting the code

The code resides in CVS with the rest of the EDT code: :pserver:anonymous@dev.eclipse.org:/cvsroot/tools

Plug-ins:

org.eclipse.edt/gen/org.eclipse.edt.gen.egldoc
org.eclipse.edt/ide/org.eclipse.edt.ide.egldoc


Running EGLDoc

You can kick off EGLDoc generation by right-clicking on an EGL project > Generate EGLDoc. This will generate HTML files for all *.egl files within the project, and the output will be placed inside <project>/egldoc/.