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

  <sect1info>
    <othername>$LastChangedBy: randy $</othername>
    <date>$Date: 2013-02-11 13:51:17 -0500 (Mon, 11 Feb 2013) $</date>
  </sect1info>

  <title>Trinity/KDE3 Pre-installation Configuration</title>

  <para>Based on your preference, set TRINITY_PREFIX.</para>

  <para>One option is to put <application>Trinity/KDE3</application> into the
  <filename class='directory'>/usr</filename> hierarchy.  This creates a
  simpler setup but is more difficult to try multiple versions of
  <application>Trinity/KDE3</application>.</para>

<screen><userinput>export TRINITY_PREFIX=/usr</userinput></screen>

  <para>The Trinty developers and BLFS editors recommend installing Trinity in
  the <filename class='directory'>/opt</filename> directory in order to support
  using one version while building another.</para>

<screen><userinput>export TRINITY_PREFIX=/opt/trinity-&trinity-version;</userinput></screen>

  <para>Using this option requires updates to the PATH, PKG_CONFIG_PATH, and
  library search path:</para>

  <itemizedlist>
    <listitem>
    <para>Update PATH</para>
<screen><userinput>export PATH=$TRINITY_PREFIX/bin:$PATH</userinput></screen>
    </listitem>

    <listitem>
    <para>Update PKG_CONFIG_PATH</para>
<screen><userinput>export PKG_CONFIG_PATH=$TRINITY_PREFIX/lib/pkgconfig:$PKG_CONFIG_PATH</userinput></screen>
    </listitem>

    <listitem>
    <para>Update the library search path</para>
<screen><userinput>export LD_LIBRARY_PATH=$TRINITY_PREFIX/lib:$LD_LIBRARY_PATH</userinput></screen>
    </listitem>

  </itemizedlist>

  <para>The instructions for making these changes permanent are in
  <xref linkend='kde-core-config'/>.</para>

  <para>There are two other environment variables that need to be set to build
  <application>Trinity/KDE3</application>. These are needed for all the
  <userinput>cmake</userinput> based packages:</para>

<screen><userinput>export CMAKE_PREFIX_PATH=/opt/qt:$TRINITY_PREFIX         &amp;&amp;

CMAKE_INCLUDE_PATH=/opt/qt/include:/usr/include/dbus-1.0 &amp;&amp;
export CMAKE_INCLUDE_PATH=$CMAKE_INCLUDE_PATH:$TRINITY_PREFIX/include</userinput></screen>

  <para>You should also consider installing the <xref linkend="desktop-file-utils"/>
  package. Though not required, this package will allow you to easily use
  existing <filename>.desktop</filename> files in
  <filename class='directory'>/usr/share/applications</filename> (and any other
  locations identified by <envar>XDG_DATA_DIRS</envar>), and automatically add
  these applications to the menu system.</para>

</sect1>
