← Back to branch summary

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

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Fathi Boudra
  • Date: 2011-06-10 11:22:47 UTC
  • mfrom: (1.1.6 upstream) (2.1.4 sid)
  • Revision ID: james.westby@ubuntu.com-20110610112247-0i1019vvmzaq6p86
Tags: 6.0.0-1
http://bugs.debian.org/624107
http://bugs.debian.org/604379
http://bugs.debian.org/626868
http://bugs.debian.org/626567
* New upstream release (Closes: #624107):
  - drop Qt3 support. (Closes: #604379, #626868)
* Register documentation with doc-base. (Closes: #626567)
* Drop patches:
  - 01_makefiles.diff
  - 02_add_missing_warnings.diff
  - 03_qwt_branch_pull_r544.diff
* Add qwt_install_paths.patch to fix the hardcoded installation paths.
* Update debian/control:
  - drop libqt3-mt-dev build dependency.
  - bump Standards-Version to 3.9.2 (no changes).
  - drop Qt3 related packages.
  - due to bump soname (and as we dropper Qt3 support):
    - libqwt5-qt4-dev -> libqwt-dev
    - libqwt5-qt4 -> libqwt6
    - libqwt5-doc -> libqwt-doc
* Update debian/copyright file.
* Update debian/rules: drop Qt3 packages support.

Show diffs side-by-side

added added

removed removed

Lines of Context:
qwt/doc/man/man3/qwtinstall.3
1
 
.TH "qwtinstall" 3 "22 Mar 2009" "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
 
Documentation
33
 
==========================
34
 
 
35
 
Qwt includes a class documentation, that is available in various formats:
36
 
 
37
 
- Html files
38
 
- PDF document 
39
 
- Qt Compressed Help (*.qch ) for the Qt assistant. 
40
 
- Man pages ( UNIX only )
41
 
 
42
 
A) Unix Qt3/Qt4
43
 
==========================
44
 
 
45
 
qmake
46
 
make
47
 
make install
48
 
 
49
 
If you have installed a shared library it's path has to be known to 
50
 
the run-time linker of your operating system. On Linux systems read
51
 
'man ldconfig' ( or google for it ). Another option is to use
52
 
the LD_LIBRARY_PATH (on some systems LIBPATH is used instead, on MacOSX
53
 
it is called DYLD_LIBRARY_PATH) environment variable.
54
 
 
55
 
If you only want to check the Qwt examples without installing something,
56
 
you can set the LD_LIBRARY_PATH to the lib directory 
57
 
of your local build. 
58
 
 
59
 
If you didn't enable autobuilding of the examples in qwtconfig.pri
60
 
you have to build the examples this way:
61
 
 
62
 
cd examples
63
 
qmake 
64
 
make
65
 
 
66
 
 
67
 
B) Win32/MSVC Qt3/Qt4
68
 
=====================
69
 
 
70
 
Please read the qmake documentation how to convert 
71
 
your *.pro files into your development environment.
72
 
 
73
 
F.e MSVC with nmake:
74
 
qmake qwt.pro
75
 
nmake
76
 
 
77
 
If you didn't enable autobuilding of the examples in qwtconfig.pri
78
 
you have to build the examples this way:
79
 
 
80
 
cd examples
81
 
qmake examples.pro
82
 
nmake
83
 
 
84
 
admin/msvc-qmake.bat helps users of Visual Studio users to
85
 
generate makefiles or project files (.dsp for MSVC-6.0 or vcproj for 
86
 
MSVC.NET) for Qwt.
87
 
 
88
 
To generate makefiles, type: 'admin\msvc-qmake'
89
 
To generate project files, type: 'admin\msvc-qmake vc'
90
 
 
91
 
When you have built a Qwt DLL you need to add the following
92
 
define to your compiler flags: QWT_DLL.
93
 
 
94
 
Windows doesn't like mixing of debug and release binaries. Most
95
 
of the problems with using the Qwt designer plugin are because
96
 
of trying to load a Qwt debug library into a designer release 
97
 
executable.
98
 
 
99
 
 
100
 
C) Win32/MinGW Qt4
101
 
==================
102
 
 
103
 
C1) Windows Shell
104
 
 
105
 
Start a Windows Shell, where Qt4 is initialized. ( F.e. with
106
 
'Programs->Qt by Trolltech ...->Qt 4.x.x Command Prompt' ).
107
 
 
108
 
qmake qwt.pro
109
 
make
110
 
 
111
 
If you didn't enable autobuilding of the examples in qwtconfig.pri
112
 
you have to build the examples this way:
113
 
 
114
 
cd examples
115
 
qmake examples.pro
116
 
make
117
 
make install
118
 
 
119
 
C2) MSYS Shell Qt >= 4.3.0
120
 
 
121
 
Support for the MSYS Shell has been improved in Qt 4.3.0. 
122
 
Now building Qwt from the MSYS Shell works exactly like in UNIX or in the 
123
 
Windows Shell - or at least it should:
124
 
because of a bug in Qt 4.3.0 you always have to do a 'qmake -r'.
125
 
 
126
 
C3) MSYS Shell Qt < 4.3.0
127
 
 
128
 
For Qt < 4.3.0 you have to set the MINGW_IN_SHELL variable. 
129
 
make will run into errors with the subdirs target, that can be 
130
 
ignored (make -i).
131
 
 
132
 
export MINGW_IN_SHELL=1;
133
 
 
134
 
qmake 
135
 
make -i
136
 
make -i install
137
 
 
138
 
If you didn't enable autobuilding of the examples in qwtconfig.pri
139
 
you have to build the examples this way:
140
 
 
141
 
cd examples
142
 
qmake examples.pro
143
 
make -i
144
 
make -i install
145
 
 
146
 
C1-C3)
147
 
 
148
 
When you have built a Qwt DLL you need to add QWT_DLL to your compiler 
149
 
flags. If you are using qmake for your own builds this done by adding 
150
 
the following line to your profile: 'DEFINES += QWT_DLL'.
151
 
 
152
 
Windows doesn't like mixing of debug and release binaries. Most
153
 
of the problems with using the Qwt designer plugin are because
154
 
of trying to load a Qwt debug library into a designer release 
155
 
executable.
156
 
 
157
 
D) MacOSX
158
 
 
159
 
Well, the Mac is only another Unix system. So read the instructions in A).
160
 
 
161
 
In the recent Qt4 releases the default target of qmake is to generate
162
 
XCode project files instead of makefiles. So you might need to do the
163
 
following:
164
 
 
165
 
qmake -spec macx-g++
166
 
...
167
 
 
168
 
D) Qtopia Core
169
 
 
170
 
I only tested Qwt with Qtopia Core in qvfb (Virtual Framebuffer Devivce)
171
 
Emulator on my Linux box. To build Qwt for the emulator was as simple as 
172
 
for a regular Unix build.
173
 
 
174
 
qmake
175
 
make
176
 
 
177
 
E) Qtopia (!= Qtopia Core)
178
 
 
179
 
I once compiled the Qwt library against Qtopia 4.2.0 successfully - but
180
 
not more. It should be possible to build and install Qwt, but it's
181
 
not done yet.
182
 
 
183
 
Good luck !
184
 
.fi
185
 
.PP
186