mbedtls/include/psa
Gilles Peskine ed73355d2e Make \retval commands non-empty
Pacify Clang >=15 which complained:
```
include/psa/crypto.h:91:23: error: empty paragraph passed to '\retval' command [-Werror,-Wdocumentation]
 * \retval #PSA_SUCCESS
   ~~~~~~~~~~~~~~~~~~~^
```

This commit performs the following systematic replacement:
```
perl -i -0777 -p -e 's/([\\@])(retval +\S+)\n(?! *\*? *([^\n \\*\/]|\\[cp]\b))/$1$2 ${1}emptydescription\n/g' $(git ls-files '*.[hc]' '*.function' '*.jinja')
```
i.e. add an `\emptydescription` argument to `\retval` commands (or
`@retval`, which we don't normally used) that are followed by a single word,
unless the next line looks like it contains text which would be the
description.

Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
2023-02-14 19:21:09 +01:00
..
crypto.h Make \retval commands non-empty 2023-02-14 19:21:09 +01:00
crypto_builtin_composites.h Switch to the new code style 2023-01-11 14:50:10 +01:00
crypto_builtin_primitives.h Switch to the new code style 2023-01-11 14:50:10 +01:00
crypto_compat.h Make \retval commands non-empty 2023-02-14 19:21:09 +01:00
crypto_config.h Add ECJPAKE secret input types to psa/crypto_config.h 2023-01-19 12:11:19 +01:00
crypto_driver_common.h Make PSA headers more self-contained 2021-11-25 20:49:09 +01:00
crypto_driver_contexts_composites.h Switch to the new code style 2023-01-11 14:50:10 +01:00
crypto_driver_contexts_primitives.h Switch to the new code style 2023-01-11 14:50:10 +01:00
crypto_extra.h Make \retval commands non-empty 2023-02-14 19:21:09 +01:00
crypto_platform.h Switch to the new code style 2023-01-11 14:50:10 +01:00
crypto_se_driver.h Make \retval commands non-empty 2023-02-14 19:21:09 +01:00
crypto_sizes.h Switch to the new code style 2023-01-11 14:50:10 +01:00
crypto_struct.h Switch to the new code style 2023-01-11 14:50:10 +01:00
crypto_types.h Switch to the new code style 2023-01-11 14:50:10 +01:00
crypto_values.h Switch to the new code style 2023-01-11 14:50:10 +01:00