[Doxygen] \note and \warning

Took 4 minutes

Took 32 seconds
This commit is contained in:
Lukas Brübach 2025-12-05 15:36:11 +01:00
parent 4fe271ab68
commit 2ce254d8bc
2 changed files with 16 additions and 14 deletions

View file

@ -10,13 +10,13 @@
# or set <category> = false to disable logging
#main = true
qt_translator = false
window_main.* = false
release_channel = false
spoiler_background_updater = false
theme_manager = false
sound_engine = false
tapped_out_interface = false
#qt_translator = true
#window_main.* = true
#release_channel = true
#spoiler_background_updater = true
#theme_manager = true
#sound_engine = true
#tapped_out_interface = true
#tab_game = true
#tab_message = true
@ -50,10 +50,10 @@ tapped_out_interface = false
#card_picture_loader.card_back_cache_fail = true
#card_picture_loader.picture_to_load = true
#deck_loader = true
card_database = false
card_database.loading = false
card_database.loading.success_or_failure = true
cockatrice_xml.* = false
#card_database = true
#card_database.loading = true
#card_database.loading.success_or_failure = true
#cockatrice_xml.* = true
#cockatrice_xml.xml_3_parser = true
#cockatrice_xml.xml_4_parser = true
#card_info = true

View file

@ -23,14 +23,16 @@ For more information, see [Logging Setup](#logging-setup).
# Log Level and Categories
The default log level for the application is info.
\note The default log level for the application is info.
This means that you should only use qInfo() in production-level code if you are truly sure that this message is
beneficial to end-users and other developers. As a general rule, if your functionality logs to info more than twice in
response to a user interaction, you are advised to consider moving some of these logs down to the debug level.
Furthermore, you are strongly advised to avoid the use of the generic logging macros (e.g. qDebug(), qInfo(), qWarn()).
You should instead use the corresponding category logging macors (qCDebug(), qCInfo(), qCWarn()) and define logging
\warning You are strongly advised to avoid the use of the generic logging macros (e.g. qDebug(), qInfo(), qWarn()).
\note You should instead use the corresponding category logging macros (qCDebug(), qCInfo(), qCWarn()) and define
logging
categories for your log statements.
Example: