C++: Automatic Doxygen comment blocks generation

This improves our completion support for documentation
comments. It's now possible to have a Doxygen block
generated when hitting enter after a /** or /*! comment
start. A couple other related options are also available.

Task-number: QTCREATORBUG-2752
Task-number: QTCREATORBUG-3165

Change-Id: I1c81c0b4b370eb1d409ef72a9c7f22c357f202f4
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@nokia.com>
Reviewed-by: Christian Kamm <christian.d.kamm@nokia.com>

1 files changed, 35 insertions, 0 deletions

diff --git a/src/plugins/cpptools/commentssettings.h b/src/plugins/cpptools/commentssettings.h
new file mode 100644
index 0000000000..2e6c140e1b
--- /dev/null
+++ b/src/plugins/cpptools/commentssettings.h
@@ -0,0 +1,35 @@
+#ifndef COMMENTSSETTINGS_H
+#define COMMENTSSETTINGS_H
+
+#include "cpptools_global.h"
+
+QT_BEGIN_NAMESPACE
+class QSettings;
+QT_END_NAMESPACE
+
+namespace CppTools {
+
+class CPPTOOLS_EXPORT CommentsSettings
+{
+public:
+    CommentsSettings();
+
+    void toSettings(const QString &category, QSettings *s) const;
+    void fromSettings(const QString &category, QSettings *s);
+
+    bool equals(const CommentsSettings &other) const;
+
+    bool m_enableDoxygen;
+    bool m_generateBrief;
+    bool m_leadingAsterisks;
+};
+
+inline bool operator==(const CommentsSettings &a, const CommentsSettings &b)
+{ return a.equals(b); }
+
+inline bool operator!=(const CommentsSettings &a, const CommentsSettings &b)
+{ return !(a == b); }
+
+} // namespace CppTools
+
+#endif // COMMENTSSETTINGS_H