<chapter id="installation">
  <!-- **********************************************************************
                               installation.docbook
                            ++++++++++++++++++++++++++
  copyright            : (C) 2000 - 2010
                          Rafi Yanai, Shie Erlich, Frank Schoolmeesters
                          & the Krusader Krew
  e-mail               : krusader@users.sourceforge.net
  web site             : http://www.krusader.org
  description          : a Krusader Documentation File

***************************************************************************
* Permission is granted to copy, distribute and/or modify this            *
* document under the terms of the GNU Free Documentation License,         *
* Version 1.1 or any later version published by the Free Software         *
* Foundation; with no Invariant Sections, no Front-Cover Texts and        *
* no Back-Cover Texts.  A copy of the license is available on the         *
* GNU site http://www.gnu.org/licenses/fdl.html or by writing to:         *
* Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,    *
* MA 02111-1307, USA.                                                     *
*********************************************************************** -->
  <title>Installation of Krusader on KDE4.x</title>
  <indexterm>
    <primary>Installation</primary>
  </indexterm>
  <sect1 id="requirements">
    <title>Requirements</title>
    <para>In order to successfully use the most recent
    &krusader;, you need &kde;libs
    &gt;= 4.x</para>
    <para>Required &kde; version: 
    <itemizedlist>
      <listitem>
        <para>&krusader; v1.01: &kde;
        2</para>
      </listitem>
      <listitem>
        <para>&krusader; v1.02 - 1.40: &kde;
        3.0 - &kde; 3.2</para>
      </listitem>
      <listitem>
        <para>&krusader; 1.40: prefers &kde;
        3.2 (otherwise all features will not be available)</para>
      </listitem>
      <listitem>
        <para>&krusader; v1.50 - v1.51: &kde;
        3.2 - &kde; 3.3 (Konfigurator crash on
        &kde; 3.4)</para>
      </listitem>
      <listitem>
        <para>&krusader; v1.60.0 - v1.70.0:
        &kde; 3.3 - &kde; 3.5</para>
      </listitem>
      <listitem>
        <para>&krusader; 1.70.x: prefers
        &kde; &gt;= 3.4 (otherwise all
        features will not be available)</para>
      </listitem>
      <listitem>
        <para>&krusader; 1.80.0: &kde; 3.4 -
        &kde; 3.5</para>
      </listitem>
      <listitem>
        <para>&krusader; 1.90.0: &kde; 3.2 -
        &kde; 3.5</para>
      </listitem>
      <listitem>
        <para>&krusader; v2.x.x: &kde; 4.x</para>
      </listitem>
    </itemizedlist>
    NOTE: for installation instructions for &krusader;-1.x for &kde; 2 visit 
    the <ulink url="http://www.krusader.org">Krusader website</ulink>.</para>
    <para>Platforms: 
    <itemizedlist>
      <listitem>
        <para>All POSIX
        (&Linux;/BSD/&UNIX;-like OSes),
        &Solaris;</para>
      </listitem>
      <listitem>
        <para>All BSD Platforms
        (<trademark class="copyright">FreeBSD</trademark>/<trademark class="registered">NetBSD</trademark>/<trademark class="registered">OpenBSD</trademark>/&MacOS;)</para>
      </listitem>
         <listitem>
        <para>&Windows; XP and Vista</para>
      </listitem>
    </itemizedlist></para>
    <para>In order to handle archives, checksums and other utilities they must be configured in our
    <link linkend="konfig-dependencies">configuration tool</link>.
    When running &krusader; for the first time the available utilities will be autodetected, and
    a report will be shown in the first lanch wizard. Afterwards additional utilities can be 
    <link linkend="konfig-dependencies">added/removed/changed</link>.</para>
    <para>A package of popular (un)packers, &krusader;
    itself and add-ons can be found on the
    <ulink url="http://www.krusader.org/down.php">&krusader; downloadpage</ulink>.</para>
    <para>For more requirements, see below. Have a look at the
    <link linkend="faq">FAQ</link> section as well.</para>
  </sect1>
  <sect1 id="getting-krusader">
    <title>Obtaining &krusader;</title>
    <para>The latest information about &krusader; can be
    found on the <ulink url="http://www.krusader.org">Krusader website</ulink> .</para>
    <sect2 id="krusader-download">
      <title>&krusader; Downloads</title>
      <para>It is recommended to use the &krusader; package
      that is provided by your distribution.
      <ulink url="http://distrowatch.com/search.php?pkg=krusader">Distrowatch.com</ulink> is a great resource to check
      the availability. If your distribution does not offer
      &krusader;, please contact the creators of your
      distribution and ask them to provide a &krusader;
      package</para>
      <para>The latest version, as well as the older versions, can
      be found on the <ulink url="http://www.krusader.org/down.php">&krusader; downloadpage</ulink> and on the
      <ulink url="http://sourceforge.net/project/showfiles.php?group_id=6488">Sourceforge mirrors</ulink>. It contains the source tarballs,
      RPM and DEB packages to whatever distro the
      &krusader;-Krew is using and packages build by
      &krusader; users and third parties.</para>
      <para>Distributions who provide &krusader;:</para>
      <itemizedlist>
        <listitem>
          <para><ulink url="http://www.novell.com/search/">&SuSE;</ulink></para>
        </listitem>
        <listitem>
          <para><ulink url="https://admin.fedoraproject.org/pkgdb/packages/name/krusader"><trademark>Fedora</trademark></ulink> via
          <command># yum install krusader</command> will do the job,
          thanks to Marcin Garski. &RedHat; RPM packages
          can usually found on the <ulink url="http://www.krusader.org/down.php">&krusader; downloadpage</ulink> or
          at <ulink url="http://dag.wieers.com/packages/krusader/">dag.wieers.com</ulink> and
          <ulink url="http://dries.ulyssis.org/rpm/packages/krusader/info.html">Dries Verachtert RPM Repository</ulink> .</para>
        </listitem>
        <listitem>
          <para><ulink url="http://packages.debian.org/krusader"><trademark class="registered">Debian</trademark></ulink>, on our
          <ulink url="http://www.krusader.org/down.php">&krusader; downloadpage</ulink> you might find more recent
          DEB packages. Note: usually <trademark class="registered">Debian</trademark> packages
          work also on distributions that are "based on
          <trademark class="registered">Debian</trademark>", and some of these provide their own
          (incompatible) packages.
          <ulink url="http://packages.ubuntu.com/krusader"><trademark class="registered">Ubuntu</trademark>/<trademark class="registered">Kubuntu</trademark></ulink>,
          <ulink url="http://www.cnr.com/search.seam?conversationId=230925"><trademark class="registered">Linspire</trademark>/<trademark class="registered">Freespire</trademark></ulink>, <trademark class="registered">Knoppix</trademark>
          4.x DVD, <trademark class="registered">Kanotix</trademark>, etc.</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.mandrivaclub.com/xwiki/bin/view/rpms/Application/krusader"><trademark class="registered">Mandriva</trademark></ulink> via the contrib
          repository 
          <command># urpmi krusader</command> will do the job,
          <ulink url="http://packages.gentoo.org/package/kde-misc/krusader"><trademark class="registered">Gentoo</trademark></ulink>,
          <trademark>Yoper</trademark>.</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.archlinux.org/packages/extra/i686/krusader/"><trademark class="registered">Arch Linux</trademark></ulink>,
          <ulink url="http://frugalware.org/packages.php?id=280"><trademark class="registered">Frugalware Linux</trademark></ulink>,
          <trademark class="registered">PCLinuxOS</trademark>,
          <ulink url="www.altlinux.com/"><trademark class="registered">altlinux</trademark></ulink>.</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.freebsd.org/cgi/ports.cgi?query=krusader&amp;stype=all"><trademark class="copyright">FreeBSD</trademark></ulink>, the port is
          maintained by 
          <link linkend="credits">Heiner Eichmann</link>.</para>
        </listitem>
        <listitem>
          <para><ulink url="http://pkgsrc.se/sysutils/krusader"><trademark class="registered">NetBSD</trademark></ulink>,
          <ulink url="http://www.lunar-linux.org/"><trademark class="registered">Lunar Linux</trademark></ulink>
          ,<trademark class="registered">Ark Linux</trademark>, <trademark>OpenLX</trademark>,
          <trademark class="registered">Source Mage</trademark>,<ulink url="http://packages.ccux-linux.de/index.php?pdetail=6986"><trademark class="registered">CCux Linux</trademark></ulink>,
	  <ulink url="http://www.rocklinux.net/packages/krusader.html"><trademark class="registered">ROCK Linux</trademark></ulink>.</para>
        </listitem>
        <listitem>
          <para>More distributions can be found with
          <ulink url="http://distrowatch.com/search.php?pkg=krusader">Distrowatch.com</ulink>.</para>
        </listitem>
      </itemizedlist>
      <para>Use the installation tools included in your
      distro to install the &krusader; package. You
      might need an internet connection if &krusader; is
      not included on the &CD; or DVD. There are
      probably other distributions which include
      &krusader;. If you know of one, please send
      feedback so that we can include it on the distrolist.</para>
      <para>Others 
      <itemizedlist>
        <listitem>
          <para><trademark class="registered">Slackware</trademark> tgz binaries can usually be
          found on the <ulink url="http://www.krusader.org/down.php">&krusader; downloadpage</ulink>. You can also
          use <ulink url="http://portpkg.berlios.de/">Portpkg</ulink> that contains a
          <ulink url="http://cvs.berlios.de/cgi-bin/viewcvs.cgi/portpkg/ports/kde/krusader/">&krusader; SlackBuild</ulink>, 
          <command># portpkg krusader</command> will do the
          job.</para>
        </listitem>
        <listitem>
          <para>There is a <link linkend="kde4_mac_install">&MacOS;-X port</link>.</para>
        </listitem>
       <listitem>
          <para>There is a <link linkend="kde4_win_install">&Windows; port</link>.</para>
        </listitem>	
      </itemizedlist></para>
            
      <para>Search engines 
      <itemizedlist>
        <listitem>
          <para>You can also find packages on &Linux;
          software archives such as <ulink url="http://freshmeat.net/projects/krusader/">freshmeat.net</ulink> or
          <ulink url="http://www.kde-apps.org/content/show.php?content=10214">KDE-APPS.org</ulink> .</para>
        </listitem>
        <listitem>
          <para>If you can not find a package for your distribution,
          we recommend searching for it with
          <ulink url="http://rpmfind.net/linux/rpm2html/search.php?query=krusader&amp;submit=Search+...">rpmfind</ulink>, <ulink url="http://rpm.pbone.net/index.php3/stat/3/search/krusader">rpmpbone</ulink> or
          <ulink url="http://rpmseek.com/rpm-pl/krusader.html?hl=com&amp;cx=2155:K:0">rpmseek</ulink>.</para>
        </listitem>
      </itemizedlist>If you enjoy using &krusader;, we
      would appreciate it if you went to one of these sites and
      rated it.</para>
      <para>If you still can not find a package, follow the
      installation procedure on how to compile
      &krusader; from source. This very thorough HowTo
      describes the process in such detail that even newcomers
      should not have any problems.</para>
    </sect2>
    <sect2 id="version_scheme">
      <title>Version Scheme</title>
      <para>A new version scheme has been used since
      &krusader;-1.60.0 
      <itemizedlist>
        <listitem>
          <para>First digit - the major version</para>
        </listitem>
        <listitem>
          <para>Second digit(s) - percentage of features completed
          for this major version</para>
        </listitem>
        <listitem>
          <para>Third digit(s) - bugfixes.</para>
        </listitem>
      </itemizedlist>In essence, releasing
      &krusader;-1.60.0 means that we believe that
      &krusader; is about 60% done with all the features
      we had scheduled for the 1.x.x series. Series 2.x.x will be
      &kde; 4.x releases. Hopefully, it is easy to
      understand.</para>
    </sect2>
    <sect2 id="krusader_stable">
      <title>Stable Version</title>
      <para>
        <filename>krusader-x.xx.tar.gz</filename>
      </para>
      <note>
        <para>&krusader; is released under the
        <link linkend="credits">&GNU; General Public License (GPL)</link>. This means that THE PROGRAM IS
        PROVIDED "AS IS" WITH NO WARRANTY OF ANY KIND, even when it
        is marked as a stable release.</para>
      </note>
    </sect2>
    <sect2 id="krusader_devel">
    <title>Development Version (beta release)</title>
    <para>
      <filename>krusader-x.xx-betax.tar.gz</filename>
    </para>
    <para>Before every stable release we release at least one
    development version in order to hunt down the bugs.</para>
    <warning>
      <para>These releases are beta releases and will probably
      contain some bugs.</para>
    </warning><note><para>
                 If you are using a <link linkend="krusader_devel">development</link> or
                 <link linkend="krusader_git">Git</link> version, it is possible that the latest
                 new features are not yet in the "The Krusader Handbook".
                 Please read the 
		 <ulink url="https://projects.kde.org/projects/extragear/utils/krusader/repository/revisions/master/entry/ChangeLog">Changelog</ulink>
		 file online or in the &krusader;
                 sources to find out more about the new features.
                 For a brief description, please read the 
		 <ulink url="https://projects.kde.org/projects/extragear/utils/krusader/repository/revisions/master/entry/SVNNEWS">SVNNEWS</ulink>
		 file online
                 or in the &krusader; sources.
                       <link linkend="faqg_wish">User feedback</link> and
                       <link linkend="faqg_bug_report">Bug reports</link> are always welcome!
                 </para></note> 
    <para>The beta release has 3 goals: 
    <itemizedlist>
      <listitem>
        <para>Apply a feature-freeze until the stable is released,
        only bugs will be fixed. New features have to wait until
        the stable is released.</para>
      </listitem>
      <listitem>
        <para>Obtain feedback from &krusader; users so
        that we can fix the bugs.</para>
      </listitem>
      <listitem>
        <para>Give translators time to update the translations for
        the coming stable release.</para>
      </listitem>
    </itemizedlist></para></sect2>

