From 4a87d61dbfcaddeafeebe5fd9546c5d9c6bc9ea2 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Mon, 23 Sep 2024 12:04:13 +0300
Subject: [PATCH] yaconf/book.xml: Capitalize the first letter of the sentense
 + tags (#3750)

* Capitalize the first letter of the sentence + tags

* Make INI-conf more readable
---
 reference/yaconf/book.xml | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/reference/yaconf/book.xml b/reference/yaconf/book.xml
index e3d5cdfeb1..95faae6e32 100644
--- a/reference/yaconf/book.xml
+++ b/reference/yaconf/book.xml
@@ -11,7 +11,7 @@
   <para>
    <literal>Yet Another Configurations Container</literal>
    (<acronym>Yaconf</acronym>) is a configurations container,
-   it parses INI files, and store the result
+   it parses <literal>INI</literal> files, and store the result
    in PHP when PHP is started, the result lives with the
    whole PHP lifecycle.
   </para>
@@ -19,12 +19,12 @@
    Yaconf stores all configurations as
    interned string or immutable array, which means they are
    not refcounted-able, thus when you retrieving configurations
-   from yaconf, it could be considered as zero-copy, very fast.
+   from <acronym>Yaconf</acronym>, it could be considered as zero-copy, very fast.
   </para>
   <para>
    Yaconf supports sections and sections
-   inheritance in INI files. if PHP is built as non-ZTS build,
-   Yaconf also supports automatically reloading after INI files
+   inheritance in <literal>INI</literal> files. If PHP is built as non-ZTS build,
+   Yaconf also supports automatically reloading after <literal>INI</literal> files
    are changed.
   </para>
   <para>
@@ -34,17 +34,21 @@
    <title>INI example</title>
    <programlisting role="ini">
 <![CDATA[
-;simple key val
+;Simple key val
 key=val
-;hash
+
+;Hash
 hash.a=val
-;array
+
+;Array
 arr.0=val
 ;or
 arr[]=val
-;use PHP constants
+
+;PHP constant
 version=PHP_VERSION
-;use environment
+
+;Environment variable
 env=${PATH}
 ]]>
    </programlisting>
@@ -59,8 +63,7 @@ hash.a=val
 
 ;SectionB inherits SectionA
 [SectionB:SectionA]
-;override configuration key in SectionA
-key=new_val
+key=new_val                  ;override configuration key in SectionA
 ]]>
    </programlisting>
   </example>