Doxygen style

2026-04-30 05:51:23 +08:00 · 2021-09-18 00:51:48 +01:00
parent 57d32da826
commit 312dec792b
66 changed files with 75 additions and 75 deletions
--- a/src/blackgui/components/abouthtmlcomponent.h
+++ b/src/blackgui/components/abouthtmlcomponent.h
@@ -19,7 +19,7 @@
 namespace Ui { class CAboutHtmlComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Display the HTML info "about swift"
     */
    class BLACKGUI_EXPORT CAboutHtmlComponent : public QFrame
--- a/src/blackgui/components/aircraftmodelsetvalidationdialog.h
+++ b/src/blackgui/components/aircraftmodelsetvalidationdialog.h
@@ -28,7 +28,7 @@ namespace BlackMisc
 }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Dialog for CAircraftModelValidationComponent
     * \remark aircraft model view has a simplified version BlackGui::Views::CAircraftModelValidationDialog
     */
--- a/src/blackgui/components/aircraftmodelvalidationcomponent.h
+++ b/src/blackgui/components/aircraftmodelvalidationcomponent.h
@@ -31,7 +31,7 @@ namespace BlackMisc
 }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Handle validation result
     */
    class BLACKGUI_EXPORT CAircraftModelValidationComponent : public COverlayMessagesFrame