<!-- OUTDATED CVS is DEACTIVATED 
    <sect2 id="krusader_cvs">
      <title>CVS Builds</title>
      <para>
        <filename>krusader-cvs-yyyymmdd.tar.gz</filename>
      </para>
      <warning>
        <para>These builds are untested and come without any
        warranty. They may contain bugfixes, new features, or even
        new bugs.</para>
      </warning>
      <para>We provide daily snapshots of &krusader;'s
      CVS version. For those who are interested, the 
      <emphasis role="bold">nightly tarball</emphasis> can be found
      on the <ulink url="http://www.krusader.org/cvs.php">&krusader;&apos;s Cutting Edge page</ulink>. Depending on the stage of
      development, this version will either be stable or unstable.
      Just before a stable release, the CVS version is almost
      stable. After a stable release new features will be committed
      into CVS, which might lead to the appearance of bugs. In some
      rare cases, the build will not even compile if we make a
      mistake. In that case we try to fix the error as soon as
      possible.</para>
      <para>&krusader; provides 2 nightly snapshots: 
      <orderedlist numeration="arabic">
        <listitem>
          <para>
          <filename>krusader-cvs-yyyymmdd.tar.gz</filename>: 
          <command>make -f Makefile.cvs</command> must be run before
          the 
          <command>./configure</command> script is available.</para>
        </listitem>
        <listitem>
          <para>
          <filename>krusader-cvs2-yyyymmdd.tar.gz</filename>: for
          users who have problems with the 
          <command>make -f Makefile.cvs</command> command, we have
          already done this for you and the 
          <command>./configure</command> script is included in the
          tarball. This tarball is a bit bigger than the first
          one.</para>
        </listitem>
      </orderedlist></para>
      <para>
      <emphasis role="bold">check out from CVS</emphasis>.
      &krusader; can be checked out through anonymous
      (pserver) CVS with the following instruction set. The module
      you wish to check out must be specified as the module name.
      When prompted for a password for anonymous, press the
      &Enter; key.</para>
      <para>Currently, there are two module options: 
      <itemizedlist>
        <listitem>
          <para>krusader_kde2: the &kde;2 branch, stable
          but it is basically v1.01 and there are no planned
          changes</para>
        </listitem>
        <listitem>
          <para>krusader_kde3: the &kde;3 branch that we
          currently use</para>
        </listitem>
      </itemizedlist></para>
      <para>To check out &krusader; from CVS: 
      <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader login</option></userinput></screen>
      <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader co krusader_kde3</option></userinput></screen>
      (note: updates from within the modules directory do
      not need the -d parameter)</para>
      <para>If you want to check out a specific version of
      &krusader; from CVS (&eg;
      &krusader;-1.60.0) : 
      <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader co -rversion_1_60_0 krusader_kde3</option></userinput></screen>
      </para>
      <para>If you want to check out a specific date of
      &krusader; from CVS (&eg;
      &krusader;-2006-10-29) : 
      <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader co -D2006-10-29 krusader_kde3</option></userinput></screen>
      </para>
      <para>Mostly being <trademark class="registered">Gentoo</trademark> users, we provide a
      <ulink url="http://www.krusader.org/cvs.php"><trademark class="registered">Gentoo</trademark> Live Ebuild</ulink> for all those who want to
      stay on the bleeding edge of file management and do not want
      to miss the advantages of portage. Please take a look at our
      <ulink url="http://www.krusader.org/cvs.php">&krusader;&apos;s Cutting Edge page</ulink> for more installation
      details.</para>
      <para>We also provide &viewcvs-url; to browse the
      CVS repository.</para>
    </sect2>

