Re: [PATCH v1 12/22] docs: driver-api: add .rst files from the main dir

Mauro Carvalho Chehab
2019-06-19T13:19:29Z

(c/c list cleaned)

Em Wed, 19 Jun 2019 13:43:56 +0200
Peter Zijlstra <peterz@infradead.org> escreveu:

> On Tue, Jun 18, 2019 at 05:53:17PM -0300, Mauro Carvalho Chehab wrote:
>
> > .../{ => driver-api}/atomic_bitops.rst | 2 -
>
> That's a .txt file, big fat NAK for making it an rst.

Rst is a text file. This one is parsed properly by Sphinx without
any changes.

>
> > .../{ => driver-api}/futex-requeue-pi.rst | 2 -
>
> > .../{ => driver-api}/gcc-plugins.rst | 2 -
>
> > Documentation/{ => driver-api}/kprobes.rst | 2 -
> > .../{ => driver-api}/percpu-rw-semaphore.rst | 2 -
>
> More NAK for rst conversion

Again, those don't need any conversion. Those files already parse
as-is by Sphinx, with no need for any change.

The only change here is that, on patch 1/22, the files that
aren't listed on an index file got a :orphan: added in order
to make this explicit. This patch removes it.

>
> > Documentation/{ => driver-api}/pi-futex.rst | 2 -
> > .../{ => driver-api}/preempt-locking.rst | 2 -
>
> > Documentation/{ => driver-api}/rbtree.rst | 2 -
>
> > .../{ => driver-api}/robust-futex-ABI.rst | 2 -
> > .../{ => driver-api}/robust-futexes.rst | 2 -
>
> > .../{ => driver-api}/speculation.rst | 8 +--
> > .../{ => driver-api}/static-keys.rst | 2 -
>
> > .../{ => driver-api}/this_cpu_ops.rst | 2 -
>
> > Documentation/locking/rt-mutex.rst | 2 +-
>
> NAK. None of the above have anything to do with driver-api.

Ok. Where do you think they should sit instead? core-api?

Thanks,
Mauro