Index: archive/colord.xml
===================================================================
--- archive/colord.xml	(revision 1accff3ccff5fba203a6c94bcaf7415759814d6a)
+++ archive/colord.xml	(revision 1accff3ccff5fba203a6c94bcaf7415759814d6a)
@@ -0,0 +1,346 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY colord-download-http
+           "https://www.freedesktop.org/software/colord/releases/colord-&colord-version;.tar.xz">
+  <!ENTITY colord-download-ftp  " ">
+  <!ENTITY colord-md5sum        "80b106ba18a43c7eeaf2d9a2b8c5725b">
+  <!ENTITY colord-size          "1.2 MB">
+  <!ENTITY colord-buildsize     "37 MB (without tests)">
+  <!ENTITY colord-time          "0.4 SBU (without tests)">
+]>
+
+<sect1 id="colord" xreflabel="Colord-&colord-version;">
+  <?dbhtml filename="colord.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>Colord-&colord-version;</title>
+
+  <indexterm zone="colord">
+    <primary sortas="a-Colord">Colord</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to Colord</title>
+
+    <para>
+      <application>Colord</application> is a system activated daemon that
+      maps devices to color profiles. It is used by
+      <application>GNOME Color Manager</application> for system integration
+      and use when there are no users logged in.
+    </para>
+
+    &lfs81_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>
+          Download (HTTP): <ulink url="&colord-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&colord-download-ftp;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &colord-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &colord-size;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &colord-buildsize;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &colord-time;
+        </para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Colord Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required">
+      <xref linkend="dbus"/>,
+      <xref linkend="glib2"/>,
+      <xref linkend="lcms2"/>, and
+      <xref linkend="sqlite"/>
+    </para>
+
+    <bridgehead renderas="sect4">Required (for the tests)</bridgehead>
+    <para role="required">
+      <xref linkend="valgrind"/>
+    </para>
+
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended">
+      <xref linkend="gobject-introspection"/>,
+      <xref linkend="libgudev"/>,
+      <xref linkend="libgusb"/>,
+      <xref linkend="polkit"/>,<phrase revision="sysv"> and</phrase>
+      <phrase revision="systemd"><xref linkend="systemd"/>, and</phrase>
+      <xref linkend="vala"/>
+    </para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="docbook-utils"/>,
+      <xref linkend="gnome-desktop"/> and
+      <xref linkend="colord-gtk"/> (to build the example tools),
+      <xref linkend="gtk-doc"/>,
+      <xref linkend="libxslt"/>,
+      <xref linkend="sane"/>,
+      <ulink url="http://www.argyllcms.com/">ArgllCMS</ulink>, and
+      <ulink url="http://bash-completion.alioth.debian.org/">Bash Completion</ulink>,
+    </para>
+
+    <para condition="html" role="usernotes">User Notes:
+      <ulink url="&blfs-wiki;/colord"/>
+    </para>
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of Colord</title>
+
+    <para>
+      There should be a dedicated user and group to take control
+      of the <command>colord</command> daemon after it is started.
+      Issue the following commands as the
+      <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>groupadd -g 71 colord &amp;&amp;
+useradd -c "Color Daemon Owner" -d /var/lib/colord -u 71 \
+        -g colord -s /bin/false colord</userinput></screen>
+
+    <para>
+      Install <application>Colord</application> by running the following
+      commands:
+    </para>
+
+<screen revision="sysv"><userinput>./configure --prefix=/usr                \
+            --sysconfdir=/etc            \
+            --localstatedir=/var         \
+            --with-daemon-user=colord    \
+            --enable-vala                \
+            --enable-systemd-login=no    \
+            --disable-argyllcms-sensor   \
+            --disable-bash-completion    \
+            --disable-static             \
+            --with-systemdsystemunitdir=no &amp;&amp;
+make</userinput></screen>
+
+<screen revision="systemd"><userinput>./configure --prefix=/usr                \
+            --sysconfdir=/etc            \
+            --localstatedir=/var         \
+            --with-daemon-user=colord    \
+            --enable-vala                \
+            --disable-argyllcms-sensor   \
+            --disable-bash-completion    \
+            --disable-static &amp;&amp;
+make</userinput></screen>
+
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+    <para>
+      To test the results, issue: <command>make -k check</command>. For unknown
+      reasons, some tests may fail. Note that the system-wide
+      <application>D-Bus</application> daemon must be running or the tests
+      will fail.
+    </para>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para>
+      <parameter>--with-daemon-user=colord</parameter>: This
+      switch is used so the <command>colord</command> daemon
+      will run as an unprivileged user instead of
+      <systemitem class="username">root</systemitem> user.
+    </para>
+
+    <para>
+      <parameter>--enable-vala</parameter>: This switch enables
+      building of the Vala bindings. Remove if you don't
+      have <xref linkend="vala"/> installed.
+    </para>
+
+    <para revision="sysv">
+      <parameter>--enable-systemd-login=no</parameter>: This parameter fixes
+      building without <application>systemd</application>, which is not part
+      of LFS/BLFS. If you use <application>systemd</application>,
+      replace "no" by "yes".
+    </para>
+
+    <para>
+      <parameter>--disable-argyllcms-sensor</parameter>: Disables <ulink
+      url="http://www.argyllcms.com/">ArgllCMS</ulink> sensor driver.
+    </para>
+
+    <para>
+      <parameter>--disable-bash-completion</parameter>: This switch
+      disables <application>Bash Completion</application>
+      support for <application>Colord</application> apps.
+    </para>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/static-libraries.xml"/>
+
+    <para revision="sysv">
+      <parameter>--with-systemdsystemunitdir=no</parameter>: Disables
+      attempting to build with systemd libraries.
+    </para>
+
+    <para>
+      <option>--enable-gtk-doc</option>: Use this switch if
+      <application>GTK-Doc</application> is installed and you wish to build
+      and install the API documentation.
+    </para>
+
+    <para>
+      <option>--disable-gusb</option>: Use this switch if you don't have
+      <application>libgusb</application> installed.
+    </para>
+
+    <para>
+      <option>--disable-udev</option>: Use this switch if you don't have GUdev
+      installed.
+    </para>
+
+    <para>
+      <option>--disable-polkit</option>: Use this switch if you don't have
+      <application>Polkit</application> installed.
+    </para>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>
+          cd-create-profile, cd-fix-profile, cd-iccdump, cd-it8, and colormgr
+        </seg>
+        <seg>
+          libcolord.so, libcolordprivate.so, and libcolorhug.so
+        </seg>
+        <seg>
+          /usr/include/colord-1,
+          /usr/lib/colord-{plugins,sensors},
+          /usr/share/color{,d},
+          /usr/share/gtk-doc/html/colord, and
+          /var/lib/colord
+        </seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="cd-create-profile">
+        <term><command>cd-create-profile</command></term>
+        <listitem>
+          <para>
+            is a Color Manager Profile Creation Tool.
+          </para>
+          <indexterm zone="colord cd-create-profile">
+            <primary sortas="b-cd-create-profile">cd-create-profile</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="cd-fix-profile">
+        <term><command>cd-fix-profile</command></term>
+        <listitem>
+          <para>
+            is a tool used to fix metadata in ICC profiles.
+          </para>
+          <indexterm zone="colord cd-fix-profile">
+            <primary sortas="b-cd-fix-profile">cd-fix-profile</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="cd-iccdump">
+        <term><command>cd-iccdump</command></term>
+        <listitem>
+          <para>
+            dumps the contents of an ICC profile as human readable text.
+          </para>
+          <indexterm zone="colord cd-iccdump">
+            <primary sortas="b-cd-iccdump">cd-iccdump</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="cd-it8">
+        <term><command>cd-it8</command></term>
+        <listitem>
+          <para>
+            is a Color Manager Testing Tool.
+          </para>
+          <indexterm zone="colord cd-it8">
+            <primary sortas="b-cd-it8">cd-it8</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="colormgr">
+        <term><command>colormgr</command></term>
+        <listitem>
+          <para>
+            is a text-mode program that allows you to interact with colord
+            on the command line.
+          </para>
+          <indexterm zone="colord colormgr">
+            <primary sortas="b-colormgr">colormgr</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libcolord">
+        <term><filename class="libraryfile">libcolord.so</filename></term>
+        <listitem>
+          <para>
+            contains the <application>Colord</application> API functions.
+          </para>
+          <indexterm zone="colord libcolord">
+            <primary sortas="c-libcolord">libcolord.so</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>
