Attachment #124354 for bug #167864

View | Details | Raw Unified | Return to bug 167864
Collapse All | Expand All





	<para>Several replacements for the default
	  <application>XDM</application> program exist.  One of them,
	  <application>KDM</application> (bundled with
	  <application>KDE</application>) is described later in this
	  chapter.  The <application>KDM</application> display manager offers many visual
	  improvements and cosmetic frills, as well as the
	  functionality to allow users to choose their window manager
	  of choice at login time.</para>

	<para>Yet another option is to configure the display manager to
	  allow choosing the window manager at login time; the section on
	  <link linkend="x11-wm-kde-details">KDE details</link>
	  explains how to do this for <application>KDM</application>, the
	  display manager of <application>KDE</application>.</para>
      </sect3>
    </sect2>


	  <listitem>
	    <para>Internationalization: <application>KDE</application>
	      is available in more than 55 languages</para>
	  </listitem>

	  <listitem>

	  can be found on the <ulink url="http://www.kde.org/">KDE
	  website</ulink>.  For FreeBSD specific information and
	  resources on <application>KDE</application>, consult
	  the <ulink url="http://freebsd.kde.org/">KDE/FreeBSD
	  initiative</ulink>'s website.</para>

	<para>There are two versions of <application>KDE</application> available
	  on FreeBSD.  Version 3 has been around for a long time, and is still
	  available in the Ports Collection though it's now unmaintained and
	  partially broken.  Version 4 is punctually updated and is the default
	  choice for <application>KDE</application> users.  They can even be
	  installed side by side.</para>
      </sect3>

      <sect3 id="x11-wm-kde-install">

	  other desktop environment, the software can be easily installed
	  from a package or the Ports Collection:</para>

	<para>To install the <application>KDE 3</application> package
	  from the network, simply type:</para>

	<screen>&prompt.root; <userinput>pkg_add -r kde</userinput></screen>

	<para>To install the <application>KDE 4</application> package
	  from the network, simply type:</para>

	<screen>&prompt.root; <userinput>pkg_add -r kde4</userinput></screen>

	<para>&man.pkg.add.1; will automatically fetch the latest version
	  of the application.</para>

	<para>To build <application>KDE 3</application> from source,
	  use the ports tree:</para>

	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde3</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

	<para>To build <application>KDE 4</application> from source,
	  use the ports tree:</para>

	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde4</userinput>

	  instead of the default window manager.  This is accomplished
	  by editing the <filename>.xinitrc</filename> file:</para>

	<para>For <application>KDE 3</application>:</para>

	<screen>&prompt.user; <userinput>echo "exec startkde" &gt; ~/.xinitrc</userinput></screen>

	<para>For <application>KDE 4</application>:</para>

	<screen>&prompt.user; <userinput>echo "exec /usr/local/kde4/bin/startkde" &gt; ~/.xinitrc</userinput></screen>

	<para>Now, whenever the X Window System is invoked with

	  <application>XDM</application> is being used, the
	  configuration is slightly different.  Edit the
	  <filename>.xsession</filename> file instead.  Instructions
	  for <application>KDM</application> are described later in
	  this chapter.</para>
      </sect3>
    </sect2>

	  <link linkend="x-xdm">XDM</link> can be
	  used, as described earlier.  However,
	  <application>KDE</application> includes an
	  alternative, <application>KDM</application>, which is designed
	  to look more attractive and include more login-time options.
	  In particular, users can easily choose (via a menu) which
	  desktop environment (<application>KDE</application>,
	  <application>GNOME</application>, or something else) to run
	  after logging on.</para>

	<para>To enable <application>KDM</application>, different files
	  need to be edited depending on the version of
	  <application>KDE</application>.</para>

	<para>For <application>KDE 3</application>, the <literal>ttyv8</literal>
	  entry in <filename>/etc/ttys</filename> has to be adapted as
	  follows:</para>

	 <programlisting>ttyv8 "/usr/local/bin/kdm -nodaemon" xterm on secure</programlisting>

	<para>For <application>KDE 4</application>, you have to mount
	  &man.procfs.5; and add the following line to
	  <filename>/etc/rc.conf</filename>:</para>

	<programlisting>kdm4_enable="YES"</programlisting>
kdm4_enable="YES"</programlisting>
      </sect3>

     </sect2>




	      <row>
		<entry><filename>kde*</filename></entry>
		<entry>Ports from the <ulink
		    url="http://www.kde.org">KDE</ulink> Project.</entry>
		    (KDE)</ulink> Project.</entry>
		<entry></entry>
	      </row>


		<entry><makevar>QTNONSTANDARD</makevar></entry>
		<entry>Suppress modification of
		  <makevar>CONFIGURE_ENV</makevar>,
		  <makevar>CONFIGURE_ARGS</makevar>,
		  <makevar>CPPFLAGS</makevar> and
		  <makevar>MAKE_ENV</makevar>.</entry>
	      </row>
	    </tbody>

	    <tbody>
	      <row>
		<entry><makevar>QT_COMPONENTS</makevar></entry>
		<entry>Specify tool and library dependencies for Qt 4.
		  See below for details.</entry>
	      </row>

	      <row>
		<entry><makevar>UIC</makevar></entry>
		<entry>Set to the path of <command>uic</command>
		  (read-only variable).</entry>
		  <makevar>USE_QT_VER</makevar> value.</entry>
	      </row>

	      <row>
		<entry><makevar>QMAKE</makevar></entry>
		<entry>Set to the path of <command>qmake</command>
		  (read-only variable).</entry>
		  <makevar>USE_QT_VER</makevar> value.</entry>
	      </row>

	      <row>
		<entry><makevar>QMAKESPEC</makevar></entry>
		<entry>Set to the path of configuration file for
		  <command>qmake</command> (read-only variable).</entry>
		  Default set according to
		  <makevar>USE_QT_VER</makevar> value.</entry>
	      </row>
	    </tbody>
	  </tgroup>

			--with-qt-libraries=${QT_PREFIX}/lib \
			--with-extra-libs=${LOCALBASE}/lib \
			--with-extra-includes=${LOCALBASE}/include
