Author: bdubbs
Date: 2008-03-05 18:35:48 -0700 (Wed, 05 Mar 2008)
New Revision: 7202
Added:
trunk/BOOK/x/lib/qt4.xml
Modified:
trunk/BOOK/general.ent
trunk/BOOK/introduction/welcome/changelog.xml
trunk/BOOK/x/lib/lib.xml
Log:
Added qt4 to the book
Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent 2008-03-05 17:19:23 UTC (rev 7201)
+++ trunk/BOOK/general.ent 2008-03-06 01:35:48 UTC (rev 7202)
@@ -3,7 +3,7 @@
$Date$
-->
-<!ENTITY day "05"> <!-- Always 2 digits -->
+<!ENTITY day "06"> <!-- Always 2 digits -->
<!ENTITY month "03"> <!-- Always 2 digits -->
<!ENTITY year "2008">
<!ENTITY version "svn-&year;&month;&day;">
@@ -422,6 +422,7 @@
<!-- Chapter 26 -->
<!ENTITY qt-version "3.3.8">
+<!ENTITY qt4-version "4.3.4">
<!ENTITY GTK-version "1.2.10">
<!ENTITY cairo-version "1.4.10">
<!ENTITY pango-version "1.16.4">
Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml 2008-03-05 17:19:23 UTC
(rev 7201)
+++ trunk/BOOK/introduction/welcome/changelog.xml 2008-03-06 01:35:48 UTC
(rev 7202)
@@ -42,6 +42,15 @@
-->
<listitem>
+ <para>March 6th, 2008</para>
+ <itemizedlist>
+ <listitem>
+ <para>[bdubbs] - Added Qt4.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para>March 5th, 2008</para>
<itemizedlist>
<listitem>
Modified: trunk/BOOK/x/lib/lib.xml
===================================================================
--- trunk/BOOK/x/lib/lib.xml 2008-03-05 17:19:23 UTC (rev 7201)
+++ trunk/BOOK/x/lib/lib.xml 2008-03-06 01:35:48 UTC (rev 7202)
@@ -25,6 +25,7 @@
assist programmers by supplying common elements.</para>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="qt.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="qt4.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="gtk+.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="cairo.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="pango.xml"/>
Added: trunk/BOOK/x/lib/qt4.xml
===================================================================
--- trunk/BOOK/x/lib/qt4.xml (rev 0)
+++ trunk/BOOK/x/lib/qt4.xml 2008-03-06 01:35:48 UTC (rev 7202)
@@ -0,0 +1,439 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [
+ <!ENTITY % general-entities SYSTEM "../../general.ent">
+ %general-entities;
+
+ <!ENTITY qt4-download-http
"http://ftp.silug.org/mirrors/ftp.trolltech.com/qt/source/qt-x11-opensource-src-&qt4-version;.tar.gz";>
+ <!ENTITY qt4-download-ftp
"ftp://ftp.trolltech.com/qt/source/qt-x11-opensource-src-&qt4-version;.tar.gz";>
+ <!ENTITY qt4-md5sum "9499101ec54eb7b0de195b3c5e3ffa93">
+ <!ENTITY qt4-size "42 MB">
+ <!ENTITY qt4-buildsize "1914 MB (full), 608 (essential)">
+ <!ENTITY qt4-time "26 SBU (full), 13.5 SBU (essential)">
+]>
+
+<sect1 id="qt4" xreflabel="Qt-&qt4-version;">
+ <?dbhtml filename="qt4.html" ?>
+
+ <sect1info>
+ <othername>$LastChangedBy: randy $</othername>
+ <date>$Date: 2007-08-11 20:04:53 -0500 (Sat, 11 Aug 2007) $</date>
+ </sect1info>
+
+ <title>Qt-&qt4-version;</title>
+
+ <indexterm zone="qt4">
+ <primary sortas="a-qt4">Qt4</primary>
+ </indexterm>
+
+ <sect2 role="package">
+ <title>Introduction to Qt4</title>
+
+ <para>The <application>Qt4</application> package contains several
+ <application>C++</application> libraries with both Gui and non-Gui
+ components. One of the major users of <application>Qt4</application> is
+ <application>KDE4</application>.</para>
+
+ <bridgehead renderas="sect3">Package Information</bridgehead>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Download (HTTP): <ulink url="&qt4-download-http;"/></para>
+ </listitem>
+ <listitem>
+ <para>Download (FTP): <ulink url="&qt4-download-ftp;"/></para>
+ </listitem>
+ <listitem>
+ <para>Download MD5 sum: &qt4-md5sum;</para>
+ </listitem>
+ <listitem>
+ <para>Download size: &qt4-size;</para>
+ </listitem>
+ <listitem>
+ <para>Estimated disk space required: &qt4-buildsize;</para>
+ </listitem>
+ <listitem>
+ <para>Estimated build time: &qt4-time;</para>
+ </listitem>
+ </itemizedlist>
+
+ <bridgehead renderas="sect3">Qt Dependencies</bridgehead>
+
+ <bridgehead renderas="sect4">Required</bridgehead>
+ <para role="required"><xref linkend="x-window-system"/></para>
+
+ <bridgehead renderas="sect4">Recommended</bridgehead>
+ <para role="recommended"><xref linkend="libjpeg"/>,
+ <xref linkend="libmng"/>,
+ <xref linkend="libtiff"/>, and
+ <xref linkend="libpng"/>
+ </para>
+
+ <bridgehead renderas="sect4">Optional</bridgehead>
+ <para role="optional"><xref linkend="nas"/>,
+ <xref linkend="dbus"/>,
+ <xref linkend="glib2"/>,
+ <xref linkend="openssl"/>,
+ <xref linkend="cups"/>,
+ <xref linkend="mysql"/>,
+ <xref linkend="postgresql"/>,
+ <xref linkend="unixodbc"/>, and
+ <ulink url="http://sqlite.org/";>SQLite</ulink>
+ </para>
+
+ <para condition="html" role="usernotes">User Notes:
+ <ulink url="&blfs-wiki;/qt"/></para>
+
+ </sect2>
+
+ <sect2 role="installation">
+ <title>Installation of Qt</title>
+
+ <para>There are several ways to install a complicated package such as
+ <application>Qt</application>. The files are not completely position
+ independent. Installation procedures execute the program
+ <command>pkg-config</command> to determine the location of package
+ executables, libraries, headers, and other files. For
+ <application>Qt</application>, <command>pkg-config</command> will look
+ for the appropriate files <filename>lib/pkgconfig/Qt*.pc</filename> which
must be
+ modified if relocating the package. These files are set up correctly by
+ the build process.</para>
+
+ <para>The default installation places the files in
+ <filename class='directory'>/usr/local/qt/</filename>. Many commercial
+ distributions place the files in the system's
+ <filename class='directory'>/usr</filename> hierarchy. The package can
+ also be installed in an arbitrary directory.</para>
+
+ <para>The advantage of this method is that no updates to the
+ <filename>/etc/ld.so.conf</filename> or
+ <filename>/etc/man_db.conf</filename> files are required. The package
+ files are distributed within several subdirectories of the
+ <filename class='directory'>/usr</filename> hierarchy.
+ This is the method that most commercial distributions use.</para>
+
+ <note>
+ <para>If <application>Qt</application> is being reinstalled and the /usr
+ directory is used as the prefix, run the following commands from a
+ console or non-Qt based window manager. It overwrites
+ <application>Qt</application> libraries that should not be in use during
+ the install process.</para>
+ </note>
+
+ <note>
+ <para>The build time and space required for the full
+ <application>Qt</application> is quite long. The instructions below do
+ not build the tutorials and examples. Removing the -nomake lines will
+ create a complete build.</para>
+ </note>
+
+ <para>The method recommended by the <application>Qt</application>
+ developers does not use the /usr directory prefix. It has the advantage of
+ keeping all the package files consolidated in a dedicated directory
+ hierarchy. By using this method, an update can be made without overwriting
+ a previous installation and users can easily revert to a previous version
+ by changing one symbolic link.</para>
+
+ <para>The <application>Qt</application> developers use a default location
+ of <filename class='directory'>/usr/local/qt/</filename>, however this
+ procedure puts the files in <filename
+ class='directory'>/opt/qt-&qt4-version;/</filename>
+ and then creates a symbolic link to <filename>/opt/qt/</filename>.</para>
+
+ <para>Build with:</para>
+
+<screen><userinput>./configure -prefix /opt/qt-&qt4-version; \
+ -release \
+ -nomake examples \
+ -nomake demos \
+ -no-separate-debug-info &&
+make</userinput></screen>
+
+ <para>This package does not come with a test suite.</para>
+
+ <para>Now, as the <systemitem class="username">root</systemitem>
+ user:</para>
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+ <para>If you installed <application>Qt</application> in the /opt directory,
+ again as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>ln -v -sfn qt-&qt4-version;
/opt/qt</userinput></screen>
+
+ </sect2>
+
+ <sect2 role="commands">
+ <title>Command Explanations</title>
+
+ <para><parameter>-release, -no-separate-debug-info</parameter>: These
+ switches minimizes the time and space used to build
+ <application>Qt</application> by not adding debug information to the
+ libraries.</para>
+
+ <para><parameter>-nomake examples, -nomake demos</parameter>:
+ These switches disable building programs that are only of interest
+ to a <application>Qt</application> developer.</para>
+
+ <para>There are several optional directories that can be specified in the
+ <command>./configure</command> line. These include
+ <option>-bindir</option>, <option>-libdir</option>,
+ <option>-docdir</option>, and <option>-headerdir</option>. For a complete
+ list, run <command>./configure -help</command>.</para>
+
+
+
<para><parameter>-plugin-sql-<replaceable><driver></replaceable></parameter>
+ or
<parameter>-qt-sql-<replaceable><driver></replaceable></parameter>:
+ These switches build SQL support into the <application>Qt</application>
+ libraries.</para>
+
+ <note>
+ <para>To check if <application>mysql</application> is autotetected
+ properly, examine the output of <command>./configure -qt-sql-mysql
+ -help</command>. Other database support will require similar
+ <command>configure</command> parameters.</para>
+ </note>
+
+ </sect2>
+
+ <sect2 role="configuration">
+ <title>Configuring Qt</title>
+
+ <sect3 id='qt4-config'>
+ <title>Configuration Information</title>
+
+ <para>If you installed <application>Qt</application> in a location other
+ than /usr, you also need to update the following configuration files so
+ that <application>Qt</application> is correctly found by other packages
+ and system processes.</para>
+
+ <para>Update the <filename>/etc/ld.so.conf</filename> and
+ <filename>/etc/man_db.conf</filename> files:</para>
+
+<screen role="root"><userinput>cat >> /etc/ld.so.conf << "EOF"
&&
+<literal># Begin qt addition to /etc/ld.so.conf
+
+/opt/qt/lib
+
+# End qt addition</literal>
+EOF
+ldconfig &&
+cat >> /etc/man_db.conf << "EOF"
+<literal># Begin qt addition to man_db.conf
+
+MANDATORY_MANPATH /opt/qt/doc/man
+
+# End qt addition to man_db.conf</literal>
+EOF</userinput></screen>
+
+ <indexterm zone="qt qt4-config">
+ <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
+ </indexterm>
+
+ <indexterm zone="qt qt4-config">
+ <primary sortas="e-etc-man_db.conf">/etc/man_db.conf</primary>
+ </indexterm>
+
+ <para>Update the <envar>PKG_CONFIG_PATH</envar> environment variable
+ in your <filename>~/.bash_profile</filename> or
+ <filename>/etc/profile</filename> with the following:</para>
+
+<screen><literal>PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/qt/lib/pkgconfig</literal></screen>
+
+ <para>If you want the <application>Qt</application> executables in your
+ shell search path, update the <envar>PATH</envar> environment variable
+ in your <filename>~/.bash_profile</filename> or
+ <filename>/etc/profile</filename> to include
+ <filename class='directory'>/opt/qt/bin</filename>.</para>
+
+ <para>As with most libraries, there is no explicit configuration to do.
+ After updating <filename>/etc/ld.so.conf</filename> as explained above,
+ run <command>/sbin/ldconfig</command> so that <command>ldd</command>
+ can find the shared libraries.</para>
+
+ </sect3>
+ </sect2>
+
+ <sect2 role="content">
+ <title>Contents</title>
+
+ <segmentedlist>
+ <segtitle>Installed Programs</segtitle>
+ <segtitle>Installed Libraries</segtitle>
+ <segtitle>Installed Directories</segtitle>
+
+ <seglistitem>
+ <seg>assistant, designer, linguist, lrelease, lupdate, moc,
+ pixeltool, qmake, qt3to4, qtconfig, qtdemo, rcc, uic, and uic3</seg>
+
+ <seg>libQt3Support.so, libQtAssistantClient.so, libQtCore.so,
+ libQtDesigner.so, libQtDesignerComponents.so, libQtGui.so,
+ libQtNetwork.so, libQtOpenGL.so, libQtScript.so, libQtSql.so,
+ libQtSvg.so, libQtTest.so, andlibQtXml.so</seg>
+
+ <seg>/opt/qt-&qt4-version;</seg>
+ </seglistitem>
+ </segmentedlist>
+
+ <variablelist>
+ <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+ <?dbfo list-presentation="list"?>
+ <?dbhtml list-presentation="table"?>
+
+ <varlistentry id="qt4-assistant">
+ <term><command>assistant</command></term>
+ <listitem>
+ <para>is a tool for presenting on-line documentation.</para>
+ <indexterm zone="qt4 qt4-assistant">
+ <primary sortas="b-assistant">assistant</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-designer">
+ <term><command>designer</command></term>
+ <listitem>
+ <para>is a full-fledged GUI builder. It includes
+ powerful features such as preview mode, automatic widget
+ layout, support for custom widgets, and an advanced
+ property editor.</para>
+ <indexterm zone="qt4 qt4-designer">
+ <primary sortas="b-designer">designer</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-linguist">
+ <term><command>linguist</command></term>
+ <listitem>
+ <para>provides support for translating applications into
+ local languages. </para>
+ <indexterm zone="qt4 qt4-linguist">
+ <primary sortas="b-linguist">linguist</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-lrelease">
+ <term><command>lrelease</command></term>
+ <listitem>
+ <para>is a simple command line tool. It reads a Qt project
+ file and produces message files used by the application.</para>
+ <indexterm zone="qt4 qt4-lrelease">
+ <primary sortas="b-lrelease">lrelease</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-lupdate">
+ <term><command>lupdate</command></term>
+ <listitem>
+ <para>reads a Qt project file, finds the translatable
+ strings in the specified source, header and Qt Designer
+ interface files, and produces or updates the translation
+ files listed in the project file.</para>
+ <indexterm zone="qt4 qt4-lupdate">
+ <primary sortas="b-lupdate">lupdate</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-moc">
+ <term><command>moc</command></term>
+ <listitem>
+ <para>generates Qt meta object support code.</para>
+ <indexterm zone="qt4 qt4-moc">
+ <primary sortas="b-moc">moc</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-pixeltool">
+ <term><command>pixeltool</command></term>
+ <listitem>
+ <para>is a desktop magnifier and as you move your mouse around
+ the screen it will show the magnified contents in its window.</para>
+ <indexterm zone="qt4 qt4-pixeltool">
+ <primary sortas="b-pixeltool">pixeltool</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-qmake">
+ <term><command>qmake</command></term>
+ <listitem>
+ <para>qmake uses information stored in project files to
+ determine what should go in the makefiles it generates.</para>
+ <indexterm zone="qt4 qt4-qmake">
+ <primary sortas="b-qmake">qmake</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-qt3to4">
+ <term><command>qt3to4</command></term>
+ <listitem>
+ <para>qt3to4 is a tool to help update qt3 code to qt4.</para>
+ <indexterm zone="qt4 qt4-qt3to4">
+ <primary sortas="b-qt3to4">qt3to4</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-qtconfig">
+ <term><command>qtconfig</command></term>
+ <listitem>
+ <para>is used to customize the appearance of Qt applications.</para>
+ <indexterm zone="qt4 qt4-qtconfig">
+ <primary sortas="b-qtconfig">qtconfig</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-qtdemo">
+ <term><command>qtdemo</command></term>
+ <listitem>
+ <para>is a portal into various demonstrations of Qt
+ applications.</para>
+ <indexterm zone="qt4 qt4-qtdemo">
+ <primary sortas="b-qtdemo">qtdemo</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-rcc">
+ <term><command>rcc</command></term>
+ <listitem>
+ <para>is a resource compiler used in conjucntion with
designer.</para>
+ <indexterm zone="qt4 qt4-rcc">
+ <primary sortas="b-rcc">rcc</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-uic">
+ <term><command>uic</command></term>
+ <listitem>
+ <para>is a Qt user interface compiler.</para>
+ <indexterm zone="qt4 qt4-uic">
+ <primary sortas="b-uic">uic</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="qt4-uic3">
+ <term><command>uic3</command></term>
+ <listitem>
+ <para>is a tool to generate Qt 4 code out of
+ user interface files genereated byt the Qt3
+ version of designer.</para>
+ <indexterm zone="qt4 qt4-uic3">
+ <primary sortas="b-uic3">uic3</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect2>
+
+</sect1>
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
