From 364c21ec6fa1439b5b831748c5436baf03fc6d36 Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@mengyan1223.wang>
Date: Sun, 6 Mar 2022 13:48:33 +0800
Subject: [PATCH] document -Dman=true failures in tracker and tracker-miners

Upstream fixes available, but they can't be converted to a sed.  And I
don't want to add two patches just for man pages.  So just document them
and wait for a new minor version upgrade of tracker & miners.
---
 gnome/platform/tracker3-miners.xml | 8 ++++++--
 gnome/platform/tracker3.xml        | 8 ++++++--
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/gnome/platform/tracker3-miners.xml b/gnome/platform/tracker3-miners.xml
index b7aca50f76..85d4f851bc 100644
--- a/gnome/platform/tracker3-miners.xml
+++ b/gnome/platform/tracker3-miners.xml
@@ -168,9 +168,13 @@ ninja</userinput></screen>
 
     <para>
       <parameter>-Dman=false</parameter>: This switch prevents the build process
-      from generating man pages. Omit this switch if you have
+      from generating man pages.  Building man pages will break the build
+      with a recent release of <application>Asciidoc</application>.
+      <!-- Restore the following when upgrading to tracker-miners-3.3.x
+           (https://gitlab.gnome.org/GNOME/tracker-miners/-/commit/cb87aa8):
+      Omit this switch if you have
       <xref linkend="asciidoc" role="nodep"/> installed and wish to generate and
-      install the man pages.
+      install the man pages. -->
     </para>
 
     <para revision="sysv">
diff --git a/gnome/platform/tracker3.xml b/gnome/platform/tracker3.xml
index 7a22f642e6..b9313ba351 100644
--- a/gnome/platform/tracker3.xml
+++ b/gnome/platform/tracker3.xml
@@ -171,9 +171,13 @@ ninja</userinput></screen>
 
     <para>
       <parameter>-Dman=false</parameter>: This switch prevents the build
-      process from generating man pages. Omit this switch if you have
+      process from generating man pages.  Building man pages will break the
+	  build with a recent release of <application>Asciidoc</application>.
+      <!-- Restore the following when upgrading to tracker-3.3.x
+           (https://gitlab.gnome.org/GNOME/tracker/-/issues/347)
+      Omit this switch if you have
       <xref linkend="asciidoc" role="nodep"/> installed and wish to generate
-      and install the man pages.
+      and install the man pages. -->
     </para>
 
     <para revision="sysv">