-->


    <sect2 id="krusader_git">
      <title>Git</title>
      
     <para><ulink url="https://projects.kde.org/projects/extragear/utils/krusader/repository/revisions/master/show">Git</ulink> is used for our sourcecode repository.
      It is also possible to <ulink url="https://projects.kde.org/projects/extragear/utils/krusader/repository/revisions/master/show">Browse the Git Repository</ulink>.</para>
<!-- Outdated information
      <para>Currently, there are four module options: 
      <itemizedlist>
        <listitem>
          <para>krusader_kde2: the &kde;2 branch, stable
          but it is basically v1.01 and there are no planned
          changes</para>
        </listitem>
        <listitem>
          <para>krusader_kde3: the &kde;3 branch, stable
          but it is basically v1.90.0 and there are no planned
          changes</para>
        </listitem>
        <listitem>
          <para>krusader_kde4: the &kde;4 branch that we
          currently use</para>
        </listitem>
        <listitem>
          <para>trunk: the &kde;4 the development version</para>
        </listitem>
      </itemizedlist></para>


      <para>
 
      To check out the latest &krusader; 1.x for
      &kde; 3 from SVN:
      <screen><prompt>$</prompt> <userinput><command>svn</command> <option>co https://krusader.svn.sourceforge.net/svnroot/krusader/branches/krusader_kde3/</option></userinput></screen>

      To check out the latest &krusader; 2.x for
      &kde; 4 from SVN:
      <screen><prompt>$</prompt> <userinput><command>svn</command> <option>co https://krusader.svn.sourceforge.net/svnroot/krusader/branches/krusader_kde4/</option></userinput></screen>
