[Doxygen-develop] Collapsible Code Fragments

[Jacopo P. <jpa...@gm...>]

Hello Everyone,

I never wrote here so I apologize if this is not the right place for
feature requests, but...
inspired by the output of literate programming you can find in this book:

  http://www.pbr-book.org/3ed-2018/Shapes/Basic_Shape_Interface.html#Shape

I was wondering that the ability to mark some code blocks collapsible (e.g.
inside \code / \endcode or even more importantly in \snippet sections)
would make for a _great_ feature.

In fact, perhaps one could reuse the block markers already present for
\snippet to automatically make sub-blocks collapsible?

e.g. if I had:

//! [MyBlock]
int a;
//! [Initialize Vars]
a = foo() ;
//! [Initialize Vars]
...
//! [MyBlock]

it would be great if the HTML output for a snippet containing MyBlock
contained a collapsible section referring to the block "Initialize Vars".

What do you think?

Best Regards,
-Jacopo