<sect1 id="using-kde">

      <title>Using KDE</title>

      <sect2 id="kde-variables">

	<title>Variable definitions (KDE 3.x only)</title>

	<table frame="none">

	  <title>Variables for ports that use KDE 3.x</title>

	  <tgroup cols="2">

	    <tbody>

	      <row>

		<entry><makevar>USE_KDELIBS_VER</makevar></entry>

		<entry>The port uses KDE libraries.  It specifies the

		  major version of KDE to use and implies

		  <makevar>USE_QT_VER</makevar> of the appropriate

		  version.  The only possible value is

		  <literal>3</literal>.</entry>

	      </row>

	      <row>

		<entry><makevar>USE_KDEBASE_VER</makevar></entry>

		<entry>The port uses KDE base.  It specifies the major

		  version of KDE to use and implies

		  <makevar>USE_QT_VER</makevar> of the appropriate version.

		  The only possible value is <literal>3</literal>.</entry>

	      </row>

	    </tbody>

	  </tgroup>

	</table>

      </sect2>

      <sect2 id="kde4-components">

	<title>KDE 4 components</title>

	<para>If your application depends on KDE 4.x, set <makevar>USE_KDE4</makevar>

	  to the list of required components. The most commonly used components are listed below

	  (up-to-date components are listed in <makevar>_USE_KDE4_ALL</makevar> in

	  <filename>/usr/ports/Mk/bsd.kde4.mk</filename>):</para>

	<table frame="none">

	  <title>Available KDE4 components</title>

	  <tgroup cols="2">

	    <thead>

	      <row>

		<entry>Name</entry>

		<entry>Description</entry>

	      </row>

	    </thead>

	    <tbody>

	      <row>

		<entry><literal>akonadi</literal></entry>

		<entry>Personal information management (PIM) storage service</entry>

	      </row>

	      <row>

		<entry><literal>automoc4</literal></entry>

		<entry>automoc4 build tool</entry>

	      </row>

	      <row>

		<entry><literal>kdebase</literal></entry>

		<entry>Basic KDE applications (Konqueror, Dolphin, Konsole)</entry>

	      </row>

	      <row>

		<entry><literal>kdeexp</literal></entry>

		<entry>Experimental KDE libraries (with non-stable API)</entry>

	      </row>

	      <row>

		<entry><literal>kdehier</literal></entry>

		<entry>Provides common KDE directories</entry>

	      </row>

	      <row>

		<entry><literal>kdelibs</literal></entry>

		<entry>The base set of KDE libraries</entry>

	      </row>

	      <row>

		<entry><literal>kdeprefix</literal></entry>

		<entry>If set, port will be installed into

		  <literal>&dollar;{KDE4_PREFIX}</literal>

		  instead of <literal>&dollar;{LOCALBASE}</literal></entry>

	      </row>

	      <row>

		<entry><literal>pimlibs</literal></entry>

		<entry>PIM libraries</entry>

	      </row>

	      <row>

		<entry><literal>workspace</literal></entry>

		<entry>Applications and libraries which form desktop (Plasma, KWin)</entry>

	      </row>

	    </tbody>

	  </tgroup>

	</table>

	<para>KDE 4.x ports are installed into <literal>&dollar;{KDE4_PREFIX}</literal>,

	  which is <filename>/usr/local/kde4</filename> currently, to avoid conflicts

	  with KDE 3.x ports. This is achieved by specifying <literal>kdeprefix</literal>

	  component, which overrides default <makevar>PREFIX</makevar>. The ports however

	  respect <makevar>PREFIX</makevar> set via <envar>MAKEFLAGS</envar> environment

	  variable and/or <application>make</application> arguments.</para>

	<example id="kde4-components-example">

	  <title><makevar>USE_KDE4</makevar> example</title>

	  <para>This is a simple example for KDE 4 port. <makevar>USE_CMAKE</makevar>

	  instructs port to utilize <application>CMake</application> &mdash;

	  configuration tool widely spread among KDE 4 projects.

	  <makevar>USE_KDE4</makevar> brings dependency on KDE libraries and makes port using

	  <application>automoc4</application> at build stage. Required KDE components

	  and other dependencies can be determined through configure log.

	  <makevar>USE_KDE4</makevar> does not imply <makevar>USE_QT_VER</makevar>.

	  If port requires some of Qt4 components, <makevar>USE_QT_VER</makevar> should be set

	  and then needed components can be specified.</para>

	  <programlisting>USE_CMAKE=     yes

USE_KDE4=      automoc4 kdelibs kdeprefix

USE_QT_VER=    4

QT_COMPONENTS= qmake_build moc_build rcc_build uic_build</programlisting>

	</example>

      </sect2>

    </sect1>