Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1467759

Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts

Show all headers | View raw

Em Mon, 22 Aug 2016 20:41:45 +0530
Sumit Semwal <sumit.semwal@linaro.org> escreveu:

> Include dma-buf sphinx documentation into top level index.
> 
> Signed-off-by: Sumit Semwal <sumit.semwal@linaro.org>
> ---
>  Documentation/index.rst | 2 ++
>  1 file changed, 2 insertions(+)
> 
> diff --git a/Documentation/index.rst b/Documentation/index.rst
> index e0fc72963e87..8d05070122c2 100644
> --- a/Documentation/index.rst
> +++ b/Documentation/index.rst
> @@ -14,6 +14,8 @@ Contents:
>     :maxdepth: 2
>  
>     kernel-documentation
> +   dma-buf/intro
> +   dma-buf/guide
>     media/media_uapi
>     media/media_kapi
>     media/dvb-drivers/index

IMHO, the best would be, instead, to add an index with a toctree
with both intro and guide, and add dma-buf/index instead.

We did that for media too (patches not merged upstream yet), together
with a patchset that will allow building just a subset of the books.

Regards,
Mauro

PS.: That's the content of our index.rst file, at
Documentation/media/index.rst:

Linux Media Subsystem Documentation
===================================

Contents:

.. toctree::
   :maxdepth: 2

   media_uapi
   media_kapi
   dvb-drivers/index
   v4l-drivers/index

.. only::  subproject

   Indices
   =======

   * :ref:`genindex`


Thanks,
Mauro

Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[PATCH v2 0/2] doc: dma-buf: sphinx conversion Sumit Semwal <sumit.semwal@linaro.org> - 2016-08-22 17:30 +0200
  [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Sumit Semwal <sumit.semwal@linaro.org> - 2016-08-22 17:50 +0200
    Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-08-22 17:50 +0200
      Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Daniel Vetter <daniel@ffwll.ch> - 2016-08-23 08:10 +0200
        Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Markus Heiser <markus.heiser@darmarit.de> - 2016-08-23 11:30 +0200
        Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Jonathan Corbet <corbet@lwn.net> - 2016-08-23 15:10 +0200
          Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Sumit Semwal <sumit.semwal@linaro.org> - 2016-08-23 15:40 +0200
          Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Daniel Vetter <daniel@ffwll.ch> - 2016-08-23 15:50 +0200
            Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Jonathan Corbet <corbet@lwn.net> - 2016-08-23 16:20 +0200
              Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Daniel Vetter <daniel@ffwll.ch> - 2016-08-23 17:20 +0200
              Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-08-23 18:50 +0200

csiph-web