source: gnome/core/dconf.xml@ ae60cb76

<?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 dconf-download-http "&gnome-download-http;/dconf/0.10/dconf-&dconf-version;.tar.xz">
  <!ENTITY dconf-download-ftp  "&gnome-download-ftp;/dconf/0.10/dconf-&dconf-version;.tar.xz">
  <!ENTITY dconf-md5sum        "71894eba6d559fb736a43032929fb98a">
  <!ENTITY dconf-size          "169 KB">
  <!ENTITY dconf-buildsize     "7.4 MB">
  <!ENTITY dconf-time          "0.1 SBU">
]>

<sect1 id="dconf" xreflabel="dconf-&dconf-version;">
  <?dbhtml filename="dconf.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>dconf-&dconf-version;</title>

  <indexterm zone="dconf">
    <primary sortas="a-dconf">dconf</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to dconf</title>

    <para>The <application>dconf</application> package contains a low-level
    configuration system. Its main purpose is to provide a backend to GSettings
    on platforms that don't already have configuration storage systems.</para>

    &lfs70_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&dconf-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&dconf-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &dconf-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &dconf-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &dconf-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &dconf-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">dconf Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="dbus"/>,
    <xref linkend="gtk3"/>,
    <xref linkend="libxml2"/>, and
    <xref linkend="pkgconfig"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="vala"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/dconf"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of dconf</title>

    <para>Install <application>dconf</application> by running the following
    commands:</para>

<screen><userinput>./configure --prefix=$GNOME_PREFIX \
            --sysconfdir=$GNOME_SYSCONFDIR \
            --libexecdir=$GNOME_PREFIX/lib/dconf &amp;&amp;
make</userinput></screen>

    <para>This package does not come with a test suite.</para>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../xincludes/gnome-prefix.xml"/>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../xincludes/gnome-sysconfdir.xml"/>

    <para><parameter>--libexecdir=<envar>$GNOME_PREFIX</envar>/lib/gnome</parameter>:
    This parameter causes the libexec files to be installed in the preferred
    location of <filename
    class="directory"><envar>$GNOME_PREFIX</envar>/lib/gnome</filename> instead
    of <filename
    class="directory"><envar>$GNOME_PREFIX</envar>/libexec</filename>.</para>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../xincludes/gtk-doc-rebuild.xml"/>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>dconf, dconf-bash-completion.sh, dconf-editor, and dconf-service</seg>
        <seg>libdconf-dbus-1.so, libdconf.so, and libdconfsettings.so</seg>
        <seg><envar>$GNOME_SYSCONFDIR</envar>/bash_completion.d,
        <envar>$GNOME_PREFIX</envar>/{include/dconf-dbus-1,lib/dconf,
        share/{applications,dconf-editor,gtk-doc/html/dconf,vala/vapi}}}</seg>
      </seglistitem>
    </segmentedlist>

    <!--<variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="dconf-prog">
        <term><command>dconf-prog</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="dconf dconf-prog">
            <primary sortas="b-dconf-prog">dconf-prog</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="dconf-bash-completion.sh">
        <term><command>dconf-bash-completion.sh</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="dconf dconf-bash-completion.sh">
            <primary sortas="b-dconf-bash-completion.sh">dconf-bash-completion.sh</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="dconf-editor">
        <term><command>dconf-editor</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="dconf dconf-editor">
            <primary sortas="b-dconf-editor">dconf-editor</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="dconf-service">
        <term><command>dconf-service</command></term>
        <listitem>
          <para>does this .....</para>
          <indexterm zone="dconf dconf-service">
            <primary sortas="b-dconf-service">dconf-service</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libdconf-dbus-1">
        <term><filename class='libraryfile'>libdconf-dbus-1.so</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="dconf libdconf-dbus-1">
            <primary sortas="c-libdconf-dbus-1">libdconf-dbus-1.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libdconf">
        <term><filename class='libraryfile'>libdconf.so</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="dconf libdconf">
            <primary sortas="c-libdconf">libdconf.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libdconfsettings">
        <term><filename class='libraryfile'>libdconfsettings.so</filename></term>
        <listitem>
          <para>contains functions that .....</para>
          <indexterm zone="dconf libdconfsettings">
            <primary sortas="c-libdconfsettings">libdconfsettings.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>-->

  </sect2>

</sect1>