From c5c112ae2927d2d026de16cc4cdfd692bb6e7ab9 Mon Sep 17 00:00:00 2001 From: Evan Travers Date: Sat, 14 Jul 2018 16:49:07 -0500 Subject: [PATCH] Update config.h boilerplate to use `#pragma once` According to @fredizzimo, this is a safer and easier way to handle the boilerplate. --- docs/getting_started_introduction.md | 14 +++----------- 1 file changed, 3 insertions(+), 11 deletions(-) diff --git a/docs/getting_started_introduction.md b/docs/getting_started_introduction.md index 82a1ca19ae..3b6a488ed6 100644 --- a/docs/getting_started_introduction.md +++ b/docs/getting_started_introduction.md @@ -35,15 +35,10 @@ There are 3 possible `config.h` locations: * userspace (`/users//config.h`) * keymap (`/keyboards//keymaps//config.h`) -The build system automatically picks up the config files in the above order. If you wish to override any setting set by a previous `config.h` you will need to first include some boilerplate code around the settings you wish to change. +The build system automatically picks up the config files in the above order. If you wish to override any setting set by a previous `config.h` you will need to first include some boilerplate code for the settings you wish to change. ``` -#ifndef CONFIG_USER_H -#define CONFIG_USER_H - -// overrides go here! - -#endif +#pragma once ``` Then to override a setting from the previous `config.h` file you must `#undef` and then `#define` the setting again. @@ -51,12 +46,9 @@ Then to override a setting from the previous `config.h` file you must `#undef` a The boilerplate code and setting look like this together: ``` -#ifndef CONFIG_USER_H -#define CONFIG_USER_H +#pragma once // overrides go here! #undef MY_SETTING #define MY_SETTING 4 - -#endif ```