-->

      <para>To check out the latest development &krusader; 2.x
      for &kde; 4 from Git:
      <screen><prompt>$</prompt> <userinput><command>git</command> <option>clone git://anongit.kde.org/krusader</option></userinput></screen>
      </para>
    </sect2>
    <sect2 id="krusader_old">
      <title>Older Releases</title>
      <para>If you are looking for older releases we recommend the
      <ulink url="http://sourceforge.net/project/showfiles.php?group_id=6488">Sourceforge mirrors</ulink>, available from our project
      page.</para>
    </sect2>
  </sect1>

<!-- <chapter id="krusader_kde4_install">
<title>Installation on KDE4.x</title> -->

<sect1 id="compilation">
   <title>Krusader installation instructions on KDE4.x</title>
      <note>
       <para>Please read the 
       <ulink url="https://projects.kde.org/projects/extragear/utils/krusader/repository/revisions/master/entry/INSTALL"><filename>INSTALL</filename></ulink> 
        file of the Krusader sources, it contains all latest installation instructions.</para>
      </note>

      <note>
        <para>From version &krusader;-2.0.0 and higher is &kde;-4 only.</para>
      </note>
 
<para><filename>krusader_kde4.tar.gz</filename> is the supposed name of the krusader tarball (it will be probably a different one ;)</para>