CONFIGURE_ENV+=	MOC="${MOC}" LIBS="${QTCFGLIBS}" \
		QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}"
CPPFLAGS+=	${QTCPPFLAGS}</programlisting>

	<para>If <makevar>USE_QT_VER</makevar> is set to
	  <literal>4</literal>, the following settings are also

      <sect2 id="qt4-components">
	<title>Component Selection (Qt 4.x Only)</title>

	<para>When <makevar>USE_QT_VER</makevar> is set to <literal>4</literal>,
	  individual Qt 4 tool and library dependencies can be
	  specified in the <makevar>QT_COMPONENTS</makevar> variable.
	  Every component can be suffixed by either
	  <literal>_build</literal> or <literal>_run</literal>, the

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

	<table frame="none">
	  <title>Available Qt 4 Library Components</title>

	  <tgroup cols="2">
	    <thead>


	      <row>
		<entry><literal>qt3support</literal></entry>
		<entry>Qt 3 compatibility library</entry>
	      </row>

	      <row>

	  executable after a successful compilation.</para>

	<table frame="none">
	  <title>Available Qt 4 Tool Components</title>

	  <tgroup cols="2">
	    <thead>


	      <row>
		<entry><literal>rcc</literal></entry>
		<entry>resource compiler (needed if the application
		  comes with <filename>*.rc</filename> or
		  <filename>*.qrc</filename> files)</entry>
	      </row>

	</table>

	<table frame="none">
	  <title>Available Qt 4 Plugin Components</title>

	  <tgroup cols="2">
	    <thead>

	</table>

	<example id="qt4-components-example">
	  <title>Selecting Qt 4 Components</title>

	  <para>In this example, the ported application uses the Qt 4
	    graphical user interface library, the Qt 4 core library,
	    all of the Qt 4 code generation tools and Qt 4's Makefile
	    generator.  Since the <literal>gui</literal> library implies
	    a dependency on the core library, <literal>corelib</literal>
	    does not need to be specified.  The Qt 4 code generation tools
	    <literal>moc</literal>, <literal>uic</literal> and
	    <literal>rcc</literal>, as well as the Makefile generator
	    <literal>qmake</literal> are only needed at buildtime, thus they
	    are specified with the <literal>_build</literal> suffix:</para>

	  <programlisting>USE_QT_VER=	4
QT_COMPONENTS=	gui moc_build qmake_build rcc_build uic_build</programlisting>


do-configure:
	@cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \
		${QMAKE} PREFIX=${PREFIX} texmaker.pro</programlisting>

	<para>Note the similarity to the <command>qmake</command> line
	  from the provided <filename>BUILD.sh</filename> script.

	<itemizedlist>
	  <listitem>
	    <para><emphasis>Missing additional
	      include paths.</emphasis>  Many applications come with
	      system tray icon support, but neglect to look for
	      includes and/or libraries in the X11 directories.  You
	      can tell <command>qmake</command> to add directories to
	      the include and library search paths via the command
	      line, for example:</para>

	    <programlisting>${QMAKE} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \
	LIBS+=-L${LOCALBASE}/lib sillyapp.pro</programlisting>
	  </listitem>


	      Sometimes data such as icons or .desktop files are by
	      default installed into directories which aren't scanned
	      by XDG-compatible applications.  <filename
	      role="package">editors/texmaker</filename> is an
	      example for this - look at
	      <filename>patch-texmaker.pro</filename> in the
	      <filename>files</filename> directory of that port for a
	      template on how to remedy this directly in the
	      <command>qmake</command> project file.</para>
	  </listitem>
	</itemizedlist>
      </sect2>


	<para>If your application depends on KDE 4.x, set
	  <makevar>USE_KDE4</makevar> to the list of required
	  components.  <literal>_build</literal> and <literal>_run</literal>
	  suffixes can be used to force components dependency type
	  (e.g., <literal>baseapps_run</literal>). If no suffix is set,
	  a default dependency type will be used. If you want to force
	  both types, add the component twice with both suffixes
	  (e.g., <literal>automoc4_build automoc4_run</literal>).
	  The most commonly used components are listed below (up-to-date
	  components are documented at the top of
	  <filename>/usr/ports/Mk/bsd.kde4.mk</filename>):</para>

	<table frame="none">
	  <title>Available KDE 4 Components</title>

	  <tgroup cols="2">
	    <thead>


	    <tbody>
	      <row>
		<entry><literal>baseapps</literal></entry>
		<entry>Basic applications for KDE Desktop</entry>
		  service</entry>
	      </row>

	      <row>
		<entry><literal>automoc4</literal></entry>
		<entry>Makes port use 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>Hierarchy of common KDE directories</entry>
	      </row>

	      <row>
		<entry><literal>kdelibs</literal></entry>
		<entry>KDE Developer Platform</entry>
	      </row>

	      <row>


	      <row>
		<entry><literal>pimlibs</literal></entry>
		<entry>KDE-Pim libraries</entry>
	      </row>

	      <row>
		<entry><literal>workspace</literal></entry>
		<entry>KDE user environments</entry>
	      </row>

	      <row>
		<entry><literal>akonadi</literal></entry>
		<entry>Storage server for KDE-Pim</entry>
	      </row>

	      <row>
		<entry><literal>automoc4</literal></entry>
		<entry>Automatic moc for Qt 4 packages</entry>
	      </row>
	    </tbody>
	  </tgroup>
	</table>

	<para>KDE 4.x ports are installed into
	  <makevar>KDE4_PREFIX</makevar>, which is
	  <filename>/usr/local/kde4</filename> currently, to avoid
	  conflicts with KDE 3.x ports.  This is achieved by
	  specifying the <literal>kdeprefix</literal> component, which
	  overrides the default <makevar>PREFIX</makevar>.  The ports
	  however respect any <makevar>PREFIX</makevar> set via
	  <envar>MAKEFLAGS</envar> environment variable and/or
	  <command>make</command> arguments.</para>

	<para>KDE 4.x ports may conflict with KDE 3.x ports, so when
	  the <literal>kdeprefix</literal> component is enabled, they
	  are installed in <literal>&dollar;{KDE4_PREFIX}</literal>.
	  The default value of <literal>KDE4_PREFIX</literal> is
	  currently <filename>/usr/local/kde4</filename>.  Installing
	  the KDE 4.x ports into a custom <literal>PREFIX</literal> is
	  also possible.  When <literal>PREFIX</literal> is set via
	  the <envar>MAKEFLAGS</envar> environment variable or via
	  <application>make</application> options it overrides the
	  value configured by <literal>kdeprefix</literal>.</para>

	<example id="kde4-components-example">
	  <title><makevar>USE_KDE4</makevar> Example</title>

	  <para>This is a simple example for a KDE 4 port.
	    <makevar>USE_CMAKE</makevar> instructs the 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
	    <command>automoc4</command> 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 a port requires some
	    Qt 4 components, <makevar>USE_QT_VER</makevar> should be
	    set and then needed components can be specified.</para>

	  <programlisting>USE_CMAKE=	yes
