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

« back to all changes in this revision

Viewing changes to qwt-5.0.2/INSTALL

  • Committer: Bazaar Package Importer
  • Author(s): Fathi Boudra
  • Date: 2007-10-05 15:20:41 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20071005152041-qmybqh4fj9jejyo2
Tags: 5.0.2-2
* Handle nostrip build option. (Closes: #437877)
* Build libqwt5-doc package in binary-indep target. (Closes: #443110)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Introduction
 
2
============
 
3
 
 
4
Qwt uses qmake to build all its components and examples. 
 
5
qmake is part of a Qt distribution. 
 
6
 
 
7
qmake reads project files, that contain the options and rules how to 
 
8
build a certain project. A project file ends with the suffix "*.pro". 
 
9
Files that end with the suffix "*.pri" are included by the project 
 
10
files and contain definitions, that are common for several project files.
 
11
 
 
12
qwtconfig.pri is read by all project files of the Qwt package.
 
13
So the first step is to edit qwtconfig.pri to adjust it to your
 
14
needs.
 
15
 
 
16
MathML Extension
 
17
================
 
18
 
 
19
Qwt/Qt4 supports the MathML render engine from the Qt solutions package,
 
20
that is only available with a commercial Qt license.
 
21
 
 
22
You need a release of qtmmlwidget >= 2.1.
 
23
Copy the files qtmmlwidget.[cpp|h] to textengines/mathml.
 
24
 
 
25
A) Unix (+ MacOSX) Qt3/Qt4
 
26
==========================
 
27
 
 
28
qmake
 
29
make
 
30
make install
 
31
 
 
32
If you didn't enable autobuilding of the examples in qwtconfig.pri
 
33
you have to build the examples this way:
 
34
 
 
35
cd examples
 
36
qmake 
 
37
make
 
38
 
 
39
If you like to run the examples, don't forget to install the 
 
40
Qwt library/plugins or set the LD_LIBRARY_PATH to the lib directory 
 
41
of your local build. ( On some systems LIBPATH is used instead, on MacOSX
 
42
it is called DYLD_LIBRARY_PATH. )
 
43
 
 
44
B) Win32/MSVC Qt3/Qt4
 
45
=====================
 
46
 
 
47
Please read the qmake documentation how to convert 
 
48
your *.pro files into your development environment.
 
49
 
 
50
F.e MSVC with nmake:
 
51
qmake qwt.pro
 
52
nmake
 
53
 
 
54
If you didn't enable autobuilding of the examples in qwtconfig.pri
 
55
you have to build the examples this way:
 
56
 
 
57
cd examples
 
58
nmake examples.pro
 
59
nmake
 
60
 
 
61
admin/msvc-qmake.bat helps users of Visual Studio users to
 
62
generate makefiles or project files (.dsp for MSVC-6.0 or vcproj for 
 
63
MSVC.NET) for Qwt.
 
64
 
 
65
To generate makefiles, type: "admin\msvc-qmake"
 
66
To generate project files, type: "admin\msvc-qmake vc"
 
67
 
 
68
C) Win32/MinGW Qt4
 
69
==================
 
70
 
 
71
C1) Windows Shell
 
72
 
 
73
Start a Windows Shell, where Qt4 is initialized. ( F.e. with
 
74
"Programs->Qt by Trolltech ...->Qt 4.x.x Command Prompt" ).
 
75
 
 
76
qmake qwt.pro
 
77
make
 
78
 
 
79
If you didn't enable autobuilding of the examples in qwtconfig.pri
 
80
you have to build the examples this way:
 
81
 
 
82
cd examples
 
83
qmake examples.pro
 
84
make
 
85
make install
 
86
 
 
87
C2) MSYS Shell Qt >= 4.3.0
 
88
 
 
89
Support for the MSYS Shell has been improved in Qt 4.3.0. 
 
90
Now building Qwt from the MSYS Shell works exactly like UNIX or in the 
 
91
Windows Shell.
 
92
 
 
93
C3) MSYS Shell Qt < 4.3.0
 
94
 
 
95
For Qt < 4.3.0 you have to set the MINGW_IN_SHELL variable. 
 
96
make will run into errors with the subdirs target, that can be 
 
97
ignored (make -i).
 
98
 
 
99
export MINGW_IN_SHELL=1;
 
100
 
 
101
qmake 
 
102
make -i
 
103
make -i install
 
104
 
 
105
If you didn't enable autobuilding of the examples in qwtconfig.pri
 
106
you have to build the examples this way:
 
107
 
 
108
cd examples
 
109
qmake examples.pro
 
110
make -i
 
111
make -i install
 
112
 
 
113
D) MacOSX
 
114
 
 
115
Well, the Mac is only another Unix system. So read the instructions in A).
 
116
 
 
117
 
 
118
D) Qtopia Core
 
119
 
 
120
I only tested Qwt with Qtopia Core in qvfb (Virtual Framebuffer Devivce)
 
121
Emulator on my Linux box. To build Qwt for the emulator was as simple as 
 
122
for a regular Unix build.
 
123
 
 
124
qmake
 
125
make
 
126
 
 
127
E) Qtopia (!= Qtopia Core)
 
128
 
 
129
I once compiled the Qwt library against Qtopia 4.2.0 successfully - but
 
130
not more. It should be possible to build and install Qwt, but it's
 
131
not done yet.
 
132
 
 
133
Good luck !