GNOME Bugzilla – Bug 653963
Fortran using @param when describing argument at the argument
Last modified: 2012-11-18 11:11:50 UTC
Created attachment 191244 [details] Problem with argument description In case we use @param to describe an argument at the place the argument is declared we get an empty line plus a line where the parameter is described. There are 2 styles of documenting arguments: before the routine (argument p1) at the argument (other arguments) if we mix these 2 possibilities we get to lists with parameters see attached example
Created attachment 192128 [details] [review] patch for jhandling different types of param definition documentation in Fortran In this patch I've made the documentation for argument more uniform. At the following places argument documentation can occur: - before the subroutine (!> @param ...) - just before the declaration of the variable (!> ...) - as inline comment with the variable (!< ...) The documentation of the last 2 occurrences can now be like it always has been: !> description or !< description but now this description will be prepended by @param [intent] variable-name the [intent] will only be done in case it is specified with the declaration of the variable. In case there is already a @param or \param the description is left unchanged. The description before the subroutine is also left unchanged.
Confirmed. Should be fixed in the next subversion update.
This bug was previously marked ASSIGNED, which means it should be fixed in doxygen version 1.7.5. Please verify if this is indeed the case. Reopen the bug if you think it is not fixed and please include any additional information that you think can be relevant.
Parameter documentation is now uniform (and together)