USE_KDE4=	kdelibs kdeprefix automoc4
USE_QT_VER=	4
QT_COMPONENTS=	moc_build qmake_build rcc_build uic_build</programlisting>
	</example>
      </sect2>
    </sect1>

Return to bug 167864

Lines 1323-1331 Link Here

(-)handbook/x11/chapter.sgml (-26 / +28 lines)
1323		1323
1324	<para>Several replacements for the default	1324	<para>Several replacements for the default
1325	<application>XDM</application> program exist. One of them,	1325	<application>XDM</application> program exist. One of them,
1326	<application>kdm</application> (bundled with	1326	<application>KDM</application> (bundled with
1327	<application>KDE</application>) is described later in this	1327	<application>KDE</application>) is described later in this
1328	chapter. The <application>kdm</application> display manager offers many visual	1328	chapter. The <application>KDM</application> display manager offers many visual
1329	improvements and cosmetic frills, as well as the	1329	improvements and cosmetic frills, as well as the
1330	functionality to allow users to choose their window manager	1330	functionality to allow users to choose their window manager
1331	of choice at login time.</para>	1331	of choice at login time.</para>
Lines 1460-1466 Link Here
1460	<para>Yet another option is to configure the display manager to	1460	<para>Yet another option is to configure the display manager to
1461	allow choosing the window manager at login time; the section on	1461	allow choosing the window manager at login time; the section on
1462	<link linkend="x11-wm-kde-details">KDE details</link>	1462	<link linkend="x11-wm-kde-details">KDE details</link>
1463	explains how to do this for <application>kdm</application>, the	1463	explains how to do this for <application>KDM</application>, the
1464	display manager of <application>KDE</application>.</para>	1464	display manager of <application>KDE</application>.</para>
1465	</sect3>	1465	</sect3>
1466	</sect2>	1466	</sect2>
Lines 1504-1510 Link Here
1504		1504
1505	<listitem>	1505	<listitem>
1506	<para>Internationalization: <application>KDE</application>	1506	<para>Internationalization: <application>KDE</application>
1507	is available in more than 40 languages</para>	1507	is available in more than 55 languages</para>
1508	</listitem>	1508	</listitem>
1509		1509
1510	<listitem>	1510	<listitem>
Lines 1525-1537 Link Here
1525	can be found on the <ulink url="http://www.kde.org/">KDE	1525	can be found on the <ulink url="http://www.kde.org/">KDE
1526	website</ulink>. For FreeBSD specific information and	1526	website</ulink>. For FreeBSD specific information and
1527	resources on <application>KDE</application>, consult	1527	resources on <application>KDE</application>, consult
1528	the <ulink url="http://freebsd.kde.org/">KDE on FreeBSD	1528	the <ulink url="http://freebsd.kde.org/">KDE/FreeBSD
1529	team</ulink>'s website.</para>	1529	initiative</ulink>'s website.</para>
1530		1530
1531	<para>There are two versions of <application>KDE</application> available on FreeBSD. Version 3	1531	<para>There are two versions of <application>KDE</application> available
1532	has been around for a long time, and is very mature. Version 4,	1532	on FreeBSD. Version 3 has been around for a long time, and is still
1533	the next generation, is also available in the Ports Collection.	1533	available in the Ports Collection though it's now unmaintained and
1534	They can even be installed side by side.</para>	1534	partially broken. Version 4 is punctually updated and is the default
		1535	choice for <application>KDE</application> users. They can even be
		1536	installed side by side.</para>
