[PATCH] befs: fix datastream.c kernel-doc warnings

[Randy Dunlap <rdunlap@infradead.org>]

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@infradead.org>
Cc: Luis de Bethencourt <luisbg@kernel.org>
Cc: Salah Triki <salah.triki@gmail.com>
---
 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.