| Both sides previous revisionPrevious revision | |
| config:ini_files [2025/12/21 03:25] – [Enumerated Values] Shorten the Info and Debug enum names to their shortest supported form (longer forms are still fine but apparently confusing) digital man | config:ini_files [2025/12/21 03:41] (current) – [Enumerated Values] Fix the confusing wording about enum key value word/partial-word matches digital man |
|---|
| A numeric value higher than the highest supported enumerated value will be treated the same as the highest supported enumerated value. | A numeric value higher than the highest supported enumerated value will be treated the same as the highest supported enumerated value. |
| |
| When a word is provided for the enumerated key value, an exact case-insensitive match is performed search following by a partial-match search, so "Debug" would match the enum value for "Debugging", and "Info" would match the enum value for "Informational". | When a word is provided as an enumerated key value, an initial partial word match is all that is required. So for example, a key value of "Debugging" would match the enum value of ''Debug'', and "Informational" would match the enum value of ''Info''. These string matches are also performed case-insensitively so "ERROR" and "error" are equivalents. |
| |
| === Log Levels === | === Log Levels === |
| ''LogLevel'' keys are one example of a key with enumerated values. The ''LogLevel'' value may be specified as a decimal number (from ''0'' to ''7'') or by specifying one of the following enumerated names: | ''LogLevel'' keys are one example of a key with enumerated values. The ''LogLevel'' value may be specified as a decimal number (from ''0'' to ''7'') or by specifying one of the following enumerated names: |
| |
| ^Value ^Name ^ Description ^ | ^Value ^Name ^ Description ^ |
| |0 |Emergency | Fatal condition | | |0 |''Emergency'' | Fatal condition | |
| |1 |Alert | Very Serious condition | | |1 |''Alert'' | Very Serious condition | |
| |2 |Critical | Serious condition | | |2 |''Critical'' | Serious condition | |
| |3 |Error | Unexpected/erroneous condition | | |3 |''Error'' | Unexpected/erroneous condition | |
| |4 |Warning | Suspicious condition | | |4 |''Warning'' | Suspicious condition | |
| |5 |Notice | Infrequent event | | |5 |''Notice'' | Infrequent event | |
| |6 |Info | Common activity (AKA "Informational") | | |6 |''Info'' | Common activity (AKA "Informational") | |
| |7 |Debug | Extra detail sometimes helpful during issue analysis (AKA "Debugging") | | |7 |''Debug'' | Extra detail sometimes helpful during issue analysis (AKA "Debugging") | |
| |
| Log entries with a log level //higher// than the specified ''LogLevel'' value will not be logged/displayed. | Log entries with a log level //higher// than the specified ''LogLevel'' value will not be logged/displayed. |
