Use envvar KDE_PREFIX for kde installation

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2204 af4574ff-66df-0310-9fd7-8a98e5e911e0

1 files changed, 61 insertions, 14 deletions

diff --git a/kde/kde-intro.xml b/kde/kde-intro.xml
index 56f2ffab53..a33cac1e18 100644
--- a/kde/kde-intro.xml
+++ b/kde/kde-intro.xml
@@ -12,19 +12,66 @@ core packages, are needed for the rest of <acronym>KDE</acronym> to work. The se
 presents additional packages which provide functionality in various areas
 (multimedia, graphics etc).</para> 
 
-<para>As the instructions for compiling and installing <acronym>KDE</acronym> were developed,
-the options to <command>configure</command> were examined and the parameters
-presented are the most likely to compile correctly. In each of the packages,
-one other option to <command>configure</command> can be added: 
-<parameter>--enable-final</parameter>. This option can speed up the build 
-process, but requires a lot of memory. If you have less than 256MB of RAM, 
-this option may cause swapping and significantly slow compilation.</para>
-
 <para><acronym>KDE</acronym> also has many internationalization packages in the form of:
 <filename>kde-i18n-xx-&kde-version;.tar.bz2</filename>
 where the xx is a two to five letter code for the country covered. We
 do not cover the installation of these packages here.</para>
 
+<para>There are two alternatives for installing <acronym>KDE</acronym>. Option one, that
+is used by most of the commercial distributions, is to
+install <acronym>KDE</acronym> in the standard system prefix: <filename>/usr</filename>.
+This option allows the use of KDE without the need for any additional configuration such
+as modification of various environment variables or configuration files. Option two is
+to install it in a unique prefix such as <filename>/opt/kde</filename> or
+<filename>/opt/kde-&kde-version;</filename>. This option allows for easy removal of
+the package.</para>
+
+<para>Based on your preference, set <envar>KDE_PREFIX</envar>.</para>
+<para>If <application><acronym>KDE</acronym></application> is your desktop of choice:</para>
+<screen><userinput><command>export KDE_PREFIX=/usr</command></userinput></screen>
+<para>If you want to try-out <application><acronym>KDE</acronym></application>:</para>
+<screen><userinput><command>export KDE_PREFIX=/opt/kde-&kde-version;</command></userinput></screen>
+
+<para>Remember to execute <command>ldconfig</command> after installation of libraries to
+update the library cache.</para>
+
+<para>If you are not installing <acronym>KDE</acronym> in <filename>/usr</filename> you will need to make some
+configuration changes:</para>
+
+<para>Add to your system or personal profile:</para>
+
+<screen><userinput><command>export PATH=$PATH:/opt/kde-&kde-version;/bin
+export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/kde-&kde-version;/lib/pkgconfig</command></userinput></screen>
+
+<para>Add to your <filename>/etc/ld.so.conf</filename>:</para>
+
+<screen><userinput><command>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"</command>
+# Begin kde addition to /etc/ld.so.conf
+
+/opt/kde-&kde-version;/lib
+
+# End kde addition
+<command>EOF</command></userinput></screen>
+
+<para>Add to your <filename>/etc/man.conf</filename>:</para>
+
+<screen><userinput><command>cat &gt;&gt; /etc/man.conf &lt;&lt; "EOF"</command>
+# Begin kde addition to man.conf
+
+MANPATH /opt/kde-&kde-version;/man
+
+# End kde addition to man.conf
+<command>EOF</command></userinput></screen>
+
+<tip>
+<para>If you prefer installing <acronym>KDE</acronym> in <filename>/opt</filename>
+one trick to avoid the above configuration changes is to replace <filename>/opt/kde-&kde-version;</filename>
+with <filename>/opt/kde</filename> and to create a symlink from <filename>/opt/kde-&kde-version;</filename>
+to <filename>/opt/kde</filename>.</para>
+<screen><userinput><command>ln -sf &kde-version; /opt/kde</command></userinput></screen>
+</tip>
+
+<tip>
 <para>All the <acronym>KDE</acronym> packages are comprised of various components. 
 The default is to
 install most of the components. If specific components are to be eliminated, the
@@ -38,12 +85,12 @@ component.</para>
 <para>The core <acronym>KDE</acronym> packages also honor this variable, but omitting components
 from the core packages is not advisable since it may result in an
 incomplete <acronym>KDE</acronym> installation.</para>
+</tip>
 
-<note><para><acronym>KDE</acronym> is a large and complicated set of packages.  In
-some cases, users have found fixes that have not made it into the official KDE
-sources yet.  If you have a problem with a specific application, take a look at
-the patches in <filename>http://www.linuxfromscratch.org/patches/downloads/kde*</filename>.
-The current patches will have the version number, &kde-version;, as a part of their 
-filename.</para></note>
+<note><para>In each of the packages,
+one other option to <command>configure</command> can be added: 
+<parameter>--enable-final</parameter>. This option can speed up the build 
+process, but requires a lot of memory. If you have less than 256MB of RAM, 
+this option may cause swapping and significantly slow compilation.</para></note>
 
 </partintro>