From 9980033377c105d2cd6539c9d73ee61d4c2263b0 Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Thu, 28 Jun 2012 18:58:56 +0200
Subject: [PATCH] man: add various links from man pages to appropriate wiki
 pages

---
 man/systemctl.xml       |  8 ++++++--
 man/systemd-nspawn.xml  |  5 +++++
 man/systemd.preset.xml  |  5 +++++
 man/systemd.service.xml |  7 ++++++-
 man/systemd.special.xml | 21 +++++++--------------
 man/systemd.xml         |  8 ++++++++
 6 files changed, 37 insertions(+), 17 deletions(-)

diff --git a/man/systemctl.xml b/man/systemctl.xml
index 646437a4ca..e3d22a7b5b 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -821,8 +821,12 @@
                                 <command>enable</command>, depending
                                 how the unit is listed in the preset
                                 files. For more information on preset
-                                policy see
-                                <citerefentry><refentrytitle>systemd.preset</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+                                policy format see
+                                <citerefentry><refentrytitle>systemd.preset</refentrytitle><manvolnum>5</manvolnum></citerefentry>. For
+                                more information on the concept of
+                                presets please consult the <ulink
+                                url="http://freedesktop.org/wiki/Software/systemd/Preset">Preset</ulink>
+                                document.</para>
                                 </listitem>
                         </varlistentry>
 
diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml
index 76e291881c..b6f2c278da 100644
--- a/man/systemd-nspawn.xml
+++ b/man/systemd-nspawn.xml
@@ -114,6 +114,11 @@
                 two containers is complete and the containers will
                 share very few runtime objects except for the
                 underlying file system.</para>
+
+                <para><command>systemd-nspawn</command> implements the
+                <ulink
+                url="http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface">Container
+                Interface</ulink> specification.</para>
         </refsect1>
 
         <refsect1>
diff --git a/man/systemd.preset.xml b/man/systemd.preset.xml
index 238cb383e2..a692053876 100644
--- a/man/systemd.preset.xml
+++ b/man/systemd.preset.xml
@@ -72,6 +72,11 @@
                 set of units to be enabled/disabled even before
                 installing the actual package.</para>
 
+                <para>For more information on the preset logic please
+                have a look at the <ulink
+                url="http://freedesktop.org/wiki/Software/systemd/Preset">Presets</ulink>
+                document.</para>
+
                 <para>It is not recommended to ship preset files
                 within the respective software packages implementing
                 the units, but rather centralize them in a
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index c57bce0ecf..69060a53b2 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -95,7 +95,12 @@
                 <filename>.service</filename> suffix removed) and
                 dynamically creates a service unit from that
                 script. This is useful for compatibility with
-                SysV.</para>
+                SysV. Note that this compatibility is quite
+                comprehensive but not 100%. For details about the
+                incomptibilities see the <ulink
+                url="http://www.freedesktop.org/wiki/Software/systemd/Incompatibilities">Incompatibilities
+                with SysV</ulink> document.
+                </para>
         </refsect1>
 
         <refsect1>
diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 396697be9b..6df89d0d2c 100644
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -93,7 +93,6 @@
                 <filename>suspend.target</filename>,
                 <filename>swap.target</filename>,
                 <filename>sysinit.target</filename>,
-                <filename>syslog.service</filename>,
                 <filename>syslog.socket</filename>,
                 <filename>syslog.target</filename>,
                 <filename>system-update.target</filename>,
@@ -730,17 +729,6 @@
                                         or b.</para>
                                 </listitem>
                         </varlistentry>
-                        <varlistentry>
-                                <term><filename>syslog.service</filename></term>
-                                <listitem>
-                                        <para>The syslog service if
-                                        any. Implementations should
-                                        create a symlink from the
-                                        actual syslog implementation
-                                        to this generic name for
-                                        activating it.</para>
-                                </listitem>
-                        </varlistentry>
                         <varlistentry>
                                 <term><filename>syslog.socket</filename></term>
                                 <listitem>
@@ -748,8 +736,13 @@
                                         syslog implementations should
                                         listen on. All userspace log
                                         messages will be made
-                                        available on this
-                                        socket.</para>
+                                        available on this socket. For
+                                        more information about syslog
+                                        integration, please consult
+                                        the <ulink
+                                        url="http://www.freedesktop.org/wiki/Software/systemd/syslog">Syslog
+                                        Interface</ulink>
+                                        document.</para>
                                 </listitem>
                         </varlistentry>
                         <varlistentry>
diff --git a/man/systemd.xml b/man/systemd.xml
index 24b442cb16..9ff6495e50 100644
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -487,6 +487,14 @@
                 command line. For details see the <ulink
                 url="http://www.freedesktop.org/wiki/Software/systemd/Generators">Generators
                 Specification</ulink>.</para>
+
+                <para>Systems which invoke systemd in a container
+                resp. initrd environment should implement the
+                <ulink
+                url="http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface">Container
+                Interface</ulink> resp. <ulink
+                url="http://www.freedesktop.org/wiki/Software/systemd/InitrdInterface">initrd
+                Interface</ulink> specifications.</para>
         </refsect1>
 
         <refsect1>