~ubuntu-branches/ubuntu/oneiric/qwt/oneiric-proposed

« back to all changes in this revision

Viewing changes to qwt-5.1.2/doc/html/qwtinstall.html

  • Committer: Bazaar Package Importer
  • Author(s): Fathi Boudra
  • Date: 2009-04-12 23:25:58 UTC
  • mfrom: (1.1.4 upstream) (2.1.2 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090412232558-3bl06x785yr8xm8u
Tags: 5.1.2-1
* New upstream release.
* Bump compat/debhelper to 7.
* Bump Standards-Version to 3.8.1. No changes needed.
* Invert Maintainers and Uploaders field.
* Fix lintian warnings:
  - dh_clean _k deprecated.
  - missing dependency on libc.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
 
3
<title>Qwt User&apos;s Guide: INSTALL</title>
 
4
<link href="doxygen.css" rel="stylesheet" type="text/css">
 
5
<link href="tabs.css" rel="stylesheet" type="text/css">
 
6
</head><body>
 
7
<!-- Generated by Doxygen 1.5.0 -->
 
8
<div class="tabs">
 
9
  <ul>
 
10
    <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
 
11
    <li><a href="classes.html"><span>Classes</span></a></li>
 
12
    <li><a href="files.html"><span>Files</span></a></li>
 
13
    <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
 
14
  </ul></div>
 
15
<h1><a class="anchor" name="qwtinstall">INSTALL</a></h1><div class="fragment"><pre class="fragment">Introduction
 
16
============
 
17
 
 
18
Qwt uses qmake to build all its components and examples. 
 
19
qmake is part of a Qt distribution. 
 
20
 
 
21
qmake reads project files, that contain the options and rules how to 
 
22
build a certain project. A project file ends with the suffix <span class="stringliteral">"*.pro"</span>. 
 
23
Files that end with the suffix <span class="stringliteral">"*.pri"</span> are included by the project 
 
24
files and contain definitions, that are common <span class="keywordflow">for</span> several project files.
 
25
 
 
26
qwtconfig.pri is read by all project files of the Qwt package.
 
27
So the first step is to edit qwtconfig.pri to adjust it to your
 
28
needs.
 
29
 
 
30
MathML Extension
 
31
================
 
32
 
 
33
Qwt/Qt4 supports the MathML render engine from the Qt solutions package,
 
34
that is only available with a commercial Qt license.
 
35
 
 
36
You need a release of qtmmlwidget &gt;= 2.1.
 
37
Copy the files qtmmlwidget.[cpp|h] to textengines/mathml.
 
38
 
 
39
A) Unix Qt3/Qt4
 
40
==========================
 
41
 
 
42
qmake
 
43
make
 
44
make install
 
45
 
 
46
If you have installed a shared library it's path has to be known to 
 
47
the run-time linker of your operating system. On Linux systems read
 
48
<span class="stringliteral">"man ldconfig"</span> ( or google <span class="keywordflow">for</span> it ). Another option is to use
 
49
the LD_LIBRARY_PATH (on some systems LIBPATH is used instead, on MacOSX
 
50
it is called DYLD_LIBRARY_PATH) environment variable.
 
51
 
 
52
If you only want to check the Qwt examples without installing something,
 
53
you can set the LD_LIBRARY_PATH to the lib directory 
 
54
of your local build. 
 
55
 
 
56
If you didn't enable autobuilding of the examples in qwtconfig.pri
 
57
you have to build the examples <span class="keyword">this</span> way:
 
58
 
 
59
cd examples
 
60
qmake 
 
61
make
 
62
 
 
63
 
 
64
B) Win32/MSVC Qt3/Qt4
 
65
=====================
 
66
 
 
67
Please read the qmake documentation how to convert 
 
68
your *.pro files into your development environment.
 
69
 
 
70
F.e MSVC with nmake:
 
71
qmake qwt.pro
 
72
nmake
 
73
 
 
74
If you didn't enable autobuilding of the examples in qwtconfig.pri
 
75
you have to build the examples <span class="keyword">this</span> way:
 
76
 
 
77
cd examples
 
78
qmake examples.pro
 
79
nmake
 
80
 
 
81
admin/msvc-qmake.bat helps users of Visual Studio users to
 
82
generate makefiles or project files (.dsp <span class="keywordflow">for</span> MSVC-6.0 or vcproj <span class="keywordflow">for</span> 
 
83
MSVC.NET) <span class="keywordflow">for</span> Qwt.
 
84
 
 
85
To generate makefiles, type: <span class="stringliteral">"admin\msvc-qmake"</span>
 
