man: xinclude pkg-config note

11 files changed, 40 insertions, 63 deletions

diff --git a/Makefile-man.am b/Makefile-man.am
index 3d43560199..aad3f444da 100644
--- a/Makefile-man.am
+++ b/Makefile-man.am
@@ -1328,6 +1328,7 @@ EXTRA_DIST += \
 	man/kernel-command-line.xml \
 	man/kernel-install.xml \
 	man/less-variables.xml \
+	man/libsystemd-pkgconfig.xml \
 	man/locale.conf.xml \
 	man/localectl.xml \
 	man/localtime.xml \
diff --git a/man/libsystemd-pkgconfig.xml b/man/libsystemd-pkgconfig.xml
new file mode 100644
index 0000000000..56a72e109b
--- /dev/null
+++ b/man/libsystemd-pkgconfig.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+          "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+
+<refsect1>
+  <title>Notes</title>
+
+  <para id='pkgconfig-text'>These APIs are implemented as a shared
+  library, which can be compiled and linked to with the
+  <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+  file.</para>
+</refsect1>
diff --git a/man/sd-daemon.xml b/man/sd-daemon.xml
index 9eef395deb..2b4f3a5598 100644
--- a/man/sd-daemon.xml
+++ b/man/sd-daemon.xml
@@ -21,7 +21,8 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd-daemon">
+<refentry id="sd-daemon"
+        xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
                 <title>sd-daemon</title>
@@ -122,14 +123,7 @@
                 </example>
         </refsect1>
 
-        <refsect1>
-                <title>Notes</title>
-
-                <para>These APIs are implemented as a shared library,
-                which can be compiled and linked to with the
-                <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                file.</para>
-        </refsect1>
+        <xi:include href="libsystemd-pkgconfig.xml" />
 
         <refsect1>
                 <title>See Also</title>
diff --git a/man/sd-id128.xml b/man/sd-id128.xml
index 1d42710855..5a4146a0f9 100644
--- a/man/sd-id128.xml
+++ b/man/sd-id128.xml
@@ -21,7 +21,8 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd-id128">
+<refentry id="sd-id128"
+        xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
                 <title>sd-id128</title>
@@ -152,15 +153,7 @@
                 <option>--new-id</option> option.</para>
         </refsect1>
 
-        <refsect1>
-                <title>Notes</title>
-
-                <para>These APIs are implemented as a shared library,
-                which can be compiled and linked to with the
-                <literal>libsystemd</literal> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                file.</para>
-
-        </refsect1>
+        <xi:include href="libsystemd-pkgconfig.xml" />
 
         <refsect1>
                 <title>See Also</title>
diff --git a/man/sd-journal.xml b/man/sd-journal.xml
index ca7e2f3ef6..7a05aee95f 100644
--- a/man/sd-journal.xml
+++ b/man/sd-journal.xml
@@ -21,7 +21,8 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd-journal">
+<refentry id="sd-journal"
+        xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
                 <title>sd-journal</title>
@@ -95,14 +96,7 @@
                 tool.</para>
         </refsect1>
 
-        <refsect1>
-                <title>Notes</title>
-
-                <para>These APIs are implemented as a shared library,
-                which can be compiled and linked to with the
-                <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                file.</para>
-        </refsect1>
+        <xi:include href="libsystemd-pkgconfig.xml" />
 
         <refsect1>
                 <title>See Also</title>
diff --git a/man/sd-login.xml b/man/sd-login.xml
index a0df90377c..e68f4fd819 100644
--- a/man/sd-login.xml
+++ b/man/sd-login.xml
@@ -21,7 +21,8 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd-login" conditional='HAVE_PAM'>
+<refentry id="sd-login" conditional='HAVE_PAM'
+        xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
                 <title>sd-login</title>
@@ -117,14 +118,7 @@
                 implemented.</para>
         </refsect1>
 
-        <refsect1>
-                <title>Notes</title>
-
-                <para>These APIs are implemented as a shared library,
-                which can be compiled and linked to with the
-                <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                file.</para>
-        </refsect1>
+        <xi:include href="libsystemd-pkgconfig.xml" />
 
         <refsect1>
                 <title>See Also</title>