1535	</sect3>	1537	</sect3>
1536		1538
1537	<sect3 id="x11-wm-kde-install">	1539	<sect3 id="x11-wm-kde-install">
Lines 1541-1552 Link Here
1541	other desktop environment, the software can be easily installed	1543	other desktop environment, the software can be easily installed
1542	from a package or the Ports Collection:</para>	1544	from a package or the Ports Collection:</para>
1543		1545
1544	<para>To install the <application>KDE3</application> package	1546	<para>To install the <application>KDE 3</application> package
1545	from the network, simply type:</para>	1547	from the network, simply type:</para>
1546		1548
1547	<screen>&prompt.root; <userinput>pkg_add -r kde</userinput></screen>	1549	<screen>&prompt.root; <userinput>pkg_add -r kde</userinput></screen>
1548		1550
1549	<para>To install the <application>KDE4</application> package	1551	<para>To install the <application>KDE 4</application> package
1550	from the network, simply type:</para>	1552	from the network, simply type:</para>
1551		1553
1552	<screen>&prompt.root; <userinput>pkg_add -r kde4</userinput></screen>	1554	<screen>&prompt.root; <userinput>pkg_add -r kde4</userinput></screen>
Lines 1554-1566 Link Here
1554	<para>&man.pkg.add.1; will automatically fetch the latest version	1556	<para>&man.pkg.add.1; will automatically fetch the latest version
1555	of the application.</para>	1557	of the application.</para>
1556		1558
1557	<para>To build <application>KDE3</application> from source,	1559	<para>To build <application>KDE 3</application> from source,
1558	use the ports tree:</para>	1560	use the ports tree:</para>
1559		1561
1560	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde3</userinput>	1562	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde3</userinput>
1561	&prompt.root; <userinput>make install clean</userinput></screen>	1563	&prompt.root; <userinput>make install clean</userinput></screen>
1562		1564
1563	<para>To build <application>KDE4</application> from source,	1565	<para>To build <application>KDE 4</application> from source,
1564	use the ports tree:</para>	1566	use the ports tree:</para>
1565		1567
1566	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde4</userinput>	1568	<screen>&prompt.root; <userinput>cd /usr/ports/x11/kde4</userinput>
Lines 1571-1582 Link Here
1571	instead of the default window manager. This is accomplished	1573	instead of the default window manager. This is accomplished
1572	by editing the <filename>.xinitrc</filename> file:</para>	1574	by editing the <filename>.xinitrc</filename> file:</para>
1573		1575
1574	<para>For <application>KDE3</application>:</para>	1576	<para>For <application>KDE 3</application>:</para>
1575		1577
1576	<screen>&prompt.user; <userinput>echo "exec startkde" > ~/.xinitrc</userinput></screen>	1578	<screen>&prompt.user; <userinput>echo "exec startkde" > ~/.xinitrc</userinput></screen>
1577		1579
1578	<para>For <application>KDE4</application>:</para>	1580	<para>For <application>KDE 4</application>:</para>
1579		1581
1580	<screen>&prompt.user; <userinput>echo "exec /usr/local/kde4/bin/startkde" > ~/.xinitrc</userinput></screen>	1582	<screen>&prompt.user; <userinput>echo "exec /usr/local/kde4/bin/startkde" > ~/.xinitrc</userinput></screen>
1581		1583
1582	<para>Now, whenever the X Window System is invoked with	1584	<para>Now, whenever the X Window System is invoked with
Lines 1587-1593 Link Here
1587	<application>XDM</application> is being used, the	1589	<application>XDM</application> is being used, the
1588	configuration is slightly different. Edit the	1590	configuration is slightly different. Edit the
1589	<filename>.xsession</filename> file instead. Instructions	1591	<filename>.xsession</filename> file instead. Instructions
1590	for <application>kdm</application> are described later in	1592	for <application>KDM</application> are described later in
1591	this chapter.</para>	1593	this chapter.</para>
1592	</sect3>	1594	</sect3>
1593	</sect2>	1595	</sect2>
Lines 1618-1645 Link Here
1618	<link linkend="x-xdm">XDM</link> can be	1620	<link linkend="x-xdm">XDM</link> can be
1619	used, as described earlier. However,	1621	used, as described earlier. However,
1620	<application>KDE</application> includes an	1622	<application>KDE</application> includes an
1621	alternative, <application>kdm</application>, which is designed	1623	alternative, <application>KDM</application>, which is designed
1622	to look more attractive and include more login-time options.	1624	to look more attractive and include more login-time options.
1623	In particular, users can easily choose (via a menu) which	1625	In particular, users can easily choose (via a menu) which
1624	desktop environment (<application>KDE</application>,	1626	desktop environment (<application>KDE</application>,
1625	<application>GNOME</application>, or something else) to run	1627	<application>GNOME</application>, or something else) to run
1626	after logging on.</para>	1628	after logging on.</para>
1627		1629
1628	<para>To enable <application>kdm</application>, different files	1630	<para>To enable <application>KDM</application>, different files
1629	need to be edited depending on the version of	1631	need to be edited depending on the version of
1630	<application>KDE</application>.</para>	1632	<application>KDE</application>.</para>
1631		1633
1632	<para>For <application>KDE3</application>, the <literal>ttyv8</literal>	1634	<para>For <application>KDE 3</application>, the <literal>ttyv8</literal>
1633	entry in <filename>/etc/ttys</filename> has to be adapted as	1635	entry in <filename>/etc/ttys</filename> has to be adapted as
1634	follows:</para>	1636	follows:</para>
1635		1637
1636	<programlisting>ttyv8 "/usr/local/bin/kdm -nodaemon" xterm on secure</programlisting>	1638	<programlisting>ttyv8 "/usr/local/bin/kdm -nodaemon" xterm on secure</programlisting>
1637		1639
1638	<para>For <application>KDE4</application>, you have to add the	1640	<para>For <application>KDE 4</application>, you have to mount
1639	following lines to <filename>/etc/rc.conf</filename>:</para>	1641	&man.procfs.5; and add the following line to
		1642	<filename>/etc/rc.conf</filename>:</para>
