Improve documentation
This commit is contained in:
parent
9e52a3ac1f
commit
9137a63462
|
@ -78,6 +78,10 @@ set(CMAKE_MODULE_FILES
|
||||||
cmake/modules/WebViewProviderConfig.cmake
|
cmake/modules/WebViewProviderConfig.cmake
|
||||||
)
|
)
|
||||||
|
|
||||||
|
set(DOC_FILES
|
||||||
|
README.md
|
||||||
|
)
|
||||||
|
|
||||||
# meta data
|
# meta data
|
||||||
set(META_PROJECT_NAME qtutilities)
|
set(META_PROJECT_NAME qtutilities)
|
||||||
set(META_PROJECT_VARNAME QT_UTILITIES)
|
set(META_PROJECT_VARNAME QT_UTILITIES)
|
||||||
|
@ -87,7 +91,7 @@ set(META_APP_URL "https://github.com/${META_APP_AUTHOR}/${META_PROJECT_NAME}")
|
||||||
set(META_APP_DESCRIPTION "Common Qt related C++ classes and routines used by my applications such as dialogs, widgets and models.")
|
set(META_APP_DESCRIPTION "Common Qt related C++ classes and routines used by my applications such as dialogs, widgets and models.")
|
||||||
set(META_VERSION_MAJOR 4)
|
set(META_VERSION_MAJOR 4)
|
||||||
set(META_VERSION_MINOR 0)
|
set(META_VERSION_MINOR 0)
|
||||||
set(META_VERSION_PATCH 0)
|
set(META_VERSION_PATCH 1)
|
||||||
set(META_APP_VERSION ${META_VERSION_MAJOR}.${META_VERSION_MINOR}.${META_VERSION_PATCH})
|
set(META_APP_VERSION ${META_VERSION_MAJOR}.${META_VERSION_MINOR}.${META_VERSION_PATCH})
|
||||||
|
|
||||||
# required to include CMake modules from own project directory
|
# required to include CMake modules from own project directory
|
||||||
|
@ -116,3 +120,4 @@ include(QtGuiConfig)
|
||||||
include(QtConfig)
|
include(QtConfig)
|
||||||
include(WindowsResources)
|
include(WindowsResources)
|
||||||
include(LibraryTarget)
|
include(LibraryTarget)
|
||||||
|
include(Doxygen)
|
||||||
|
|
|
@ -18,6 +18,7 @@ namespace MiscUtils {
|
||||||
/*!
|
/*!
|
||||||
* \brief Constructs a new recent menu manager.
|
* \brief Constructs a new recent menu manager.
|
||||||
* \param menu Specifies the QMenu instance to operate with.
|
* \param menu Specifies the QMenu instance to operate with.
|
||||||
|
* \param parent Specifies the parent QObject; might be nullptr.
|
||||||
* \remarks
|
* \remarks
|
||||||
* - Menu title and icon are set within the constructor.
|
* - Menu title and icon are set within the constructor.
|
||||||
* - The current menu entries are cleared.
|
* - The current menu entries are cleared.
|
||||||
|
|
|
@ -97,7 +97,7 @@ void loadApplicationTranslationFile(const QString &applicationName)
|
||||||
/*!
|
/*!
|
||||||
* \brief Loads and installs the appropriate application translation file for the specified locale.
|
* \brief Loads and installs the appropriate application translation file for the specified locale.
|
||||||
* \param applicationName Specifies the name of the application.
|
* \param applicationName Specifies the name of the application.
|
||||||
* \param localName Specifies the name of the locale.
|
* \param localeName Specifies the name of the locale.
|
||||||
* \remarks Translation files have to be placed in one of the following
|
* \remarks Translation files have to be placed in one of the following
|
||||||
* locations:
|
* locations:
|
||||||
* - ./translations
|
* - ./translations
|
||||||
|
|
|
@ -22,10 +22,9 @@ OptionCategoryModel::OptionCategoryModel(QObject *parent) :
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
* \brief Constructs an option category model with the specified \a categories.
|
* \brief Constructs an option category model with the specified \a categories.
|
||||||
*
|
* \remarks The model takes ownership over the given categories.
|
||||||
* The model takes ownership over the given categories.
|
|
||||||
*/
|
*/
|
||||||
OptionCategoryModel::OptionCategoryModel(const QList<Dialogs::OptionCategory *> &categories, QObject *parent) :
|
OptionCategoryModel::OptionCategoryModel(const QList<OptionCategory *> &categories, QObject *parent) :
|
||||||
QAbstractListModel(parent),
|
QAbstractListModel(parent),
|
||||||
m_categories(categories)
|
m_categories(categories)
|
||||||
{
|
{
|
||||||
|
|
|
@ -84,11 +84,6 @@ bool OptionPage::matches(const QString &searchKeyWord)
|
||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
/*!
|
|
||||||
* \fn OptionPage::displayName()
|
|
||||||
* \brief Returns the display name of the page.
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
* \fn OptionPage::apply()
|
* \fn OptionPage::apply()
|
||||||
* \brief Applies altered settings.
|
* \brief Applies altered settings.
|
||||||
|
|
Loading…
Reference in New Issue