man: link in API FS documentation from the wiki

diff --git a/man/systemd-remount-fs.service.xml b/man/systemd-remount-fs.service.xml
index d920c0c4004b2c7af6772e8b6d6b5f0f0dc7aeab..9fe953e8c674376a1af7380b7c19d82a8d335a01 100644 (file)
--- a/man/systemd-remount-fs.service.xml
+++ b/man/systemd-remount-fs.service.xml
@@ -59,20 +59,26 @@
                 listed in
                 <citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>
                 to the root file system, the <filename>/usr</filename>
-                file system and the kernel API virtual file
-                systems. This is required so that the mount options of
-                these file systems -- which are pre-mounted by the
-                kernel, the initial RAM disk, container environments
-                or system manager code -- are updated to those listed
-                in <filename>/etc/fstab</filename>. This service
-                ignores normal file systems and only changes the root
-                file system (i.e. <filename>/</filename>),
+                file system and the kernel API file systems. This is
+                required so that the mount options of these file
+                systems -- which are pre-mounted by the kernel, the
+                initial RAM disk, container environments or system
+                manager code -- are updated to those listed in
+                <filename>/etc/fstab</filename>. This service ignores
+                normal file systems and only changes the root file
+                system (i.e. <filename>/</filename>),
                 <filename>/usr</filename> and the virtual kernel API
                 file systems such as <filename>/proc</filename>,
                 <filename>/sys</filename> or
                 <filename>/dev/</filename>. This service executes no
                 operation if <filename>/etc/fstab</filename> does not
-                exist or lists no entries for the mentioned file systems.</para>
+                exist or lists no entries for the mentioned file
+                systems.</para>
+
+                <para>For a longer discussion of kernel API file
+                systems see <ulink
+                url="http://www.freedesktop.org/wiki/Software/systemd/APIFileSystems">API
+                File Systems</ulink>.</para>
         </refsect1>
 
         <refsect1>

diff --git a/man/systemd.mount.xml b/man/systemd.mount.xml
index 78b5f5257c3aea88603cd2782dffbf009be8edf2..d1940831a9d6bd14f23442386a66eaf55088f8ee 100644 (file)
--- a/man/systemd.mount.xml
+++ b/man/systemd.mount.xml
@@ -102,10 +102,18 @@
                 in the file system hierarchy, a dependency between both
                 units is created automatically.</para>
 
-                <para>Mount points created at runtime independent on
-                unit files or <filename>/etc/fstab</filename> will be
+                <para>Mount points created at runtime (independently of
+                unit files or <filename>/etc/fstab</filename>) will be
                 monitored by systemd and appear like any other mount
                 unit in systemd.</para>
+
+                <para>Some file systems have special semantics as API
+                file systems for kernel-to-userspace and
+                userspace-to-userpace interfaces. Some of them may not
+                be changed via mount units, and cannot be disabled.
+                For a longer discussion see <ulink
+                url="http://www.freedesktop.org/wiki/Software/systemd/APIFileSystems">API
+                File Systems</ulink>.</para>
         </refsect1>
 
         <refsect1>

diff --git a/units/systemd-remount-fs.service.in b/units/systemd-remount-fs.service.in
index cddb0a1fb93cb8bb2b119468d3857772fb5c52ca..70e1a8680a5e11bd4cdeeb395014bcc22ac122c1 100644 (file)
--- a/units/systemd-remount-fs.service.in
+++ b/units/systemd-remount-fs.service.in
@@ -8,6 +8,7 @@
 [Unit]
 Description=Remount Root and Kernel File Systems
 Documentation=man:systemd-remount-fs.service(8)
+Documentation=http://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
 DefaultDependencies=no
 Conflicts=shutdown.target
 After=systemd-readahead-collect.service systemd-readahead-replay.service systemd-fsck-root.service