anb0s / eclox

Eclox is a simple doxygen frontend plug-in for eclipse. It aims to provide a slim and sleek integration of the code documentation process into Eclipse.
http://anb0s.github.io/eclox
Eclipse Public License 2.0
35 stars 2 forks source link
doxyfile doxygen doxygen-frontend-plug eclipse eclipse-plugin
- Project is discontinued and not maintained anymore!

eclox Version Issues Build Status License

Eclox is a simple Doxygen frontend plug-in for Eclipse. It aims to provide a slim and sleek integration of the code documentation process into Eclipse.

eclox_arch

Features Overview:

Not supported:

Prerequisites:

Installation:

From Eclipse Markeplace:

Drag to your running Eclipse* workspace. *Requires Eclipse Marketplace Client

http://marketplace.eclipse.org/content/eclox

OR

Using the update site located at: http://anb0s.github.io/eclox

Select Eclox Plugin and optional bundled Doxygen executable:

Eclox install

OR

You can download the update sites for offline install --> go to: https://github.com/anb0s/eclox/releases and download the org.gna.eclox.site-0.12.1-SNAPSHOT.zip and optional bundled doxygen executable org.gna.eclox.doxygen.site-X.Y.Z-SNAPSHOT.zip files, e.g. for latest stable version: https://github.com/anb0s/eclox/releases/latest

Now use inside Eclipse: "Help-> Install New Software... -> Add... -> Archive...", select the zip file and enter name:

Eclox instal local

and select it:

Eclox instal local-2

Optional: similar installation for Doxygen binaries:

Eclox Doxygen instal local

Eclox instal local-2

For additional details, please refer to Eclipse user guide.

Configuration

Once the plugin installed, you must ensure that the default PATH environment variable makes the Doxygen binary reachable for the plugin or you have installed the bundled Doxygen executable from Eclox site. If not, you can update PATH to include to directory containing the Doxygen binary, or you can tell eclox where that binary is located on your system (which is in my opinion the better solution). To do this, open eclipse's preference edition dialog window and go into the new "Doxygen" section.

If you have installed Doxygen executable from Eclox update site, check if it was automaticaly selected: Eclox Doxygen Bundled

If not you can select custom Doxygen location with "Add..." and "Browse...": Eclox Doxygen Custom

Now just select and apply: Eclox Doxygen Custom

For Mac OS X users there is an excellent HowTo: https://github.com/theolind/mahm3lib/wiki/Integrating-Doxygen-with-Eclipse

Usage

You can create new Doxygen projects (also called doxyfiles) using the creation wizard. Go to "File -> New -> Other -> Other -> Doxyfile". Press next and set both file location and name. Then an empty doxyfile will be created at the specified location. The wizard automatically adds the ".Doxyfile" extension.

You should now see a file with a blue @-sign icon. This is your new doxyfile. Double-clicking on it will open the editor. You can now browse and edit the settings.

Eclox basic editor

Eclox advanced editor

Once your have properly set all doxyfile fields, you can launch a documentation build using the toolbar icon showing a blue @-sign. Eclox toolbar icon

In the case the button is not visible in the toolbar, your current perspective needs to get configured. Go to "Window -> Customize perspective -> Commands" and in "Available command groups" check "Doxygen". Additionally, you can browse the latest builds by clicking the down arrow right to the toolbar button.

Eclox toolbar icon menu

When the documentation build starts, a new view showing the build log opens.

Eclox console

In its toolbar, a button named "Stop" allows you to halt the current build process. The current build also appears in the Eclipse job progress view and you can control the job from there.

The build toolbar action determine the next doxyfile to build depending on the current active workbench part (editor or view) and the current selection in that part. For example, if the active part is a doxyfile editor, the next doxyfile to build will be the one being edited. If the active part is the resource explorer and the current selection is a doxyfile, that doxyfile will be next to get build. In the case the active part selection doesn't correspond to a doxyfile, the last built doxyfile will be rebuiled. And if the build history is empty, you will be asked for the doxyfile to build.

Eclox select doxyfile

For developers and contributors

Please checkout the wiki page: https://github.com/anb0s/eclox/wiki/How-to-build

License:

https://www.eclipse.org/legal/epl-2.0