From owner-freebsd-doc@FreeBSD.ORG Tue Oct 8 15:40:00 2013 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id E4149727 for ; Tue, 8 Oct 2013 15:40:00 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C49152B76 for ; Tue, 8 Oct 2013 15:40:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id r98Fe0Xn023306 for ; Tue, 8 Oct 2013 15:40:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id r98Fe0On023292; Tue, 8 Oct 2013 15:40:00 GMT (envelope-from gnats) Resent-Date: Tue, 8 Oct 2013 15:40:00 GMT Resent-Message-Id: <201310081540.r98Fe0On023292@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:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 90D5DD9 for ; Tue, 8 Oct 2013 15:29:55 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from oldred.freebsd.org (oldred.freebsd.org [8.8.178.121]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 6DE122AB0 for ; Tue, 8 Oct 2013 15:29:55 +0000 (UTC) Received: from oldred.freebsd.org ([127.0.1.6]) by oldred.freebsd.org (8.14.5/8.14.7) with ESMTP id r98FTthf008780 for ; Tue, 8 Oct 2013 15:29:55 GMT (envelope-from nobody@oldred.freebsd.org) Received: (from nobody@localhost) by oldred.freebsd.org (8.14.5/8.14.5/Submit) id r98FTtXl008774; Tue, 8 Oct 2013 15:29:55 GMT (envelope-from nobody) Message-Id: <201310081529.r98FTtXl008774@oldred.freebsd.org> Date: Tue, 8 Oct 2013 15:29:55 GMT From: Max Brazhnikov To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Subject: docs/182833: [porters-handbook]: document QMake usage, update Qt section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 08 Oct 2013 15:40:01 -0000 >Number: 182833 >Category: docs >Synopsis: [porters-handbook]: document QMake usage, update Qt section >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Tue Oct 08 15:40:00 UTC 2013 >Closed-Date: >Last-Modified: >Originator: Max Brazhnikov >Release: FreeBSD 9.2-PRERELEASE amd64 >Organization: >Environment: >Description: Document new USES= qmake Remove Qt 3.x stuff http://people.freebsd.org/~makc/patches/ph-qmake.diff >How-To-Repeat: >Fix: Patch attached with submission follows: Index: en_US.ISO8859-1/books/porters-handbook/book.xml =================================================================== --- en_US.ISO8859-1/books/porters-handbook/book.xml (revision 42890) +++ en_US.ISO8859-1/books/porters-handbook/book.xml (working copy) @@ -6539,15 +6539,6 @@ - USE_QT_VER - 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 @@ -6648,19 +6639,7 @@ - When USE_QT_VER is set to - 3, some useful settings are passed to the - configure script: - - CONFIGURE_ARGS+= --with-qt-includes=${QT_PREFIX}/include \ - --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} - - If USE_QT4 is set, the following + When USE_QT4 is set, the following settings are deployed: CONFIGURE_ARGS+= --with-qt-includes=${QT_INCDIR} \ @@ -6677,7 +6656,7 @@ - Component Selection (Qt 4.x Only) + Component Selection Individual Qt 4 tool and library dependencies must be specified in the USE_QT4 variable. Every @@ -6847,29 +6826,60 @@ - - Additional Considerations + + Using <command>qmake</command> + + Variables for Ports That Use + <command>qmake</command> + + + + + Variable + Means + + + + + + QMAKE_ARGS + Port specific QMake + flags to be passed to the qmake + binary. + + + + QMAKE_ENV + Environment variables to be set for + qmake binary. Default is + ${CONFIGURE_ENV}. + + + + QMAKE_PRO + Name of the project .pro file. + Default is empty (using autodetection). + + + +
+ If the application does not provide a - configure file but a + configure script but a .pro file, you can use the following: - HAS_CONFIGURE= yes + USES= qmake +USE_QT4= qmake_build -do-configure: - @cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \ - ${QMAKE} ${QMAKEFLAGS} PREFIX=${PREFIX} texmaker.pro + USES= qmake instructs the port to + use qmake for configuring. + Note that USES= qmake does not imply + dependency on Qt 4 qmake, thus + USE_QT4 has to be populated with + qmake_build component. - Note the similarity to the qmake line - from the provided BUILD.sh script. - Passing CONFIGURE_ENV ensures - qmake will see the - QMAKESPEC variable, without which it - cannot work. qmake generates standard - Makefiles, so it is not necessary to write our own - build target. - Qt applications often are written to be cross-platform and often X11/Unix is not the platform they are developed on, which in turn often leads to certain loose ends, @@ -6885,8 +6895,8 @@ the include and library search paths via the command line, for example: - ${QMAKE} ${QMAKEFLAGS} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \ - LIBS+=-L${LOCALBASE}/lib sillyapp.pro + QMAKE_ARGS+= INCLUDEPATH+=${LOCALBASE}/include \ + LIBS+=-L${LOCALBASE}/lib Index: en_US.ISO8859-1/books/porters-handbook/uses.xml =================================================================== --- en_US.ISO8859-1/books/porters-handbook/uses.xml (revision 42890) +++ en_US.ISO8859-1/books/porters-handbook/uses.xml (working copy) @@ -179,6 +179,15 @@ + qmake + (none), norecursive + + The port will use QMake for + configuring. For more information see + . + + + readline (none), port Implies that the port uses >Release-Note: >Audit-Trail: >Unformatted: