Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 19 Sep 2012 15:17:21 GMT
From:      Max Brazhnikov <makc@FreeBSD.org>
To:        freebsd-gnats-submit@FreeBSD.org
Subject:   docs/171788: update porters handbook: Qt/KDE sections
Message-ID:  <201209191517.q8JFHLCN073216@red.freebsd.org>
Resent-Message-ID: <201209191520.q8JFK7H9041608@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         171788
>Category:       docs
>Synopsis:       update porters handbook: Qt/KDE sections
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Wed Sep 19 15:20:07 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Max Brazhnikov
>Release:        
>Organization:
>Environment:
>Description:
Update Qt/KDE sections
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: en_US.ISO8859-1/books/porters-handbook/book.sgml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/book.sgml	(revision 39578)
+++ en_US.ISO8859-1/books/porters-handbook/book.sgml	(working copy)
@@ -6244,15 +6244,21 @@
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_QT_VER</makevar></entry>
-		<entry>The port uses the Qt toolkit.  Possible values
-		  are <literal>3</literal> and <literal>4</literal>;
-		  each specify the major version of Qt to use.
+		<entry>The port uses the Qt toolkit.  The only possible
+		  value is <literal>3</literal>.
 		  Appropriate parameters are passed to
 		  <command>configure</command> script and
 		  <command>make</command>.</entry>
 	      </row>
 
 	      <row>
+		<entry><makevar>USE_QT4</makevar></entry>
+		<entry>Specify tool and library dependencies for ports
+		that use Qt 4. See <link linkend="qt4-components"> Qt 4 component
+		selection</link> for more details.</entry>
+	      </row>
+
+	      <row>
 		<entry><makevar>QT_PREFIX</makevar></entry>
 		<entry>Set to the path where Qt installed to
 		  (read-only variable).</entry>
@@ -6300,12 +6306,6 @@
 	  <tgroup cols="2">
 	    <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>
@@ -6323,12 +6323,33 @@
 		  <command>qmake</command> (read-only
 		  variable).</entry>
 	      </row>
+
+	      <row>
+		<entry><makevar>QMAKEFLAGS</makevar></entry>
+		<entry>Additional flags for
+		  <command>qmake</command>.</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>QT_INCDIR</makevar></entry>
+		<entry>Set to Qt 4 include directories (read-only variable).</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>QT_LIBDIR</makevar></entry>
+		<entry>Set to Qt 4 libraries path (read-only variable).</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>QT_PLUGINDIR</makevar></entry>
+		<entry>Set to Qt 4 plugins path (read-only variable).</entry>
+	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
-	<para>When <makevar>USE_QT_VER</makevar> is set, some useful
-	  settings are passed to <command>configure</command>
+	<para>When <makevar>USE_QT_VER</makevar> is set to <literal>3</literal>
+	  some useful settings are passed to <command>configure</command>
 	  script:</para>
 
 	<programlisting>CONFIGURE_ARGS+=	--with-qt-includes=${QT_PREFIX}/include \
@@ -6339,21 +6360,28 @@
 		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
-	  deployed:</para>
+	<para>If <makevar>USE_QT4</makevar> is set the following
+	  settings are deployed:</para>
 
-	<programlisting>CONFIGURE_ENV+=	UIC="${UIC}" QMAKE="${QMAKE}" QMAKESPEC="${QMAKESPEC}"
-MAKE_ENV+=	QMAKESPEC="${QMAKESPEC}"</programlisting>
+	<programlisting>CONFIGURE_ARGS+=	--with-qt-includes=${QT_INCDIR} \
+			--with-qt-libraries=${QT_LIBDIR} \
+			--with-extra-libs=${LOCALBASE}/lib \
+			--with-extra-includes=${LOCALBASE}/include
+CONFIGURE_ENV+=	MOC="${MOC}" UIC="${UIC}" LIBS="${QTCFGLIBS}" \
+		QMAKE="${QMAKE}" QMAKESPEC="${QMAKESPEC}" QTDIR="${QT_PREFIX}"
+MAKE_ENV+=	QMAKESPEC="${QMAKESPEC}"
+
+PLIST_SUB+=	QT_INCDIR_REL=${QT_INCDIR_REL} \
+		QT_LIBDIR_REL=${QT_LIBDIR_REL} \
+		QT_PLUGINDIR_REL=${QT_PLUGINDIR_REL}</programlisting>
       </sect2>
 
       <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
+	<para>Individual Qt 4 tool and library
+	  dependencies must be specified in the
+	  <makevar>USE_QT4</makevar> variable.  Every component
 	  can be suffixed by either <literal>_build</literal> or
 	  <literal>_run</literal>, the suffix indicating whether the
 	  component should be depended on at buildtime or runtime,
