From 9b3f37cb0c70c7b18c49b657e3799094a8711cad Mon Sep 17 00:00:00 2001
From: Jakub Hrozek <jhrozek@redhat.com>
Date: Apr 20 2012 14:55:15 +0000
Subject: Document sss_tools better


https://fedorahosted.org/sssd/ticket/917

---

diff --git a/src/man/include/local.xml b/src/man/include/local.xml
new file mode 100644
index 0000000..913ed82
--- /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 3e5af74..e0f835d 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 15b7ea5..16fb99b 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 978fc73..1003fbf 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 b2226e2..34874e6 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 cb1046b..bfc6b37 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 70998f8..2520e95 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 b37718c..4ba46d2 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 2b43708..ff8469b 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>