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

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.com


Signed-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

mm/vmalloc.c

+182 −185
Original line number Diff line number Diff line
@@ -1191,6 +1191,7 @@ void *vm_map_ram(struct page **pages, unsigned int count, int node, pgprot_t pro 
EXPORT_SYMBOL(vm_map_ram);



static struct vm_struct *vmlist __initdata;



/**

 * vm_area_add_early - add vmap area early during boot

 * @vm: vm_struct to add
@@ -1805,7 +1806,6 @@ EXPORT_SYMBOL_GPL(__vmalloc_node_range); 
 *

 * Any use of gfp flags outside of GFP_KERNEL should be consulted

 * with mm people.

 *

 */

static void *__vmalloc_node(unsigned long size, unsigned long align,

			    gfp_t gfp_mask, pgprot_t prot,
@@ -1839,6 +1839,7 @@ void *__vmalloc_node_flags_caller(unsigned long size, int node, gfp_t flags, 
/**

 * vmalloc - allocate virtually contiguous memory

 * @size:    allocation size

 *

 * Allocate enough pages to cover @size from the page level

 * allocator and map them into contiguous kernel virtual space.

 *
@@ -1855,6 +1856,7 @@ EXPORT_SYMBOL(vmalloc); 
/**

 * vzalloc - allocate virtually contiguous memory with zero fill

 * @size:    allocation size

 *

 * Allocate enough pages to cover @size from the page level

 * allocator and map them into contiguous kernel virtual space.

 * The memory allocated is set to zero.
@@ -1933,7 +1935,6 @@ EXPORT_SYMBOL(vzalloc_node); 
 * For tight control over page level allocator and protection flags

 * use __vmalloc() instead.

 */



void *vmalloc_exec(unsigned long size)

{

	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) 
 * should know vmalloc() area is valid and can use memcpy().

 * This is for routines which have to access vmalloc area without

 * any informaion, as /dev/kmem.

 *

 */



long vread(char *buf, char *addr, unsigned long count)

{

	struct vmap_area *va;
@@ -2169,7 +2168,6 @@ finished: 
 * This is for routines which have to access vmalloc area without

 * any informaion, as /dev/kmem.

 */



long vwrite(char *buf, char *addr, unsigned long count)

{

	struct vmap_area *va;
@@ -2756,4 +2754,3 @@ static int __init proc_vmalloc_init(void) 
module_init(proc_vmalloc_init);



#endif

CRA Git | Maintained and supported by SUSTech CRA and CCSE