source: gnome/core/pre-install-config.xml@ 91953bc

<?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-pre-install-config">
  <?dbhtml filename="pre-install-config.html"?>

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

  <title>Pre-installation Configuration</title>

<!-- FIXME:ken -->
<note>
<para>The <application>GNOME</application> packages in this book are being
updated to <application>GNOME-3</application>.  At the moment, the instructions
and links for many <application>GNOME</application> packages are probably
broken. Please consult the archives for the BLFS-support mailing list, from
January 24th 2012 onwards, for pointers to the old
<application>GNOME-2</application> book and for where to look when building
<application>GNOME-3</application>.</para>
</note>

  <para>Set an environment variable to resolve the prefix destination.</para>

  <para>If <application>GNOME</application> is your desktop of choice:</para>

<screen><userinput>cat &gt; /etc/profile.d/gnome.sh &lt;&lt; "EOF" &amp;&amp;
<literal>export GNOME_PREFIX=/usr
export GNOME_SYSCONFDIR=&gnome-etc-dir;
export XDG_CONFIG_DIRS=$GNOME_SYSCONFDIR/xdg
export XDG_DATA_DIRS=/usr/share:/usr/local/share</literal>
EOF
. /etc/profile.d/gnome.sh</userinput></screen>


  <para>If you want to try-out <application>GNOME</application>, or install
  it in an easy-to-remove location:</para>

  <note>
    <para>You may wish to create a symbolic link to the actual versioned
    directory using a non-versioned name. This has the advantage of an easier
    path to type in all the changes below and also makes it easy to point
    to a different/newer version of GNOME without changing all the edits
    below. If you wish to use a non-versioned name in the changes below,
    issue the following commands as the
    <systemitem class='username'>root</systemitem> user:</para>

<screen role='root'><userinput>install -v -m755 -d /opt/gnome-&gnome-version;&gnome-minor-version; &amp;&amp;
ln -v -s gnome-&gnome-version;&gnome-minor-version; /opt/gnome</userinput></screen>
  </note>

  <para>If you created the symbolic link, change all instances of <filename
  class='directory'>/opt/gnome-&gnome-version;&gnome-minor-version;</filename>
  to <filename class='directory'>/opt/gnome</filename> in the instructions
  below.</para>

<screen><userinput>export GNOME_PREFIX=/opt/gnome-&gnome-version;&gnome-minor-version;</userinput></screen>

  <para>The try-out group will also need to make all the following
  configuration changes:</para>

  <para>Add to your system or personal profile:</para>

<screen><literal>export PATH=$PATH:/opt/gnome-&gnome-version;&gnome-minor-version;/bin
export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/gnome-&gnome-version;&gnome-minor-version;/lib/pkgconfig
export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/gnome-&gnome-version;&gnome-minor-version;/share/pkgconfig
export GNOME_LIBCONFIG_PATH=/usr/lib:/opt/gnome-&gnome-version;&gnome-minor-version;/lib
export PYTHONPATH=$PYTHONPATH:/opt/gnome-&gnome-version;&gnome-minor-version;/lib/python&python2-majorver;/site-packages</literal></screen>

  <para>Add to your <filename>/etc/ld.so.conf</filename>:</para>

<screen role='root'><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
<literal># Begin gnome addition to /etc/ld.so.conf

/opt/gnome-&gnome-version;&gnome-minor-version;/lib

# End gnome addition</literal>
EOF</userinput></screen>

  <para>Add to your <filename>/etc/man_db.conf</filename>:</para>

<screen role='root'><userinput>cat &gt;&gt; /etc/man_db.conf &lt;&lt; "EOF"
<literal># Begin gnome addition to man_db.conf

MANDATORY_MANPATH /opt/gnome-&gnome-version;&gnome-minor-version;/share/man

# End gnome addition to man_db.conf</literal>
EOF</userinput></screen>

  <tip>
    <para>Remember to execute <command>ldconfig</command> as the
    <systemitem class='username'>root</systemitem> user after installation of
    libraries to update the linker's library cache.</para>
  </tip>

</sect1>