1640		1643
1641	<programlisting>local_startup="${local_startup} /usr/local/kde4/etc/rc.d"	1644	<programlisting>kdm4_enable="YES"</programlisting>
1642	kdm4_enable="YES"</programlisting>
1643	</sect3>	1645	</sect3>
1644		1646
1645	</sect2>	1647	</sect2>

Lines 1742-1749 Link Here

(-)porters-handbook/book.sgml (-85 / +68 lines)
1742	<row>	1742	<row>
1743	<entry><filename>kde*</filename></entry>	1743	<entry><filename>kde*</filename></entry>
1744	<entry>Ports from the <ulink	1744	<entry>Ports from the <ulink
1745	url="http://www.kde.org">K Desktop Environment	1745	url="http://www.kde.org">KDE</ulink> Project.</entry>
1746	(KDE)</ulink> Project.</entry>
1747	<entry></entry>	1746	<entry></entry>
1748	</row>	1747	</row>
1749		1748
Lines 6004-6010 Link Here
6004	<entry><makevar>QTNONSTANDARD</makevar></entry>	6003	<entry><makevar>QTNONSTANDARD</makevar></entry>
6005	<entry>Suppress modification of	6004	<entry>Suppress modification of
6006	<makevar>CONFIGURE_ENV</makevar>,	6005	<makevar>CONFIGURE_ENV</makevar>,
6007	<makevar>CONFIGURE_ARGS</makevar>, and	6006	<makevar>CONFIGURE_ARGS</makevar>,
		6007	<makevar>CPPFLAGS</makevar> and
6008	<makevar>MAKE_ENV</makevar>.</entry>	6008	<makevar>MAKE_ENV</makevar>.</entry>
6009	</row>	6009	</row>
6010	</tbody>	6010	</tbody>
Lines 6019-6048 Link Here
6019	<tbody>	6019	<tbody>
6020	<row>	6020	<row>
6021	<entry><makevar>QT_COMPONENTS</makevar></entry>	6021	<entry><makevar>QT_COMPONENTS</makevar></entry>
6022	<entry>Specify tool and library dependencies for Qt4.	6022	<entry>Specify tool and library dependencies for Qt 4.
6023	See below for details.</entry>	6023	See below for details.</entry>
6024	</row>	6024	</row>
6025		6025
6026	<row>	6026	<row>
6027	<entry><makevar>UIC</makevar></entry>	6027	<entry><makevar>UIC</makevar></entry>
6028	<entry>Set to the path of <command>uic</command>	6028	<entry>Set to the path of <command>uic</command>
6029	(read-only variable). Default set according to	6029	(read-only variable).</entry>
6030	<makevar>USE_QT_VER</makevar> value.</entry>
6031	</row>	6030	</row>
6032		6031
6033	<row>	6032	<row>
6034	<entry><makevar>QMAKE</makevar></entry>	6033	<entry><makevar>QMAKE</makevar></entry>
6035	<entry>Set to the path of <command>qmake</command>	6034	<entry>Set to the path of <command>qmake</command>
6036	(read-only variable). Default set according to	6035	(read-only variable).</entry>
6037	<makevar>USE_QT_VER</makevar> value.</entry>
6038	</row>	6036	</row>
6039		6037
6040	<row>	6038	<row>
6041	<entry><makevar>QMAKESPEC</makevar></entry>	6039	<entry><makevar>QMAKESPEC</makevar></entry>
6042	<entry>Set to the path of configuration file for	6040	<entry>Set to the path of configuration file for
6043	<command>qmake</command> (read-only variable).	6041	<command>qmake</command> (read-only variable).</entry>
6044	Default set according to
6045	<makevar>USE_QT_VER</makevar> value.</entry>
6046	</row>	6042	</row>
6047	</tbody>	6043	</tbody>
6048	</tgroup>	6044	</tgroup>
Lines 6056-6063 Link Here
6056	--with-qt-libraries=${QT_PREFIX}/lib \	6052	--with-qt-libraries=${QT_PREFIX}/lib \
6057	--with-extra-libs=${LOCALBASE}/lib \	6053	--with-extra-libs=${LOCALBASE}/lib \
6058	--with-extra-includes=${LOCALBASE}/include	6054	--with-extra-includes=${LOCALBASE}/include
6059	CONFIGURE_ENV+= MOC="${MOC}" CPPFLAGS="${CPPFLAGS} ${QTCPPFLAGS}" LIBS="${QTCFGLIBS}" \	6055	CONFIGURE_ENV+= MOC="${MOC}" LIBS="${QTCFGLIBS}" \
6060	QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}"</programlisting>	6056	QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}"
		6057	CPPFLAGS+= ${QTCPPFLAGS}</programlisting>
