> The kernel-doc in include/linux/seq_buf.h and lib/seq_buf.c documents > the seq_buf interface, but no .rst file pulls either of them in, so none > of it reaches the generated documentation. > > Add the missing kernel-doc for seq_buf_clear() and seq_buf_init(), and a > Sequence Buffers section to the kernel API documentation. The static > internal helper seq_buf_can_fit() is left out. Additionally fix > seq_buf_hex_dump() indentation to avoid the reported Sphinx error: > > ERROR: Unexpected indentation. > WARNING: Block quote ends without a blank line; unexpected unindent. > > Verified with "make SPHINXDIRS=core-api htmldocs", which rendered > happily into core-api/kernel-api.html. > > Assisted-by: LLM > Co-developed-by: Bill Wendling <[email protected]> > Signed-off-by: Bill Wendling <[email protected]> > Tested-by: Randy Dunlap <[email protected]> > Reviewed-by: Randy Dunlap <[email protected]> > Signed-off-by: Kees Cook <[email protected]>
Sashiko has reviewed this patch and found no issues. It looks great! -- Sashiko AI review ยท https://sashiko.dev/#/patchset/[email protected]?part=11
