← Back to branch summary

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

« back to all changes in this revision

Viewing changes to qwt-5.1.2/doc/man/man3/qwtinstall.3

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