Documenting a fortran program.

[Ilie__Daniel]

Hello!

I was give a fortran program which I have to document.
Is there a special way to write the comments so that they could be generated into a document?

In C# one can use the triple slash /// to generate documentation for methods in XML format. Using an extension such as GhostDoc can speed up the process.

Are there any know extension for Visual Studio 2010 that would work for fortran programs?

Do you have any other suggestions?

Thank you for your help with this.

[Arjen_Markus]

I suggest you have a look at general tools like ROBODoc and Doxygen as alternatives.

Regards,

Arjen

[jimdempseyatthecove]

! /// Would this work with GhostDoc?

Jim Dempsey

[DavidWhite]

I recommend RoboDoc. I have worked with the main developers to ensure that it works well for Fortran (as well as Aspen Custom Modeller, for anyone interested).

David

[Ilie__Daniel]

I do not know Jim.
Probably not as this should be first supported by the Fortran parser.

Daniel Ilie.

[Ilie__Daniel]

Thank you all for your suggestions.

Daniel.

[jimdempseyatthecove]

Daniel,

In free format "! /// ..." is a comment
In fixed format use "C /// ..."

The rest is up to your external document parser.
I assume the document parser you mentioned accepts:

blah blah blah /// document this

Jim

[Steven_L_Intel1]

You can use ! in both forms.