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>
This commit is contained in:
Randy Dunlap 2008-02-29 22:02:31 -08:00 committed by Linus Torvalds
parent 64e6269071
commit 78a4a50a86
3 changed files with 13 additions and 18 deletions

View File

@ -627,8 +627,7 @@ static int osync_buffers_list(spinlock_t *lock, struct list_head *list)
} }
/** /**
* sync_mapping_buffers - write out and wait upon a mapping's "associated" * sync_mapping_buffers - write out & wait upon a mapping's "associated" buffers
* buffers
* @mapping: the mapping which wants those buffers written * @mapping: the mapping which wants those buffers written
* *
* Starts I/O against the buffers at mapping->private_list, and waits upon * Starts I/O against the buffers at mapping->private_list, and waits upon

View File

@ -369,7 +369,7 @@ int journal_extend(handle_t *handle, int nblocks)
/** /**
* int journal_restart() - restart a handle . * int journal_restart() - restart a handle.
* @handle: handle to restart * @handle: handle to restart
* @nblocks: nr credits requested * @nblocks: nr credits requested
* *
@ -844,8 +844,7 @@ int journal_get_create_access(handle_t *handle, struct buffer_head *bh)
} }
/** /**
* int journal_get_undo_access() - Notify intent to modify metadata with * int journal_get_undo_access() - Notify intent to modify metadata with non-rewindable consequences
* non-rewindable consequences
* @handle: transaction * @handle: transaction
* @bh: buffer to undo * @bh: buffer to undo
* @credits: store the number of taken credits here (if not NULL) * @credits: store the number of taken credits here (if not NULL)
@ -921,12 +920,14 @@ int journal_get_undo_access(handle_t *handle, struct buffer_head *bh)
} }
/** /**
* int journal_dirty_data() - mark a buffer as containing dirty data which * int journal_dirty_data() - mark a buffer as containing dirty data to be flushed
* needs to be flushed before we can commit the
* current transaction.
* @handle: transaction * @handle: transaction
* @bh: bufferhead to mark * @bh: bufferhead to mark
* *
* Description:
* Mark a buffer as containing dirty data which needs to be flushed before
* we can commit the current transaction.
*
* The buffer is placed on the transaction's data list and is marked as * The buffer is placed on the transaction's data list and is marked as
* belonging to the transaction. * belonging to the transaction.
* *
@ -1098,11 +1099,11 @@ int journal_dirty_data(handle_t *handle, struct buffer_head *bh)
} }
/** /**
* int journal_dirty_metadata() - mark a buffer as containing dirty metadata * int journal_dirty_metadata() - mark a buffer as containing dirty metadata
* @handle: transaction to add buffer to. * @handle: transaction to add buffer to.
* @bh: buffer to mark * @bh: buffer to mark
* *
* mark dirty metadata which needs to be journaled as part of the current * Mark dirty metadata which needs to be journaled as part of the current
* transaction. * transaction.
* *
* The buffer is placed on the transaction's metadata list and is marked * The buffer is placed on the transaction's metadata list and is marked

View File

@ -325,16 +325,12 @@ do_mpage_readpage(struct bio *bio, struct page *page, unsigned nr_pages,
} }
/** /**
* mpage_readpages - populate an address space with some pages, and * mpage_readpages - populate an address space with some pages & start reads against them
* start reads against them.
*
* @mapping: the address_space * @mapping: the address_space
* @pages: The address of a list_head which contains the target pages. These * @pages: The address of a list_head which contains the target pages. These
* pages have their ->index populated and are otherwise uninitialised. * pages have their ->index populated and are otherwise uninitialised.
*
* The page at @pages->prev has the lowest file offset, and reads should be * The page at @pages->prev has the lowest file offset, and reads should be
* issued in @pages->prev to @pages->next order. * issued in @pages->prev to @pages->next order.
*
* @nr_pages: The number of pages at *@pages * @nr_pages: The number of pages at *@pages
* @get_block: The filesystem's block mapper function. * @get_block: The filesystem's block mapper function.
* *
@ -360,6 +356,7 @@ do_mpage_readpage(struct bio *bio, struct page *page, unsigned nr_pages,
* So an mpage read of the first 16 blocks of an ext2 file will cause I/O to be * So an mpage read of the first 16 blocks of an ext2 file will cause I/O to be
* submitted in the following order: * submitted in the following order:
* 12 0 1 2 3 4 5 6 7 8 9 10 11 13 14 15 16 * 12 0 1 2 3 4 5 6 7 8 9 10 11 13 14 15 16
*
* because the indirect block has to be read to get the mappings of blocks * because the indirect block has to be read to get the mappings of blocks
* 13,14,15,16. Obviously, this impacts performance. * 13,14,15,16. Obviously, this impacts performance.
* *
@ -656,9 +653,7 @@ static int __mpage_writepage(struct page *page, struct writeback_control *wbc,
} }
/** /**
* mpage_writepages - walk the list of dirty pages of the given * mpage_writepages - walk the list of dirty pages of the given address space & writepage() all of them
* address space and writepage() all of them.
*
* @mapping: address space structure to write * @mapping: address space structure to write
* @wbc: subtract the number of written pages from *@wbc->nr_to_write * @wbc: subtract the number of written pages from *@wbc->nr_to_write
* @get_block: the filesystem's block mapper function. * @get_block: the filesystem's block mapper function.