<para>You can download the latest available &krusader;-2.x <link linkend="krusader_git">from Git</link>.</para>


<sect2>
<title>Krusader dependencies</title>
<para>The next packages are needed to run the Krusader binary.</para>
<para>
    <itemizedlist>
      <listitem>
        <para>c libraries</para>
      </listitem>
      <listitem>
        <para>kdelibs5 (KDE4 core libraries and binaries for all KDE4 applications)</para>
      </listitem>
<!--      <listitem>
        <para>libkjsembed1  (Embedded JavaScript library)
              (for the optional Javascripting function in Krusader)</para>
	    </listitem>  disabled due to KrJS does not compile (cannot find kjsembed from kdelibs -->
    </itemizedlist>
</para>
</sect2>

<sect2>
<title>Suggested packages</title>
<para>These packages are optional but they will make Krusader much more powerful and useful.</para>

<para>The next packages are the names that Debian/Ubuntu uses, other Linux
distros will probably use similar names.</para>
<para>
    <itemizedlist>
      <listitem>
        <para>arj: archiver for .arj files </para>
      </listitem>
      <listitem>
        <para>ark: graphical archiving tool for KDE</para>
      </listitem>
      <listitem>
        <para>bzip2: high-quality block-sorting file compressor - utilities</para>
      </listitem>
      <listitem>
        <para>cpio: GNU cpio -- a program to manage archives of files</para>
      </listitem>
      <listitem>
        <para>kdebase-bin: core binaries for the KDE base module</para>
      </listitem>
      <listitem>
        <para>kdebase-bin: core binaries for the KDE base module</para>
      </listitem>
      <listitem>
        <para>kdiff3: compares and merges 2 or 3 files or directories</para>
      </listitem>
      <listitem>
        <para>OR kompare: a KDE GUI for viewing differences between files</para>
      </listitem>
      <listitem>
        <para>OR xxdiff: a graphical file and directories comparison and merge tool</para>
      </listitem>
      <listitem>
        <para>kmail: KDE Email client</para>
      </listitem>
      <listitem>
        <para>okteta: KDE hex editor</para>
      </listitem>
      <listitem>
        <para>konsole: X terminal emulator for KDE </para>
      </listitem>
      <listitem>
        <para>krename: Powerful batch renamer for KDE</para>
      </listitem>
      <listitem>
        <para>lha: lzh archiver</para>
      </listitem>
      <listitem>
        <para>md5deep: versatile file checksum creator and verifier</para>
      </listitem>
      <listitem>
        <para>cfv: versatile file checksum creator and verifier</para>
      </listitem>
      <listitem>
        <para>p7zip: 7zr file archiver with high compression ratio</para>
      </listitem>
      <listitem>
        <para>rpm: Red Hat package manager</para>
      </listitem>
      <listitem>
        <para>unace: extract, test and view .ace archives</para>
      </listitem>
      <listitem>
        <para>unrar: Unarchiver for .rar files (non-free version)</para>
      </listitem>
      <listitem>
        <para>OR unrar-free: Unarchiver for .rar files</para>
      </listitem>
      <listitem>
        <para>OR rar: Archiver for .rar files</para>
      </listitem>
      <listitem>
        <para>unzip: De-archiver for .zip files</para>
      </listitem>
      <listitem>
        <para>zip: Archiver for .zip files</para>
      </listitem>
    </itemizedlist>
</para>
</sect2>


<sect2>
<title>Compilation requirements</title>
<para>The next packages are needed for compiling Krusader,
if you only run a Krusader binary you do not need these packages.</para>
<para>
    <itemizedlist>
      <listitem>
        <para>gcc (The GNU C compiler)</para>
      </listitem>
      <listitem>
        <para>g++ (The GNU C++ compiler)</para>
      </listitem>
      <listitem>
        <para>cmake (A cross-platform, open-source make system)</para>
      </listitem>
      <listitem>
        <para>zlib1g-dev: (library for implementing the deflate compression method found in gzip and PKZIP)</para>
      </listitem>
      <listitem>
        <para>gettext (contains msgfmt)</para>
      </listitem>
      <listitem>
        <para>kdelibs5-dev (installs many development libraries for KDE4)</para>
      </listitem>
      <listitem>
        <para>libphonon-dev (libphonon-dev cross-platform multimedia framework development)</para>
      </listitem>
    </itemizedlist>
</para>
</sect2>



</sect1>

<sect1 id="kde4_lin_install">
   <title>Installing on &Linux; and &BSD; platforms</title>

      <note>
       <para>Please read the 
       <ulink url="https://projects.kde.org/projects/extragear/utils/krusader/repository/revisions/master/entry/INSTALL"><filename>INSTALL</filename></ulink> 
        file of the Krusader sources, it contains all latest installation instructions.</para>
      </note>


<para><command>-DQT_INCLUDES=/usr/share/qt4/include</command> is the location of the &Qt;4 includes</para>

<para><command>-DCMAKE_INSTALL_PREFIX=/usr/</command> is the location where Krusader will be 
      installed with the make command.</para>
 
<para>An other example is: <command>-DCMAKE_INSTALL_PRFIX=/opt/krusader</command>
      to install the compiled Krusader in an other directory to not overwrite
      the Krusader version installed by your package manager.</para>

<para>
    <screen>
      <prompt>$</prompt> <userinput><command>tar -xzvf</command> <option>krusader_kde4.tar.gz</option></userinput>
      <prompt>$</prompt> <userinput><command>cd</command> <option>krusader_kde4</option></userinput>
      <prompt>$</prompt> <userinput><command>cmake</command> <option>-DCMAKE_INSTALL_PREFIX=/usr/ -DQT_INCLUDES=/usr/share/qt4/include</option></userinput>
      <prompt>$</prompt> <userinput><command>make</command></userinput>
      <prompt>$</prompt> <userinput><command>sudo</command> <option>make install</option></userinput>
     </screen>
</para>

<para>Uninstall</para>
<para>
    <screen>
      <prompt>$</prompt> <userinput><command>su -c "make uninstall"</command></userinput>
     </screen>
</para>

</sect1>

<sect1 id="kde4_mac_install">
   <title>Installing on the &MacOS;-X platform</title>

      <note>
       <para>Please read the 
       <ulink url="https://projects.kde.org/projects/extragear/utils/krusader/repository/revisions/master/entry/INSTALL"><filename>INSTALL</filename></ulink> 
        file of the Krusader sources, it contains all latest installation instructions.</para>
      </note>

<para>With &kde;-4 Krusader runs natively on &MacOS;-X, using its Aqua user interface (No more X11 needed!).</para>

<para>With the help of <ulink url="http://www.macports.org/">macports.org</ulink> , &krusader; is ported to &MacOS;-X,
      the port is maintained by <ulink url="http://www.krusader.org/developers.php">Jonas B&auml;hr</ulink>.
      A <ulink url="http://trac.macports.org/ticket/17731">portfile</ulink> is provided.</para>

<para>
    <screen>
      <prompt>$</prompt> <userinput><command>sudo port install krusader</command></userinput>
     </screen>
</para>      
      
</sect1>

<sect1 id="kde4_win_install">
   <title>Installing on the &Windows; platform</title>

      <note>
       <para>Please read the 
       <ulink url="https://projects.kde.org/projects/extragear/utils/krusader/repository/revisions/master/entry/INSTALL"><filename>INSTALL</filename></ulink> 
        file of the Krusader sources, it contains all latest installation instructions.</para>
      </note>

<para>Tested on &Windows; XP, not yet tested on &Windows; Vista but it should work.</para>

<para>With Krusader-2.0.0 it is the first time that Krusader compiles on &Windows;,
      some work needs to be done to make Krusader more usable on the &Windows; platform.
      All feedback is welcome!</para>

<para>Krusader can be compiled and installed on &Windows; with the 
      <ulink url="http://winkde.org/pub/kde/ports/win32/installer/">Win-KDE installer</ulink>. 
      See also <ulink url="http://windows.kde.org/">windows.kde.org</ulink> for more information.</para>
              
</sect1>



  <sect1 id="starting-krusader">
    <title>Starting &krusader;</title>
    <para>Type 
    <userinput>
      <command>krusader</command>
    </userinput> (lower case) at a command prompt. You can create
    shortcut on your desktop or create an entry in the
    (&kde;) menu. Read the previous page and the
    <link linkend="faq">FAQ</link> if &krusader; does not
    start.</para>
    <para>When &krusader; is started from the
    command line, various options can be specified to modify its
    behavior.</para>
    <screen>
    	<prompt>$</prompt> <userinput><command>krusader</command></userinput>
    	WARNING: Mt.Man: Born, looking around to get familiar. foo</screen>
    <note>
      <para>Do not worry about the messages you get in the
      &konsole;. These messages are log messages that
      can be used for debugging &krusader;.</para>
    </note>
    <para>You can also use 
    <keycombo action="simul">&Alt;
    <keycap>F2</keycap></keycombo> to open the Run Command dialog
    box, type 
    <userinput>
      <command>krusader</command>
    </userinput> (lower case) and press &Enter; or click
    on the 
    <guibutton>Run</guibutton> button.</para>
    <para>If &krusader; is installed by an RPM or DEB
    package then usually &krusader; can be started from
    the &kmenu;. &eg; on
    KUbuntu click on the
    &kicon; button and choose 
    <emphasis role="bold">
      <menuchoice>
        <guimenuitem>Applications</guimenuitem>
        <guimenuitem>Utilities</guimenuitem>
        <guimenuitem>&krusader;</guimenuitem>
      </menuchoice>
    </emphasis>.</para>
    <variablelist>
      <title>Command-line options:</title>
      <varlistentry>
        <term>
          <option>--left</option>
          <replaceable>
          &lt;path&gt;</replaceable>
        </term>
        <listitem>
          <para>
            <action>start left panel at
            &lt;path&gt;</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--right</option>
          <replaceable>
          &lt;path&gt;</replaceable>
        </term>
        <listitem>
          <para>
            <action>start right panel at
            &lt;path&gt;</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--left</option>
          <replaceable>
          &lt;path1&gt;,&lt;path2&gt;,&lt;path3&gt;</replaceable>
        </term>
        <listitem>
          <para>
            <action>start left panel at
            &lt;path1&gt;,&lt;path2&gt;,&lt;path3&gt;,
            with tabs.</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--profile</option>
          <replaceable>
          &lt;panel-profile&gt;</replaceable>
        </term>
        <listitem>
          <para>
            <action>load a 
            <link linkend="panel_profiles">panel-profile</link> on
            startup (this overrides the 
            <link linkend="konfig-startup">default startup
            profile</link>).</action>
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    <para>Examples: 
    <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=&lt;path&gt; --right=&lt;path&gt;</replaceable></userinput></screen>
    <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=/mnt/cdrom --right=ftp://downloads@myserver.net</replaceable></userinput></screen>
    <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=&lt;path1&gt;,&lt;path2&gt; --right=&lt;path1&gt;,&lt;path2&gt;,&lt;path3&gt;</replaceable></userinput></screen>
    <screen><prompt>$</prompt> <userinput><command>krusader</command><replaceable>--profile &lt;panel-profile&gt;</replaceable></userinput></screen>
    <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--profile ftp-managment</replaceable></userinput></screen>
    </para>
    <para>The standard &Qt; and &kde;
    command-line options are available, and can be listed by
    entering 
    <userinput>
      <command>krusader</command>
      <option>--help</option>
    </userinput>.</para>
    <variablelist>
      <title>Other command-line options:</title>
      <varlistentry>
        <term>
          <option>--help-qt</option>
        </term>
        <listitem>
          <para>
            <action>List Qt-specific options</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--help-kde</option>
        </term>
        <listitem>
          <para>
            <action>List KDE-specific options</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--help-all</option>
        </term>
        <listitem>
          <para>
            <action>List all options</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--author</option>
        </term>
        <listitem>
          <para>
            <action>Show the authors names</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>-v,--version</option>
        </term>
        <listitem>
          <para>
            <action>Show the version number</action>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>--license</option>
        </term>
        <listitem>
          <para>
            <action>Show license information</action>
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect1>
  <sect1 id="configuration">
    <title>Configuring &krusader;</title>
    <para>When you run &krusader; for the first time,
    the &krusader; configuration module 
    <link linkend="konfigurator">Konfigurator</link> will show up
    and allow you to configure &krusader; as well as
    detect installed packers and tools. You can always run
    Konfigurator again from the
    <link linkend="settings-menu">Settings menu</link>.</para>
  </sect1>
  <sect1 id="default-file-manager">
    <title>Making &krusader; the default file
    manager</title>
    <para>To make &krusader; the default file manager in
    Gnome, <ulink url="http://psychocats.net/ubuntu/nonautilusplease">click here</ulink> for more information.
    </para>
    <para>To make &krusader; the default file manager in
    &kde;, <ulink url="http://groups.google.com/group/krusader-devel/browse_thread/thread/8209d785d3ba0ac6">click here</ulink> for more information. 
    </para>
  </sect1>
</chapter>