6061		6058
6062	<para>If <makevar>USE_QT_VER</makevar> is set to	6059	<para>If <makevar>USE_QT_VER</makevar> is set to
6063	<literal>4</literal>, the following settings are also	6060	<literal>4</literal>, the following settings are also
Lines 6070-6077 Link Here
6070	<sect2 id="qt4-components">	6067	<sect2 id="qt4-components">
6071	<title>Component Selection (Qt 4.x Only)</title>	6068	<title>Component Selection (Qt 4.x Only)</title>
6072		6069
6073	<para>When <makevar>USE_QT_VER</makevar> is set to 4,	6070	<para>When <makevar>USE_QT_VER</makevar> is set to <literal>4</literal>,
6074	individual Qt4 tool and library dependencies can be	6071	individual Qt 4 tool and library dependencies can be
6075	specified in the <makevar>QT_COMPONENTS</makevar> variable.	6072	specified in the <makevar>QT_COMPONENTS</makevar> variable.
6076	Every component can be suffixed by either	6073	Every component can be suffixed by either
6077	<literal>_build</literal> or <literal>_run</literal>, the	6074	<literal>_build</literal> or <literal>_run</literal>, the
Lines 6088-6094 Link Here
6088	<filename>/usr/ports/Mk/bsd.qt.mk</filename>):</para>	6085	<filename>/usr/ports/Mk/bsd.qt.mk</filename>):</para>
6089		6086
6090	<table frame="none">	6087	<table frame="none">
6091	<title>Available Qt4 Library Components</title>	6088	<title>Available Qt 4 Library Components</title>
6092		6089
6093	<tgroup cols="2">	6090	<tgroup cols="2">
6094	<thead>	6091	<thead>
Lines 6122-6128 Link Here
6122		6119
6123	<row>	6120	<row>
6124	<entry><literal>qt3support</literal></entry>	6121	<entry><literal>qt3support</literal></entry>
6125	<entry>Qt3 compatibility library</entry>	6122	<entry>Qt 3 compatibility library</entry>
6126	</row>	6123	</row>
6127		6124
6128	<row>	6125	<row>
Lines 6154-6160 Link Here
6154	executable after a successful compilation.</para>	6151	executable after a successful compilation.</para>
6155		6152
6156	<table frame="none">	6153	<table frame="none">
6157	<title>Available Qt4 Tool Components</title>	6154	<title>Available Qt 4 Tool Components</title>
6158		6155
6159	<tgroup cols="2">	6156	<tgroup cols="2">
6160	<thead>	6157	<thead>
Lines 6178-6184 Link Here
6178		6175
6179	<row>	6176	<row>
6180	<entry><literal>rcc</literal></entry>	6177	<entry><literal>rcc</literal></entry>
6181	<entry>resource compiler (need if the application	6178	<entry>resource compiler (needed if the application
6182	comes with <filename>*.rc</filename> or	6179	comes with <filename>*.rc</filename> or
6183	<filename>*.qrc</filename> files)</entry>	6180	<filename>*.qrc</filename> files)</entry>
6184	</row>	6181	</row>
Lines 6195-6201 Link Here
6195	</table>	6192	</table>
6196		6193
6197	<table frame="none">	6194	<table frame="none">
6198	<title>Available Qt4 Plugin Components</title>	6195	<title>Available Qt 4 Plugin Components</title>
6199		6196
6200	<tgroup cols="2">	6197	<tgroup cols="2">
6201	<thead>	6198	<thead>
Lines 6223-6239 Link Here
6223	</table>	6220	</table>
6224		6221
6225	<example id="qt4-components-example">	6222	<example id="qt4-components-example">
6226	<title>Selecting Qt4 Components</title>	6223	<title>Selecting Qt 4 Components</title>
6227		6224
6228	<para>In this example, the ported application uses the Qt4	6225	<para>In this example, the ported application uses the Qt 4
6229	graphical user interface library, the Qt4 core library,	6226	graphical user interface library, the Qt 4 core library,
6230	all of the Qt4 code generation tools and Qt4's Makefile	6227	all of the Qt 4 code generation tools and Qt 4's Makefile
6231	generator. Since the gui library implies a dependency on	6228	generator. Since the <literal>gui</literal> library implies
6232	the core library, corelib does not need to be specified.	6229	a dependency on the core library, <literal>corelib</literal>
6233	The Qt4 code generation tools moc, uic and rcc, as well as	6230	does not need to be specified. The Qt 4 code generation tools
6234	the Makefile generator qmake are only needed at buildtime,	6231	<literal>moc</literal>, <literal>uic</literal> and
6235	thus they are specified with the <literal>_build</literal>	6232	<literal>rcc</literal>, as well as the Makefile generator
6236	suffix:</para>	6233	<literal>qmake</literal> are only needed at buildtime, thus they
		6234	are specified with the <literal>_build</literal> suffix:</para>
