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

Document new bsd.qt.mk features

Browse source
This commit is contained in:
Michael Nottebrock 2007-08-02 22:38:49 +00:00
parent 1779758ec5
commit 69bb1e33cf
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=30575
1 changed files with 28 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -5620,10 +5620,16 @@ MAKE_ENV+= QMAKESPEC="${QMAKESPEC}"</programlisting>
<title>Component selection (Qt 4.x only)</title>
<para>When <makevar>USE_QT_VER</makevar> is set to 4, individual
Qt4 tool and library can be specified in the
<makevar>QT_COMPONENTS</makevar> variable. Most important
components are listed below (all components are listed in
<makevar>_QT_COMPONENTS_ALL</makevar> of
Qt4 tool and library dependencies can be specified in the
<makevar>QT_COMPONENTS</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, respectively. If unsuffixed, the component will be
depended on at both build- and runtime. Usually, library components
should be specified unsuffixed and tool components should be
specified with the <literal>_build</literal> suffix. The most commonly
used components are listed below (all available components are
listed in <makevar>_QT_COMPONENTS_ALL</makevar> in
<filename>/usr/ports/Mk/bsd.qt.mk</filename>):</para>
<table frame="none">
@ -5706,26 +5712,27 @@ MAKE_ENV+= QMAKESPEC="${QMAKESPEC}"</programlisting>
<tbody>
<row>
<entry><literal>moc</literal></entry>
<entry>meta object compiler (you need it for almost
every Qt applications)</entry>
<entry>meta object compiler (needed for almost
every Qt application at buildtime)</entry>
</row>
<row>
<entry><literal>qmake</literal></entry>
<entry>build utility of the Qt project</entry>
<entry>Makefile generator / build utility</entry>
</row>
<row>
<entry><literal>rcc</literal></entry>
<entry>resource compiler (if application has
<filename>*.rc</filename> or <filename>*.qrc</filename>
<entry>resource compiler (need if the application comes
with <filename>*.rc</filename> or <filename>*.qrc</filename>
files)</entry>
</row>
<row>
<entry><literal>uic</literal></entry>
<entry>user interface compiler (if the application
uses GUI)</entry>
<entry>user interface compiler (needed if the application
comes with <filename>*.ui</filename> files created by Qt Designer
- in practice, every Qt application with a GUI)</entry>
</row>
</tbody>
@ -5763,13 +5770,18 @@ MAKE_ENV+= QMAKESPEC="${QMAKESPEC}"</programlisting>
<example id="qt4-components-example">
<title>Selecting Qt4 components</title>
<para>The following fragment is from the port
<filename role="package">editors/texmaker</filename> which
uses Qt4 graphical user interface library (it also implies
it uses the core library) and building tools:</para>
<para>In this example, the ported application uses the
Qt4 graphical user interface library, the Qt4 core
library, all of the Qt4 code generation tools and Qt4's
Makefile generator. Since the gui library implies a
dependency on the core library, corelib does
not need to be specified. The Qt4 code generation
tools moc, uic and rcc, as well as the Makefile generator
qmake are only needed at buildtime, thus they are specified
with the <literal>_build</literal> suffix:</para>
<programlisting>USE_QT_VER= 4
QT_COMPONENTS= gui moc qmake rcc uic</programlisting>
QT_COMPONENTS= gui moc_build qmake_build rcc_build uic_build</programlisting>
</example>
</sect2>