← Back to branch summary

~oif-team/ubuntu/natty/qt4-x11/xi2.1

« back to all changes in this revision

Viewing changes to INSTALL

  • Committer: Bazaar Package Importer
  • Author(s): Alessandro Ghersi
  • Date: 2009-11-02 18:30:08 UTC
  • mfrom: (1.2.2 upstream)
  • mto: (15.2.5 experimental)
  • mto: This revision was merged to the branch mainline in revision 88.
  • Revision ID: james.westby@ubuntu.com-20091102183008-b6a4gcs128mvfb3m
Tags: upstream-4.6.0~beta1
Import upstream version 4.6.0~beta1

Show diffs side-by-side

added added

removed removed

Lines of Context:
INSTALL
1
 
                          INSTALLING Qt/X11 Version 4.5.2.
 
1
        INSTALLING Qt Source Package Version 4.6.0.
2
2
 
3
3
1.  If you have the commercial edition of Qt, install your license
4
 
    file as $HOME/.qt-license.
 
4
    file as $HOME/.qt-license if you are on Unix. If you are on
 
5
    Windows, copy the license file into your home directory
 
6
    (this may be known as the userprofile environment variable) and
 
7
    rename it to .qt-license. For example on Windows XP,
 
8
    %USERPROFILE% should be something like C:\Documents and
 
9
    Settings\username.
5
10
 
6
11
    For the open source version you do not need a license file.
7
12
 
8
13
2.  Unpack the archive if you have not done so already:
9
14
 
 
15
    On Unix (X11 and Mac):
10
16
        cd /tmp
11
17
        gunzip %DISTNAME%.tar.gz        # uncompress the archive
12
18
        tar xvf %DISTNAME%.tar          # unpack it
15
21
    from the archive. We only support the GNU version of the tar
16
22
    archiving utility. Note that on some systems it is called gtar.
17
23
 
18
 
3.  Building
 
24
    On Windows, uncompress the files into the directory you want Qt
 
25
    installed, e.g. C:\Qt\4.6.0.
 
26
 
 
27
    NOTE: The install path must not contain any spaces.
 
28
 
 
29
4. Environment variables
 
30
 
 
31
   In order to build and use Qt, the PATH environment variable needs
 
32
   to be extended to locate qmake, moc and other Qt tools
 
33
 
 
34
   On Windows, this is done by adding C:\Qt\4.6.0\bin
 
35
   to the PATH variable. On Unix, this is done by adding
 
36
   /tmp/%DISTNAME%.
 
37
 
 
38
   For newer versions of Windows, PATH can be extended through
 
39
   "Control Panel->System->Advanced->Environment variables" and for
 
40
   older versions by editing C:\autoexec.bat.
 
41
 
 
42
   In .profile (if your Unix shell is bash), add the following lines:
 
43
 
 
44
        PATH=/usr/local/Trolltech/Qt-4.6.0/bin:$PATH
 
45
        export PATH
 
46
 
 
47
   In .login (in case your Unix shell is csh or tcsh), add the following line:
 
48
 
 
49
        setenv PATH /usr/local/Trolltech/Qt-4.6.0/bin:$PATH
 
50
 
 
51
   If you use a different Unix shell, please modify your environment
 
52
   variables accordingly.
 
53
 
 
54
   For some X11 compilers that do not support rpath you must also
 
55
   extended the LD_LIBRARY_PATH environment variable to include
 
56
   /usr/local/Trolltech/Qt-4.6.0/lib. On Linux or Mac with GCC
 
57
   this step is not needed.
 
58
 
 
59
4.  Building
 
60
 
 
61
4.1 Building on Unix
19
62
 
20
63
    To configure the Qt library for your machine type, run the
21
64
    ./configure script in the package directory.
22
65
 
23
66
    By default, Qt is configured for installation in the
24
 
    /usr/local/Trolltech/Qt-4.5.2 directory, but this can be
25
 
    changed by using the -prefix option. Alternatively, the
26
 
    -prefix-install option can be used to specify a "local"
27
 
    installation within the source directory.
 
67
    /usr/local/Trolltech/Qt-4.6.0 directory, but this can be
 
68
    changed by using the -prefix option.
28
69
 
29
70
        cd /tmp/%DISTNAME%
30
71
        ./configure
42
83
 
43
84
        su -c "make install"
44
85
 
45
 
    and enter the root password.
 
86
    and enter the root password. On some systems, you have to use the
 
87
    sudo command as follows:
 
88
 
 
89
        sudo make install
 
90
 
 
91
    and enter your password, this requires that you have administrator access
 
92
    to your machine.
46
93
 
47
94
    Note that on some systems the make utility is named differently,
48
95
    e.g. gmake. The configure script tells you which make utility to
56
103
 
57
104
    before running the configure script again.
58
105
 
59
 
4.  Environment variables
60
 
 
61
 
    In order to use Qt, some environment variables needs to be
62
 
    extended.
63
 
 
64
 
        PATH               - to locate qmake, moc and other Qt tools
65
 
 
66
 
    This is done like this:
67
 
 
68
 
    In .profile (if your shell is bash, ksh, zsh or sh), add the
69
 
    following lines:
70
 
 
71
 
        PATH=/usr/local/Trolltech/Qt-4.5.2/bin:$PATH
72
 
        export PATH
73
 
 
74
 
    In .login (in case your shell is csh or tcsh), add the following line:
75
 
 
76
 
        setenv PATH /usr/local/Trolltech/Qt-4.5.2/bin:$PATH
77
 
 
78
 
    If you use a different shell, please modify your environment
79
 
    variables accordingly.
80
 
 
81
 
    For compilers that do not support rpath you must also extended the
82
 
    LD_LIBRARY_PATH environment variable to include
83
 
    /usr/local/Trolltech/Qt-4.5.2/lib. On Linux with GCC this step
84
 
    is not needed.
 
106
4.2 Building on Windows
 
107
 
 
108
    To configure the Qt library for your machine type:
 
109
 
 
110
        C:
 
111
        cd \Qt\4.6.0
 
112
        configure
 
113
 
 
114
    Type "configure -help" to get a list of all available options.
 
115
 
 
116
    If you are using the "-direct3d" option, make sure that you have
 
117
    the Direct3D SDK installed, and that you have run the
 
118
    %DXSDK_DIR%\Utilities\Bin\dx_setenv.cmd command, before attempting
 
119
    to run configure.
 
120
 
 
121
    The actual commands needed to build Qt depends on your development
 
122
    system. For Microsoft Visual Studio to create the library and
 
123
    compile all the demos, examples, tools and tutorials type:
 
124
 
 
125
        nmake
 
126
 
 
127
    If you need to reconfigure and rebuild Qt from the same location,
 
128
    ensure that all traces of the previous configuration are removed
 
129
    by entering the build directory and typing
 
130
 
 
131
        nmake confclean
 
132
 
 
133
    before running the configure script again.
85
134
 
86
135
5.  That's all. Qt is now installed.
87
136
 
92
141
 
93
142
    You might also want to try the following links:
94
143
 
95
 
        http://doc.trolltech.com/4.5.2/how-to-learn-qt.html
96
 
        http://doc.trolltech.com/4.5.2/tutorial.html
97
 
        http://qtsoftware.com/developer
 
144
        http://qt.nokia.com/doc/4.6.0/how-to-learn-qt.html
 
145
        http://qt.nokia.com/doc/4.6.0/tutorial.html
 
146
        http://qt.nokia.com/developer
98
147
 
99
148
    We hope you will enjoy using Qt. Good luck!