[RFC 3/4] Documentation: move dma-buf documentation to rst

2016-08-11 Thread Sumit Semwal
Hi Markus, On 11 August 2016 at 17:28, Markus Heiser wrote: > Hi Sumit, > > I haven't compiled your patch yet, just my 2cent about the > reStructuredText (reST) ASCII markup ... > Thanks very much for your detailed review comments - highly appreciated! > Here are some handy links about reST and

[RFC 3/4] Documentation: move dma-buf documentation to rst

2016-08-11 Thread Sumit Semwal
Hello Jani, On 11 August 2016 at 17:17, Jani Nikula wrote: > On Thu, 11 Aug 2016, Sumit Semwal wrote: >> diff --git a/Documentation/dma-buf/guide.rst >> b/Documentation/dma-buf/guide.rst >> new file mode 100644 >> index ..fd3534fdccb3 >> --- /dev/null >> +++ b/Documentation/dma-buf/

[RFC 3/4] Documentation: move dma-buf documentation to rst

2016-08-11 Thread Sumit Semwal
Branch out dma-buf related documentation into its own rst file to allow adding it to the sphinx documentation generated. While at it, move dma-buf-sharing.txt into rst as the dma-buf guide too. Signed-off-by: Sumit Semwal --- Documentation/DocBook/device-drivers.tmpl | 37 --- Documentation/dm

[RFC 3/4] Documentation: move dma-buf documentation to rst

2016-08-11 Thread Jani Nikula
On Thu, 11 Aug 2016, Sumit Semwal wrote: > diff --git a/Documentation/dma-buf/guide.rst b/Documentation/dma-buf/guide.rst > new file mode 100644 > index ..fd3534fdccb3 > --- /dev/null > +++ b/Documentation/dma-buf/guide.rst > @@ -0,0 +1,503 @@ > + > +.. _dma-buf-guide: > + > +=

[RFC 3/4] Documentation: move dma-buf documentation to rst

2016-08-11 Thread Markus Heiser
Am 11.08.2016 um 13:58 schrieb Markus Heiser : >> +.. note:: Until this stage, the buffer-exporter has the option to choose >> not to >> + actually allocate the backing storage for this buffer, but wait for the >> + first buffer-user to request use of buffer for allocation. > > Use newlines

[RFC 3/4] Documentation: move dma-buf documentation to rst

2016-08-11 Thread Markus Heiser
Hi Sumit, I haven't compiled your patch yet, just my 2cent about the reStructuredText (reST) ASCII markup ... Here are some handy links about reST and the Sphinx markup constructs, we have not yet added to the documentation (sorry): * reST primer:http://www.sphinx-doc.org/en/stable/rest.htm