Re: Return: vs Returns:

2019-02-08 Thread Mike Rapoport
On Thu, Feb 07, 2019 at 06:33:34PM +0100, Markus Heiser wrote: > > Am 07.02.19 um 17:18 schrieb Mike Rapoport: > >>>Does checkpatch checks the kernel-doc parts at all? > >>No. I guess there are to many places to fail / to hard to put someone in > >>charge. E.g. if you do include a single kernel-

[PATCH] memblock: update comments and kernel-doc

2019-02-08 Thread Mike Rapoport
* Remove comments mentioning bootmem * Extend "DOC: memblock overview" * Add kernel-doc comments for several more functions Signed-off-by: Mike Rapoport --- The patch is against the current -mm tree which seems the best route for it as well :) mm/memblock.c | 60 +++

[PATCH] doc:dmaengine: clarify DMA desc. pointer after submission

2019-02-08 Thread Federico Vaga
It clarifies that the DMA description pointer returned by `dmaengine_prep_*` function should not be used after submission. Signed-off-by: Federico Vaga --- Documentation/driver-api/dmaengine/client.rst | 7 +++ 1 file changed, 7 insertions(+) diff --git a/Documentation/driver-api/dmaengine/

[PATCH] drm/doc: Remove solved KMS cleanup task

2019-02-08 Thread Shayenne Moura
Remove KMS cleanup task from documentation solved by patchset https://patchwork.freedesktop.org/series/54310/ Signed-off-by: Shayenne Moura --- Documentation/gpu/todo.rst | 4 1 file changed, 4 deletions(-) diff --git a/Documentation/gpu/todo.rst b/Documentation/gpu/todo.rst index cda4a37a

Re: [PATCH] Documentation: cgroup-v2: eliminate markup warnings

2019-02-08 Thread Tejun Heo
On Wed, Feb 06, 2019 at 04:59:00PM -0800, Randy Dunlap wrote: > From: Randy Dunlap > > Fix markup warnings in cgroup-v2.rst: > > Documentation/admin-guide/cgroup-v2.rst:1509: WARNING: Block quote ends > without a blank line; unexpected unindent. > Documentation/admin-guide/cgroup-v2.rst:1511: W

Re: [PATCH] drm/doc: Remove solved KMS cleanup task

2019-02-08 Thread Jonathan Corbet
On Fri, 8 Feb 2019 13:35:39 -0200 Shayenne Moura wrote: > Remove KMS cleanup task from documentation solved by patchset > https://patchwork.freedesktop.org/series/54310/ > > Signed-off-by: Shayenne Moura This seems like a worthy change, but Documentation/gpu is managed by the DRM maintainers.

[PATCH] drm/doc: Remove solved KMS cleanup task

2019-02-08 Thread Shayenne Moura
Remove KMS cleanup task from documentation solved by patchset https://patchwork.freedesktop.org/series/54310/ Signed-off-by: Shayenne Moura --- Documentation/gpu/todo.rst | 4 1 file changed, 4 deletions(-) diff --git a/Documentation/gpu/todo.rst b/Documentation/gpu/todo.rst index cda4a37a

Re: [PATCH 0/1] Start conversion of PowerPC docs

2019-02-08 Thread Jonathan Corbet
On Fri, 08 Feb 2019 14:40:28 +1100 Michael Ellerman wrote: > > - I don't think this should be a top-level directory full of docs; the top > > level is already rather overpopulated. At worst, we should create an > > arch/ directory for architecture-specific docs. > > We currently have arch

Re: [PATCH] docs: kernel-doc: typo "documentaion"

2019-02-08 Thread Jonathan Corbet
On Mon, 4 Feb 2019 16:29:31 -0800 Frank Rowand wrote: > On 2/2/19 12:56 PM, Matthew Wilcox wrote: > > On Fri, Feb 01, 2019 at 02:04:16PM -0800, frowand.l...@gmail.com wrote: > >>Include documentation for each *function* in *source*. > >> - If no *function* if specified, the documentaion fo

Re: [PATCH] memblock: update comments and kernel-doc

2019-02-08 Thread Andrew Morton
On Fri, 8 Feb 2019 13:45:47 +0200 Mike Rapoport wrote: > * Remove comments mentioning bootmem > * Extend "DOC: memblock overview" > * Add kernel-doc comments for several more functions > > ... > > @@ -1400,6 +1413,19 @@ phys_addr_t __init > memblock_phys_alloc_range(phys_addr_t size, > r