diff --git a/man/sd_booted.xml b/man/sd_booted.xml
index f699cefb14..28c153a324 100644
--- a/man/sd_booted.xml
+++ b/man/sd_booted.xml
@@ -21,7 +21,8 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd_booted">
+<refentry id="sd_booted"
+        xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
                 <title>sd_booted</title>
@@ -76,17 +77,13 @@
         <refsect1>
                 <title>Notes</title>
 
-                <para>These APIs are implemented as a shared library,
-                which can be compiled and linked to with the
-                <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                file.</para>
+                <xi:include href="libsystemd-pkgconfig.xml" xpointer="pkgconfig-text"/>
 
                 <para>Internally, this function checks whether the
                 directory <filename>/run/systemd/system/</filename>
                 exists. A simple check like this can also be
                 implemented trivially in shell or any other
                 language.</para>
-
         </refsect1>
 
         <refsect1>
diff --git a/man/sd_is_fifo.xml b/man/sd_is_fifo.xml
index 60684bcee4..bb851d1638 100644
--- a/man/sd_is_fifo.xml
+++ b/man/sd_is_fifo.xml
@@ -21,7 +21,8 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd_is_fifo">
+<refentry id="sd_is_fifo"
+        xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
                 <title>sd_is_fifo</title>
@@ -185,10 +186,7 @@
         <refsect1>
                 <title>Notes</title>
 
-                <para>These APIs are implemented as a shared library,
-                which can be compiled and linked to with the
-                <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                file.</para>
+                <xi:include href="libsystemd-pkgconfig.xml" xpointer="pkgconfig-text"/>
 
                 <para>Internally, these function use a combination of
                 <filename>fstat()</filename> and
diff --git a/man/sd_listen_fds.xml b/man/sd_listen_fds.xml
index 88fb77bd22..6999db9804 100644
--- a/man/sd_listen_fds.xml
+++ b/man/sd_listen_fds.xml
@@ -21,7 +21,8 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd_listen_fds">
+<refentry id="sd_listen_fds"
+        xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
                 <title>sd_listen_fds</title>
@@ -121,10 +122,7 @@
         <refsect1>
                 <title>Notes</title>
 
-                <para>These APIs are implemented as a shared library,
-                which can be compiled and linked to with the
-                <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                file.</para>
+                <xi:include href="libsystemd-pkgconfig.xml" xpointer="pkgconfig-text"/>
 
                 <para>Internally, this function checks whether the
                 <varname>$LISTEN_PID</varname> environment variable
diff --git a/man/sd_notify.xml b/man/sd_notify.xml
index 3e530757ce..6bf8230763 100644
--- a/man/sd_notify.xml
+++ b/man/sd_notify.xml
@@ -21,7 +21,8 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd_notify">
+<refentry id="sd_notify"
+        xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
                 <title>sd_notify</title>
@@ -211,10 +212,7 @@
         <refsect1>
                 <title>Notes</title>
 
-                <para>These APIs are implemented as a shared library,
-                which can be compiled and linked to with the
-                <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                file.</para>
+                <xi:include href="libsystemd-pkgconfig.xml" xpointer="pkgconfig-text"/>
 
                 <para>Internally, these functions send a single
                 datagram with the state string as payload to the
diff --git a/man/sd_watchdog_enabled.xml b/man/sd_watchdog_enabled.xml
index 0e4df37506..88d1e5b8de 100644
--- a/man/sd_watchdog_enabled.xml
+++ b/man/sd_watchdog_enabled.xml
@@ -21,7 +21,8 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="sd_watchdog_enabled">
+<refentry id="sd_watchdog_enabled"
+        xmlns:xi="http://www.w3.org/2001/XInclude">
 
         <refentryinfo>
                 <title>sd_watchdog_enabled</title>
@@ -115,10 +116,7 @@
         <refsect1>
                 <title>Notes</title>
 
-                <para>These APIs are implemented as a shared library,
-                which can be compiled and linked to with the
-                <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                file.</para>
+                <xi:include href="libsystemd-pkgconfig.xml" xpointer="pkgconfig-text"/>
 
                 <para>Internally, this functions parses the
                 <varname>$WATCHDOG_PID</varname> and