6237		6235
6238	<programlisting>USE_QT_VER= 4	6236	<programlisting>USE_QT_VER= 4
6239	QT_COMPONENTS= gui moc_build qmake_build rcc_build uic_build</programlisting>	6237	QT_COMPONENTS= gui moc_build qmake_build rcc_build uic_build</programlisting>
Lines 6252-6258 Link Here
6252		6250
6253	do-configure:	6251	do-configure:
6254	@cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \	6252	@cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \
6255	${QMAKE} -unix PREFIX=${PREFIX} texmaker.pro</programlisting>	6253	${QMAKE} PREFIX=${PREFIX} texmaker.pro</programlisting>
6256		6254
6257	<para>Note the similarity to the <command>qmake</command> line	6255	<para>Note the similarity to the <command>qmake</command> line
6258	from the provided <filename>BUILD.sh</filename> script.	6256	from the provided <filename>BUILD.sh</filename> script.
Lines 6271-6284 Link Here
6271	<itemizedlist>	6269	<itemizedlist>
6272	<listitem>	6270	<listitem>
6273	<para><emphasis>Missing additional	6271	<para><emphasis>Missing additional
6274	includepaths.</emphasis> Many applications come with	6272	include paths.</emphasis> Many applications come with
6275	system tray icon support, but neglect to look for	6273	system tray icon support, but neglect to look for
6276	includes and/or libraries in the X11 directories. You	6274	includes and/or libraries in the X11 directories. You
6277	can tell <command>qmake</command> to add directories to	6275	can tell <command>qmake</command> to add directories to
6278	the include and library searchpaths via the command	6276	the include and library search paths via the command
6279	line, for example:</para>	6277	line, for example:</para>
6280		6278
6281	<programlisting>${QMAKE} -unix PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \	6279	<programlisting>${QMAKE} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \
6282	LIBS+=-L${LOCALBASE}/lib sillyapp.pro</programlisting>	6280	LIBS+=-L${LOCALBASE}/lib sillyapp.pro</programlisting>
6283	</listitem>	6281	</listitem>
6284		6282
Lines 6287-6298 Link Here
6287	Sometimes data such as icons or .desktop files are by	6285	Sometimes data such as icons or .desktop files are by
6288	default installed into directories which aren't scanned	6286	default installed into directories which aren't scanned
6289	by XDG-compatible applications. <filename	6287	by XDG-compatible applications. <filename
6290	role="package">editors/texmaker</filename> is an	6288	role="package">editors/texmaker</filename> is an
6291	example for this - look at	6289	example for this - look at
6292	<filename>patch-texmaker.pro</filename> in the	6290	<filename>patch-texmaker.pro</filename> in the
6293	<filename>files</filename> directory of that port for a	6291	<filename>files</filename> directory of that port for a
6294	template on how to remedy this directly in the Qmake	6292	template on how to remedy this directly in the
6295	project file.</para>	6293	<command>qmake</command> project file.</para>
6296	</listitem>	6294	</listitem>
6297	</itemizedlist>	6295	</itemizedlist>
6298	</sect2>	6296	</sect2>
Lines 6336-6348 Link Here
6336		6334
6337	<para>If your application depends on KDE 4.x, set	6335	<para>If your application depends on KDE 4.x, set
6338	<makevar>USE_KDE4</makevar> to the list of required	6336	<makevar>USE_KDE4</makevar> to the list of required
6339	components. The most commonly used components are listed	6337	components. <literal>_build</literal> and <literal>_run</literal>
6340	below (up-to-date components are listed in	6338	suffixes can be used to force components dependency type
6341	<makevar>_USE_KDE4_ALL</makevar> in	6339	(e.g., <literal>baseapps_run</literal>). If no suffix is set,
		6340	a default dependency type will be used. If you want to force
		6341	both types, add the component twice with both suffixes
		6342	(e.g., <literal>automoc4_build automoc4_run</literal>).
		6343	The most commonly used components are listed below (up-to-date
		6344	components are documented at the top of
6342	<filename>/usr/ports/Mk/bsd.kde4.mk</filename>):</para>	6345	<filename>/usr/ports/Mk/bsd.kde4.mk</filename>):</para>
6343		6346
6344	<table frame="none">	6347	<table frame="none">
6345	<title>Available KDE4 Components</title>	6348	<title>Available KDE 4 Components</title>
6346		6349
6347	<tgroup cols="2">	6350	<tgroup cols="2">
6348	<thead>	6351	<thead>
Lines 6354-6389 Link Here
6354		6357
6355	<tbody>	6358	<tbody>
6356	<row>	6359	<row>
6357	<entry><literal>akonadi</literal></entry>	6360	<entry><literal>baseapps</literal></entry>
6358	<entry>Personal information management (PIM) storage	6361	<entry>Basic applications for KDE Desktop</entry>
6359	service</entry>
6360	</row>
6361
6362	<row>
6363	<entry><literal>automoc4</literal></entry>
6364	<entry>Makes port use automoc4 build tool</entry>
6365	</row>
6366
6367	<row>
6368	<entry><literal>kdebase</literal></entry>
6369	<entry>Basic KDE applications (Konqueror, Dolphin,
6370	Konsole)</entry>
6371	</row>
6372
6373	<row>
6374	<entry><literal>kdeexp</literal></entry>
6375	<entry>Experimental KDE libraries (with non-stable
6376	API)</entry>
6377	</row>	6362	</row>
6378		6363
6379	<row>	6364	<row>
6380	<entry><literal>kdehier</literal></entry>	6365	<entry><literal>kdehier</literal></entry>
6381	<entry>Provides common KDE directories</entry>	6366	<entry>Hierarchy of common KDE directories</entry>
6382	</row>	6367	</row>
6383		6368
6384	<row>	6369	<row>
6385	<entry><literal>kdelibs</literal></entry>	6370	<entry><literal>kdelibs</literal></entry>
6386	<entry>The base set of KDE libraries</entry>	6371	<entry>KDE Developer Platform</entry>
6387	</row>	6372	</row>
6388		6373
6389	<row>	6374	<row>
Lines 6395-6454 Link Here
6395		6380
6396	<row>	6381	<row>
6397	<entry><literal>pimlibs</literal></entry>	6382	<entry><literal>pimlibs</literal></entry>
6398	<entry>PIM libraries</entry>	6383	<entry>KDE-Pim libraries</entry>
6399	</row>	6384	</row>
6400		6385
6401	<row>	6386	<row>
6402	<entry><literal>workspace</literal></entry>	6387	<entry><literal>workspace</literal></entry>
6403	<entry>Applications and libraries which form desktop	6388	<entry>KDE user environments</entry>
6404	(Plasma, KWin)</entry>	6389	</row>
		6390
		6391	<row>
		6392	<entry><literal>akonadi</literal></entry>
		6393	<entry>Storage server for KDE-Pim</entry>
		6394	</row>
		6395
		6396	<row>
		6397	<entry><literal>automoc4</literal></entry>
		6398	<entry>Automatic moc for Qt 4 packages</entry>
