>From 9dc1f957095f6cf6ac9605f5f54bd6c996048a89 Mon Sep 17 00:00:00 2001
From: Jakub Hrozek <jhrozek@redhat.com>
Date: Mon, 16 Apr 2012 10:38:05 +0200
Subject: [PATCH] Document sss_tools better

https://fedorahosted.org/sssd/ticket/917
---
 src/man/include/local.xml   |   20 ++++++++++++++++++++
 src/man/po/po4a.cfg         |    1 +
 src/man/sss_groupadd.8.xml  |    2 ++
 src/man/sss_groupdel.8.xml  |    2 ++
 src/man/sss_groupmod.8.xml  |    2 ++
 src/man/sss_groupshow.8.xml |    2 ++
 src/man/sss_useradd.8.xml   |    2 ++
 src/man/sss_userdel.8.xml   |    2 ++
 src/man/sss_usermod.8.xml   |    2 ++
 9 files changed, 35 insertions(+), 0 deletions(-)
 create mode 100644 src/man/include/local.xml

diff --git a/src/man/include/local.xml b/src/man/include/local.xml
new file mode 100644
index 0000000000000000000000000000000000000000..913ed8265dff2b722c8f6c3815902b91c603e0a8
--- /dev/null
+++ b/src/man/include/local.xml
@@ -0,0 +1,20 @@
+<refsect1 id='local'>
+    <title>THE LOCAL DOMAIN</title>
+    <para>
+        In order to function correctly, a domain with
+        <quote>id_provider=local</quote> must be created and the SSSD must
+        be running.
+    </para>
+    <para>
+        The administrator might want to use the SSSD local users instead
+        of traditional UNIX users in cases where the group nesting (see
+        <citerefentry>
+            <refentrytitle>sss_groupadd</refentrytitle>
+            <manvolnum>8</manvolnum>
+        </citerefentry>) is needed. The local users are also useful for
+        testing and development of the SSSD without having to deploy
+        a full remote server. The <command>sss_user*</command> and
+        <command>sss_group*</command> tools use a local LDB storage to
+        store users and groups.
+    </para>
+</refsect1>
diff --git a/src/man/po/po4a.cfg b/src/man/po/po4a.cfg
index 3e5af74213af4040b731a5fcb7b10fc9da4ef925..e0f835d4c3c44315a183d102a613263719a9adf9 100644
--- a/src/man/po/po4a.cfg
+++ b/src/man/po/po4a.cfg
@@ -26,3 +26,4 @@
 [type:docbook] include/param_help.xml $lang:$(builddir)/$lang/include/param_help.xml opt:"-k 0"
 [type:docbook] include/debug_levels.xml $lang:$(builddir)/$lang/include/debug_levels.xml opt:"-k 0"
 [type:docbook] include/experimental.xml $lang:$(builddir)/$lang/include/experimental.xml opt:"-k 0"
+[type:docbook] include/local.xml $lang:$(builddir)/$lang/include/local.xml opt:"-k 0"
diff --git a/src/man/sss_groupadd.8.xml b/src/man/sss_groupadd.8.xml
index 15b7ea5ac26e089c042f583a37a5500852b97afd..16fb99bfea9738b473027256e33a5d7f90fdb9f9 100644
--- a/src/man/sss_groupadd.8.xml
+++ b/src/man/sss_groupadd.8.xml
@@ -54,6 +54,8 @@
         </variablelist>
     </refsect1>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/local.xml" />
+
     <refsect1 id='see_also'>
         <title>SEE ALSO</title>
         <para>
diff --git a/src/man/sss_groupdel.8.xml b/src/man/sss_groupdel.8.xml
index 978fc73688a53616b00493bd3c520ff3a4b1e27a..1003fbf37f5ce6342ddd862dca39eb464730e61c 100644
--- a/src/man/sss_groupdel.8.xml
+++ b/src/man/sss_groupdel.8.xml
@@ -42,6 +42,8 @@
         </variablelist>
     </refsect1>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/local.xml" />
+
     <refsect1 id='see_also'>
         <title>SEE ALSO</title>
         <para>
diff --git a/src/man/sss_groupmod.8.xml b/src/man/sss_groupmod.8.xml
index b2226e2e6596a9d01f6a42d58c1c186943fe83f9..34874e66ebdecd4116e662ce345185d7b6cfc827 100644
--- a/src/man/sss_groupmod.8.xml
+++ b/src/man/sss_groupmod.8.xml
@@ -68,6 +68,8 @@
         </variablelist>
     </refsect1>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/local.xml" />
+
     <refsect1 id='see_also'>
         <title>SEE ALSO</title>
         <para>
diff --git a/src/man/sss_groupshow.8.xml b/src/man/sss_groupshow.8.xml
index cb1046b9cff8430cdf8b13d5b0abc685fb2b738e..bfc6b371f893092654f459aa33aa7852d5463dec 100644
--- a/src/man/sss_groupshow.8.xml
+++ b/src/man/sss_groupshow.8.xml
@@ -54,6 +54,8 @@
         </variablelist>
     </refsect1>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/local.xml" />
+
     <refsect1 id='see_also'>
         <title>SEE ALSO</title>
         <para>
diff --git a/src/man/sss_useradd.8.xml b/src/man/sss_useradd.8.xml
index 70998f8e63898a336680c9623edbe8e08d0ccd22..2520e95e1a8400ee87c31294e30a0825cedc641d 100644
--- a/src/man/sss_useradd.8.xml
+++ b/src/man/sss_useradd.8.xml
@@ -163,6 +163,8 @@
         </variablelist>
     </refsect1>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/local.xml" />
+
     <refsect1 id='see_also'>
         <title>SEE ALSO</title>
         <para>
diff --git a/src/man/sss_userdel.8.xml b/src/man/sss_userdel.8.xml
index b37718c6ca0900a053262f1f9cd2495625c769c3..4ba46d2d1dd7fc7d6e7a4b98016fc3e20aec6065 100644
--- a/src/man/sss_userdel.8.xml
+++ b/src/man/sss_userdel.8.xml
@@ -89,6 +89,8 @@
         </variablelist>
     </refsect1>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/local.xml" />
+
     <refsect1 id='see_also'>
         <title>SEE ALSO</title>
         <para>
diff --git a/src/man/sss_usermod.8.xml b/src/man/sss_usermod.8.xml
index 2b4370856f1f0d48b445d971084c5e0233fa5b13..ff8469be9edc4414c67f3ee1b166b1bdb1ecadff 100644
--- a/src/man/sss_usermod.8.xml
+++ b/src/man/sss_usermod.8.xml
@@ -134,6 +134,8 @@
         </variablelist>
     </refsect1>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/local.xml" />
+
     <refsect1 id='see_also'>
         <title>SEE ALSO</title>
         <para>
-- 
1.7.7.6