| commit | 57a48b218f234412662c72141323c1552478e75c | [log] [tgz] |
|---|---|---|
| author | Patrick Williams <patrick@stwcx.xyz> | Wed Dec 18 17:25:08 2024 -0500 |
| committer | Patrick Williams <patrick@stwcx.xyz> | Sat Feb 01 13:12:09 2025 +0000 |
| tree | d782d93f9914a35f3f305dd0b8306868dfe2548a | |
| parent | d376bef4f1aa7ca6ff2140841fd9ad61bff4adea [diff] |
clang-format: adjust PenaltyReturnTypeOnItOwnLine
Tweaking this format penalty was suggested during a review of the
latest clang-format results against dbus-sensors. The primary result
of this change is that long function names and arguments tend to not
be separated from their return type.
Before:
```
void
someReallyLongFunctionName(int andAnArg);
```
After:
```
void someReallyLongFunctionName(
int andAnArg);
```
My primary concern with this change is the readability of code
using post-function return types, but I don't see any evidence
of this affecting them when I apply this to a few repositories.
Example:
```
auto
someReallyLongFunctionName(int andAnArg) -> int;
// vs
auto someReallyLongFunctionName(
int andAnArg)
-> int;
```
An experimental version of this change is available[1].
[1]: https://gerrit.openbmc.org/c/openbmc/dbus-sensors/+/76859
Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: If7dac1a3c796a8145f0ca09b78941a23cabcdd7d
The OpenBMC project is a Linux Foundation project whose goal is to produce a customizable, open-source firmware stack for Baseboard Management Controllers (BMCs). This repository contains documentation for OpenBMC as a whole. There may be component-specific documentation in the repository for each component.
The features document lists the project's major features with links to more information.
These documents contain details on developing OpenBMC code itself
cheatsheet.md: Quick reference for some common development tasks
CONTRIBUTING.md: Guidelines for contributing to OpenBMC
development tutorials: Tutorials for getting up to speed on OpenBMC development
kernel-development.md: Reference for common kernel development tasks
These documents describe how to use OpenBMC, including using the programmatic interfaces to an OpenBMC system.
code-update: Updating OpenBMC and host platform firmware
console.md: Using the host console
host-management.md: Performing host management tasks with OpenBMC
rest-api.md: Introduction to using the OpenBMC REST API
REDFISH-cheatsheet.md: Quick reference for some common OpenBMC Redfish commands
REST-cheatsheet.md: Quick reference for some common OpenBMC REST API commands