util/dist/README
changeset 7 f7bc934e204c
equal deleted inserted replaced
3:41300fa6a67c 7:f7bc934e204c
       
     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 DEMOS AND EXAMPLES
       
    35 
       
    36 Once Qt is installed, we suggest that you take a look at the demos and
       
    37 examples to see Qt in action.
       
    38 
       
    39 For desktop computers, run the Qt Examples and Demos either by
       
    40 typing 'qtdemo' on the command line or through the desktop's Start
       
    41 menu. On Mac OS X, you can find it in /Developers/Applications/Qt.
       
    42 
       
    43 For embedded devices, launch the Qt 'fluidlauncher' demo, either through 
       
    44 the platforms filebrowser or the built in menu system.
       
    45 
       
    46 
       
    47 REFERENCE DOCUMENTATION
       
    48 
       
    49 The Qt reference documentation is available locally in Qt's doc/html
       
    50 directory. You can use Qt Assistant to view it; to launch Assistant,
       
    51 type 'assistant' on the command line or use the Start menu. On Mac OS
       
    52 X, you can find it in /Developer/Applications/Qt.  The latest
       
    53 documentation is available at http://qt.nokia.com/doc/.
       
    54 
       
    55 
       
    56 SUPPORTED PLATFORMS
       
    57 
       
    58 For a complete list of supported platforms, see
       
    59 http://qt.nokia.com/doc/%SHORTVERSION%/supported-platforms.html.
       
    60 
       
    61 
       
    62 COMMERCIAL EDITIONS
       
    63 
       
    64 Desktop Edition licensees can use all the modules provided with their
       
    65 Qt package.
       
    66 
       
    67 GUI Framework licensees may only use the classes contained in
       
    68 the QtCore, QtGui (except QGraphicsView), QtTest, QtDBus and
       
    69 Qt3Support modules.
       
    70 
       
    71 For a full listing of the contents of each module, please refer to 
       
    72 http://qt.nokia.com/doc/%SHORTVERSION%/modules.html
       
    73 
       
    74 
       
    75 HOW TO REPORT A BUG
       
    76 
       
    77 If you think you have found a bug in Qt, we would like to hear about
       
    78 it so that we can fix it.  The Qt bug tracking system is open to the
       
    79 public at http://bugreports.qt.nokia.com/.
       
    80 
       
    81 Before reporting a bug, please use the bug-tracker's search functions
       
    82 and consult http://qt.nokia.com/developer/faqs/ to see if the issue is
       
    83 already known.
       
    84 
       
    85 Always include the following information in your bug report: the name
       
    86 and version number of your compiler; the name and version number of
       
    87 your operating system; the version of Qt you are using, and what
       
    88 configure options it was compiled with.
       
    89 
       
    90 If the problem you are reporting is only visible at run-time, try to
       
    91 create a small test program that shows the problem when run. Often,
       
    92 such a program can be created with some minor changes to one of the many
       
    93 example programs in Qt's examples directory, or to the autotests that
       
    94 are available in the public source repository on http://qt.gitorious.org/.
       
    95 
       
    96 
       
    97 Qt is a trademark of Nokia Corporation and/or its subsidiary(-ies).