cpp-style: Special note on acronyms

There was a discussion in code reviews on how acronyms should be
handled.  In DBus interfaces, we have used UpperCamelCase through-out
and therefore acronyms are always UPPERCASE in DBus interfaces
specifically.  There was an attempt to carry this forward into C++
style, which caused a contradiction between acronyms-always-uppercase
and variables-are-lower-case.  Clarify this to indicate that acronyms
should always be same-case and are UPPER or lower depending on the
context.

Change-Id: I5bf19595ba38405d1d5d629f8ce854bbc47af8cf
Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
1 file changed
tree: 8cf3284a484bf7e45bf5e9a62fcc9d62fbc41067
  1. userguide/
  2. cheatsheet.md
  3. code-update.md
  4. console.md
  5. contributing.md
  6. cpp-style-and-conventions.md
  7. dbus-interfaces.md
  8. host-management.md
  9. kernel-development.md
  10. Makefile
  11. openbmc-conversion.md
  12. README.md
  13. rest-api.md
  14. rfc-obmc-service-iface.md
  15. yocto-development.md
README.md

OpenBMC documentation

This repository contains documentation for OpenBMC as a whole. There may be component-specific documentation in the repository for each component.

OpenBMC Usage

These documents describe how to use OpenBMC, including using the programmatic interfaces to an OpenBMC system.

OpenBMC Development

These documents contain details on developing OpenBMC code itself

OpenBMC Goals

The OpenBMC project's aim is to create a highly extensible framework for BMC software and implement for data-center computer systems.

We have a few high-level objectives:

  • The OpenBMC framework must be extensible, easy to learn, and usable in a variety of programming languages.

  • Provide a REST API for external management, and allow for "pluggable" interfaces for other types of management interactions.

  • Provide a remote host console, accessible over the network

  • Persist network configuration settable from REST interface and host

  • Provide a robust solution for RTC management, exposed to the host.

  • Compatible with host firmware implementations for basic IPMI communication between host and BMC

  • Provide a flexible and hierarchical inventory tracking component

  • Maintain a sensor database and track thresholds