English 中文(简体)
How to use eclox, the doxygen plugin for Eclipse
原标题:

How do I get eclox working in Eclipse 3.5?

I m using Ubuntu 9.04. I installed Doxygen from ubuntu repositories(version 1.5.8). Then I installed eclox on eclipse through the update site.

Despite this, I don t get any option to in any menu to initiate it.

Also the eclox site doesn t seem to have any "getting started" guide.

Please help.

最佳回答

Never mind, worked it out my self.

First you need to create a DoxyFile (which is the configuration file) by giving the source path and the output path.

Then only you can generate the documentation by right clicking the project and selecting the "Generate Documentation".

Thanks anyway!

问题回答

BTW there is a manual inside org.gna.eclox_0.8.0.jar, wierd they did not post this on the project site!!!

Here is the content

      Eclox, a Doxygen frontend plugin for Eclipse.
            <http://gna.org/projects/eclox>
  1. INSTALLATION

    There are two options to install the plugin: using the update site or using the packaged feature.

    The update site is the more convenient way to install eclox. It is located at https://anb0s.github.io/eclox. See eclipse s user guilde for additionnal details.

    When using the packaged feature, you must extract the archive content into your eclipse s root location. For additionnal details, please refer to eclipse s user guide.

  2. CONFIGURATION

    Once the plugin installed, you must ensure that the default PATH environment variable makes the doxygen binary reachable for the plugin. 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.

  3. USAGE

    You can create new Doxygen projects (also called doxyfiles) using the creation wizard. Go to "File->New->Other->Other->Doxygen Configuration". Press next and set both file location and name. Then a 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.

    Once your have properly set all doxyfile fields, you can launch a documentation build using the toolbar icon showing a blue @-sign. 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". Additionnaly, you can browse the laetest builds by clicking the down arrow right to the toolbar button.

    When the documentation build starts, a new view showing the build log opens. 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.

HTH Anybody

I just faced a problem setting the Doxygen binary path in eclox 0.8.0 settings in Eclipse on Mac OS X 10.7. There is no way to configure the path via Eclipse-preferences->Doxygen.

The solution is to edit the preferences file manually

  1. add a (fake) location, let s say /Applications, using the wizard mentioned above.
  2. close Eclipse
  3. edit this file: $WORKSPACE/.metadata/.plugins/org.eclipse.core.runtime/.settings/org.gna.eclox.core.prefs: Replace the value for doxygen.default (currently eclox.core.doxygen.CustomDoxygen /Applications ) with eclox.core.doxygen.CustomDoxygen /Applications/Doxygen.app/Contents/Resources/doxygen .
  4. restart Eclipse

For MacOS user there is a very easy way to get around via the issue of the Doxygen version selection. The link that provides details is here:https://github.com/theolind/mahm3lib/wiki/Integrating-Doxygen-with-Eclipse

After installing the Eclox plugging:

1)"go to "Eclipse --> Preferences --> Oxygen" 2)"Press Shift+CMD+G then Add: "/Applications/Doxygen.app/Contents/Resources/doxygen" 3) Doxygen s version should be displayed

this might help you or any windows user trying to install eclox:

Tutorial for Installing eclox — Document Transcript

Step 1: go to eclox website (http://home.gna.org/eclox/) and to copy the update link address.Step

step 2: Insert the link into the update manager in eclipse and press OK.

Step 3: Select the Eclox item and to complete the installation.

Step 4: When the installation has done, you should select a project that you want to generate thedoxygen documents. Then, create a doxygen project for it.

Step 5: config the options. Note: You have to provide the “Input directories” correctly and to select the “Scan recursively”item. Finally, save the configuration file.

Step 6: find out the “@” and to choice “Choose Doxyfile...”.

Step 7: select a doxyfile.Step 8: wait for few seconds and the doucments will be generated.

its from this link: http://www.slideshare.net/pickerweng/tutorial-for-installing-eclox

Like claus I had to dig into the preferences file maually, because eclox 0.8.0 would just not take a good path from Eclipse Preferences file chooser. So, edit this file: $WORKSPACE/.metadata/.plugins/org.eclipse.core.runtime/.settings/org.gna.eclox.core.prefs and alter the given path (in my case I had to change from

doxygen.default=eclox.core.doxygen.CustomDoxygen C:\Programm Files\doxygen\bin

to this

doxygen.default=eclox.core.doxygen.CustomDoxygen C:\Programme\doxygen\bin

Hope this helps.

I find a webpage https://github.com/theolind/mahm3lib/wiki/Integrating-Doxygen-with-Eclipse where you can find more details. Especially, for Mac users, you need to Press Shift+CMD+G then Add: "/Applications/Doxygen.app/Contents/Resources/doxygen" when you configure the doxygen in eclipse before compiling .doxygfile by using Eclox.

Alternative from eclipse is to use Javadoc:

  1. From menu (...Search Project Run...)

Project > Generate Javadoc

  1. You should be in Java project and add comments with tags.

!!!





相关问题
In Eclipse, why doesn t "Show In" appear for non-Java files?

If I have a *java file open, I can right click on the source, scroll down to "Show In (Alt-Shift-W)", and select Navigator. If I have an *xml, *jsp, or pretty much anything besides a Java source ...

Eclipse: Hover broken in debug perspective

Since upgrading Eclipse (Galileo build 20090920-1017), hover in debug no longer displays a variable s value. Instead, hover behaves as if I were in normal Java perspective: alt text http://...

Eclipse smart quotes - like in Textmate

Happy Friday — Does anyone know if eclipse has the notion of smart quotes like Textmate. The way it works is to select some words and quote them by simply hitting the " key? I m a newbie here so be ...

Indentation guide for the eclipse editor

Is there a setting or plugin for eclipse that can show indentation guides in the editor? Something like the Codekana plugin for visual studio (not so fancy is also OK). Important that it works with ...

Adding jar from Eclipse plugin runtime tab

I want to add .jar files for plugin from the Runtime tab of manifest file. When I use the Add... button, I can see only sub-directories of the plugin project. So if I want to add same .jar file to ...

How to copy multiple projects into single folder in eclipse

I have two projects, Project1 and Project2. Now i want to copy this projects into eclipse workspace but i want these projects to be in a single folder like below. Eclipse Workspace -> Project -> ...

Java: Finding out what is using all the memory

I have a java application that runs out of memory, but I have no idea which code is allocating the memory. Is there an application with which I can check this? I use Eclipse.

热门标签