Steve Karg
d50c190957
* moving folders and files and adjust server demo build * Fix Makefile for apps/server on Linux * fix unit test source file folders * fix datetime convert UTC functions. Add Code::Blocks project for datetime testing * added some ignore extensions * disable parallel make option * fix build for abort, dcc, and epics apps * fix build for dcc, epics, error, and getevent apps. * Fixed building of all apps * fix the ipv4 to ipv6 router app build * Change indent style from Google to Webkit * make pretty to re-format style * removed common Makefile since we already had one and two was too many * remove scripts from root folder that are no longer maintained or used * remove mercurial EOL and ignore files for git repo * remove .vscodeconfig files from repo * tweak clang-format style * clang-format src and apps with tweaked style * added clang-tidy to fix readability if braces in src * result of make tidy for src and apps * fix clang-tidy mangling * Added code::blocks project for BACnet server simulation * added code::blocks linux project for WhoIs app * update text files for EOL * fix EOL in some files * fixed make win32 apps for older gcc * Removed Borland C++ Makefile in apps. Unable to maintain support for Borland C++ compiler. * created codeblocks project for apps/epics for Windows * fixing ports/xplained to work with new data structure. * fix ports/xplained example for Atmel Studio compile * fix ports/stm32f10x example for gcc Makefile compile * fix ports/stm32f10x example for IAR EWARM compile * fix ports/xplained timer callback * fix ports/bdk_atxx_mspt build with subdirs * fix ports/bdk_atxx_mspt build with subdirs * updated git ignore for IAR build artifacts * updated gitignore for non-tracked files and folders * fixed bdk-atxx4-mstp port for Rowley Crossworks project file * fixed bdk-atxx4-mstp port for GCC AVR Makefile * fixed atmega168 port for IAR AVR and GCC AVR Makefile * fixed at91sam7s port for IAR ARM and GCC ARM Makefile * removed unmaintainable DOS, RTOS32, and atmega8 ports. Updated rx62n (untested). * changed arm7 to uip port
49 lines
1.7 KiB
Markdown
49 lines
1.7 KiB
Markdown
# How to configure clang‐format
|
||
|
||
## Overview
|
||
clang-format is an utility to format source code in several languages
|
||
according to predefined settings. Settings for auto-formatting of C source
|
||
files are summarized below, and should be saved in .clang-format file in root
|
||
folder. These settings are chosen to closely match the formatting style used.
|
||
|
||
## Configuring Editors
|
||
### Visual Studio Code
|
||
Install the C/C++ extension and customize settings.json to include:
|
||
|
||
"C_Cpp.clang_format_path": "/path/to/<clang-format-executable>",
|
||
"C_Cpp.clang_format_style": "file",
|
||
"C_Cpp.clang_format_fallbackStyle": "none"
|
||
|
||
### Emacs
|
||
Add the line
|
||
|
||
(load "/path/to/clang-format.el")
|
||
|
||
to `~/.emacs.d/init.el`. Format a source file with `M-x clang-format-region`.
|
||
|
||
### CLion
|
||
* Add the .clang-format file to the root directory as
|
||
explained above. Go to File->Settings->Tools->External Tools
|
||
and click on the plus sign. A window should pop up.
|
||
Choose a name, for example "clang-format"
|
||
* For the Tool settings tab use this configuration:
|
||
- Program: `clang-format` (use the name of your executable here)
|
||
- Parameters: `--style=file -i $FileName$`
|
||
- Working directory: `$FileDir$`
|
||
With your file open, go to `Tools->External tools` and run the config above.
|
||
This calls `clang-format` and does in-place formatting using the style
|
||
defined in the first `.clang-format` file found in a parent directory.
|
||
|
||
### .clang-format file
|
||
|
||
---
|
||
BasedOnStyle: Google
|
||
AllowShortFunctionsOnASingleLine: None
|
||
AllowShortIfStatementsOnASingleLine: false
|
||
AllowShortLoopsOnASingleLine: false
|
||
AlwaysBreakAfterReturnType: None
|
||
BreakBeforeBraces: Linux
|
||
IndentWidth: 4
|
||
SortIncludes: false
|
||
...
|