common/logging: Amend documentation comments
Multi-line doc comments still need the '<' after the ///, otherwise it's treated as a regular comment and makes the original doc comment broken in viewers, IDEs, etc. While we're at it, also fix some typos in the comments.
This commit is contained in:
parent
2949d9552c
commit
6ef84f1c4c
|
@ -12,14 +12,14 @@ namespace Log {
|
||||||
/// Specifies the severity or level of detail of the log message.
|
/// Specifies the severity or level of detail of the log message.
|
||||||
enum class Level : u8 {
|
enum class Level : u8 {
|
||||||
Trace, ///< Extremely detailed and repetitive debugging information that is likely to
|
Trace, ///< Extremely detailed and repetitive debugging information that is likely to
|
||||||
/// pollute logs.
|
///< pollute logs.
|
||||||
Debug, ///< Less detailed debugging information.
|
Debug, ///< Less detailed debugging information.
|
||||||
Info, ///< Status information from important points during execution.
|
Info, ///< Status information from important points during execution.
|
||||||
Warning, ///< Minor or potential problems found during execution of a task.
|
Warning, ///< Minor or potential problems found during execution of a task.
|
||||||
Error, ///< Major problems found during execution of a task that prevent it from being
|
Error, ///< Major problems found during execution of a task that prevent it from being
|
||||||
/// completed.
|
///< completed.
|
||||||
Critical, ///< Major problems during execution that threathen the stability of the entire
|
Critical, ///< Major problems during execution that threaten the stability of the entire
|
||||||
/// application.
|
///< application.
|
||||||
|
|
||||||
Count ///< Total number of logging levels
|
Count ///< Total number of logging levels
|
||||||
};
|
};
|
||||||
|
@ -49,7 +49,7 @@ enum class Class : ClassType {
|
||||||
Kernel, ///< The HLE implementation of the CTR kernel
|
Kernel, ///< The HLE implementation of the CTR kernel
|
||||||
Kernel_SVC, ///< Kernel system calls
|
Kernel_SVC, ///< Kernel system calls
|
||||||
Service, ///< HLE implementation of system services. Each major service
|
Service, ///< HLE implementation of system services. Each major service
|
||||||
/// should have its own subclass.
|
///< should have its own subclass.
|
||||||
Service_ACC, ///< The ACC (Accounts) service
|
Service_ACC, ///< The ACC (Accounts) service
|
||||||
Service_AM, ///< The AM (Applet manager) service
|
Service_AM, ///< The AM (Applet manager) service
|
||||||
Service_AOC, ///< The AOC (AddOn Content) service
|
Service_AOC, ///< The AOC (AddOn Content) service
|
||||||
|
|
|
@ -15,6 +15,6 @@ struct Entry;
|
||||||
std::string FormatLogMessage(const Entry& entry);
|
std::string FormatLogMessage(const Entry& entry);
|
||||||
/// Formats and prints a log entry to stderr.
|
/// Formats and prints a log entry to stderr.
|
||||||
void PrintMessage(const Entry& entry);
|
void PrintMessage(const Entry& entry);
|
||||||
/// Prints the same message as `PrintMessage`, but colored acoording to the severity level.
|
/// Prints the same message as `PrintMessage`, but colored according to the severity level.
|
||||||
void PrintColoredMessage(const Entry& entry);
|
void PrintColoredMessage(const Entry& entry);
|
||||||
} // namespace Log
|
} // namespace Log
|
||||||
|
|
Reference in New Issue