Fix kernel-doc warnings found when using "W=1". datastream.c:51: warning: No description found for return value of 'befs_read_datastream' datastream.c:97: warning: No description found for return value of 'befs_fblock2brun' datastream.c:132: warning: expecting prototype for befs_read_lsmylink(). Prototype was for befs_read_lsymlink() instead datastream.c:132: warning: No description found for return value of 'befs_read_lsymlink' datastream.c:173: warning: No description found for return value of 'befs_count_blocks' datastream.c:253: warning: No description found for return value of 'befs_find_brun_direct' datastream.c:309: warning: No description found for return value of 'befs_find_brun_indirect' datastream.c:418: warning: No description found for return value of 'befs_find_brun_dblindirect' Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx> Cc: Luis de Bethencourt <luisbg@xxxxxxxxxx> Cc: Salah Triki <salah.triki@xxxxxxxxx> --- fs/befs/datastream.c | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff -- a/fs/befs/datastream.c b/fs/befs/datastream.c --- a/fs/befs/datastream.c +++ b/fs/befs/datastream.c @@ -42,7 +42,7 @@ static int befs_find_brun_dblindirect(st * @pos: start of data * @off: offset of data in buffer_head->b_data * - * Returns pointer to buffer_head containing data starting with offset @off, + * Returns: pointer to buffer_head containing data starting with offset @off, * if you don't need to know offset just set @off = NULL. */ struct buffer_head * @@ -86,7 +86,7 @@ befs_read_datastream(struct super_block * Takes a file position and gives back a brun who's starting block * is block number fblock of the file. * - * Returns BEFS_OK or BEFS_ERR. + * Returns: BEFS_OK or BEFS_ERR. * * Calls specialized functions for each of the three possible * datastream regions. @@ -118,13 +118,13 @@ befs_fblock2brun(struct super_block *sb, } /** - * befs_read_lsmylink - read long symlink from datastream. + * befs_read_lsymlink - read long symlink from datastream. * @sb: Filesystem superblock * @ds: Datastream to read from * @buff: Buffer in which to place long symlink data * @len: Length of the long symlink in bytes * - * Returns the number of bytes read + * Returns: the number of bytes read */ size_t befs_read_lsymlink(struct super_block *sb, const befs_data_stream *ds, @@ -166,6 +166,8 @@ befs_read_lsymlink(struct super_block *s * inode occupies on the filesystem, counting both regular file * data and filesystem metadata (and eventually attribute data * when we support attributes) + * + * Returns: count of blocks used by the file */ befs_blocknr_t @@ -229,8 +231,7 @@ befs_count_blocks(struct super_block *sb * in the file represented by the datastream data, if that * blockno is in the direct region of the datastream. * - * Return value is BEFS_OK if the blockrun is found, BEFS_ERR - * otherwise. + * Returns: BEFS_OK if the blockrun is found, BEFS_ERR otherwise. * * Algorithm: * Linear search. Checks each element of array[] to see if it @@ -290,8 +291,7 @@ befs_find_brun_direct(struct super_block * in the file represented by the datastream data, if that * blockno is in the indirect region of the datastream. * - * Return value is BEFS_OK if the blockrun is found, BEFS_ERR - * otherwise. + * Returns: BEFS_OK if the blockrun is found, BEFS_ERR otherwise. * * Algorithm: * For each block in the indirect run of the datastream, read @@ -381,8 +381,7 @@ befs_find_brun_indirect(struct super_blo * in the file represented by the datastream data, if that * blockno is in the double-indirect region of the datastream. * - * Return value is BEFS_OK if the blockrun is found, BEFS_ERR - * otherwise. + * Returns: BEFS_OK if the blockrun is found, BEFS_ERR otherwise. * * Algorithm: * The block runs in the double-indirect region are different.