Date: Fri, 22 Nov 2013 17:17:10 +0000 (UTC) From: Rene Ladan <rene@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43218 - head/en_US.ISO8859-1/books/porters-handbook Message-ID: <201311221717.rAMHHAiN072908@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: rene Date: Fri Nov 22 17:17:10 2013 New Revision: 43218 URL: http://svnweb.freebsd.org/changeset/doc/43218 Log: - Document new USES=qmake in the USES list - Remove texts about Qt 3.X - Update texts about Qt 4.X, describing new variables and integrating USES=qmake PR: docs/182833 (small language/DocBook modifications) Submitted by: makc Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml head/en_US.ISO8859-1/books/porters-handbook/uses.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Fri Nov 22 16:34:57 2013 (r43217) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Fri Nov 22 17:17:10 2013 (r43218) @@ -5715,7 +5715,7 @@ IGNORE= may not be redistributed because <row> <entry><varname>CMAKE_ENV</varname></entry> - <entry>Environment variables to be set for + <entry>Environment variables to be set for the <command>cmake</command> binary. Default is <literal>${CONFIGURE_ENV}</literal>.</entry> </row> @@ -6544,15 +6544,6 @@ USE_XORG= x11 xpm</programlisting> <tgroup cols="2"> <tbody> <row> - <entry><varname>USE_QT_VER</varname></entry> - <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><varname>USE_QT4</varname></entry> <entry>Specify tool and library dependencies for ports that use Qt 4. See @@ -6653,19 +6644,7 @@ USE_XORG= x11 xpm</programlisting> </tgroup> </table> - <para>When <varname>USE_QT_VER</varname> is set to - <literal>3</literal>, some useful settings are passed to the - <command>configure</command> script:</para> - - <programlisting>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}</programlisting> - - <para>If <varname>USE_QT4</varname> is set, the following + <para>When <varname>USE_QT4</varname> is set, the following settings are deployed:</para> <programlisting>CONFIGURE_ARGS+= --with-qt-includes=${QT_INCDIR} \ @@ -6682,7 +6661,7 @@ PLIST_SUB+= QT_INCDIR_REL=${QT_INCDIR_RE </sect2> <sect2 xml:id="qt4-components"> - <title>Component Selection (Qt 4.x Only)</title> + <title>Component Selection</title> <para>Individual Qt 4 tool and library dependencies must be specified in the <varname>USE_QT4</varname> variable. Every @@ -6852,28 +6831,59 @@ PLIST_SUB+= QT_INCDIR_REL=${QT_INCDIR_RE </example> </sect2> - <sect2 xml:id="qt-additional"> - <title>Additional Considerations</title> + <sect2 xml:id="using-qmake"> + <title>Using <command>qmake</command></title> + + <table frame="none"> + <title>Variables for Ports That Use + <command>qmake</command></title> + + <tgroup cols="2"> + <thead> + <row> + <entry>Variable</entry> + <entry>Means</entry> + </row> + </thead> + + <tbody> + <row> + <entry><varname>QMAKE_ARGS</varname></entry> + <entry>Port specific <application>QMake</application> + flags to be passed to the <command>qmake</command> + binary.</entry> + </row> + + <row> + <entry><varname>QMAKE_ENV</varname></entry> + <entry>Environment variables to be set for the + <command>qmake</command> binary. The default is + <literal>${CONFIGURE_ENV}</literal>.</entry> + </row> + + <row> + <entry><varname>QMAKE_PRO</varname></entry> + <entry>Name of the project <filename>.pro</filename> file. + The default is empty (using autodetection).</entry> + </row> + </tbody> + </tgroup> + </table> <para>If the application does not provide a - <filename>configure</filename> file but a + <filename>configure</filename> script but a <filename>.pro</filename> file, you can use the following:</para> - <programlisting>HAS_CONFIGURE= yes + <programlisting>USES= qmake +USE_QT4= qmake_build</programlisting> -do-configure: - @cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \ - ${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. - Passing <varname>CONFIGURE_ENV</varname> ensures - <command>qmake</command> will see the - <varname>QMAKESPEC</varname> variable, without which it - cannot work. <command>qmake</command> generates standard - Makefiles, so it is not necessary to write our own - <buildtarget>build</buildtarget> target.</para> + <para><literal>USES=qmake</literal> instructs the port to + use <command>qmake</command> for configuring. + Note that <literal>USES=qmake</literal> does not imply a + dependency on Qt 4 <command>qmake</command>, thus + <literal>USE_QT4</literal> has to be populated with the + <literal>qmake_build</literal> component.</para> <para>Qt applications often are written to be cross-platform and often X11/Unix is not the platform they are developed @@ -6890,8 +6900,8 @@ do-configure: the include and library search paths via the command line, for example:</para> - <programlisting>${QMAKE} ${QMAKEFLAGS} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \ - LIBS+=-L${LOCALBASE}/lib sillyapp.pro</programlisting> + <programlisting>QMAKE_ARGS+= INCLUDEPATH+=${LOCALBASE}/include \ + LIBS+=-L${LOCALBASE}/lib</programlisting> </listitem> <listitem> Modified: head/en_US.ISO8859-1/books/porters-handbook/uses.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses.xml Fri Nov 22 16:34:57 2013 (r43217) +++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml Fri Nov 22 17:17:10 2013 (r43218) @@ -282,6 +282,15 @@ </row> <row> + <entry><literal>qmake</literal></entry> + <entry>(none), <literal>norecursive</literal></entry> + + <entry>The port will use <application>QMake</application> for + configuring. For more information see + <xref linkend="using-qmake"/>.</entry> +</row> + +<row> <entry><literal>readline</literal></entry> <entry>(none), port</entry> <entry>Implies that the port uses
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201311221717.rAMHHAiN072908>