Commit 78a4a50a86b0a54f7ecbc164267b6c762760254c

Authored by Randy Dunlap
Committed by Linus Torvalds
1 parent 64e6269071

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

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