On 6/23/22 23:07, Christoph Hellwig wrote:
On Thu, Jun 23, 2022 at 04:25:59PM -0700, Bart Van Assche wrote:
+/**
+ * blk_rq_is_zoned_seq_write() - Whether @rq is a write request for a sequential zone.
This doesn't parse and is overly long at the same time.
Hi Christoph,
It is not clear to me why you wrote that "this doesn't parse"? Are you
referring to the function name or to the function description? I think
the text at the right side of the hyphen is grammatically correct.
Although I'm in favor of respecting the 80 column limit, I haven't found
any explanation in Documentation/doc-guide/kernel-doc.rst about whether
or not splitting the brief description across multiple lines is supported.
Thanks,
Bart.