86
To generate project files, type: <span class="stringliteral">"admin\msvc-qmake vc"</span>
 
87
 
 
88
When you have built a Qwt DLL you need to add the following
 
89
define to your compiler flags: QWT_DLL.
 
90
 
 
91
Windows doesn't like mixing of debug and release binaries. Most
 
92
of the problems with <span class="keyword">using</span> the Qwt designer plugin are because
 
93
of trying to load a Qwt debug library into a designer release 
 
94
executable.
 
95
 
 
96
 
 
97
C) Win32/MinGW Qt4
 
98
==================
 
99
 
 
100
C1) Windows Shell
 
101
 
 
102
Start a Windows Shell, where Qt4 is initialized. ( F.e. with
 
103
<span class="stringliteral">"Programs-&gt;Qt by Trolltech ...-&gt;Qt 4.x.x Command Prompt"</span> ).
 
104
 
 
105
qmake qwt.pro
 
106
make
 
107
 
 
108
If you didn't enable autobuilding of the examples in qwtconfig.pri
 
109
you have to build the examples <span class="keyword">this</span> way:
 
110
 
 
111
cd examples
 
112
qmake examples.pro
 
113
make
 
114
make install
 
115
 
 
116
C2) MSYS Shell Qt &gt;= 4.3.0
 
117
 
 
118
Support <span class="keywordflow">for</span> the MSYS Shell has been improved in Qt 4.3.0. 
 
119
Now building Qwt from the MSYS Shell works exactly like in UNIX or in the 
 
120
Windows Shell - or at least it should:
 
121
because of a bug in Qt 4.3.0 you always have to <span class="keywordflow">do</span> a <span class="stringliteral">"qmake -r"</span>.
 
122
 
 
123
C3) MSYS Shell Qt &lt; 4.3.0
 
124
 
 
125
For Qt &lt; 4.3.0 you have to set the MINGW_IN_SHELL variable. 
 
126
make will run into errors with the subdirs target, that can be 
 
127
ignored (make -i).
 
128
 
 
129
export MINGW_IN_SHELL=1;
 
130
 
 
131
qmake 
 
132
make -i
 
133
make -i install
 
134
 
 
135
If you didn't enable autobuilding of the examples in qwtconfig.pri
 
136
you have to build the examples <span class="keyword">this</span> way:
 
137
 
 
138
cd examples
 
139
qmake examples.pro
 
140
make -i
 
141
make -i install
 
142
 
 
143
C1-C3)
 
144
 
 
145
When you have built a Qwt DLL you need to add QWT_DLL to your compiler 
 
146
flags. If you are <span class="keyword">using</span> qmake <span class="keywordflow">for</span> your own builds <span class="keyword">this</span> done by adding 
 
147
the following line to your profile: <span class="stringliteral">"DEFINES += QWT_DLL"</span>.
 
148
 
 
149
Windows doesn't like mixing of debug and release binaries. Most
 
150
of the problems with <span class="keyword">using</span> the Qwt designer plugin are because
 
151
of trying to load a Qwt debug library into a designer release 
 
152
executable.
 
153
 
 
154
D) MacOSX
 
155
 
 
156
Well, the Mac is only another Unix system. So read the instructions in A).
 
157
 
 
158
In the recent Qt4 releases the <span class="keywordflow">default</span> target of qmake is to generate
 
159
XCode project files instead of makefiles. So you might need to <span class="keywordflow">do</span> the
 
160
following:
 
161
 
 
162
qmake -spec macx-g++
 
163
...
 
164
 
 
165
D) Qtopia Core
 
166
 
 
167
I only tested Qwt with Qtopia Core in qvfb (Virtual Framebuffer Devivce)
 
168
Emulator on my Linux box. To build Qwt <span class="keywordflow">for</span> the emulator was as simple as 
 
169
<span class="keywordflow">for</span> a regular Unix build.
 
170
 
 
171
qmake
 
172
make
 
173
 
 
174
E) Qtopia (!= Qtopia Core)
 
175
 
 
176
I once compiled the Qwt library against Qtopia 4.2.0 successfully - but
 
177
not more. It should be possible to build and install Qwt, but it's
 
178
not done yet.
 
179
 
 
180
Good luck !
 
181
</pre></div> <hr size="1"><address style="align: right;"><small>Generated on Sun Mar 22 16:54:10 2009 for Qwt User's Guide by&nbsp;
 
182
<a href="http://www.doxygen.org/index.html">
 
183
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.0 </small></address>
 
184
</body>
 
185
</html>