(Difference between revisions)
(User View)
Line 22: Line 22:
===User View===
===User View===
====Doxygen Code Templates====
Support commen Doxygen templates for easily adding Doxygen command to source files (see
Line 28: Line 31:
====Doxygen Code Templates====
Support commen Doxygen templates for easily adding Doxygen command to source files (see
====Typical Workflow====
====Typical Workflow====

Revision as of 21:33, 17 February 2010


CND 69 Doxygen

Doxygen is a tool to convert your C++ comments into publishable HTML. It works by extracting commentary directly from the source with the help of a special Doxygen syntax.


  • Dev: Thomas Preisler
  • Lead: Vladimir Voskresensky


Supporting Doxygen is a feature requested by many C/C++ CND developers. Target user is a C/C++ developer using the IDE for code development (Leon & Steven) but may also be somewhat useful for sustaining tasks (Antony). This feature is aiming to make the developer more productive by providing useful code documentation in the editor associated with the code completion feature. Overview:

  1. Support Doxygen at a similar level as Javadoc is supported by Java projects.
  2. User builds and installs Doxygen application seperately. Doxygen is not distributed with NetBeans/CND.
  3. Integrate Doxygen with C/C++ managed projects in a similar fashion Javadoc is integrated with Java projects supporting project properties and a run action to generate the documentation files.
  4. No direct support for Doxygen for unmanaged projects
  5. Test and verify with Doxygen 1.6.2 available here
  6. Implement as plugin module using only public project SPIs/APIs.


  1. Is 6) possible?

User View

Doxygen Code Templates

Support commen Doxygen templates for easily adding Doxygen command to source files (see

Integration with Code Completion

Integrate html Doxygen docs with code completion. If html output is chosen, code completion will automatically pick up the generated html documentation and present it in the code completion pop-up choice dialog.


Typical Workflow

  1. User adds Doxygen commands to source files
  2. He modifies the Doxygen project properties to suit he needs
  3. He runs the "Generate Doxygen" action from the project context menu
  4. Two usages:
    1. Using code completion now shows proper documentation for classes, methods, ...
    2. He picks up the generated documentation in dist/.../doxygen for external use





Latest sources:

I have started experimenting with documentation in C/C++ code completion. The code is in the pelmel project: in the NB6.8 repository: in module "cnd"/"Extended C/C++ Editor". The module can be installed from this update center: Note that the module requires a very recent trunk build.


Milestone Date Content
1 1/18/10 User View Ready
2 3/15/10 Feature useful
3 NB 6.9 M1 4/07/10
4 NB 6.9 Beta 4/15/10 Feature complete
5 NB 6.9 Code Freeze 5/10/10 Done, all P1/2 bugs fixed.
Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo