View | Details | Raw Unified | Return to bug 171788
Collapse All | Expand All

(-)en_US.ISO8859-1/books/porters-handbook/book.sgml (-41 / +152 lines)
Lines 6244-6258 Link Here
6244
	    <tbody>
6244
	    <tbody>
6245
	      <row>
6245
	      <row>
6246
		<entry><makevar>USE_QT_VER</makevar></entry>
6246
		<entry><makevar>USE_QT_VER</makevar></entry>
6247
		<entry>The port uses the Qt toolkit.  Possible values
6247
		<entry>The port uses the Qt toolkit.  The only possible
6248
		  are <literal>3</literal> and <literal>4</literal>;
6248
		  value is <literal>3</literal>.
6249
		  each specify the major version of Qt to use.
6250
		  Appropriate parameters are passed to
6249
		  Appropriate parameters are passed to
6251
		  <command>configure</command> script and
6250
		  <command>configure</command> script and
6252
		  <command>make</command>.</entry>
6251
		  <command>make</command>.</entry>
6253
	      </row>
6252
	      </row>
6254
6253
6255
	      <row>
6254
	      <row>
6255
		<entry><makevar>USE_QT4</makevar></entry>
6256
		<entry>Specify tool and library dependencies for ports
6257
		that use Qt 4. See <link linkend="qt4-components"> Qt 4 component
6258
		selection</link> for more details.</entry>
6259
	      </row>
6260
6261
	      <row>
6256
		<entry><makevar>QT_PREFIX</makevar></entry>
6262
		<entry><makevar>QT_PREFIX</makevar></entry>
6257
		<entry>Set to the path where Qt installed to
6263
		<entry>Set to the path where Qt installed to
6258
		  (read-only variable).</entry>
6264
		  (read-only variable).</entry>
Lines 6300-6311 Link Here
6300
	  <tgroup cols="2">
6306
	  <tgroup cols="2">
6301
	    <tbody>
6307
	    <tbody>
6302
	      <row>
6308
	      <row>
6303
		<entry><makevar>QT_COMPONENTS</makevar></entry>
6304
		<entry>Specify tool and library dependencies for Qt 4.
6305
		  See below for details.</entry>
6306
	      </row>
6307
6308
	      <row>
6309
		<entry><makevar>UIC</makevar></entry>
6309
		<entry><makevar>UIC</makevar></entry>
6310
		<entry>Set to the path of <command>uic</command>
6310
		<entry>Set to the path of <command>uic</command>
6311
		  (read-only variable).</entry>
6311
		  (read-only variable).</entry>
Lines 6323-6334 Link Here
6323
		  <command>qmake</command> (read-only
6323
		  <command>qmake</command> (read-only
6324
		  variable).</entry>
6324
		  variable).</entry>
6325
	      </row>
6325
	      </row>
6326
6327
	      <row>
6328
		<entry><makevar>QMAKEFLAGS</makevar></entry>
6329
		<entry>Additional flags for
6330
		  <command>qmake</command>.</entry>
6331
	      </row>
6332
6333
	      <row>
6334
		<entry><makevar>QT_INCDIR</makevar></entry>
6335
		<entry>Set to Qt 4 include directories (read-only variable).</entry>
6336
	      </row>
6337
6338
	      <row>
6339
		<entry><makevar>QT_LIBDIR</makevar></entry>
6340
		<entry>Set to Qt 4 libraries path (read-only variable).</entry>
6341
	      </row>
6342
6343
	      <row>
6344
		<entry><makevar>QT_PLUGINDIR</makevar></entry>
6345
		<entry>Set to Qt 4 plugins path (read-only variable).</entry>
6346
	      </row>
6326
	    </tbody>
6347
	    </tbody>
6327
	  </tgroup>
6348
	  </tgroup>
6328
	</table>
6349
	</table>
6329
6350
6330
	<para>When <makevar>USE_QT_VER</makevar> is set, some useful
6351
	<para>When <makevar>USE_QT_VER</makevar> is set to <literal>3</literal>
6331
	  settings are passed to <command>configure</command>
6352
	  some useful settings are passed to <command>configure</command>
6332
	  script:</para>
6353
	  script:</para>
6333
6354
6334
	<programlisting>CONFIGURE_ARGS+=	--with-qt-includes=${QT_PREFIX}/include \
6355
	<programlisting>CONFIGURE_ARGS+=	--with-qt-includes=${QT_PREFIX}/include \
Lines 6339-6359 Link Here
6339
		QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}"
6360
		QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}"
6340
CPPFLAGS+=	${QTCPPFLAGS}</programlisting>
6361
CPPFLAGS+=	${QTCPPFLAGS}</programlisting>
6341
6362
6342
	<para>If <makevar>USE_QT_VER</makevar> is set to
6363
	<para>If <makevar>USE_QT4</makevar> is set the following
6343
	  <literal>4</literal>, the following settings are also
6364
	  settings are deployed:</para>
6344
	  deployed:</para>
6345
6365
6346
	<programlisting>CONFIGURE_ENV+=	UIC="${UIC}" QMAKE="${QMAKE}" QMAKESPEC="${QMAKESPEC}"
6366
	<programlisting>CONFIGURE_ARGS+=	--with-qt-includes=${QT_INCDIR} \
6347
MAKE_ENV+=	QMAKESPEC="${QMAKESPEC}"</programlisting>
6367
			--with-qt-libraries=${QT_LIBDIR} \
6368
			--with-extra-libs=${LOCALBASE}/lib \
6369
			--with-extra-includes=${LOCALBASE}/include
6370
CONFIGURE_ENV+=	MOC="${MOC}" UIC="${UIC}" LIBS="${QTCFGLIBS}" \
6371
		QMAKE="${QMAKE}" QMAKESPEC="${QMAKESPEC}" QTDIR="${QT_PREFIX}"
6372
MAKE_ENV+=	QMAKESPEC="${QMAKESPEC}"
6373
6374
PLIST_SUB+=	QT_INCDIR_REL=${QT_INCDIR_REL} \
6375
		QT_LIBDIR_REL=${QT_LIBDIR_REL} \
6376
		QT_PLUGINDIR_REL=${QT_PLUGINDIR_REL}</programlisting>
6348
      </sect2>
6377
      </sect2>
6349
6378
6350
      <sect2 id="qt4-components">
6379
      <sect2 id="qt4-components">
6351
	<title>Component Selection (Qt 4.x Only)</title>
6380
	<title>Component Selection (Qt 4.x Only)</title>
6352
6381
6353
	<para>When <makevar>USE_QT_VER</makevar> is set to
6382
	<para>Individual Qt 4 tool and library
6354
	  <literal>4</literal>, individual Qt 4 tool and library
6383
	  dependencies must be specified in the
6355
	  dependencies can be specified in the
6384
	  <makevar>USE_QT4</makevar> variable.  Every component
6356
	  <makevar>QT_COMPONENTS</makevar> variable.  Every component
6357
	  can be suffixed by either <literal>_build</literal> or
6385
	  can be suffixed by either <literal>_build</literal> or
6358
	  <literal>_run</literal>, the suffix indicating whether the
6386
	  <literal>_run</literal>, the suffix indicating whether the
6359
	  component should be depended on at buildtime or runtime,
6387
	  component should be depended on at buildtime or runtime,
Lines 6364-6370 Link Here
6364
	  plugin components should be specified with the
6392
	  plugin components should be specified with the
6365
	  <literal>_run</literal> suffix.  The most commonly used
6393
	  <literal>_run</literal> suffix.  The most commonly used
6366
	  components are listed below (all available components are
6394
	  components are listed below (all available components are
6367
	  listed in <makevar>_QT_COMPONENTS_ALL</makevar> in
6395
	  listed in <makevar>_USE_QT4_ALL</makevar> in
6368
	  <filename>/usr/ports/Mk/bsd.qt.mk</filename>):</para>
6396
	  <filename>/usr/ports/Mk/bsd.qt.mk</filename>):</para>
6369
6397
6370
	<table frame="none">
6398
	<table frame="none">
Lines 6517-6524 Link Here
6517
	    only needed at buildtime, thus they are specified with the
6545
	    only needed at buildtime, thus they are specified with the
6518
	    <literal>_build</literal> suffix:</para>
6546
	    <literal>_build</literal> suffix:</para>
6519
6547
6520
	  <programlisting>USE_QT_VER=	4
6548
	  <programlisting>USE_QT4=	gui moc_build qmake_build rcc_build uic_build</programlisting>
6521
QT_COMPONENTS=	gui moc_build qmake_build rcc_build uic_build</programlisting>
6522
	</example>
6549
	</example>
6523
      </sect2>
6550
      </sect2>
6524
6551
Lines 6534-6540 Link Here
6534
6561
6535
do-configure:
6562
do-configure:
6536
	@cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \
6563
	@cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \
6537
		${QMAKE} PREFIX=${PREFIX} texmaker.pro</programlisting>
6564
		${QMAKE} ${QMAKEFLAGS} PREFIX=${PREFIX} texmaker.pro</programlisting>
6538
6565
6539
	<para>Note the similarity to the <command>qmake</command> line
6566
	<para>Note the similarity to the <command>qmake</command> line
6540
	  from the provided <filename>BUILD.sh</filename> script.
6567
	  from the provided <filename>BUILD.sh</filename> script.
Lines 6560-6566 Link Here
6560
	      the include and library search paths via the command
6587
	      the include and library search paths via the command
6561
	      line, for example:</para>
6588
	      line, for example:</para>
6562
6589
6563
	    <programlisting>${QMAKE} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \
6590
	    <programlisting>${QMAKE} ${QMAKEFLAGS} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \
6564
	LIBS+=-L${LOCALBASE}/lib sillyapp.pro</programlisting>
6591
	LIBS+=-L${LOCALBASE}/lib sillyapp.pro</programlisting>
6565
	  </listitem>
6592
	  </listitem>
6566
6593
Lines 6642-6652 Link Here
6642
6669
6643
	    <tbody>
6670
	    <tbody>
6644
	      <row>
6671
	      <row>
6645
		<entry><literal>baseapps</literal></entry>
6646
		<entry>Basic applications for KDE Desktop</entry>
6647
	      </row>
6648
6649
	      <row>
6650
		<entry><literal>kdehier</literal></entry>
6672
		<entry><literal>kdehier</literal></entry>
6651
		<entry>Hierarchy of common KDE directories</entry>
6673
		<entry>Hierarchy of common KDE directories</entry>
6652
	      </row>
6674
	      </row>
Lines 6664-6676 Link Here
6664
	      </row>
6686
	      </row>
6665
6687
6666
	      <row>
6688
	      <row>
6667
		<entry><literal>pimlibs</literal></entry>
6689
		<entry><literal>sharedmime</literal></entry>
6668
		<entry>KDE-Pim libraries</entry>
6690
		<entry>MIME types database for KDE ports</entry>
6669
	      </row>
6691
	      </row>
6670
6692
6671
	      <row>
6693
	      <row>
6672
		<entry><literal>workspace</literal></entry>
6694
		<entry><literal>automoc4</literal></entry>
6673
		<entry>KDE user environments</entry>
6695
		<entry>Automatic moc for Qt 4 packages</entry>
6674
	      </row>
6696
	      </row>
6675
6697
6676
	      <row>
6698
	      <row>
Lines 6679-6687 Link Here
6679
	      </row>
6701
	      </row>
6680
6702
6681
	      <row>
6703
	      <row>
6682
		<entry><literal>automoc4</literal></entry>
6704
		<entry><literal>soprano</literal></entry>
6683
		<entry>Automatic moc for Qt 4 packages</entry>
6705
		<entry>Qt 4 RDF framework</entry>
6684
	      </row>
6706
	      </row>
6707
6708
	      <row>
6709
		<entry><literal>strigi</literal></entry>
6710
		<entry>Desktop search daemon</entry>
6711
	      </row>
6712
6713
	      <row>
6714
		<entry><literal>libkcddb</literal></entry>
6715
		<entry>KDE CDDB library</entry>
6716
	      </row>
6717
6718
	      <row>
6719
		<entry><literal>libkcompactdisc</literal></entry>
6720
		<entry>KDE library for interfacing with audio CDs</entry>
