docs/core-api/mm: fix return value descriptions
Get series with b4
b4 am [email protected]Versions newest first · linked by author and title
- v1 Latest posting 2/23 patches 0 repliesNew
- v1 posting 1/23 patches 1 replySuperseded
Patches in v1 posting 2/2 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/3 | docs/mm: vmalloc: re-indent kernel-doc comemntsmm/ | +182 | 0 replies | |
| 2/3 | docs/core-api/mm: fix user memory accessors formattingarch/ arch/ | +16 | 0 replies | |
| 3/3 | docs/core-api/mm: fix return value descriptions in mm/mm/ mm/ mm/ +9 more | +221 | 0 replies |
Reviews trailers per patch
No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.
Cover letter [RESEND PATCH 0/3] docs/core-api/mm: fix return value descriptions
Many kernel-doc comments referenced by Documentation/core-api/mm-api.rst have the return value descriptions misformatted or lack it completely. This makes kernel-doc script unhappy and produces more than 100 warnings when running
make htmldocs V=1
These patches fix the formatting of present return value descriptions and add some new ones.
As these patches touch lots of mm/ files, I think it's better to merge them via -mm tree.
Side note:
----------
I've noticed that kernel-doc produces
warning: contents before sections
when it is parsing description of a function that has no parameters, but does have a return value, i.e.
unsigned long nr_free_buffer_pages(void)
As far as I can tell, the generated html is ok no matter if the detailed description present before 'the sections', so probably this warning is not really needed?
Mike Rapoport (3):
docs/mm: vmalloc: re-indent kernel-doc comemnts docs/core-api/mm: fix user memory accessors formatting docs/core-api/mm: fix return value descriptions in mm/
arch/x86/include/asm/uaccess.h | 24 +-- arch/x86/lib/usercopy_32.c | 8 +- mm/dmapool.c | 13 +- mm/filemap.c | 73 ++++++-- mm/memory.c | 26 ++- mm/mempool.c | 8 + mm/page-writeback.c | 24 ++- mm/page_alloc.c | 24 ++- mm/readahead.c | 2 + mm/slab.c | 14 ++ mm/slab_common.c | 6 + mm/truncate.c | 6 +- mm/util.c | 37 ++-- mm/vmalloc.c | 394 ++++++++++++++++++++++------------------- 14 files changed, 409 insertions(+), 250 deletions(-)
Signature · 1 line
2.7.4