os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Split Qt and KDE sections

Browse source 
- Add notes About KDE 4

PR:		docs/138283
Submitted by:	makc
Approved by:	pav
This commit is contained in:
Thomas Abthorpe 2009-09-30 15:06:38 +00:00
parent e66811cfe6
commit 1fe8c80dd6
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=34746
1 changed files with 138 additions and 35 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

173
en_US.ISO8859-1/books/porters-handbook/book.sgml
View file

@ -5427,42 +5427,10 @@ USE_XORG= x11 xpm</programlisting>
</sect1>
<sect1 id="using-kde">
<title>Using KDE</title>
<sect1 id="using-qt">
<title>Using Qt</title>
<sect2 id="kde-variables">
<title>Variable definitions</title>
<table frame="none">
<title>Variables for ports that use KDE</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="kde-qt">
<sect2 id="qt-common">
<title>Ports that require Qt</title>
<table frame="none">
@ -5809,6 +5777,141 @@ do-configure:
</sect1>
<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-variables">
<title>KDE 4 variable definitions</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>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>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>
<sect1 id="using-java">
<title>Using Java</title>