Commit 92eac168 authored by Mike Rapoport's avatar Mike Rapoport Committed by Linus Torvalds

docs/mm: vmalloc: re-indent kernel-doc comemnts

Some kernel-doc comments in mm/vmalloc.c have leading tab in
indentation.  This leads to excessive indentation in the generated HTML
and to the inconsistency of its layout ([1] vs [2]).

Besides, multi-line Note: sections are not handled properly with extra
indentation.

[1] https://www.kernel.org/doc/html/v4.20/core-api/mm-api.html?#c.vm_map_ram
[2] https://www.kernel.org/doc/html/v4.20/core-api/mm-api.html?#c.vfree

Link: http://lkml.kernel.org/r/1549549644-4903-2-git-send-email-rppt@linux.ibm.comSigned-off-by: default avatarMike Rapoport <rppt@linux.ibm.com>
Reviewed-by: default avatarAndrew Morton <akpm@linux-foundation.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
Signed-off-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
parent 6d2bef9d
...@@ -1191,6 +1191,7 @@ void *vm_map_ram(struct page **pages, unsigned int count, int node, pgprot_t pro ...@@ -1191,6 +1191,7 @@ void *vm_map_ram(struct page **pages, unsigned int count, int node, pgprot_t pro
EXPORT_SYMBOL(vm_map_ram); EXPORT_SYMBOL(vm_map_ram);
static struct vm_struct *vmlist __initdata; static struct vm_struct *vmlist __initdata;
/** /**
* vm_area_add_early - add vmap area early during boot * vm_area_add_early - add vmap area early during boot
* @vm: vm_struct to add * @vm: vm_struct to add
...@@ -1805,7 +1806,6 @@ EXPORT_SYMBOL_GPL(__vmalloc_node_range); ...@@ -1805,7 +1806,6 @@ EXPORT_SYMBOL_GPL(__vmalloc_node_range);
* *
* Any use of gfp flags outside of GFP_KERNEL should be consulted * Any use of gfp flags outside of GFP_KERNEL should be consulted
* with mm people. * with mm people.
*
*/ */
static void *__vmalloc_node(unsigned long size, unsigned long align, static void *__vmalloc_node(unsigned long size, unsigned long align,
gfp_t gfp_mask, pgprot_t prot, gfp_t gfp_mask, pgprot_t prot,
...@@ -1839,6 +1839,7 @@ void *__vmalloc_node_flags_caller(unsigned long size, int node, gfp_t flags, ...@@ -1839,6 +1839,7 @@ void *__vmalloc_node_flags_caller(unsigned long size, int node, gfp_t flags,
/** /**
* vmalloc - allocate virtually contiguous memory * vmalloc - allocate virtually contiguous memory
* @size: allocation size * @size: allocation size
*
* Allocate enough pages to cover @size from the page level * Allocate enough pages to cover @size from the page level
* allocator and map them into contiguous kernel virtual space. * allocator and map them into contiguous kernel virtual space.
* *
...@@ -1855,6 +1856,7 @@ EXPORT_SYMBOL(vmalloc); ...@@ -1855,6 +1856,7 @@ EXPORT_SYMBOL(vmalloc);
/** /**
* vzalloc - allocate virtually contiguous memory with zero fill * vzalloc - allocate virtually contiguous memory with zero fill
* @size: allocation size * @size: allocation size
*
* Allocate enough pages to cover @size from the page level * Allocate enough pages to cover @size from the page level
* allocator and map them into contiguous kernel virtual space. * allocator and map them into contiguous kernel virtual space.
* The memory allocated is set to zero. * The memory allocated is set to zero.
...@@ -1933,7 +1935,6 @@ EXPORT_SYMBOL(vzalloc_node); ...@@ -1933,7 +1935,6 @@ EXPORT_SYMBOL(vzalloc_node);
* For tight control over page level allocator and protection flags * For tight control over page level allocator and protection flags
* use __vmalloc() instead. * use __vmalloc() instead.
*/ */
void *vmalloc_exec(unsigned long size) void *vmalloc_exec(unsigned long size)
{ {
return __vmalloc_node(size, 1, GFP_KERNEL, PAGE_KERNEL_EXEC, return __vmalloc_node(size, 1, GFP_KERNEL, PAGE_KERNEL_EXEC,
...@@ -2086,9 +2087,7 @@ static int aligned_vwrite(char *buf, char *addr, unsigned long count) ...@@ -2086,9 +2087,7 @@ static int aligned_vwrite(char *buf, char *addr, unsigned long count)
* should know vmalloc() area is valid and can use memcpy(). * should know vmalloc() area is valid and can use memcpy().
* This is for routines which have to access vmalloc area without * This is for routines which have to access vmalloc area without
* any informaion, as /dev/kmem. * any informaion, as /dev/kmem.
*
*/ */
long vread(char *buf, char *addr, unsigned long count) long vread(char *buf, char *addr, unsigned long count)
{ {
struct vmap_area *va; struct vmap_area *va;
...@@ -2169,7 +2168,6 @@ long vread(char *buf, char *addr, unsigned long count) ...@@ -2169,7 +2168,6 @@ long vread(char *buf, char *addr, unsigned long count)
* This is for routines which have to access vmalloc area without * This is for routines which have to access vmalloc area without
* any informaion, as /dev/kmem. * any informaion, as /dev/kmem.
*/ */
long vwrite(char *buf, char *addr, unsigned long count) long vwrite(char *buf, char *addr, unsigned long count)
{ {
struct vmap_area *va; struct vmap_area *va;
...@@ -2756,4 +2754,3 @@ static int __init proc_vmalloc_init(void) ...@@ -2756,4 +2754,3 @@ static int __init proc_vmalloc_init(void)
module_init(proc_vmalloc_init); module_init(proc_vmalloc_init);
#endif #endif
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment