Doxygen is a tool that creates structured documentation out of the raw source code and comments embedded in it. In order to make this possible the comments have to be marked in a certain way, which is in general programming language dependent. This text describes how to write comments in Fortran code in order to enable Doxygen to make use of them.
module itm_assert ... contains !> A generic assertion, tests a given logical expression. (The short, concise description) !> If it evaluates to .false., !> print the fail message and possibly stop execution. (A more detailed description) !> !> @param test The logical expression to test. (Explanation of individual arguments) !> @param failmsg The message to print on fail. If omitted, a generic message is printed. !> Can be modified with a prefix (see assertSetMsgPrefix) !> @param doStop Controls whether to stop execution. If doStop .true., !> the program is stopped. If .false., only the fail message is printed !> and bookkeeping is done for delayed stopping (see assertStopOnFailed). !> If given, overrides the default behaviour set by assertSetStopMode. !> @see assertStopOnFailed (References to other routines) !> @see assertSetStopMode !> @see assertSetMsgPrefix !> @author H.-J. Klingshirn (Author information) !> @version 1.0 (Version information) subroutine assert( test, failmsg, doStop ) logical, intent(in) :: test character(*), intent(in), optional :: failmsg logical, intent(in), optional :: doStop ... end subroutine assert ... end module itm_assert
subroutine assert( test, failmsg, doStop ) logical, intent(in) :: test !> The logical expression to test. ...