Hi Petr, it looks like you only send your last mail to me, not the whole list. So I'm including it below.
The feature I was referring to in my last e-mail was this: http://www.stack.nl/~dimitri/doxygen/manual/docblocks.html#structuralcommands HTH, Fabian. On 13.03.2015 12:17, Petr Parik wrote: > Hi all, > > if there's a possibility to put the comment blocks in a separate file > (how? - I did not find it in docs), then there must be a way to connect > the blocks with subroutine/function declarations, something like: > > !> @identifier FOO > !> ....description.... > > where the command @identifier says which subroutine I want to describe. > Again, is this possible? > > -- > There is another setback to the solution I wrote earlier - I have found > out that if I put the comment block inside a subroutine, no brief > description is shown in the Functions/Subroutines index (detailed > description below is ok). I tried to explicitly use @brief, but it is > ignored. > > Best regards, > > Petr > > Dne 13.3.2015 v 9:21 Fabian Nick napsal(a): > > 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 (petr.pa...@seznam.cz) > > * To: Fabian Nick (fabian.n...@scai.fraunhofer.de) > > * 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 <petr.pa...@seznam.cz > >>> <mailto:petr.pa...@seznam.cz>> 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 > >>> Doxygen-users@lists.sourceforge.net > >>> <mailto:Doxygen-users@lists.sourceforge.net> > >>> 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 > >> Doxygen-users@lists.sourceforge.net > >> 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 Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users
