Re: [Doxygen-users] Comment block AFTER declaration in Fortran

[Fabian N. <fab...@sc...>]

Hi all,

if I remember correctly, there's a possibility to put all the doxygen 
comment blocks for the subroutines in a separate file, isn't there?
Of course that would "hide" them statically, but you could still have a 
short description in-line if you like..

Just a thought...

Best regards,
Fabian.

* From: Petr Parik (pet...@se...)
* To: Fabian Nick (fab...@sc...)
* Sent:  12.03.2015 at 22:00 +0100
* Subject: Re: [Doxygen-users] Comment block AFTER declaration in Fortran
> Dear Albert,
>
> thanks. I tried many ways in Doxygen 1.8.9.1 until I have found that the
> inside comment block works only if I put it AFTER any argument
> declarations (and use !>).
>
>      SUBROUTINE FOO(BAR)
>      IMPLICIT NONE
>      INTEGER BAR
>      !> description of FOO
>      !> here it works!
>      REAL A,B,C,D
>      ! rest of the code
>      END
>
> This is not ideal but still better than putting the comment blocks
> before. Would it be possible to enhance !< to work after any declaration
> just like !> does before any declaration? That would be swell! :)
>
> Best regards,
>
> Petr
>
> Dne 12.3.2015 v 19:47 Albert napsal(a):
>> Dear Petr,
>>
>> Currently there is no way to use the !< for the purpose you describe
>> (interesting thought though). As far as I know a !> block will work
>> (in most cases) provided it is not direct before an argument (as this
>> will be seen as documentation for the argument).
>>
>> Albert
>>
>> On Thu, Mar 12, 2015 at 2:57 PM, Petr Parik <pet...@se...
>> <mailto:pet...@se...>> wrote:
>>
>>     Hi,
>>
>>     how do I put the comment block after module/subroutine/function
>>     declaration in Fortran? I tried
>>
>>           SUBROUTINE FOO
>>           !< description of FOO
>>
>>     but it does not work. For arguments and variables the "after" comment
>>     block works fine. I simply need to hide the bulky comment blocks
>>     inside
>>     subroutines to keep the code readable when collapsing the outlines in
>>     Visual Studio.
>>
>>     Thanks for any help,
>>
>>     Petr Parik
>>
>>     ------------------------------------------------------------------------------
>>     Dive into the World of Parallel Programming The Go Parallel
>>     Website, sponsored
>>     by Intel and developed in partnership with Slashdot Media, is your
>>     hub for all
>>     things parallel software development, from weekly thought
>>     leadership blogs to
>>     news, videos, case studies, tutorials and more. Take a look and
>>     join the
>>     conversation now. http://goparallel.sourceforge.net/
>>     _______________________________________________
>>     Doxygen-users mailing list
>>     Dox...@li...
>>     <mailto:Dox...@li...>
>>     https://lists.sourceforge.net/lists/listinfo/doxygen-users
>>
>>
>
>
>
> ------------------------------------------------------------------------------
> Dive into the World of Parallel Programming The Go Parallel Website, sponsored
> by Intel and developed in partnership with Slashdot Media, is your hub for all
> things parallel software development, from weekly thought leadership blogs to
> news, videos, case studies, tutorials and more. Take a look and join the
> conversation now. http://goparallel.sourceforge.net/
>
>
>
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>