Collapsible Code Fragments

Jacopo Pantaleoni <[email protected]> Tue, 8 Jan 2019 10:41:15 +0100
Newsgroups gmane.text.doxygen.devel
Message-ID <CALyofL1qFp=MTYYKhL-CWKhBnefF5rHeyJZgNmYvEP2vYFPwdA@mail.gmail.com>
--===============1364342224872416478==
Content-Type: multipart/alternative; boundary="0000000000002e5246057eef26ae"

--0000000000002e5246057eef26ae
Content-Type: text/plain; charset="UTF-8"

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

--0000000000002e5246057eef26ae
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><div dir=3D"ltr">Hello Everyone,<div><br>=
</div><div>I never wrote here so I apologize if this is not the right place=
 for feature requests, but...</div><div>inspired by the output of literate =
programming you can find in this book:</div><div><br></div><div>=C2=A0 <a h=
ref=3D"http://www.pbr-book.org/3ed-2018/Shapes/Basic_Shape_Interface.html#S=
hape">http://www.pbr-book.org/3ed-2018/Shapes/Basic_Shape_Interface.html#Sh=
ape</a>=C2=A0</div><div><br></div><div>I was wondering that the ability to =
mark some code blocks collapsible (e.g. inside \code / \endcode or even mor=
e importantly in \snippet sections) would make for a _great_ feature.</div>=
<div><br></div><div>In fact, perhaps one could reuse the block markers alre=
ady present for \snippet to automatically make sub-blocks collapsible?</div=
><div><br></div><div>e.g. if I had:</div><div><br></div><div><div>//! [MyBl=
ock]</div></div><div>int a;</div><div>//! [Initialize Vars]<br></div><div><=
div>a =3D foo() ;</div></div><div>//! [Initialize Vars]</div><div>...=C2=A0=
=C2=A0<br></div><div><div>//! [MyBlock]=C2=A0</div><div><br></div><div>it w=
ould be great if the HTML output for a snippet containing MyBlock contained=
 a collapsible section referring to the block &quot;Initialize Vars&quot;.=
=C2=A0</div><div><br></div><div>What do you think?</div><div><br></div><div=
>Best Regards,</div><div>-Jacopo</div><br class=3D"gmail-Apple-interchange-=
newline"></div></div></div></div>

--0000000000002e5246057eef26ae--


--===============1364342224872416478==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline


--===============1364342224872416478==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
Doxygen-develop mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

--===============1364342224872416478==--