6721
	      </row>
6722
6723
	      <row>
6724
		<entry><literal>libkdeedu</literal></entry>
6725
		<entry>Libraries used by educational applications</entry>
6726
	      </row>
6727
6728
	      <row>
6729
		<entry><literal>libkdcraw</literal></entry>
6730
		<entry>KDE LibRaw library</entry>
6731
	      </row>
6732
6733
	      <row>
6734
		<entry><literal>libkexiv2</literal></entry>
6735
		<entry>KDE Exiv2 library</entry>
6736
	      </row>
6737
6738
	      <row>
6739
		<entry><literal>libkipi</literal></entry>
6740
		<entry> KDE Image Plugin Interface</entry>
6741
	      </row>
6742
6743
	      <row>
6744
		<entry><literal>libkonq</literal></entry>
6745
		<entry>Konqueror core library</entry>
6746
	      </row>
6747
6748
	      <row>
6749
		<entry><literal>libksane</literal></entry>
6750
		<entry>KDE SANE ("Scanner Access Now Easy") library</entry>
6751
	      </row>
6752
6753
	      <row>
6754
		<entry><literal>pimlibs</literal></entry>
6755
		<entry>KDE-Pim libraries</entry>
6756
	      </row>
6757
6758
	      <row>
6759
		<entry><literal>kate</literal></entry>
6760
		<entry>Text editor framework</entry>
6761
	      </row>
6762
6763
	      <row>
6764
		<entry><literal>marble</literal></entry>
6765
		<entry>Virtual globe</entry>
6766
	      </row>
6767
6768
	      <row>
6769
		<entry><literal>okular</literal></entry>
6770
		<entry>Universal document viewer</entry>
6771
	      </row>
6772
6773
	      <row>
6774
		<entry><literal>korundum</literal></entry>
6775
		<entry>KDE Ruby bindings</entry>
6776
	      </row>
6777
6778
	      <row>
6779
		<entry><literal>perlkde</literal></entry>
6780
		<entry>KDE Perl bindings</entry>
6781
	      </row>
6782
6783
	      <row>
6784
		<entry><literal>pykde4</literal></entry>
6785
		<entry>KDE Python bindings</entry>
6786
	      </row>
6787
6788
	      <row>
6789
		<entry><literal>pykdeuic4</literal></entry>
6790
		<entry>PyKDE user interface compiler</entry>
6791
	      </row>
6792
6793
	      <row>
6794
		<entry>smokekde<literal></literal></entry>
6795
		<entry>KDE SMOKE libraries</entry>
6796
	      </row>
6685
	    </tbody>
6797
	    </tbody>
6686
	  </tgroup>
6798
	  </tgroup>
6687
	</table>
6799
	</table>
Lines 6709-6722 Link Here
6709
	    Required KDE components and other dependencies can be
6821
	    Required KDE components and other dependencies can be
6710
	    determined through configure log.
6822
	    determined through configure log.
6711
	    <makevar>USE_KDE4</makevar> does not imply
6823
	    <makevar>USE_KDE4</makevar> does not imply
6712
	    <makevar>USE_QT_VER</makevar>.  If a port requires some
6824
	    <makevar>USE_QT4</makevar>.  If a port requires some
6713
	    Qt 4 components, <makevar>USE_QT_VER</makevar> should be
6825
	    Qt 4 components, they should be specified in 
6714
	    set and then needed components can be specified.</para>
6826
	    <makevar>USE_QT4</makevar>.</para>
6715
6827
6716
	  <programlisting>USE_CMAKE=	yes
6828
	  <programlisting>USE_CMAKE=	yes
6717
USE_KDE4=	kdelibs kdeprefix automoc4
6829
USE_KDE4=	kdelibs kdeprefix automoc4
6718
USE_QT_VER=	4
6830
USE_QT4=	moc_build qmake_build rcc_build uic_build</programlisting>
6719
QT_COMPONENTS=	moc_build qmake_build rcc_build uic_build</programlisting>
6720
	</example>
6831
	</example>
6721
      </sect2>
6832
      </sect2>
6722
    </sect1>
6833
    </sect1>

Return to bug 171788