diff options
author | dimitri <dimitri@afe2bf4a-e733-0410-8a33-86f594647bc7> | 2010-06-25 11:31:51 (GMT) |
---|---|---|
committer | dimitri <dimitri@afe2bf4a-e733-0410-8a33-86f594647bc7> | 2010-06-25 11:31:51 (GMT) |
commit | d0412f05557d55f465407a9337553c0a6ee0396f (patch) | |
tree | fa51c4ac8c1fe241b2d6c4af9d2f9a1297ce8e0a /doc/docblocks.doc | |
parent | 1cbd7d2faa8d543f521b144a8120c3a1ba2f832f (diff) | |
download | Doxygen-d0412f05557d55f465407a9337553c0a6ee0396f.zip Doxygen-d0412f05557d55f465407a9337553c0a6ee0396f.tar.gz Doxygen-d0412f05557d55f465407a9337553c0a6ee0396f.tar.bz2 |
Release-1.7.1
Diffstat (limited to 'doc/docblocks.doc')
-rw-r--r-- | doc/docblocks.doc | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/doc/docblocks.doc b/doc/docblocks.doc index ebbe879..aa9e873 100644 --- a/doc/docblocks.doc +++ b/doc/docblocks.doc @@ -448,4 +448,36 @@ config file. This will also affect a number of other settings. When they were not already set correctly doxygen will produce a warning telling which settings where overruled. +\section fortranblocks Special documentation blocks in Fortran + +When using doxygen for Fortran code you should +set \ref cfg_optimize_for_fortran "OPTIMIZE_FOR_FORTRAN" to \c YES. + +For fortran "!>" or "!<" starts a comment and "!!" or "!>" can be used to +continuate a one line comment into a multi-line comment. + +Here is an example of a documented Fortran subroutine: +\verbatim + !> Build the restriction matrix for the aggregation + !! method. + !! @param aggr information about the aggregates + !! @todo Handle special case + subroutine IntRestBuild(A,aggr,Restrict,A_ghost) + implicit none + Type(SpMtx), intent(in) :: A !< our fine level matrix + Type(Aggrs), intent(in) :: aggr + Type(SpMtx), intent(out) :: Restrict !< Our restriction matrix +\endverbatim + +As a alternative you can also use comments in fixed format code: + +\verbatim +C> Function comment +C> another line of comment + function A(i) +C> input parameter + integer i + end function A +\endverbatim + */ |