From owner-freebsd-doc@FreeBSD.ORG Wed Sep 19 15:20:08 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AAE73106568F for ; Wed, 19 Sep 2012 15:20:07 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id CA3788FC17 for ; Wed, 19 Sep 2012 15:20:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q8JFK7vk041609 for ; Wed, 19 Sep 2012 15:20:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q8JFK7H9041608; Wed, 19 Sep 2012 15:20:07 GMT (envelope-from gnats) Resent-Date: Wed, 19 Sep 2012 15:20:07 GMT Resent-Message-Id: <201209191520.q8JFK7H9041608@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Max Brazhnikov Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 22D0D106564A for ; Wed, 19 Sep 2012 15:17:22 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 0DAAB8FC18 for ; Wed, 19 Sep 2012 15:17:22 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.5/8.14.5) with ESMTP id q8JFHLrS073233 for ; Wed, 19 Sep 2012 15:17:21 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.5/8.14.5/Submit) id q8JFHLCN073216; Wed, 19 Sep 2012 15:17:21 GMT (envelope-from nobody) Message-Id: <201209191517.q8JFHLCN073216@red.freebsd.org> Date: Wed, 19 Sep 2012 15:17:21 GMT From: Max Brazhnikov To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/171788: update porters handbook: Qt/KDE sections X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 19 Sep 2012 15:20:08 -0000 >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 @@ USE_QT_VER - The port uses the Qt toolkit. Possible values - are 3 and 4; - each specify the major version of Qt to use. + The port uses the Qt toolkit. The only possible + value is 3. Appropriate parameters are passed to configure script and make. + USE_QT4 + Specify tool and library dependencies for ports + that use Qt 4. See Qt 4 component + selection for more details. + + + QT_PREFIX Set to the path where Qt installed to (read-only variable). @@ -6300,12 +6306,6 @@ - QT_COMPONENTS - Specify tool and library dependencies for Qt 4. - See below for details. - - - UIC Set to the path of uic (read-only variable). @@ -6323,12 +6323,33 @@ qmake (read-only variable). + + + QMAKEFLAGS + Additional flags for + qmake. + + + + QT_INCDIR + Set to Qt 4 include directories (read-only variable). + + + + QT_LIBDIR + Set to Qt 4 libraries path (read-only variable). + + + + QT_PLUGINDIR + Set to Qt 4 plugins path (read-only variable). + - When USE_QT_VER is set, some useful - settings are passed to configure + When USE_QT_VER is set to 3 + some useful settings are passed to configure script: CONFIGURE_ARGS+= --with-qt-includes=${QT_PREFIX}/include \ @@ -6339,21 +6360,28 @@ QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}" CPPFLAGS+= ${QTCPPFLAGS} - If USE_QT_VER is set to - 4, the following settings are also - deployed: + If USE_QT4 is set the following + settings are deployed: - CONFIGURE_ENV+= UIC="${UIC}" QMAKE="${QMAKE}" QMAKESPEC="${QMAKESPEC}" -MAKE_ENV+= QMAKESPEC="${QMAKESPEC}" + 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} Component Selection (Qt 4.x Only) - When USE_QT_VER is set to - 4, individual Qt 4 tool and library - dependencies can be specified in the - QT_COMPONENTS variable. Every component + Individual Qt 4 tool and library + dependencies must be specified in the + USE_QT4 variable. Every component can be suffixed by either _build or _run, 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 _run suffix. The most commonly used components are listed below (all available components are - listed in _QT_COMPONENTS_ALL in + listed in _USE_QT4_ALL in /usr/ports/Mk/bsd.qt.mk): @@ -6517,8 +6545,7 @@ only needed at buildtime, thus they are specified with the _build suffix: - USE_QT_VER= 4 -QT_COMPONENTS= gui moc_build qmake_build rcc_build uic_build + USE_QT4= gui moc_build qmake_build rcc_build uic_build @@ -6534,7 +6561,7 @@ do-configure: @cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \ - ${QMAKE} PREFIX=${PREFIX} texmaker.pro + ${QMAKE} ${QMAKEFLAGS} PREFIX=${PREFIX} texmaker.proNote the similarity to the qmake line from the provided BUILD.sh script. @@ -6560,7 +6587,7 @@ the include and library search paths via the command line, for example: - ${QMAKE} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \ + ${QMAKE} ${QMAKEFLAGS} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \ LIBS+=-L${LOCALBASE}/lib sillyapp.pro @@ -6642,11 +6669,6 @@ - baseapps - Basic applications for KDE Desktop - - - kdehier Hierarchy of common KDE directories @@ -6664,13 +6686,13 @@ - pimlibs - KDE-Pim libraries + sharedmime + MIME types database for KDE ports - workspace - KDE user environments + automoc4 + Automatic moc for Qt 4 packages @@ -6679,9 +6701,99 @@ - automoc4 - Automatic moc for Qt 4 packages + soprano + Qt 4 RDF framework + + + strigi + Desktop search daemon + + + + libkcddb + KDE CDDB library + + + + libkcompactdisc + KDE library for interfacing with audio CDs + + + + libkdeedu + Libraries used by educational applications + + + + libkdcraw + KDE LibRaw library + + + + libkexiv2 + KDE Exiv2 library + + + + libkipi + KDE Image Plugin Interface + + + + libkonq + Konqueror core library + + + + libksane + KDE SANE ("Scanner Access Now Easy") library + + + + pimlibs + KDE-Pim libraries + + + + kate + Text editor framework + + + + marble + Virtual globe + + + + okular + Universal document viewer + + + + korundum + KDE Ruby bindings + + + + perlkde + KDE Perl bindings + + + + pykde4 + KDE Python bindings + + + + pykdeuic4 + PyKDE user interface compiler + + + + smokekde + KDE SMOKE libraries +
@@ -6709,14 +6821,13 @@ Required KDE components and other dependencies can be determined through configure log. USE_KDE4 does not imply - USE_QT_VER. If a port requires some - Qt 4 components, USE_QT_VER should be - set and then needed components can be specified. + USE_QT4. If a port requires some + Qt 4 components, they should be specified in + USE_QT4. USE_CMAKE= yes USE_KDE4= kdelibs kdeprefix automoc4 -USE_QT_VER= 4 -QT_COMPONENTS= moc_build qmake_build rcc_build uic_build +USE_QT4= moc_build qmake_build rcc_build uic_build >Release-Note: >Audit-Trail: >Unformatted: