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: Rolf Eike Beer <eike-kernel@sf-tec.de>
Acked-by: Randy Dunlap <rdunlap@xenotime.net>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
/**
* get_vm_area - reserve a contingous kernel virtual area
/**
* get_vm_area - reserve a contingous kernel virtual area
* @size: size of the area
* @flags: %VM_IOREMAP for I/O mappings or VM_ALLOC
*
* @size: size of the area
* @flags: %VM_IOREMAP for I/O mappings or VM_ALLOC
*
/**
* 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
*
* Search for the kernel VM area starting at @addr, and remove it.
* @addr: base address
*
* Search for the kernel VM area starting at @addr, and remove it.
/**
* vfree - release memory allocated by vmalloc()
/**
* vfree - release memory allocated by vmalloc()
* @addr: memory base address
*
* Free the virtually contiguous memory area starting at @addr, as
* @addr: memory base address
*
* Free the virtually contiguous memory area starting at @addr, as
/**
* vunmap - release virtual mapping obtained by vmap()
/**
* vunmap - release virtual mapping obtained by vmap()
* @addr: memory base address
*
* Free the virtually contiguous memory area starting at @addr,
* @addr: memory base address
*
* Free the virtually contiguous memory area starting at @addr,
/**
* 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
* @count: number of pages to map
* @flags: vm_area->flags
* @pages: array of page pointers
* @count: number of pages to map
* @flags: vm_area->flags
/**
* __vmalloc_node - allocate virtually contiguous memory
/**
* __vmalloc_node - allocate virtually contiguous memory
* @size: allocation size
* @gfp_mask: flags for the page level allocator
* @prot: protection mask for the allocated pages
* @size: allocation size
* @gfp_mask: flags for the page level allocator
* @prot: protection mask for the allocated pages
/**
* vmalloc - allocate virtually contiguous memory
/**
* vmalloc - allocate virtually contiguous memory
* Allocate enough pages to cover @size from the page level
* allocator and map them into contiguous kernel virtual space.
*
* Allocate enough pages to cover @size from the page level
* allocator and map them into contiguous kernel virtual space.
*
EXPORT_SYMBOL(vmalloc);
/**
EXPORT_SYMBOL(vmalloc);
/**
- * vmalloc_user - allocate virtually contiguous memory which has
- * been zeroed so it can be mapped to userspace without
- * leaking data.
+ * vmalloc_user - allocate zeroed virtually contiguous memory for userspace
+ * @size: allocation size
- * @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)
{
/**
* vmalloc_node - allocate memory on a specific node
/**
* vmalloc_node - allocate memory on a specific node
* @size: allocation size
* @node: numa node
*
* @size: allocation size
* @node: numa node
*
/**
* vmalloc_exec - allocate virtually contiguous, executable memory
/**
* vmalloc_exec - allocate virtually contiguous, executable memory
* @size: allocation size
*
* Kernel-internal function to allocate enough pages to cover @size
* @size: allocation size
*
* Kernel-internal function to allocate enough pages to cover @size
/**
* vmalloc_32 - allocate virtually contiguous memory (32bit addressable)
/**
* vmalloc_32 - allocate virtually contiguous memory (32bit addressable)
* @size: allocation size
*
* Allocate enough 32bit PA addressable pages to cover @size from the
* @size: allocation size
*
* Allocate enough 32bit PA addressable pages to cover @size from the
EXPORT_SYMBOL(vmalloc_32);
/**
EXPORT_SYMBOL(vmalloc_32);
/**
- * vmalloc_32_user - allocate virtually contiguous memory (32bit
- * addressable) which is zeroed so it can be
- * mapped to userspace without leaking data.
- *
+ * vmalloc_32_user - allocate zeroed virtually contiguous 32bit memory
+ *
+ * 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)
{
/**
* 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)
* @addr: vmalloc memory
* @pgoff: number of pages into addr before first page to map
* @vma: vma to cover (map full range of vma)
* @addr: vmalloc memory
* @pgoff: number of pages into addr before first page to map