6405	</row>	6399	</row>
6406	</tbody>	6400	</tbody>
6407	</tgroup>	6401	</tgroup>
6408	</table>	6402	</table>
6409		6403
6410	<para>KDE 4.x ports are installed into	6404	<para>KDE 4.x ports are installed into
6411	<literal>&dollar;{KDE4_PREFIX}</literal>, which is	6405	<makevar>KDE4_PREFIX</makevar>, which is
6412	<filename>/usr/local/kde4</filename> currently, to avoid	6406	<filename>/usr/local/kde4</filename> currently, to avoid
6413	conflicts with KDE 3.x ports. This is achieved by	6407	conflicts with KDE 3.x ports. This is achieved by
6414	specifying the <literal>kdeprefix</literal> component, which	6408	specifying the <literal>kdeprefix</literal> component, which
6415	overrides the default <makevar>PREFIX</makevar>. The ports	6409	overrides the default <makevar>PREFIX</makevar>. The ports
6416	however respect any <makevar>PREFIX</makevar> set via	6410	however respect any <makevar>PREFIX</makevar> set via
6417	<envar>MAKEFLAGS</envar> environment variable and/or	6411	<envar>MAKEFLAGS</envar> environment variable and/or
6418	<application>make</application> arguments.</para>	6412	<command>make</command> arguments.</para>
6419
6420	<para>KDE 4.x ports may conflict with KDE 3.x ports, so when
6421	the <literal>kdeprefix</literal> component is enabled, they
6422	are installed in <literal>&dollar;{KDE4_PREFIX}</literal>.
6423	The default value of <literal>KDE4_PREFIX</literal> is
6424	currently <filename>/usr/local/kde4</filename>. Installing
6425	the KDE 4.x ports into a custom <literal>PREFIX</literal> is
6426	also possible. When <literal>PREFIX</literal> is set via
6427	the <envar>MAKEFLAGS</envar> environment variable or via
6428	<application>make</application> options it overrides the
6429	value configured by <literal>kdeprefix</literal>.</para>
6430		6413
6431	<example id="kde4-components-example">	6414	<example id="kde4-components-example">
6432	<title><makevar>USE_KDE4</makevar> Example</title>	6415	<title><makevar>USE_KDE4</makevar> Example</title>
6433		6416
6434	<para>This is a simple example for KDE 4 port.	6417	<para>This is a simple example for a KDE 4 port.
6435	<makevar>USE_CMAKE</makevar> instructs port to utilize	6418	<makevar>USE_CMAKE</makevar> instructs the port to utilize
6436	<application>CMake</application> — configuration	6419	<application>CMake</application> — configuration
6437	tool widely spread among KDE 4 projects.	6420	tool widely spread among KDE 4 projects.
6438	<makevar>USE_KDE4</makevar> brings dependency on KDE	6421	<makevar>USE_KDE4</makevar> brings dependency on KDE
6439	libraries and makes port using	6422	libraries and makes port using
6440	<application>automoc4</application> at build stage.	6423	<command>automoc4</command> at build stage.
6441	Required KDE components and other dependencies can be	6424	Required KDE components and other dependencies can be
6442	determined through configure log.	6425	determined through configure log.
6443	<makevar>USE_KDE4</makevar> does not imply	6426	<makevar>USE_KDE4</makevar> does not imply
6444	<makevar>USE_QT_VER</makevar>. If a port requires some	6427	<makevar>USE_QT_VER</makevar>. If a port requires some
6445	Qt4 components, <makevar>USE_QT_VER</makevar> should be	6428	Qt 4 components, <makevar>USE_QT_VER</makevar> should be
6446	set and then needed components can be specified.</para>	6429	set and then needed components can be specified.</para>
6447		6430
6448	<programlisting>USE_CMAKE= yes	6431	<programlisting>USE_CMAKE= yes
6449	USE_KDE4= automoc4 kdelibs kdeprefix	6432	USE_KDE4= kdelibs kdeprefix automoc4
6450	USE_QT_VER= 4	6433	USE_QT_VER= 4
6451	QT_COMPONENTS= qmake_build moc_build rcc_build uic_build</programlisting>	6434	QT_COMPONENTS= moc_build qmake_build rcc_build uic_build</programlisting>
6452	</example>	6435	</example>
6453	</sect2>	6436	</sect2>
6454	</sect1>	6437	</sect1>