From fbb4f560be709e5c6c404c9b1e15693870cd17e7 Mon Sep 17 00:00:00 2001 From: "A. Wilcox" Date: Mon, 21 Sep 2020 16:44:10 -0500 Subject: doc: Formatting fixes for logging spec --- doc/logging.rst | 32 ++++++++++++++++++-------------- 1 file changed, 18 insertions(+), 14 deletions(-) (limited to 'doc/logging.rst') diff --git a/doc/logging.rst b/doc/logging.rst index 8b86608..7280ee7 100644 --- a/doc/logging.rst +++ b/doc/logging.rst @@ -21,10 +21,10 @@ Distributions system. Definition of terms ------------------- -* `NETCONF APK`: The NETCONF for APK Distributions system, including the +* ``NETCONF APK``: The NETCONF for APK Distributions system, including the base server and modules contained in the netconfapk source distribution. -* `stderr`: The standard error output stream as defined by POSIX. +* ``stderr``: The standard error output stream as defined by POSIX. Intended audience @@ -47,16 +47,20 @@ the message. The message's Level indicates the urgency of the message, and may be one of the following six values: Critical, Error, Warning, Notice, Info, and Debug. The message's Message is the text being logged. -The system outputs every message processed to `stderr`, with the +The system outputs every message processed to ``stderr``, with the following format: +:: + : : : : iso-date is defined as an ISO 8601 extended timestamp, of the format: +:: + YYYY-MM-DDThh:mm:ss -`device` is the hostname of the device running the logging system. +``device`` is the hostname of the device running the logging system. @@ -64,12 +68,12 @@ iso-date is defined as an ISO 8601 extended timestamp, of the format: Configuration ============= -The `netconf.conf` YAML configuration file will be read for a scalar -`loglevel` present in the top-level `server` node, which defines the -lowest log level to output. The default, if the `loglevel` scalar is not -set, is `notice`. +The ``netconf.conf`` YAML configuration file will be read for a scalar +``loglevel`` present in the top-level ``server`` node, which defines the +lowest log level to output. The default, if the ``loglevel`` scalar is +not set, is ``notice``. -The `loglevel` node is case-insensitive. +The ``loglevel`` node is case-insensitive. @@ -134,8 +138,8 @@ operational ----------- Messages in this category concern operations carried out. This includes -standard operations such as `edit-config` and also RPCs such as -`system-restart`. +standard operations such as ``edit-config`` and also RPCs such as +``system-restart``. RPC executed ```````````` @@ -183,7 +187,7 @@ reading and writing to any NETCONF datastore. Configuration editing ````````````````````` -This event is triggered just before `edit-config` is executed. +This event is triggered just before ``edit-config`` is executed. :Format: %{user} on session %{sessid} is editing configuration: %{xml} @@ -192,7 +196,7 @@ This event is triggered just before `edit-config` is executed. Configuration edited ```````````````````` -This event is triggered when `edit-config` nodes are being processed by +This event is triggered when ``edit-config`` nodes are being processed by their respective NETCONF modules. :Format: @@ -202,7 +206,7 @@ their respective NETCONF modules. Configuration reading ````````````````````` -This event is triggered just before `get-config` or `get` is executed. +This event is triggered just before ``get-config`` or ``get`` is executed. :Format: %{user} on session %{sessid} is requesting configuration: %{xml} -- cgit v1.2.3-60-g2f50