Re: [PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-19 Thread Mike Rapoport
On Tue, Jun 19, 2018 at 11:09:42AM +0300, Jani Nikula wrote: > On Tue, 19 Jun 2018, Mike Rapoport wrote: > > On Tue, Jun 19, 2018 at 10:29:20AM +0300, Jani Nikula wrote: > >> On Tue, 19 Jun 2018, Mike Rapoport wrote: > >> > On Mon, Jun 18, 2018 at 11:01:32PM +0300, Jani Nikula wrote: > >> >> On

Re: [PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-19 Thread Jani Nikula
On Tue, 19 Jun 2018, Mike Rapoport wrote: > On Tue, Jun 19, 2018 at 10:29:20AM +0300, Jani Nikula wrote: >> On Tue, 19 Jun 2018, Mike Rapoport wrote: >> > On Mon, Jun 18, 2018 at 11:01:32PM +0300, Jani Nikula wrote: >> >> On Mon, 18 Jun 2018, Mike Rapoport wrote: >> >> > When kernel-doc::

Re: [PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-19 Thread Mike Rapoport
On Tue, Jun 19, 2018 at 10:29:20AM +0300, Jani Nikula wrote: > On Tue, 19 Jun 2018, Mike Rapoport wrote: > > On Mon, Jun 18, 2018 at 11:01:32PM +0300, Jani Nikula wrote: > >> On Mon, 18 Jun 2018, Mike Rapoport wrote: > >> > When kernel-doc:: specified in .rst document without explicit

Re: [PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-19 Thread Jani Nikula
On Tue, 19 Jun 2018, Mike Rapoport wrote: > On Mon, Jun 18, 2018 at 11:01:32PM +0300, Jani Nikula wrote: >> On Mon, 18 Jun 2018, Mike Rapoport wrote: >> > When kernel-doc:: specified in .rst document without explicit directives, >> > it outputs both comment and DOC: sections. If a DOC: section

Re: [PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-18 Thread Mike Rapoport
On Mon, Jun 18, 2018 at 11:01:32PM +0300, Jani Nikula wrote: > On Mon, 18 Jun 2018, Mike Rapoport wrote: > > When kernel-doc:: specified in .rst document without explicit directives, > > it outputs both comment and DOC: sections. If a DOC: section was explictly > > included in the same document

Re: [PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-18 Thread Jani Nikula
On Mon, 18 Jun 2018, Mike Rapoport wrote: > When kernel-doc:: specified in .rst document without explicit directives, > it outputs both comment and DOC: sections. If a DOC: section was explictly > included in the same document it will be duplicated. For example, the > output generated for