dist/README

   1 This is Qt version %VERSION%.
   2
   3 Qt is a comprehensive cross-platform C++ application framework. Qt 4
   4 introduces new features and many improvements over the 3.x series. See
   5 http://qt.nokia.com/doc/latest/qt4-intro.html for details.
   6
   7 The Qt 4.x series is not binary compatible or source compatible with
   8 the 3.x series. For more information on porting from Qt 3 to Qt 4, see
   9 http://qt.nokia.com/doc/latest/porting4.html.
  10
  11
  12 INSTALLING Qt
  13
  14 If you have a source package (a .tar.gz, or .zip file), follow the
  15 instructions in the INSTALL file.
  16
  17 On Windows and Mac OS X, if you want to install the precompiled binary
  18 packages, simply launch the package and follow the instructions in the
  19 installation wizard.
  20
  21 For Mac OS X Carbon, the binary package requires Mac OS X 10.4 (Tiger) or
  22 later and GCC 4.0.1 to develop applications. Its applications will run
  23 on Mac OS X 10.4 and above.
  24
  25 For Mac OS X Cocoa, the binary package requires Mac OS X 10.5 (Leopard) or
  26 later and GCC 4.0.1 to develop applications.  Its applications will run
  27 on Mac OS X 10.5 and above.
  28
  29 If you want to install the precompiled binary package for Symbian,
  30 follow these instructions:
  31 http://qt.nokia.com/doc/%SHORTVERSION%/install-symbian-installer.html
  32
  33
  34 EXAMPLES
  35
  36 Once Qt is installed, we suggest that you take a look at the examples
  37 to see Qt in action.
  38
  39 For desktop computers, run the Qt Examples by opening them in Qt Creator.
  40
  41 For embedded devices, launch the Qt 'fluidlauncher' example, either through
  42 the platforms filebrowser or the built in menu system.
  43
  44
  45 REFERENCE DOCUMENTATION
  46
  47 The Qt reference documentation is available locally in Qt's doc/html
  48 directory. You can use Qt Assistant to view it; to launch Assistant,
  49 type 'assistant' on the command line or use the Start menu. On Mac OS
  50 X, you can find it in /Developer/Applications/Qt.  The latest
  51 documentation is available at http://qt.nokia.com/doc/.
  52
  53
  54 SUPPORTED PLATFORMS
  55
  56 For a complete list of supported platforms, see
  57 http://qt.nokia.com/doc/%SHORTVERSION%/supported-platforms.html.
  58
  59
  60 COMMERCIAL EDITIONS
  61
  62 Desktop Edition licensees can use all the modules provided with their
  63 Qt package.
  64
  65 GUI Framework licensees may only use the classes contained in
  66 the QtCore, QtGui (except QGraphicsView), QtTest, QtDBus and
  67 Qt3Support modules.
  68
  69 For a full listing of the contents of each module, please refer to
  70 http://qt.nokia.com/doc/%SHORTVERSION%/modules.html
  71
  72
  73 HOW TO REPORT A BUG
  74
  75 If you think you have found a bug in Qt, we would like to hear about
  76 it so that we can fix it.  The Qt bug tracking system is open to the
  77 public at http://bugreports.qt-project.org/.
  78
  79 Before reporting a bug, please use the bug-tracker's search functions
  80 and consult http://qt.nokia.com/developer/faqs/ to see if the issue is
  81 already known.
  82
  83 Always include the following information in your bug report: the name
  84 and version number of your compiler; the name and version number of
  85 your operating system; the version of Qt you are using, and what
  86 configure options it was compiled with.
  87
  88 If the problem you are reporting is only visible at run-time, try to
  89 create a small test program that shows the problem when run. Often,
  90 such a program can be created with some minor changes to one of the many
  91 example programs in Qt's examples directory, or to the autotests that
  92 are available in the public source repository on http://qt.gitorious.org/.
  93
  94
  95 Qt is a trademark of Nokia Corporation and/or its subsidiary(-ies).