Commit ead04089 authored by Rolf Eike Beer's avatar Rolf Eike Beer Committed by Linus Torvalds

[PATCH] Fix kerneldoc comments in mm/vmalloc.c

The empty line between the short description and the first argument
description causes a section to appear twice in the generated manpage.
Also the short description should really be short: the script can't handle
multiple lines.
Signed-off-by: default avatarRolf Eike Beer <eike-kernel@sf-tec.de>
Acked-by: default avatarRandy Dunlap <rdunlap@xenotime.net>
Signed-off-by: default avatarAndrew Morton <akpm@osdl.org>
Signed-off-by: default avatarLinus Torvalds <torvalds@osdl.org>
parent 423b41d7
...@@ -241,7 +241,6 @@ struct vm_struct *__get_vm_area(unsigned long size, unsigned long flags, ...@@ -241,7 +241,6 @@ struct vm_struct *__get_vm_area(unsigned long size, unsigned long flags,
/** /**
* get_vm_area - reserve a contingous kernel virtual area * get_vm_area - reserve a contingous kernel virtual area
*
* @size: size of the area * @size: size of the area
* @flags: %VM_IOREMAP for I/O mappings or VM_ALLOC * @flags: %VM_IOREMAP for I/O mappings or VM_ALLOC
* *
...@@ -296,7 +295,6 @@ struct vm_struct *__remove_vm_area(void *addr) ...@@ -296,7 +295,6 @@ struct vm_struct *__remove_vm_area(void *addr)
/** /**
* remove_vm_area - find and remove a contingous kernel virtual area * remove_vm_area - find and remove a contingous kernel virtual area
*
* @addr: base address * @addr: base address
* *
* Search for the kernel VM area starting at @addr, and remove it. * Search for the kernel VM area starting at @addr, and remove it.
...@@ -355,7 +353,6 @@ void __vunmap(void *addr, int deallocate_pages) ...@@ -355,7 +353,6 @@ void __vunmap(void *addr, int deallocate_pages)
/** /**
* vfree - release memory allocated by vmalloc() * vfree - release memory allocated by vmalloc()
*
* @addr: memory base address * @addr: memory base address
* *
* Free the virtually contiguous memory area starting at @addr, as * Free the virtually contiguous memory area starting at @addr, as
...@@ -373,7 +370,6 @@ EXPORT_SYMBOL(vfree); ...@@ -373,7 +370,6 @@ EXPORT_SYMBOL(vfree);
/** /**
* vunmap - release virtual mapping obtained by vmap() * vunmap - release virtual mapping obtained by vmap()
*
* @addr: memory base address * @addr: memory base address
* *
* Free the virtually contiguous memory area starting at @addr, * Free the virtually contiguous memory area starting at @addr,
...@@ -390,7 +386,6 @@ EXPORT_SYMBOL(vunmap); ...@@ -390,7 +386,6 @@ EXPORT_SYMBOL(vunmap);
/** /**
* vmap - map an array of pages into virtually contiguous space * vmap - map an array of pages into virtually contiguous space
*
* @pages: array of page pointers * @pages: array of page pointers
* @count: number of pages to map * @count: number of pages to map
* @flags: vm_area->flags * @flags: vm_area->flags
...@@ -471,7 +466,6 @@ void *__vmalloc_area(struct vm_struct *area, gfp_t gfp_mask, pgprot_t prot) ...@@ -471,7 +466,6 @@ void *__vmalloc_area(struct vm_struct *area, gfp_t gfp_mask, pgprot_t prot)
/** /**
* __vmalloc_node - allocate virtually contiguous memory * __vmalloc_node - allocate virtually contiguous memory
*
* @size: allocation size * @size: allocation size
* @gfp_mask: flags for the page level allocator * @gfp_mask: flags for the page level allocator
* @prot: protection mask for the allocated pages * @prot: protection mask for the allocated pages
...@@ -505,9 +499,7 @@ EXPORT_SYMBOL(__vmalloc); ...@@ -505,9 +499,7 @@ EXPORT_SYMBOL(__vmalloc);
/** /**
* 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.
* *
...@@ -521,11 +513,11 @@ void *vmalloc(unsigned long size) ...@@ -521,11 +513,11 @@ void *vmalloc(unsigned long size)
EXPORT_SYMBOL(vmalloc); EXPORT_SYMBOL(vmalloc);
/** /**
* vmalloc_user - allocate virtually contiguous memory which has * vmalloc_user - allocate zeroed virtually contiguous memory for userspace
* been zeroed so it can be mapped to userspace without * @size: allocation size
* leaking data.
* *
* @size: allocation size * The resulting memory area is zeroed so it can be mapped to userspace
* without leaking data.
*/ */
void *vmalloc_user(unsigned long size) void *vmalloc_user(unsigned long size)
{ {
...@@ -544,7 +536,6 @@ EXPORT_SYMBOL(vmalloc_user); ...@@ -544,7 +536,6 @@ EXPORT_SYMBOL(vmalloc_user);
/** /**
* vmalloc_node - allocate memory on a specific node * vmalloc_node - allocate memory on a specific node
*
* @size: allocation size * @size: allocation size
* @node: numa node * @node: numa node
* *
...@@ -566,7 +557,6 @@ EXPORT_SYMBOL(vmalloc_node); ...@@ -566,7 +557,6 @@ EXPORT_SYMBOL(vmalloc_node);
/** /**
* vmalloc_exec - allocate virtually contiguous, executable memory * vmalloc_exec - allocate virtually contiguous, executable memory
*
* @size: allocation size * @size: allocation size
* *
* Kernel-internal function to allocate enough pages to cover @size * Kernel-internal function to allocate enough pages to cover @size
...@@ -584,7 +574,6 @@ void *vmalloc_exec(unsigned long size) ...@@ -584,7 +574,6 @@ void *vmalloc_exec(unsigned long size)
/** /**
* vmalloc_32 - allocate virtually contiguous memory (32bit addressable) * vmalloc_32 - allocate virtually contiguous memory (32bit addressable)
*
* @size: allocation size * @size: allocation size
* *
* Allocate enough 32bit PA addressable pages to cover @size from the * Allocate enough 32bit PA addressable pages to cover @size from the
...@@ -597,11 +586,11 @@ void *vmalloc_32(unsigned long size) ...@@ -597,11 +586,11 @@ void *vmalloc_32(unsigned long size)
EXPORT_SYMBOL(vmalloc_32); EXPORT_SYMBOL(vmalloc_32);
/** /**
* vmalloc_32_user - allocate virtually contiguous memory (32bit * vmalloc_32_user - allocate zeroed virtually contiguous 32bit memory
* addressable) which is zeroed so it can be
* mapped to userspace without leaking data.
*
* @size: allocation size * @size: allocation size
*
* The resulting memory area is 32bit addressable and zeroed so it can be
* mapped to userspace without leaking data.
*/ */
void *vmalloc_32_user(unsigned long size) void *vmalloc_32_user(unsigned long size)
{ {
...@@ -695,7 +684,6 @@ long vwrite(char *buf, char *addr, unsigned long count) ...@@ -695,7 +684,6 @@ long vwrite(char *buf, char *addr, unsigned long count)
/** /**
* remap_vmalloc_range - map vmalloc pages to userspace * remap_vmalloc_range - map vmalloc pages to userspace
*
* @vma: vma to cover (map full range of vma) * @vma: vma to cover (map full range of vma)
* @addr: vmalloc memory * @addr: vmalloc memory
* @pgoff: number of pages into addr before first page to map * @pgoff: number of pages into addr before first page to map
......
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