block: improve the submit_bio and generic_make_request documentation
authorChristoph Hellwig <hch@lst.de>
Tue, 28 Apr 2020 11:27:53 +0000 (13:27 +0200)
committerJens Axboe <axboe@kernel.dk>
Wed, 29 Apr 2020 15:33:26 +0000 (09:33 -0600)
commit3fdd40861d800a4e1eb67c5158e8ab90076e2f93
tree14b5a086a61b7db16a138b89a18c24d8fb6d870c
parente1b586f2b83d56f40faa5f23d5ecac866d61320d
block: improve the submit_bio and generic_make_request documentation

The current documentation is a little weird, as it doesn't clearly
explain which function to use, and also has the guts of the information
on generic_make_request, which is the internal interface for stacking
drivers.

Fix this up by properly documenting submit_bio, and only documenting
the differences and the use case for generic_make_request.

Signed-off-by: Christoph Hellwig <hch@lst.de>
Reviewed-by: Keith Busch <kbusch@kernel.org>
Signed-off-by: Jens Axboe <axboe@kernel.dk>
block/blk-core.c