--- a/src/blackgui/components/altitudedialog.h
+++ b/src/blackgui/components/altitudedialog.h
@@ -19,7 +19,7 @@
 namespace Ui { class CAltitudeDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Dialog to get a correct altitude
     */
    class CAltitudeDialog : public QDialog
--- a/src/blackgui/components/callsigncompleter.h
+++ b/src/blackgui/components/callsigncompleter.h
@@ -24,7 +24,7 @@
 namespace Ui { class CCallsignCompleter; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Completer for aircraft callsigns
     */
    class BLACKGUI_EXPORT CCallsignCompleter : public QFrame
--- a/src/blackgui/components/configsimulatorcomponent.h
+++ b/src/blackgui/components/configsimulatorcomponent.h
@@ -20,7 +20,7 @@
 namespace Ui { class CConfigSimulatorComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Simulator configuration
     */
    class CConfigSimulatorComponent : public QFrame
@@ -55,7 +55,7 @@ namespace BlackGui::Components
        QScopedPointer<Ui::CConfigSimulatorComponent> ui;
    };

-    /**
+    /*!
     * Wizard page for CConfigSimulatorComponent
     */
    class CConfigSimulatorWizardPage : public QWizardPage
--- a/src/blackgui/components/configurationwizard.h
+++ b/src/blackgui/components/configurationwizard.h
@@ -18,7 +18,7 @@
 namespace Ui { class CConfigurationWizard; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Configure the most important settings
     */
    class BLACKGUI_EXPORT CConfigurationWizard : public QWizard
--- a/src/blackgui/components/copyconfigurationcomponent.h
+++ b/src/blackgui/components/copyconfigurationcomponent.h
@@ -140,7 +140,7 @@ namespace BlackGui::Components
        BlackMisc::CData<BlackCore::Data::TVatsimLastServer> m_lastVatsimServer { this }; //!< recently used VATSIM server
    };

-    /**
+    /*!
     * Wizard page for CCopyConfigurationComponent
     */
    class CCopyConfigurationWizardPage : public QWizardPage
--- a/src/blackgui/components/copymodelsfromotherswiftversionscomponent.h
+++ b/src/blackgui/components/copymodelsfromotherswiftversionscomponent.h
@@ -21,7 +21,7 @@
 namespace Ui { class CCopyModelsFromOtherSwiftVersionsComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Copy models from another swift version
     */
    class CCopyModelsFromOtherSwiftVersionsComponent : public COverlayMessagesFrame
@@ -58,7 +58,7 @@ namespace BlackGui::Components
        BlackMisc::Simulation::Data::CModelSetCaches m_modelSetCaches { false, this };
    };

-    /**
+    /*!
     * Wizard page for CCopyModelsFromOtherSwiftVersionsComponent
     */
    class CCopyModelsFromOtherSwiftVersionsWizardPage : public QWizardPage
--- a/src/blackgui/components/copymodelsfromotherswiftversionsdialog.h
+++ b/src/blackgui/components/copymodelsfromotherswiftversionsdialog.h
@@ -17,7 +17,7 @@
 namespace Ui { class CCopyModelsFromOtherSwiftVersionsDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Copy models from other swift versions as dialog
     */
    class CCopyModelsFromOtherSwiftVersionsDialog : public QDialog
--- a/src/blackgui/components/copysettingsandcachescomponent.h
+++ b/src/blackgui/components/copysettingsandcachescomponent.h
@@ -41,7 +41,7 @@
 namespace Ui { class CCopySettingsAndCachesComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Copy settings and caches
     */
    class CCopySettingsAndCachesComponent : public COverlayMessagesFrame
@@ -140,7 +140,7 @@ namespace BlackGui::Components
        BlackMisc::CData<BlackMisc::Simulation::Data::TLastModel> m_cacheLastAircraftModel { this }; //!< recently used aircraft model
    };

-    /**
+    /*!
     * Wizard page for CCopySettingsAndCaches
     */
    class CCopySettingsAndCachesWizardPage : public QWizardPage
--- a/src/blackgui/components/coresettingsdialog.h
+++ b/src/blackgui/components/coresettingsdialog.h
@@ -18,7 +18,7 @@
 namespace Ui { class CCoreSettingsDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Core / swift pilot client settings as Dialog
     */
    class BLACKGUI_EXPORT CCoreSettingsDialog : public QDialog
--- a/src/blackgui/components/countryselector.h
+++ b/src/blackgui/components/countryselector.h
@@ -18,7 +18,7 @@
 namespace Ui { class CCountrySelector; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * @brief Select a valid country
     */
    class CCountrySelector : public QFrame
--- a/src/blackgui/components/datainfoareacomponent.h
+++ b/src/blackgui/components/datainfoareacomponent.h
@@ -33,7 +33,7 @@ namespace BlackGui::Components
    class CDbModelComponent;
    class CDbAircraftCategoryComponent;

-    /**
+    /*!
     * Info area containing the DB data (models, liveries ...)
     */
    class BLACKGUI_EXPORT CDataInfoAreaComponent :
--- a/src/blackgui/components/datamaininfoareacomponent.h
+++ b/src/blackgui/components/datamaininfoareacomponent.h
@@ -29,7 +29,7 @@ namespace BlackGui::Components
    class CLogComponent;
    class CDataSettingsComponent;

-    /**
+    /*!
     * Main info area for data entry tool
     */
    class BLACKGUI_EXPORT CDataMainInfoAreaComponent :
--- a/src/blackgui/components/datasettingscomponent.h
+++ b/src/blackgui/components/datasettingscomponent.h
@@ -22,7 +22,7 @@ namespace Ui { class CDataSettingsComponent; }
 namespace BlackCore::Db { class CBackgroundDataUpdater; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Settings
     */
    class BLACKGUI_EXPORT CDataSettingsComponent : public COverlayMessagesFrame
--- a/src/blackgui/components/dbaircraftcategorycomponent.h
+++ b/src/blackgui/components/dbaircraftcategorycomponent.h
@@ -22,7 +22,7 @@
 namespace Ui { class CDbAircraftCategoryComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * DB aircraft categories
     */
    class BLACKGUI_EXPORT CDbAircraftCategoryComponent :
--- a/src/blackgui/components/dbaircrafticaocomponent.h
+++ b/src/blackgui/components/dbaircrafticaocomponent.h
@@ -27,7 +27,7 @@ namespace BlackGui
    namespace Views { class CAircraftIcaoCodeView; }
    namespace Components
    {
-        /**
+        /*!
         * DB aircraft ICAO data
         */
        class BLACKGUI_EXPORT CDbAircraftIcaoComponent :
--- a/src/blackgui/components/dbairlineicaocomponent.h
+++ b/src/blackgui/components/dbairlineicaocomponent.h
@@ -27,7 +27,7 @@ namespace BlackGui
    namespace Views { class CAirlineIcaoCodeView; }
    namespace Components
    {
-        /**
+        /*!
         * Airline ICAO code
         */
        class BLACKGUI_EXPORT CDbAirlineIcaoComponent :
--- a/src/blackgui/components/dbautosimulatorstashingcomponent.h
+++ b/src/blackgui/components/dbautosimulatorstashingcomponent.h
@@ -23,7 +23,7 @@
 namespace Ui { class CDbAutoSimulatorStashingComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Allows to automatically update models if found in own model set, but already existing
     * for a sibling simulator (ie. FSX/P3D/FS9)
     */
--- a/src/blackgui/components/dbdistributorcomponent.h
+++ b/src/blackgui/components/dbdistributorcomponent.h
@@ -27,7 +27,7 @@ namespace BlackGui
    namespace Views { class CDistributorView; }
    namespace Components
    {
-        /**
+        /*!
         * Distributors
         */
        class BLACKGUI_EXPORT CDbDistributorComponent :
--- a/src/blackgui/components/dbloaddatadialog.h
+++ b/src/blackgui/components/dbloaddatadialog.h
@@ -23,7 +23,7 @@
 namespace Ui { class CDbLoadDataDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Load data from DB as dialog
     */
    class BLACKGUI_EXPORT CDbLoadDataDialog : public QDialog
--- a/src/blackgui/components/dblogincomponent.h
+++ b/src/blackgui/components/dblogincomponent.h
@@ -25,7 +25,7 @@ namespace BlackMisc::Network { class CAuthenticatedUser; }
 namespace Ui { class CDbLoginComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Login to DB
     * \sa BlackCore::Db::CDatabaseAuthenticationService
     */
--- a/src/blackgui/components/dbmodelcomponent.h
+++ b/src/blackgui/components/dbmodelcomponent.h
@@ -26,7 +26,7 @@
 namespace Ui { class CDbModelComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Database models. Those are the models loaaded from the DB.
     */
    class BLACKGUI_EXPORT CDbModelComponent :
--- a/src/blackgui/components/dbmodelkeycompleter.h
+++ b/src/blackgui/components/dbmodelkeycompleter.h
@@ -17,7 +17,7 @@

 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Completer for model keys
     */
    class CDbModelKeyCompleter : public QLineEdit
--- a/src/blackgui/components/downloadcomponent.h
+++ b/src/blackgui/components/downloadcomponent.h
@@ -25,7 +25,7 @@
 namespace Ui { class CDownloadComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Download a file
     */
    class BLACKGUI_EXPORT CDownloadComponent :
--- a/src/blackgui/components/downloaddialog.h
+++ b/src/blackgui/components/downloaddialog.h
@@ -21,7 +21,7 @@ namespace Ui { class CDownloadDialog; }
 namespace BlackMisc::Network { class CRemoteFile; class CRemoteFileList; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * CDownloadComponent as dialog
     */
    class BLACKGUI_EXPORT CDownloadDialog : public QDialog
--- a/src/blackgui/components/firstmodelsetdialog.h
+++ b/src/blackgui/components/firstmodelsetdialog.h
@@ -17,7 +17,7 @@
 namespace Ui { class CFirstModelSetDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * First model set dialog
     */
    class CFirstModelSetDialog : public QDialog
--- a/src/blackgui/components/initialdataloadcomponent.h
+++ b/src/blackgui/components/initialdataloadcomponent.h
@@ -18,7 +18,7 @@
 namespace Ui { class CInitialDataLoadComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Initial data load to prefill caches
     * \remark Normally used in wizard
     */
@@ -46,7 +46,7 @@ namespace BlackGui::Components
        QScopedPointer<Ui::CInitialDataLoadComponent> ui;
    };

-    /**
+    /*!
    * Wizard page for CInitialDataLoadComponent
    */
    class CInitialDataLoadWizardPage : public QWizardPage
--- a/src/blackgui/components/installsimulatorspecificwizardpage.h
+++ b/src/blackgui/components/installsimulatorspecificwizardpage.h
@@ -19,7 +19,7 @@ namespace BlackGui::Components
    class CInstallXSwiftBusComponent;
    class CInstallFsxTerrainProbeComponent;

-    /**
+    /*!
     * Simulator specific installation
     */
    class CInstallSimulatorSpecificWizardPage : public COverlayMessagesWizardPage
--- a/src/blackgui/components/installxswiftbuscomponent.h
+++ b/src/blackgui/components/installxswiftbuscomponent.h
@@ -26,7 +26,7 @@
 namespace Ui { class CInstallXSwiftBusComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Download and install XSwiftBus
     */
    class CInstallXSwiftBusComponent :
@@ -101,7 +101,7 @@ namespace BlackGui::Components
        void openDownloadDir();
    };

-    /**
+    /*!
     * Wizard page for CInstallXSwiftBusWizardPage
     */
    class CInstallXSwiftBusWizardPage : public QWizardPage
--- a/src/blackgui/components/installxswiftbusdialog.h
+++ b/src/blackgui/components/installxswiftbusdialog.h
@@ -17,7 +17,7 @@
 namespace Ui { class CInstallXSwiftBusDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * CInstallXSwiftBusComponent as dialog
     */
    class CInstallXSwiftBusDialog : public QDialog
--- a/src/blackgui/components/interpolationlogdisplay.h
+++ b/src/blackgui/components/interpolationlogdisplay.h
@@ -30,7 +30,7 @@ namespace Ui { class CInterpolationLogDisplay; }
 namespace BlackCore  { class CAirspaceMonitor; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Display live data of interpolation
     */
    class BLACKGUI_EXPORT CInterpolationLogDisplay :
--- a/src/blackgui/components/interpolationlogdisplaydialog.h
+++ b/src/blackgui/components/interpolationlogdisplaydialog.h
@@ -23,7 +23,7 @@ namespace BlackCore
 namespace Ui { class CInterpolationLogDisplayDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * CInterpolationLogDisplay as dialog
     */
    class BLACKGUI_EXPORT CInterpolationLogDisplayDialog : public QDialog
--- a/src/blackgui/components/legalinfocomponent.h
+++ b/src/blackgui/components/legalinfocomponent.h
@@ -20,7 +20,7 @@
 namespace Ui { class CLegalInfoComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * swift legal information
     */
    class CLegalInfoComponent : public COverlayMessagesFrame
@@ -54,7 +54,7 @@ namespace BlackGui::Components
        BlackMisc::CSetting<BlackCore::Application::TCrashDumpSettings> m_crashDumpSettings { this };
    };

-    /**
+    /*!
     * Wizard page for CLegalInfoComponent
     */
    class CLegalInfoWizardPage : public QWizardPage
--- a/src/blackgui/components/modelconverterxsetupcomponent.h
+++ b/src/blackgui/components/modelconverterxsetupcomponent.h
@@ -17,7 +17,7 @@
 namespace Ui { class CModelConverterXSetupComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
    * Setup to start ModelConverterX
    */
    class CModelConverterXSetupComponent : public QFrame
--- a/src/blackgui/components/otherswiftversionscomponent.h
+++ b/src/blackgui/components/otherswiftversionscomponent.h
@@ -18,7 +18,7 @@
 namespace Ui { class COtherSwiftVersionsComponent; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Overview about other "swift" versions
     */
    class COtherSwiftVersionsComponent : public QFrame
--- a/src/blackgui/components/otherswiftversionsdialog.h
+++ b/src/blackgui/components/otherswiftversionsdialog.h
@@ -17,7 +17,7 @@
 namespace Ui { class COtherSwiftVersionsDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * COtherVersionsComponent as dialog
     */
    class COtherSwiftVersionsDialog : public QDialog
--- a/src/blackgui/components/scalescreenfactor.h
+++ b/src/blackgui/components/scalescreenfactor.h
@@ -18,7 +18,7 @@
 namespace Ui { class CScaleScreenFactor; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * UI to scale screen factor
     */
    class BLACKGUI_EXPORT CScaleScreenFactor : public QFrame
--- a/src/blackgui/components/settingshotkeycomponent.h
+++ b/src/blackgui/components/settingshotkeycomponent.h
@@ -66,7 +66,7 @@ namespace BlackGui::Components
        BlackCore::CActionBind m_action { "/Test/Message", BlackMisc::CIcons::StandardIconWrench16, this, &CSettingsHotkeyComponent::hotkeySlot };
    };

-    /**
+    /*!
     * Wizard page for CConfigSimulatorComponent
     */
    class CConfigHotkeyWizardPage : public QWizardPage
--- a/src/blackgui/components/settingsswiftplugin.h
+++ b/src/blackgui/components/settingsswiftplugin.h
@@ -18,7 +18,7 @@
 namespace Ui { class CSettingsSwiftPlugin; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Settings for the swift pseudo driver
     */
    class BLACKGUI_EXPORT CSettingsSwiftPlugin : public QFrame
--- a/src/blackgui/components/setuploadingdialog.h
+++ b/src/blackgui/components/setuploadingdialog.h
@@ -19,7 +19,7 @@ namespace BlackGui::Components
 {
    class CCopyModelsFromOtherSwiftVersionsDialog;

-    /**
+    /*!
     * Setup dialog, if something goes wrong allows to copy bootstrap file
     */
    class CSetupLoadingDialog : public QDialog
--- a/src/blackgui/components/stringlistdialog.h
+++ b/src/blackgui/components/stringlistdialog.h
@@ -17,7 +17,7 @@
 namespace Ui { class CStringListDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Select from a list of string
     */
    class CStringListDialog : public QDialog
--- a/src/blackgui/components/transpondermodecomponent.h
+++ b/src/blackgui/components/transpondermodecomponent.h
@@ -20,7 +20,7 @@ namespace Ui { class CTransponderModeComponent; }
 namespace BlackMisc { class CIdentifier; namespace Simulation { class CSimulatedAircraft; }}
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Small component to display XPDR mode
     */
    class CTransponderModeComponent : public QFrame, BlackMisc::CIdentifiable
--- a/src/blackgui/components/updateinfocomponent.h
+++ b/src/blackgui/components/updateinfocomponent.h
@@ -25,7 +25,7 @@ namespace BlackGui::Components
    class CInstallXSwiftBusDialog;
    class CDownloadDialog;

-    /**
+    /*!
     * Update info (distributions, artifacts etc.)
     */
    class BLACKGUI_EXPORT CUpdateInfoComponent : public QFrame
--- a/src/blackgui/components/updateinfodialog.h
+++ b/src/blackgui/components/updateinfodialog.h
@@ -18,7 +18,7 @@
 namespace Ui { class CUpdateInfoDialog; }
 namespace BlackGui::Components
 {
-    /**
+    /*!
     * Download and install swift
     */
    class BLACKGUI_EXPORT CUpdateInfoDialog : public QDialog
--- a/src/blackgui/dockwidget.cpp
+++ b/src/blackgui/dockwidget.cpp
@@ -302,7 +302,7 @@ namespace BlackGui
        this->setFrameless(!frameless);
    }

-    /**
+    /*!
    void CDockWidget::toggleFramelessDeferred(int delayMs)
    {
        QPointer<CDockWidget> myself(this);
--- a/src/blackgui/editors/aircraftmodelform.h
+++ b/src/blackgui/editors/aircraftmodelform.h
@@ -19,7 +19,7 @@
 namespace Ui { class CAircraftModelForm; }
 namespace BlackGui::Editors
 {
-    /**
+    /*!
     * Combined form of Livery, ICAOs, distributor
     */
    class CAircraftModelForm : public CForm
--- a/src/blackgui/editors/aircraftpartsform.h
+++ b/src/blackgui/editors/aircraftpartsform.h
@@ -21,7 +21,7 @@ class QWidget;
 namespace Ui { class CAircraftPartsForm; }
 namespace BlackGui::Editors
 {
-    /**
+    /*!
     * Edit and set aircraft parts
     */
    class BLACKGUI_EXPORT CAircraftPartsForm : public CForm
--- a/src/blackgui/editors/coordinateform.h
+++ b/src/blackgui/editors/coordinateform.h
@@ -19,7 +19,7 @@
 namespace Ui { class CCoordinateForm; }
 namespace BlackGui::Editors
 {
-    /**
+    /*!
     * Select / enter a geo position
     */
    class BLACKGUI_EXPORT CCoordinateForm : public CForm
--- a/src/blackgui/editors/situationform.h
+++ b/src/blackgui/editors/situationform.h
@@ -20,7 +20,7 @@
 namespace Ui { class CSituationForm; }
 namespace BlackGui::Editors
 {
-    /**
+    /*!
     * Selector / entry
     */
    class BLACKGUI_EXPORT CSituationForm : public CForm
--- a/src/blackgui/elidedpushbutton.h
+++ b/src/blackgui/elidedpushbutton.h
@@ -15,7 +15,7 @@

 namespace BlackGui
 {
-    /**
+    /*!
     * Push button with elided text
     * \remark based on http://doc.qt.io/qt-5/qtwidgets-widgets-elidedlabel-example.html
     */
--- a/src/blackgui/graphs/barchart.h
+++ b/src/blackgui/graphs/barchart.h
@@ -23,7 +23,7 @@

 namespace BlackGui::Graphs
 {
-    /**
+    /*!
     * For axis labels
     */
    class CTextScaleDraw: public QwtScaleDraw
@@ -45,7 +45,7 @@ namespace BlackGui::Graphs
        QStringList m_labels;
    };

-    /**
+    /*!
     * Bar chart, modified version of QWT examples
     */
    class BLACKGUI_EXPORT CBarChart: public QwtPlot
--- a/src/blackgui/pluginconfig.h
+++ b/src/blackgui/pluginconfig.h
@@ -21,7 +21,7 @@ namespace BlackGui
 {
    class CPluginConfigWindow;

-    /**
+    /*!
     * The interface for the plugin config.
     * The plugin config plugin is always called from the GUI process in order
     * to make it possible to create a config window.
--- a/src/blackgui/pluginconfigwindow.h
+++ b/src/blackgui/pluginconfigwindow.h
@@ -18,7 +18,7 @@ class QShowEvent;

 namespace BlackGui
 {
-    /**
+    /*!
     * Base class for plugin config window.
     */
    class BLACKGUI_EXPORT CPluginConfigWindow : public COverlayMessagesFrame
--- a/src/blackgui/sharedstringlistcompleter.h
+++ b/src/blackgui/sharedstringlistcompleter.h
@@ -56,7 +56,7 @@ namespace BlackGui
        QStringListModel *getCompleterModel() const;
    };

-    /**
+    /*!
     * Utility functions
     */
    class BLACKGUI_EXPORT CompleterUtils
--- a/src/blackgui/singleapplicationui.h
+++ b/src/blackgui/singleapplicationui.h
@@ -17,7 +17,7 @@ class QWidget;

 namespace BlackGui
 {
-    /**
+    /*!
     * Enable / disable UI depending on how many swift applications are running
     */
    class CSingleApplicationUi
--- a/src/blackgui/splashscreen.h
+++ b/src/blackgui/splashscreen.h
@@ -21,7 +21,7 @@

 namespace BlackGui
 {
-    /**
+    /*!
     * Own splash screen
     */
    class CSplashScreen : public QSplashScreen
--- a/src/blackgui/views/aircraftmodelvalidationdialog.h
+++ b/src/blackgui/views/aircraftmodelvalidationdialog.h
@@ -18,7 +18,7 @@
 namespace Ui { class CAircraftModelValidationDialog; }
 namespace BlackGui::Views
 {
-    /**
+    /*!
     * Model validation
     * \remark there is also a more specific validation version BlackGui::Components::CAircraftModelSetValidationDialog
     */