Changeset 7623a70

Timestamp:

06/02/2023 11:08:19 AM (11 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

12.0, 12.1, kea, ken/TL2024, ken/tuningfonts, lazarus, lxqt, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal

Children:

c407a61

Parents:

7bfd30d

Message:

tracker3: Always install the doc into expected location, ...

and use a more clever way for testing.

File:

• gnome/platform/tracker3.xml (modified) (7 diffs)

gnome/platform/tracker3.xml

@@ -103 +103 @@
     <para role="optional">
       <xref linkend="asciidoc"/>,
-      <xref linkend="gi-docgen"/>,
+<!--  It looks like not used even if docs=true,
+      the pre-built doc is shipped in tarball and will be installed
+      <xref linkend="gi-docgen"/>
+-->
       <xref linkend="graphviz"/>,
       <xref linkend="libsoup"/>,
@@ -121 +124 @@
 
     <para>
+      Fix the location to install the documentation into:
+    </para>
+
+<screen><userinput>mv docs/reference/libtracker-sparql/doc/{Tracker-3.0,tracker-&tracker3-version;} &amp;&amp;
+sed '/docs_name/s/Tracker-3.0/tracker-&tracker3-version;/' \
+    -i docs/reference/libtracker-sparql/meson.build</userinput></screen>
+
+    <para>
       Install <application>Tracker</application> by running the following
       commands:
@@ -128 +139 @@
 cd    build &amp;&amp;
 
-meson setup --prefix=/usr              \
-            --buildtype=debugoptimized \
-            -Ddocs=false               \
-            -Dman=false                \
+meson setup --prefix=/usr       \
+            --buildtype=release \
+            -Dman=false         \
             ..                  &amp;&amp;
 ninja</userinput></screen>
@@ -139 +149 @@
 
 meson setup --prefix=/usr                 \
-            --buildtype=debugoptimized    \
-            -Ddocs=false                  \
+            --buildtype=release           \
             -Dman=false                   \
             -Dsystemd_user_services=false \
@@ -147 +156 @@
 
     <para>
-      To test the results, issue: <command>ninja test</command>. The tests
-      should be run from a graphical session. One test,
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>ninja install</userinput></screen>
+
+    <para>
+      To test the results, issue: <command>meson configure -Ddebug=true
+      &amp;&amp; ninja test</command>.
+      The test suite should be run from a graphical session. One test,
       <filename>tracker: fts / fts</filename>, is known to fail due to an
       incompatiblity with SQLite-3.42.
     </para>
 
-    <para>
-      Now, as the <systemitem class="username">root</systemitem> user:
-    </para>
-
-<screen role="root"><userinput>ninja install</userinput></screen>
-
   </sect2>
 
@@ -165 +175 @@
     <title>Command Explanations</title>
 
-    <!--
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
       href="../../xincludes/meson-buildtype-release.xml"/>
-    -->
-
-    <para>
-      <parameter>--buildtype=debugoptimized</parameter>: In normal packages
-      using the meson build system, it would be appropriate to use a Release
-      mode. The tests require debugging information to be present, so build
-      debugging information while still providing optimizations.
-    </para>
-
-    <para>
-      <parameter>-Ddocs=false</parameter>: This switch prevents the
-      build process from generating API documentation. Omit this switch if you
-      have <xref linkend="gtk-doc" role="nodep"/> installed and wish to
-      generate and install the API documentation.
-    </para>
 
     <para>
@@ -195 +189 @@
       the build process from installing systemd user services since they are
       useless on SysV systems.
+    </para>
+
+    <para>
+      <command>meson configure -Ddebug=true</command>: This command enables
+      some debug checks necessary for the test suite.  We don't want to
+      enable them for the installed Tracker 3 libraries and programs, so
+      we run the test suite after installation.
     </para>