diff options
Diffstat (limited to 'docs/manual/Contributing.Style.md')
-rw-r--r-- | docs/manual/Contributing.Style.md | 58 |
1 files changed, 0 insertions, 58 deletions
diff --git a/docs/manual/Contributing.Style.md b/docs/manual/Contributing.Style.md deleted file mode 100644 index 7f3a052..0000000 --- a/docs/manual/Contributing.Style.md +++ /dev/null @@ -1,58 +0,0 @@ -# Code style - -## Guidelines -* Use generic formats -* Where possible, use QVector over QList: http://lists.qt-project.org/pipermail/development/2017-March -/029040.html - -## Versioning - -- major version: Changed infrequently and almost entirely out of foppery and whim. -- minor version: Milestone of multiple features. -- revision: Major bugfixes and each new feature should get a revision. - -### Branching -* master - main branch, should be kept up-to-date, and have only working code -* next - next stable release preparation, mostly for bugfixes -* development - development branch, anything goes there - -## Qt -* Check pointers with ´´´Q_CHECK_PTR´´´ before returning them -* Avoid using connect SIGNAL and SLOT. Instead use &Class::method. This way, -connects are checked during the compile, not at runtime. - -## clazy -You can use [clazy](https://github.com/KDE/clazy) to check Qt semantics. -Requires clang. - -To set check levels, set the CLAZY_CHECKS environment variable to 'level0,level1', etc. - -### Setting up in QtCreator -The simplest way to set it up is to use _clazy_ instead of _clang_. - -1. Go to Tools » Options » Build & Run » Compilers -2. Clone the clang compiler of your choice -3. Set _Compiler path_ to _/usr/bin/clazy_ - -This will update the qbs profile that QtCreator uses. - -### Reducing clazy noise -If you want to suppress warnings from headers of Qt or 3rd party code, include -them with -isystem instead of -I. To do this, you have to -[modify your Qt profile](clazy-sysincludes) like this: - -Find the profile's search path: -```sh -$ qbs config --list profiles.qt562.preferences -profiles.qt562.preferences.qbsSearchPaths: "/home/someone/.config/QtProject/qbs/1.9.0/profiles/qt562" -``` - -Replace cpp.includePaths with cpp.systemIncludePaths in the Qt modules of that -profile: - -```sh -$ find /home/someone/.config/QtProject/qbs/1.9.0/profiles/qt562/modules/Qt/ -name '*.qbs' | xargs -n1 sed -i s/cpp\.includePaths/cpp.systemIncludePaths/ -``` - -[clazy-sysincludes]: http://lists.qt-project.org/pipermail/qbs/2017-April/001709.html - |