<?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;
]>

<sect1 id="gnome-config">
  <?dbhtml filename="config.html"?>

  <sect1info>
    <othername>$LastChangedBy: bdubbs $</othername>
    <date>$Date: 2012-05-12 18:30:32 -0400 (Sat, 12 May 2012) $</date>
  </sect1info>

  <title>Configuring the Core GNOME Packages</title>

  <para>Create (or append to) a <filename>~/.xinitrc</filename> file to start
  <application>GNOME</application>:</para>

<screen><userinput>echo "exec gnome-session" &gt;&gt; ~/.xinitrc</userinput></screen>

  <para>If you have <xref linkend="dbus"/> installed, you can start the
  <application>D-BUS</application> session daemon here as well. Starting the
  session daemon here has the added bonus that it will exit when you log out
  of your <application>GNOME</application> session. If you wish to start the
  daemon here, use the following command instead of the one shown above:</para>

<screen><userinput>echo "exec dbus-launch --exit-with-session gnome-session" &gt;&gt; ~/.xinitrc</userinput></screen>

  <note>
    <para>Check the <filename>~/.xinitrc</filename> file and ensure you have
    no other window managers or other <application>X</application> applications
    mentioned before <application>GNOME</application>.</para>
  </note>

  <para>Ensure all libraries can be found by updating the linker's cache (as
  <systemitem class="username">root</systemitem>):</para>

<screen role='root'><userinput>ldconfig</userinput></screen>

  <para>Update the MIME-type application database
  (as <systemitem class="username">root</systemitem>):</para>

<screen role='root'><userinput>update-desktop-database</userinput></screen>

  <para>At this point you can bring up <application>GNOME</application> with
  <command>startx</command>.</para>

</sect1>
