Add an entity for gi-docgen explanation and use it

This commit is contained in:
Xi Ruoyao 2023-02-14 20:09:55 +08:00
parent a4bf068b52
commit a51e56d5ba
No known key found for this signature in database
GPG Key ID: ACAAD20E19E710E3
4 changed files with 15 additions and 7 deletions

View File

@ -180,3 +180,9 @@ export -f as_root</userinput></screen>
variable or configuration of the package will
fail.</para></note>">
<!ENTITY gi-doc-disable
"Allow building this package without <xref linkend='gi-docgen'/>
installed. If you have <xref linkend='gi-docgen'/> installed and
you wish to rebuild and install the API documentation, a
<command>meson configure</command> command will reset this
option.">

View File

@ -146,13 +146,7 @@ ninja</userinput></screen>
href="../../xincludes/meson-buildtype-release.xml"/>
<para>
<parameter>-Ddocs=false</parameter>: Remove this parameter if
<xref linkend="gi-docgen"/> is installed and you wish to rebuild
and install the API documentation. If this parameter is removed,
as the &root; user, use the <command>mv -v
/usr/share/doc/libportal-{1,&libportal-version;}</command> to fix the
name of the directory containing the API documentation after
installing the package.
<parameter>-Ddocs=false</parameter>: &gi-doc-disable;
</para>
<para>

View File

@ -203,6 +203,10 @@ ninja</userinput></screen>
even if <parameter>-Dgtk_doc=false</parameter> is passed.
</para>
<para>
<parameter>-Dgtk_doc=false</parameter>: &gi-doc-disable;
</para>
<para>
<option>-Dgspell=false</option>: This switch turns off support
for the spell checking plugin.

View File

@ -139,6 +139,10 @@ ninja</userinput></screen>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/meson-buildtype-release.xml"/>
<para>
<parameter>-Dgtk_doc=false</parameter>: &gi-doc-disable;
</para>
<para>
<parameter>-Dexamples=false</parameter>: Remove this option if
<xref linkend="libadwaita1"/> and <xref linkend="gtksourceview5"/> are