File: qwtinstall.3

package info (click to toggle)
qwt5 5.2.3-1
  • links: PTS
  • area: main
  • in suites: buster, jessie, jessie-kfreebsd, stretch
  • size: 12,640 kB
  • ctags: 11,024
  • sloc: cpp: 32,660; makefile: 26; sh: 4
file content (185 lines) | stat: -rw-r--r-- 5,005 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
.TH "qwtinstall" 3 "Tue Nov 20 2012" "Version 5.2.3" "Qwt User's Guide" \" -*- nroff -*-
.ad l
.nh
.SH NAME
qwtinstall \- INSTALL 
.PP
.nf
Introduction
============

Qwt uses qmake to build all its components and examples\&. 
qmake is part of a Qt distribution\&. 

qmake reads project files, that contain the options and rules how to 
build a certain project\&. A project file ends with the suffix '*\&.pro'\&. 
Files that end with the suffix '*\&.pri' are included by the project 
files and contain definitions, that are common for several project files\&.

qwtconfig\&.pri is read by all project files of the Qwt package\&.
So the first step is to edit qwtconfig\&.pri to adjust it to your
needs\&.

MathML Extension
================

Qwt/Qt4 supports the MathML render engine from the Qt solutions package,
that is only available with a commercial Qt license\&.

You need a release of qtmmlwidget >= 2\&.1\&.
Copy the files qtmmlwidget\&.[cpp|h] to textengines/mathml\&.

Documentation
==========================

Qwt includes a class documentation, that is available in various formats:

- Html files
- PDF document 
- Qt Compressed Help (*\&.qch ) for the Qt assistant or creator\&. 
  You can load it 'Edit Preferences' -> 'Documentation' -> 'Add\&.\&.\&.'
- Man pages ( UNIX only )

A) Unix Qt3/Qt4
==========================

qmake qwt\&.pro
make
make install

If you have installed a shared library it's path has to be known to 
the run-time linker of your operating system\&. On Linux systems read
'man ldconfig' ( or google for it )\&. Another option is to use
the LD_LIBRARY_PATH (on some systems LIBPATH is used instead, on MacOSX
it is called DYLD_LIBRARY_PATH) environment variable\&.

If you only want to check the Qwt examples without installing something,
you can set the LD_LIBRARY_PATH to the lib directory 
of your local build\&. 

If you didn't enable autobuilding of the examples in qwtconfig\&.pri
you have to build the examples this way:

cd examples
qmake examples\&.pro
make


B) Win32/MSVC Qt3/Qt4
=====================

Please read the qmake documentation how to convert 
your *\&.pro files into your development environment\&.

F\&.e MSVC with nmake:
qmake qwt\&.pro
nmake
nmake install

If you didn't enable autobuilding of the examples in qwtconfig\&.pri
you have to build the examples this way:

cd examples
qmake examples\&.pro
nmake

admin/msvc-qmake\&.bat helps users of Visual Studio users to
generate makefiles or project files (\&.dsp for MSVC-6\&.0 or vcproj for 
MSVC\&.NET) for Qwt\&.

To generate makefiles, type: 'admin\msvc-qmake'
To generate project files, type: 'admin\msvc-qmake vc'

When you have built a Qwt DLL you need to add the following
define to your compiler flags: QWT_DLL\&.

Windows doesn't like mixing of debug and release binaries\&. Most
of the problems with using the Qwt designer plugin are because
of trying to load a Qwt debug library into a designer release 
executable\&.


C) Win32/MinGW Qt4
==================

C1) Windows Shell

Start a Windows Shell, where Qt4 is initialized\&. ( F\&.e\&. with
'Programs->Qt by Trolltech \&.\&.\&.->Qt 4\&.x\&.x Command Prompt' )\&.

qmake qwt\&.pro
make
make install

If you didn't enable autobuilding of the examples in qwtconfig\&.pri
you have to build the examples this way:

cd examples
qmake examples\&.pro
make

C2) MSYS Shell Qt >= 4\&.3\&.0

Support for the MSYS Shell has been improved in Qt 4\&.3\&.0\&. 
Now building Qwt from the MSYS Shell works exactly like in UNIX or in the 
Windows Shell - or at least it should:
because of a bug in Qt 4\&.3\&.0 you always have to do a 'qmake \-r'\&.

C3) MSYS Shell Qt < 4\&.3\&.0

For Qt < 4\&.3\&.0 you have to set the MINGW_IN_SHELL variable\&. 
make will run into errors with the subdirs target, that can be 
ignored (make \-i)\&.

export MINGW_IN_SHELL=1;

qmake 
make \-i
make \-i install

If you didn't enable autobuilding of the examples in qwtconfig\&.pri
you have to build the examples this way:

cd examples
qmake examples\&.pro
make \-i

C1-C3)

When you have built a Qwt DLL you need to add QWT_DLL to your compiler 
flags\&. If you are using qmake for your own builds this done by adding 
the following line to your profile: 'DEFINES += QWT_DLL'\&.

Windows doesn't like mixing of debug and release binaries\&. Most
of the problems with using the Qwt designer plugin are because
of trying to load a Qwt debug library into a designer release 
executable\&.

D) MacOSX

Well, the Mac is only another Unix system\&. So read the instructions in A)\&.

In the recent Qt4 releases the default target of qmake is to generate
XCode project files instead of makefiles\&. So you might need to do the
following:

qmake \-spec macx-g++ qwt\&.pro
\&.\&.\&.

E) Qt Embedded
--------

I only tested Qwt with Qt Embedded in qvfb (Virtual Framebuffer Devivce)
Emulator on my Linux box\&. To build Qwt for the emulator was as simple as 
for a regular Unix build\&.

F) Symbian
--------

I never tried this platform myself\&.


Good luck !
.fi
.PP