From 021f52d74ec87be51fa62df8efe381326e3ff1f4 Mon Sep 17 00:00:00 2001
From: Daniel Markstedt <daniel@mindani.net>
Date: Tue, 3 Dec 2024 01:14:19 +0100
Subject: [PATCH] docs: More accurate descriptions of optional dependencies in
 Install chapter

---
 doc/ja/manual/install.xml | 17 ++++++++++++-----
 doc/manual/install.xml    | 23 +++++++++++++++--------
 2 files changed, 27 insertions(+), 13 deletions(-)

diff --git a/doc/ja/manual/install.xml b/doc/ja/manual/install.xml
index 4800bd32769..3c7beadf595 100644
--- a/doc/ja/manual/install.xml
+++ b/doc/ja/manual/install.xml
@@ -154,7 +154,7 @@ Resolving deltas: 100% (32227/32227), done.
             Netatalk は、Avahi または mDNSResponder を使用して AFP ファイル共有と Time Machine
             ボリュームをアドバタイズできる。</para>
 
-            <para>Avahi ライブラリ自体は、D-Bus サポートを使用してビルドされている必要がある。</para>
+            <para>Avahi を使用する場合は、D-Bus または D-Bus サポートを有効になっている Avahi ライブラリは必要になる。</para>
           </listitem>
 
           <listitem>
@@ -168,20 +168,27 @@ Resolving deltas: 100% (32227/32227), done.
           </listitem>
 
           <listitem>
-            <para>D-Bus および GLib</para>
+            <para>D-Bus</para>
 
-            <para>afpd にファイル サーバーの使用統計を問い合わせるために
-            <userinput>afpstats</userinput> ツールによって使用される。</para>
+            <para>下記機能を有効にするには、D-Bus が必要である：Spotlight、Avahi を使用した Zeroconf、
+            および <userinput>afpstats</userinput> ツール。</para>
           </listitem>
 
           <listitem>
-            <para>DocBook XSL およびxsltproc</para>
+            <para>DocBook XSL および xsltproc</para>
 
             <para>このマニュアルを含む Netatalk ドキュメントは、XML 形式で作成されている。次に、DocBook XSL
             スタイルシートと xsltproc を使用して、XML を troff (マニュアル ページ用)、html、pdf
             などの人間が読める形式に変換する。</para>
           </listitem>
 
+          <listitem>
+            <para>GLib および GIO</para>
+
+            <para>afpd にファイル サーバーの使用統計を問い合わせるために
+            <userinput>afpstats</userinput> ツールによって使用される。</para>
+          </listitem>
+
           <listitem>
             <para>iconv</para>
 
diff --git a/doc/manual/install.xml b/doc/manual/install.xml
index 44f7f0e66fa..755ed1e22c9 100644
--- a/doc/manual/install.xml
+++ b/doc/manual/install.xml
@@ -164,8 +164,8 @@ Resolving deltas: 100% (32227/32227), done.
             sharing and Time Machine volumes by using Avahi or
             mDNSResponder.</para>
 
-            <para>The Avahi library itself must have been built with D-Bus
-            support.</para>
+            <para>When using Avahi, D-Bus is also required, and the Avahi
+            library must have been built with D-Bus support.</para>
           </listitem>
 
           <listitem>
@@ -181,21 +181,28 @@ Resolving deltas: 100% (32227/32227), done.
           </listitem>
 
           <listitem>
-            <para>D-Bus and GLib</para>
+            <para>D-Bus</para>
 
-            <para>Used by the <userinput>afpstats</userinput> tool to inquire
-            afpd about file server usage statistics.</para>
+            <para>Used to enable multiple features: Spotlight, Zeroconf with
+            Avahi, and the <userinput>afpstats</userinput> tool.</para>
           </listitem>
 
           <listitem>
             <para>DocBook XSL and xsltproc</para>
 
             <para>The Netatalk documentation, including this manual, are
-            authored in XML format. Then we leverage DocBook XSL stylesheets
-            and xsltproc to transcode the XML to other human-readable formats
+            authored in XML format. Then DocBook XSL stylesheets and xsltproc
+            are used to transcode the XML to other human-readable formats
             such as troff (for man pages), html, or pdf.</para>
           </listitem>
 
+          <listitem>
+            <para>GLib and GIO</para>
+
+            <para>Used by the <userinput>afpstats</userinput> tool to inquire
+            afpd about file server usage statistics.</para>
+          </listitem>
+
           <listitem>
             <para>iconv</para>
 
@@ -283,7 +290,7 @@ Resolving deltas: 100% (32227/32227), done.
           </listitem>
 
           <listitem>
-            <para>Perl and UnicodeData.txt</para>
+            <para>UnicodeData.txt</para>
 
             <para>The build system uses Perl and the Unicode Character
             Database to generate Netatalk's Unicode character conversion