aboutsummaryrefslogtreecommitdiffstats
path: root/docs/checks/README-qt-keywords.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/checks/README-qt-keywords.md')
-rw-r--r--docs/checks/README-qt-keywords.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/checks/README-qt-keywords.md b/docs/checks/README-qt-keywords.md
new file mode 100644
index 00000000..0abca20a
--- /dev/null
+++ b/docs/checks/README-qt-keywords.md
@@ -0,0 +1,12 @@
+# qt-keywords
+
+Warns when using Qt keywords such as emit, slots, signals and foreach.
+
+This check is disabled by default and must be explicitly enabled, as using the
+above Qt keywords is fine unless you're using 3rdparty headers that also define them,
+in which case you'll want to use Q_EMIT, Q_SLOTS, Q_SIGNALS and Q_FOREACH instead.
+
+It's also recommended you don't use the Qt keywords in public headers.
+
+Also consider using `CONFIG += no_keywords` (qmake) or `ADD_DEFINITIONS(-DQT_NO_KEYWORDS)` (CMake)
+instead of using this check.