fs/hfsplus: use better @opf description

rddunlap · brauner · commit cf12445daec0 · 2024-02-12T11:55:13.000+01:00
Use a more descriptive explanation of the @opf function parameter, more in line with <linux/blk_types.h>. Fixes: 02105f1 ("fs/hfsplus: wrapper.c: fix kernel-doc warnings") Suggested-by: Bart Van Assche <bvanassche@acm.org> Signed-off-by: Randy Dunlap <rdunlap@infradead.org> Link: https://lore.kernel.org/r/20240210050606.9182-1-rdunlap@infradead.org Reviewed-by: Bart Van Assche <bvanassche@acm.org> Cc: Alexander Viro <viro@zeniv.linux.org.uk> Cc: Christian Brauner <brauner@kernel.org> Cc: Jens Axboe <axboe@kernel.dk> Signed-off-by: Christian Brauner <brauner@kernel.org>
diff --git a/fs/hfsplus/wrapper.c b/fs/hfsplus/wrapper.c
@@ -30,7 +30,7 @@ struct hfsplus_wd {
  * @sector: block to read or write, for blocks of HFSPLUS_SECTOR_SIZE bytes
  * @buf: buffer for I/O
  * @data: output pointer for location of requested data
- * @opf: request op flags
+ * @opf: I/O operation type and flags
  *
  * The unit of I/O is hfsplus_min_io_size(sb), which may be bigger than
  * HFSPLUS_SECTOR_SIZE, and @buf must be sized accordingly. On reads

Original file line number	Diff line number	Diff line change
`@@ -30,7 +30,7 @@ struct hfsplus_wd {`
`30`	`30`	`* @sector: block to read or write, for blocks of HFSPLUS_SECTOR_SIZE bytes`
`31`	`31`	`* @buf: buffer for I/O`
`32`	`32`	`* @data: output pointer for location of requested data`
`33`		`- * @opf: request op flags`
	`33`	`+ * @opf: I/O operation type and flags`
`34`	`34`	`*`
`35`	`35`	`* The unit of I/O is hfsplus_min_io_size(sb), which may be bigger than`
`36`	`36`	`* HFSPLUS_SECTOR_SIZE, and @buf must be sized accordingly. On reads`