[Spice-commits] docs/spice_style.txt

[GitLab Mirror]

 docs/spice_style.txt |    9 +++++++++
 1 file changed, 9 insertions(+)

New commits:
commit 2379fcd6a50dbf39801080c44cb6640702f3e02d
Author: Frediano Ziglio <fziglio at redhat.com>
Date:   Sun Aug 11 14:16:16 2019 +0100

    style: Specify the possibility of "pragma once" usage
    
    Signed-off-by: Frediano Ziglio <fziglio at redhat.com>
    Acked-by: Snir Sheriber <ssheribe at redhat.com>

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
 ----------------