From 2379fcd6a50dbf39801080c44cb6640702f3e02d Mon Sep 17 00:00:00 2001 From: Frediano Ziglio Date: Sun, 11 Aug 2019 14:16:16 +0100 Subject: [PATCH] style: Specify the possibility of "pragma once" usage Signed-off-by: Frediano Ziglio Acked-by: Snir Sheriber --- docs/spice_style.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/spice_style.txt b/docs/spice_style.txt index e4d7fc6d..89a550fb 100644 --- a/docs/spice_style.txt +++ b/docs/spice_style.txt @@ -372,6 +372,15 @@ The macro may include additional information, e.g. a component. For example a fi Historically, some headers added underscores liberally, e.g. MY_MODULE_H_. This is neither necessary nor discouraged, although as a reminder, a leading underscore followed by a capital letter is reserved for the implementation and should not be used, so _MY_MODULE_H is, technically speaking, invalid C. +Alternatively (recommended on newer code) you can use the `pragma once` directive, as: + +[source,c] +---- +#pragma once + +... +---- + Header inclusion ----------------