Re: Including files Into Doxygen Comments

Hi Joel,

A small thought: Are these guides generated separately (i.e. one after
the other) ? In that case a \cond might work (together with Doxyfile's
where the relevant condition is set.note that it is possible to have
Doxyfile's include other Doxyfile's)

Albert

On Thu, Jul 7, 2011 at 22:18, Joel Sherrill <[email protected]> wrote:
> Hi,
>
> This is bordering on a user question,
> but I think I may end up having to
> implement this so here goes.
>
> I was looking for a way to have some
> documentation for a method in a separate
> file.  All of the various include and
> example commands I see assume they
> are adding some markup like verbatim
> or before and after.
>
> + @include - @code
> + @includelineno - ditto
> + @verbinclude - @verbatim
> + @htmlinclude - @htmlonly
>
> I'm looking at a use case for someone where
> they have multiple language bindings and
> generate Java, C, and C++ API guides but
> a significant portion of the text is shared.
> They have a custom post-processing to insert
> the external files into the generated output.
> It just feels wrong to post-process and seems
> like something Doxygen should just be able to do.
>
> Any thoughts on this?  I can't be the first
> person to think this was useful. :)
>
> If useful, what would be a good command name
> and existing comment to base it upon.
>
> --
> Joel Sherrill, Ph.D.             Director of Research&  Development
> [email protected]        On-Line Applications Research
> Ask me about RTEMS: a free RTOS  Huntsville AL 35805
>    Support Available             (256) 722-9985
>
>
>
> ------------------------------------------------------------------------------
> All of the data generated in your IT infrastructure is seriously valuable.
> Why? It contains a definitive record of application performance, security
> threats, fraudulent activity, and more. Splunk takes this data and makes
> sense of it. IT sense. And common sense.
> http://p.sf.net/sfu/splunk-d2d-c2
> _______________________________________________
> Doxygen-develop mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>

------------------------------------------------------------------------------
All of the data generated in your IT infrastructure is seriously valuable.
Why? It contains a definitive record of application performance, security 
threats, fraudulent activity, and more. Splunk takes this data and makes 
sense of it. IT sense. And common sense.
http://p.sf.net/sfu/splunk-d2d-c2