Messages in this thread | | | From | Ryusuke Konishi <> | Date | Thu, 24 Mar 2022 12:38:54 +0900 | Subject | Re: [PATCH -next v2] fs: Fix some kernel-doc comments |
| |
On Thu, Mar 24, 2022 at 11:42 AM Yang Li <yang.lee@linux.alibaba.com> wrote: > > The description of @flags in nilfs_dirty_inode() kernel-doc > comment is missing, and some functions had kernel-doc that > used a hash instead of a colon to separate the parameter > name from the one line description. > > Fix them to remove some warnings found by running scripts/kernel-doc, > which is caused by using 'make W=1'. > > fs/nilfs2/inode.c:73: warning: Function parameter or member 'inode' not > described in 'nilfs_get_block' > fs/nilfs2/inode.c:73: warning: Function parameter or member 'blkoff' not > described in 'nilfs_get_block' > fs/nilfs2/inode.c:73: warning: Function parameter or member 'bh_result' > not described in 'nilfs_get_block' > fs/nilfs2/inode.c:73: warning: Function parameter or member 'create' not > described in 'nilfs_get_block' > fs/nilfs2/inode.c:145: warning: Function parameter or member 'file' not > described in 'nilfs_readpage' > fs/nilfs2/inode.c:145: warning: Function parameter or member 'page' not > described in 'nilfs_readpage' > fs/nilfs2/inode.c:968: warning: Function parameter or member 'flags' not > described in 'nilfs_dirty_inode' > > Reported-by: Abaci Robot <abaci@linux.alibaba.com> > Signed-off-by: Yang Li <yang.lee@linux.alibaba.com> > --- > > --Changes in v2: > Modified description of @flags in nilfs_dirty_inode() kernel-doc comment > > fs/nilfs2/inode.c | 13 +++++++------ > 1 file changed, 7 insertions(+), 6 deletions(-)
Will apply, thanks!
Ryusuke Konishi
| |