docs/CODING_STYLE: document that we nowadays prefer (const char*) for func ret type

Addresses https://github.com/systemd/systemd/pull/33567#discussion_r1662818225

(cherry picked from commit 4b7249111a)
This commit is contained in:
Mike Yuan 2024-07-02 19:20:01 +02:00 committed by Luca Boccassi
parent ea92f16422
commit 3c91ea49d2

View file

@ -54,6 +54,18 @@ SPDX-License-Identifier: LGPL-2.1-or-later
}
```
- Function return types should be seen/written as whole, i.e. write this:
```c
const char* foo(const char *input);
```
instead of this:
```c
const char *foo(const char *input);
```
- Single-line `if` blocks should not be enclosed in `{}`. Write this:
```c
@ -182,7 +194,7 @@ SPDX-License-Identifier: LGPL-2.1-or-later
```c
static int foobar_frobnicate(
Foobar* object, /* the associated mutable object */
Foobar *object, /* the associated mutable object */
const char *input, /* immutable input parameter */
char **ret_frobnicated, /* return parameter on success */
unsigned *reterr_line, /* return parameter on failure */