From 8590a9c47d17f34e9e8bd0b6406f0f5b58e954fa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michal=20Mal=C3=A9=C5=99?= <mmaler@redhat.com>
Date: Mon, 18 Sep 2023 11:12:39 +0200
Subject: [PATCH] Trying to escape the badly rendered asciidoc
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Michal Maléř <mmaler@redhat.com>
---
 docs/src/main/asciidoc/logging.adoc | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/docs/src/main/asciidoc/logging.adoc b/docs/src/main/asciidoc/logging.adoc
index 78483f3aa643c..33432c57f7c39 100644
--- a/docs/src/main/asciidoc/logging.adoc
+++ b/docs/src/main/asciidoc/logging.adoc
@@ -241,13 +241,19 @@ All potential properties are listed in the <<loggingConfigurationReference,loggi
 
 === Logging categories
 
-Logging is done on a per-category basis, with each category being configured independently.
-A category configuration recursively applies to all subcategories of that category unless there is a more specific matching sub-category configuration.
+Logging is configured on a per-category basis, with each category being configured independently.
+Configuration for a category applies recursively to all subcategories unless there is a more specific subcategory configuration.
 
-The parent of all logging categories is called the "root category".
-This category, being the ultimate parent, may contain configuration which applies globally to all other categories. This includes the globally configured handlers and formatters.
+The parent of all logging categories is called the "root" category.
+As the ultimate parent, this category might contain a configuration that applies globally to all other categories.
+This includes the globally configured handlers and formatters.
+
+An example of a global configuration that applies for all categories:
+
+* `quarkus.log.console.pass:c,a[*]`
+* `quarkus.log.file.pass:c,a[*]`
+* `quarkus.log.syslog.pass:c,a[*]`
 
-Thus, configurations made under `quarkus.log.console.+*+`, `quarkus.log.file.+*+`, and `quarkus.log.syslog.+*+` are global and apply for all categories.
 For more information, see <<loggingConfigurationReference>>.
 
 If you want to configure something extra for a specific category, create a named handler like `quarkus.log.handler.[console|file|syslog].<your-handler-name>.*` and set it up for that category by using `quarkus.log.category.<my-category>.handlers`.