Commit dad7557eb705688040aac134efa5418b66d5ed92
Committed by
Linus Torvalds
1 parent
4fe7efdbdf
Exists in
master
and in
20 other branches
mm: fix kernel-doc warnings
Fix kernel-doc warnings such as Warning(../mm/page_cgroup.c:432): No description found for parameter 'id' Warning(../mm/page_cgroup.c:432): Excess function parameter 'mem' description in 'swap_cgroup_record' Signed-off-by: Wanpeng Li <liwp@linux.vnet.ibm.com> Cc: Randy Dunlap <randy.dunlap@oracle.com> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Showing 6 changed files with 11 additions and 13 deletions Side-by-side Diff
mm/memblock.c
... | ... | @@ -540,9 +540,9 @@ |
540 | 540 | * __next_free_mem_range - next function for for_each_free_mem_range() |
541 | 541 | * @idx: pointer to u64 loop variable |
542 | 542 | * @nid: nid: node selector, %MAX_NUMNODES for all nodes |
543 | - * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | |
544 | - * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | |
545 | - * @p_nid: ptr to int for nid of the range, can be %NULL | |
543 | + * @out_start: ptr to phys_addr_t for start address of the range, can be %NULL | |
544 | + * @out_end: ptr to phys_addr_t for end address of the range, can be %NULL | |
545 | + * @out_nid: ptr to int for nid of the range, can be %NULL | |
546 | 546 | * |
547 | 547 | * Find the first free area from *@idx which matches @nid, fill the out |
548 | 548 | * parameters, and update *@idx for the next iteration. The lower 32bit of |
... | ... | @@ -616,9 +616,9 @@ |
616 | 616 | * __next_free_mem_range_rev - next function for for_each_free_mem_range_reverse() |
617 | 617 | * @idx: pointer to u64 loop variable |
618 | 618 | * @nid: nid: node selector, %MAX_NUMNODES for all nodes |
619 | - * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | |
620 | - * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | |
621 | - * @p_nid: ptr to int for nid of the range, can be %NULL | |
619 | + * @out_start: ptr to phys_addr_t for start address of the range, can be %NULL | |
620 | + * @out_end: ptr to phys_addr_t for end address of the range, can be %NULL | |
621 | + * @out_nid: ptr to int for nid of the range, can be %NULL | |
622 | 622 | * |
623 | 623 | * Reverse of __next_free_mem_range(). |
624 | 624 | */ |
mm/memcontrol.c
... | ... | @@ -1234,7 +1234,7 @@ |
1234 | 1234 | |
1235 | 1235 | /** |
1236 | 1236 | * mem_cgroup_margin - calculate chargeable space of a memory cgroup |
1237 | - * @mem: the memory cgroup | |
1237 | + * @memcg: the memory cgroup | |
1238 | 1238 | * |
1239 | 1239 | * Returns the maximum amount of memory @mem can be charged with, in |
1240 | 1240 | * pages. |
... | ... | @@ -1508,7 +1508,7 @@ |
1508 | 1508 | |
1509 | 1509 | /** |
1510 | 1510 | * test_mem_cgroup_node_reclaimable |
1511 | - * @mem: the target memcg | |
1511 | + * @memcg: the target memcg | |
1512 | 1512 | * @nid: the node ID to be checked. |
1513 | 1513 | * @noswap : specify true here if the user wants flle only information. |
1514 | 1514 | * |
mm/oom_kill.c
... | ... | @@ -365,7 +365,7 @@ |
365 | 365 | |
366 | 366 | /** |
367 | 367 | * dump_tasks - dump current memory state of all system tasks |
368 | - * @mem: current's memory controller, if constrained | |
368 | + * @memcg: current's memory controller, if constrained | |
369 | 369 | * @nodemask: nodemask passed to page allocator for mempolicy ooms |
370 | 370 | * |
371 | 371 | * Dumps the current memory state of all eligible tasks. Tasks not in the same |
mm/page_cgroup.c
... | ... | @@ -392,7 +392,7 @@ |
392 | 392 | |
393 | 393 | /** |
394 | 394 | * swap_cgroup_cmpxchg - cmpxchg mem_cgroup's id for this swp_entry. |
395 | - * @end: swap entry to be cmpxchged | |
395 | + * @ent: swap entry to be cmpxchged | |
396 | 396 | * @old: old id |
397 | 397 | * @new: new id |
398 | 398 | * |
... | ... | @@ -422,7 +422,7 @@ |
422 | 422 | /** |
423 | 423 | * swap_cgroup_record - record mem_cgroup for this swp_entry. |
424 | 424 | * @ent: swap entry to be recorded into |
425 | - * @mem: mem_cgroup to be recorded | |
425 | + * @id: mem_cgroup to be recorded | |
426 | 426 | * |
427 | 427 | * Returns old value at success, 0 at failure. |
428 | 428 | * (Of course, old value can be 0.) |
mm/pagewalk.c
mm/percpu-vm.c
... | ... | @@ -360,7 +360,6 @@ |
360 | 360 | * @chunk: chunk to depopulate |
361 | 361 | * @off: offset to the area to depopulate |
362 | 362 | * @size: size of the area to depopulate in bytes |
363 | - * @flush: whether to flush cache and tlb or not | |
364 | 363 | * |
365 | 364 | * For each cpu, depopulate and unmap pages [@page_start,@page_end) |
366 | 365 | * from @chunk. If @flush is true, vcache is flushed before unmapping |