From c06ca69aa15590889d294775c5baa58617d00094 Mon Sep 17 00:00:00 2001 From: hjk Date: Thu, 14 Apr 2011 11:14:21 +0200 Subject: [PATCH] coding style: prefer 'class' over 'struct' for consistency reasons --- doc/api/coding-style.qdoc | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/api/coding-style.qdoc b/doc/api/coding-style.qdoc index 3703eb3345f..4030790c6f0 100644 --- a/doc/api/coding-style.qdoc +++ b/doc/api/coding-style.qdoc @@ -440,8 +440,15 @@ protected, private. The public section is interesting for every user of the class. The private section is only of interest for the implementors of the class (you). + \o Avoid declaring global objects in the declaration file of the class. If the same variable is used for all objects, use a static member. + + \o Use \c{class} instead of \c{struct}. Some compilers mangle that + difference into the symbol names and spit out warnings if a struct + declaration is followed by a class definition. To avoid ongoing + changes from one to the other we declare \c{class} the prefered way. + \endlist \section3 Declaring Variables