@@ -6364,7 +6392,7 @@
 	  plugin components should be specified with the
 	  <literal>_run</literal> suffix.  The most commonly used
 	  components are listed below (all available components are
-	  listed in <makevar>_QT_COMPONENTS_ALL</makevar> in
+	  listed in <makevar>_USE_QT4_ALL</makevar> in
 	  <filename>/usr/ports/Mk/bsd.qt.mk</filename>):</para>
 
 	<table frame="none">
@@ -6517,8 +6545,7 @@
 	    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>
+	  <programlisting>USE_QT4=	gui moc_build qmake_build rcc_build uic_build</programlisting>
 	</example>
       </sect2>
 
@@ -6534,7 +6561,7 @@
 
 do-configure:
 	@cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \
-		${QMAKE} PREFIX=${PREFIX} texmaker.pro</programlisting>
+		${QMAKE} ${QMAKEFLAGS} PREFIX=${PREFIX} texmaker.pro</programlisting>
 
 	<para>Note the similarity to the <command>qmake</command> line
 	  from the provided <filename>BUILD.sh</filename> script.
@@ -6560,7 +6587,7 @@
 	      the include and library search paths via the command
 	      line, for example:</para>
 
-	    <programlisting>${QMAKE} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \
+	    <programlisting>${QMAKE} ${QMAKEFLAGS} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \
 	LIBS+=-L${LOCALBASE}/lib sillyapp.pro</programlisting>
 	  </listitem>
 
@@ -6642,11 +6669,6 @@
 
 	    <tbody>
 	      <row>
-		<entry><literal>baseapps</literal></entry>
-		<entry>Basic applications for KDE Desktop</entry>
-	      </row>
-
-	      <row>
 		<entry><literal>kdehier</literal></entry>
 		<entry>Hierarchy of common KDE directories</entry>
 	      </row>
@@ -6664,13 +6686,13 @@
 	      </row>
 
 	      <row>
-		<entry><literal>pimlibs</literal></entry>
-		<entry>KDE-Pim libraries</entry>
+		<entry><literal>sharedmime</literal></entry>
+		<entry>MIME types database for KDE ports</entry>
 	      </row>
 
 	      <row>
-		<entry><literal>workspace</literal></entry>
-		<entry>KDE user environments</entry>
+		<entry><literal>automoc4</literal></entry>
+		<entry>Automatic moc for Qt 4 packages</entry>
 	      </row>
 
 	      <row>
@@ -6679,9 +6701,99 @@
 	      </row>
 
 	      <row>
-		<entry><literal>automoc4</literal></entry>
-		<entry>Automatic moc for Qt 4 packages</entry>
+		<entry><literal>soprano</literal></entry>
+		<entry>Qt 4 RDF framework</entry>
 	      </row>
+
+	      <row>
+		<entry><literal>strigi</literal></entry>
+		<entry>Desktop search daemon</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>libkcddb</literal></entry>
+		<entry>KDE CDDB library</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>libkcompactdisc</literal></entry>
+		<entry>KDE library for interfacing with audio CDs</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>libkdeedu</literal></entry>
+		<entry>Libraries used by educational applications</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>libkdcraw</literal></entry>
+		<entry>KDE LibRaw library</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>libkexiv2</literal></entry>
+		<entry>KDE Exiv2 library</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>libkipi</literal></entry>
+		<entry> KDE Image Plugin Interface</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>libkonq</literal></entry>
+		<entry>Konqueror core library</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>libksane</literal></entry>
+		<entry>KDE SANE ("Scanner Access Now Easy") library</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>pimlibs</literal></entry>
+		<entry>KDE-Pim libraries</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>kate</literal></entry>
+		<entry>Text editor framework</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>marble</literal></entry>
+		<entry>Virtual globe</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>okular</literal></entry>
+		<entry>Universal document viewer</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>korundum</literal></entry>
+		<entry>KDE Ruby bindings</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>perlkde</literal></entry>
+		<entry>KDE Perl bindings</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>pykde4</literal></entry>
+		<entry>KDE Python bindings</entry>
+	      </row>
+
+	      <row>
+		<entry><literal>pykdeuic4</literal></entry>
+		<entry>PyKDE user interface compiler</entry>
+	      </row>
+
+	      <row>
+		<entry>smokekde<literal></literal></entry>
+		<entry>KDE SMOKE libraries</entry>
+	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
@@ -6709,14 +6821,13 @@
 	    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>
+	    <makevar>USE_QT4</makevar>.  If a port requires some
+	    Qt 4 components, they should be specified in 
+	    <makevar>USE_QT4</makevar>.</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>
+USE_QT4=	moc_build qmake_build rcc_build uic_build</programlisting>
 	</example>
       </sect2>
     </sect1>


>Release-Note:
>Audit-Trail:
>Unformatted:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201209191517.q8JFHLCN073216>