Re: [PATCH] libqos/qgraph: format qgraph comments for sphinx documentation

[Paolo Bonzini]

On 25/02/21 09:22, Emanuele Giuseppe Esposito wrote:
> diff --git a/docs/devel/index.rst b/docs/devel/index.rst
> index 1dcce3bbed..f0038f8722 100644
> --- a/docs/devel/index.rst
> +++ b/docs/devel/index.rst
> @@ -12,6 +12,7 @@ Contents:
>
>   .. toctree::
>      :maxdepth: 2
> +   :includehidden:
>
>      build-system
>      kconfig
> @@ -24,7 +25,6 @@ Contents:
>      atomics
>      stable-process
>      qtest
> -   qgraph
>      decodetree
>      secure-coding-practices
>      tcg
>
> -------
>
> Allow showing the hidden toctree in the docs/devel index, so that the 
> link is visible
>
> End result:
> - no visible change in docs/index
> - qgraph link visible in docs/devel/index
> - qgraph linked as text link in qtree

Makes sense.  Did you also try increasing the maxdepth?

Paolo