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>
This commit is contained in:
Heinrich Schuchardt
2022-01-19 18:05:50 +01:00
parent 6a685753ce
commit 185f812c41
524 changed files with 2505 additions and 2505 deletions

View File

@@ -27,7 +27,7 @@ struct hda_codec_priv {
* hda_wait_for_ready() - Wait for the codec to indicate it is ready
*
* @regs: HDA registers
* @return 0 if OK -ETIMEDOUT if codec did not respond in time
* Return: 0 if OK -ETIMEDOUT if codec did not respond in time
*/
int hda_wait_for_ready(struct hda_regs *regs);
@@ -35,7 +35,7 @@ int hda_wait_for_ready(struct hda_regs *regs);
* hda_wait_for_valid() - Wait for the codec to accept the last command
*
* @regs: HDA registers
* @return 0 if OK -ETIMEDOUT if codec did not respond in time
* Return: 0 if OK -ETIMEDOUT if codec did not respond in time
*/
int hda_wait_for_valid(struct hda_regs *regs);
@@ -43,8 +43,8 @@ int hda_wait_for_valid(struct hda_regs *regs);
* hda_codec_detect() - Detect which codecs are present
*
* @regs: HDA registers
* @return bit mask of active codecs (0 if none)
* @return 0 if OK, -ve on error
* Return: bit mask of active codecs (0 if none)
* Return: 0 if OK, -ve on error
*/
int hda_codec_detect(struct hda_regs *regs);
@@ -54,7 +54,7 @@ int hda_codec_detect(struct hda_regs *regs);
* @dev: Sound device
* @regs: HDA registers
* @codec_mask: Mask of codecs to init (bits 3:0)
* @return 0 if OK, -ve on error
* Return: 0 if OK, -ve on error
*/
int hda_codecs_init(struct udevice *dev, struct hda_regs *regs, u32 codec_mask);
@@ -66,7 +66,7 @@ int hda_codecs_init(struct udevice *dev, struct hda_regs *regs, u32 codec_mask);
*
* @dev: Sound device
* @frequency_hz: Beep frequency in hertz
* @return if OK, -ve on error
* Return: if OK, -ve on error
*/
int hda_codec_start_beep(struct udevice *dev, int frequency_hz);
@@ -76,7 +76,7 @@ int hda_codec_start_beep(struct udevice *dev, int frequency_hz);
* This tells the sound hardware to stop a previously started beep.
*
* @dev: Sound device
* @return if OK, -ve on error
* Return: if OK, -ve on error
*/
int hda_codec_stop_beep(struct udevice *dev);
@@ -86,7 +86,7 @@ int hda_codec_stop_beep(struct udevice *dev);
* This should be called at the start of the probe() method.
*
* @dev: Sound device
* @return 0 if OK, -ve on error
* Return: 0 if OK, -ve on error
*/
int hda_codec_init(struct udevice *dev);
@@ -96,7 +96,7 @@ int hda_codec_init(struct udevice *dev);
* This should be called at the end of the probe() method.
*
* @dev: Sound device
* @return 0 if OK, -ve on error
* Return: 0 if OK, -ve on error
*/
int hda_codec_finish_init(struct udevice *dev);