diff options
author | Heinrich Schuchardt <heinrich.schuchardt@canonical.com> | 2022-01-19 20:05:50 +0300 |
---|---|---|
committer | Heinrich Schuchardt <heinrich.schuchardt@canonical.com> | 2022-01-19 20:11:34 +0300 |
commit | 185f812c419f1b4f0d10d9787d59cf9f11a2a600 (patch) | |
tree | 2fea02768d6005934547f075586c60ba7aca6253 /include/membuff.h | |
parent | 6a685753ce8b6b02b67d64b239143bf19eda63c9 (diff) | |
download | u-boot-185f812c419f1b4f0d10d9787d59cf9f11a2a600.tar.xz |
doc: replace @return by Return:
Sphinx expects Return: and not @return to indicate a return value.
find . -name '*.c' -exec \
sed -i 's/^\(\s\)\*\(\s*\)@return\(\s\)/\1*\2Return:\3/' {} \;
find . -name '*.h' -exec \
sed -i 's/^\(\s\)\*\(\s*\)@return\(\s\)/\1*\2Return:\3/' {} \;
Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
Diffstat (limited to 'include/membuff.h')
-rw-r--r-- | include/membuff.h | 30 |
1 files changed, 15 insertions, 15 deletions
diff --git a/include/membuff.h b/include/membuff.h index c992067133..21051b0c54 100644 --- a/include/membuff.h +++ b/include/membuff.h @@ -62,7 +62,7 @@ void membuff_purge(struct membuff *mb); * @maxlen: the number of bytes we want to write * @update: true to update the membuff as if the write happened, false to not * @data: the address data can be written to - * @return number of bytes which can be written + * Return: number of bytes which can be written */ int membuff_putraw(struct membuff *mb, int maxlen, bool update, char **data); @@ -80,7 +80,7 @@ int membuff_putraw(struct membuff *mb, int maxlen, bool update, char **data); * @update: true to update the membuff as if the bytes have been read (use * false to check bytes without reading them) * @data: returns address of data in input membuff - * @return the number of bytes available at *@data + * Return: the number of bytes available at *@data */ int membuff_getraw(struct membuff *mb, int maxlen, bool update, char **data); @@ -89,14 +89,14 @@ int membuff_getraw(struct membuff *mb, int maxlen, bool update, char **data); * * @mb: membuff to adjust * @ch: byte to write - * @return true on success, false if membuff is full + * Return: true on success, false if membuff is full */ bool membuff_putbyte(struct membuff *mb, int ch); /** * @mb: membuff to adjust * membuff_getbyte() - Read a byte from the membuff - * @return the byte read, or -1 if the membuff is empty + * Return: the byte read, or -1 if the membuff is empty */ int membuff_getbyte(struct membuff *mb); @@ -107,7 +107,7 @@ int membuff_getbyte(struct membuff *mb); * removing it from the membuff. * * @mb: membuff to adjust - * @return the byte peeked, or -1 if the membuff is empty + * Return: the byte peeked, or -1 if the membuff is empty */ int membuff_peekbyte(struct membuff *mb); @@ -120,7 +120,7 @@ int membuff_peekbyte(struct membuff *mb); * @mb: membuff to adjust * @Buff: address of membuff to transfer bytes to * @maxlen: maximum number of bytes to read - * @return the number of bytes read + * Return: the number of bytes read */ int membuff_get(struct membuff *mb, char *buff, int maxlen); @@ -133,7 +133,7 @@ int membuff_get(struct membuff *mb, char *buff, int maxlen); * @mb: membuff to adjust * @data: the data to write * @length: number of bytes to write from 'data' - * @return the number of bytes added + * Return: the number of bytes added */ int membuff_put(struct membuff *mb, const char *buff, int length); @@ -141,7 +141,7 @@ int membuff_put(struct membuff *mb, const char *buff, int length); * membuff_isempty() - check if a membuff is empty * * @mb: membuff to check - * @return true if empty, else false + * Return: true if empty, else false */ bool membuff_isempty(struct membuff *mb); @@ -149,7 +149,7 @@ bool membuff_isempty(struct membuff *mb); * membuff_avail() - check available data in a membuff * * @mb: membuff to check - * @return number of bytes of data available + * Return: number of bytes of data available */ int membuff_avail(struct membuff *mb); @@ -159,7 +159,7 @@ int membuff_avail(struct membuff *mb); * Note that a membuff can only old data up to one byte less than its size. * * @mb: membuff to check - * @return total size + * Return: total size */ int membuff_size(struct membuff *mb); @@ -170,7 +170,7 @@ int membuff_size(struct membuff *mb); * possible * * @mb: membuff to adjust - * @return true on success + * Return: true on success */ bool membuff_makecontig(struct membuff *mb); @@ -178,7 +178,7 @@ bool membuff_makecontig(struct membuff *mb); * membuff_free() - find the number of bytes that can be written to a membuff * * @mb: membuff to check - * @return returns the number of bytes free in a membuff + * Return: returns the number of bytes free in a membuff */ int membuff_free(struct membuff *mb); @@ -192,7 +192,7 @@ int membuff_free(struct membuff *mb); * @mb: membuff to adjust * @str: Place to put the line * @maxlen: Maximum line length (excluding terminator) - * @return number of bytes read (including terminator) if a line has been + * Return: number of bytes read (including terminator) if a line has been * read, 0 if nothing was there */ int membuff_readline(struct membuff *mb, char *str, int maxlen, int minch); @@ -205,7 +205,7 @@ int membuff_readline(struct membuff *mb, char *str, int maxlen, int minch); * @mb: membuff to adjust * @by: Number of bytes to increase the size by * @max: Maximum size to allow - * @return 0 if the expand succeeded, -ENOMEM if not enough memory, -E2BIG + * Return: 0 if the expand succeeded, -ENOMEM if not enough memory, -E2BIG * if the the size would exceed @max */ int membuff_extend_by(struct membuff *mb, int by, int max); @@ -231,7 +231,7 @@ void membuff_uninit(struct membuff *mb); * * @mb: membuff to init * @size: size of membuff to create - * @return 0 if OK, -ENOMEM if out of memory + * Return: 0 if OK, -ENOMEM if out of memory */ int membuff_new(struct membuff *mb, int size); |