Commit 78a4a50a86b0a54f7ecbc164267b6c762760254c
Committed by
Linus Torvalds
1 parent
64e6269071
Exists in
master
and in
39 other branches
docbook: fix filesystems.tmpl source files
Fix docbook problems in filesystems.tmpl. These cause the generated docbook to be incorrect. Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Showing 3 changed files with 13 additions and 18 deletions Side-by-side Diff
fs/buffer.c
... | ... | @@ -627,8 +627,7 @@ |
627 | 627 | } |
628 | 628 | |
629 | 629 | /** |
630 | - * sync_mapping_buffers - write out and wait upon a mapping's "associated" | |
631 | - * buffers | |
630 | + * sync_mapping_buffers - write out & wait upon a mapping's "associated" buffers | |
632 | 631 | * @mapping: the mapping which wants those buffers written |
633 | 632 | * |
634 | 633 | * Starts I/O against the buffers at mapping->private_list, and waits upon |
fs/jbd/transaction.c
... | ... | @@ -369,7 +369,7 @@ |
369 | 369 | |
370 | 370 | |
371 | 371 | /** |
372 | - * int journal_restart() - restart a handle . | |
372 | + * int journal_restart() - restart a handle. | |
373 | 373 | * @handle: handle to restart |
374 | 374 | * @nblocks: nr credits requested |
375 | 375 | * |
... | ... | @@ -844,8 +844,7 @@ |
844 | 844 | } |
845 | 845 | |
846 | 846 | /** |
847 | - * int journal_get_undo_access() - Notify intent to modify metadata with | |
848 | - * non-rewindable consequences | |
847 | + * int journal_get_undo_access() - Notify intent to modify metadata with non-rewindable consequences | |
849 | 848 | * @handle: transaction |
850 | 849 | * @bh: buffer to undo |
851 | 850 | * @credits: store the number of taken credits here (if not NULL) |
852 | 851 | |
... | ... | @@ -921,12 +920,14 @@ |
921 | 920 | } |
922 | 921 | |
923 | 922 | /** |
924 | - * int journal_dirty_data() - mark a buffer as containing dirty data which | |
925 | - * needs to be flushed before we can commit the | |
926 | - * current transaction. | |
923 | + * int journal_dirty_data() - mark a buffer as containing dirty data to be flushed | |
927 | 924 | * @handle: transaction |
928 | 925 | * @bh: bufferhead to mark |
929 | 926 | * |
927 | + * Description: | |
928 | + * Mark a buffer as containing dirty data which needs to be flushed before | |
929 | + * we can commit the current transaction. | |
930 | + * | |
930 | 931 | * The buffer is placed on the transaction's data list and is marked as |
931 | 932 | * belonging to the transaction. |
932 | 933 | * |
933 | 934 | |
... | ... | @@ -1098,11 +1099,11 @@ |
1098 | 1099 | } |
1099 | 1100 | |
1100 | 1101 | /** |
1101 | - * int journal_dirty_metadata() - mark a buffer as containing dirty metadata | |
1102 | + * int journal_dirty_metadata() - mark a buffer as containing dirty metadata | |
1102 | 1103 | * @handle: transaction to add buffer to. |
1103 | 1104 | * @bh: buffer to mark |
1104 | 1105 | * |
1105 | - * mark dirty metadata which needs to be journaled as part of the current | |
1106 | + * Mark dirty metadata which needs to be journaled as part of the current | |
1106 | 1107 | * transaction. |
1107 | 1108 | * |
1108 | 1109 | * The buffer is placed on the transaction's metadata list and is marked |
fs/mpage.c
... | ... | @@ -325,16 +325,12 @@ |
325 | 325 | } |
326 | 326 | |
327 | 327 | /** |
328 | - * mpage_readpages - populate an address space with some pages, and | |
329 | - * start reads against them. | |
330 | - * | |
328 | + * mpage_readpages - populate an address space with some pages & start reads against them | |
331 | 329 | * @mapping: the address_space |
332 | 330 | * @pages: The address of a list_head which contains the target pages. These |
333 | 331 | * pages have their ->index populated and are otherwise uninitialised. |
334 | - * | |
335 | 332 | * The page at @pages->prev has the lowest file offset, and reads should be |
336 | 333 | * issued in @pages->prev to @pages->next order. |
337 | - * | |
338 | 334 | * @nr_pages: The number of pages at *@pages |
339 | 335 | * @get_block: The filesystem's block mapper function. |
340 | 336 | * |
... | ... | @@ -360,6 +356,7 @@ |
360 | 356 | * So an mpage read of the first 16 blocks of an ext2 file will cause I/O to be |
361 | 357 | * submitted in the following order: |
362 | 358 | * 12 0 1 2 3 4 5 6 7 8 9 10 11 13 14 15 16 |
359 | + * | |
363 | 360 | * because the indirect block has to be read to get the mappings of blocks |
364 | 361 | * 13,14,15,16. Obviously, this impacts performance. |
365 | 362 | * |
... | ... | @@ -656,9 +653,7 @@ |
656 | 653 | } |
657 | 654 | |
658 | 655 | /** |
659 | - * mpage_writepages - walk the list of dirty pages of the given | |
660 | - * address space and writepage() all of them. | |
661 | - * | |
656 | + * mpage_writepages - walk the list of dirty pages of the given address space & writepage() all of them | |
662 | 657 | * @mapping: address space structure to write |
663 | 658 | * @wbc: subtract the number of written pages from *@wbc->nr_to_write |
664 | 659 | * @get_block: the filesystem's block mapper function. |