Long live Qt 4.5!

1 files changed, 168 insertions, 0 deletions

diff --git a/doc/src/qtcocoa-known-issues.qdoc b/doc/src/qtcocoa-known-issues.qdoc
new file mode 100644
index 0000000..eedbd68
--- /dev/null
+++ b/doc/src/qtcocoa-known-issues.qdoc
@@ -0,0 +1,168 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: Qt Software Information (qt-info@nokia.com)
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the either Technology Preview License Agreement or the
+** Beta Release License Agreement.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain
+** additional rights. These rights are described in the Nokia Qt LGPL
+** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
+** package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+** If you are unsure which license is appropriate for your use, please
+** contact the sales department at qt-sales@nokia.com.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+    \page qtcocoa-known-issues.html
+    \title Known Issues with the Qt/Mac Cocoa Port
+
+    This document explains the current list of features in the Qt/Mac Cocoa port
+    that are currently not working. Most of the issues will be addressed in
+    upcoming snapshots and beta releases. We hope that all the issues should be
+    addressed by the time the of the final 4.5.0 release.
+
+    \tableofcontents
+
+    \section1 What Works
+    
+    Here are the things that we can say about the current state of the Qt/Mac Cocoa port.
+
+    \list
+    \i \e{64-bit Support}:
+    The Qt libraries currently do build and link as 64-bit frameworks and it is
+    possible to build and run many of the Qt examples as 64-bit.
+
+    \i \e{HIViews are now NSViews}:
+    Every QWidget is now backed by an NSView pointer instead of an HIViewRef.
+    QWidget::winId() will return an NSView pointer that can be used in other
+    Cocoa technologies (e.g., Core Animation).
+
+    \i \e{Some Native Dialogs Work}:
+    QFileDialog and QColorDialog have been ported to use NSOpen-/NSSavePanel and
+    NSColorPanel respectively. QPrintDialog and QPageSetupDialog are not in
+    this release, but are on their way. Currently, none of these dialogs show
+    up as sheets pending the creation of an asynchronous API.
+
+    \i \e{Painting, Printing, and Styles}:
+    Since printing and painting used Quartz 2D and styling used HITheme, these
+    sub-systems work without any changes.
+
+    \i \e {OpenGL}:
+    OpenGL is fully supported,including pixel buffers and framebuffer objects.
+
+    \i \e{Clipboard}:
+    Using QClipboard to copy and paste data works as expected.
+
+    \i \e{Mouse, Keyboard, and Wheel events}:
+    Mouse, keyboard, and wheel events are dispatched to the proper
+    widget. The Qt/Mac Cocoa port respects Cocoa's idea of a "First
+    Responder."
+
+    \endlist
+
+    \section1 Current Known Issues
+
+    The following are items that don't currently work, but that we plan to have
+    resolved before the final release of the Qt/Mac Cocoa port. Please do not
+    file bugs on these. 
+
+    \list
+    \i \e{Carbon Support}:
+    The current source tree for the Qt/Mac Cocoa port contains source for
+    building Qt/Mac with Cocoa. It contains some of the source code that is
+    used for the Carbon port, but it is currently not set up to build the
+    Carbon Qt/Mac libraries. Please use a normal release or snapshot if you
+    want to use Carbon.
+
+    \i \e{Drag and Drop Support}:
+    Drag and Drop is currently not implemented and needs to be ported to Cocoa,
+    but using the clipboard does work at this time.
+
+    \i \e {Accessibility}:
+    Accessibility support is not implemented and needs to be ported to Cocoa.
+
+    \i \e {Text}:
+    Most text rendering works fine for Latin-1 characters. However, rendering
+    non-Latin-1 characters has not been tested.
+
+    \i \e {Input Methods}:
+    Input methods also need to be ported to Cocoa.
+
+    \i \e {Shortcuts}:
+    Shortcuts that exist outside of the menu bar may not be dispatched.
+
+    \i \e {Tablet Support}:
+    The tablet support has not been ported from Carbon yet. However, it should
+    still be possible to use the tablet as a mouse.
+
+    \i \e {Phonon}:
+    Phonon uses the QuickTime backend that is only available on 32-bit. Using
+    Phonon in 64-bit requires a QTKit-based backend and has not been done.
+
+    \i \e {Unified Toolbar}:
+    The QMainWindow::setUnifiedTitleAndToolBarOnMac() method currently does nothing.
+
+    \i \e {Dialogs, Tool Windows, Sheets, and Drawers}:
+    At the moment, all windows are subclasses of NSWindow. This means that
+    window types like drawers and sheets do not work and tool windows do not
+    get the right decorations. Modal dialogs do show up at the correct window
+    level, but are not yet considered "panels." Many window flags are not
+    recognized.
+
+    \endlist
+
+    \section1 Things We Don't Expect to Support
+
+    The following items that we do not plan on spending any resources on unless
+    there is monumental outcry for their inclusion.
+
+    \list 
+    \i \e{Qt3Support}:
+    At this time we have no plans for making the Qt3Support module work with
+    the Qt/Mac Cocoa port in 64-bit mode. Following in footsteps of Apple, we
+    would like to encourage you to consider the time of going Cocoa and 64-bit
+    as a chance to jettison Qt 3 constructs and classes.
+
+    \i \e{Support for versions of Mac OS X below 10.5}:
+    We are using methods and classes that are only available in 10.5 and
+    higher. Most of these functions don't have any equivalent on earlier
+    versions. We recommend using the Carbon version for earlier versions of Mac
+    OS X. We anticipate keeping the Carbon port supported at least for the
+    lifetime of 4.5.
+
+    \i \e{Support for -no-framework or -static}:
+    Cocoa requires that we load a nib in order to properly access the global
+    menu bar. This nib has to reside on disk somewhere. The most logical place
+    for it to reside is inside the QtGui framework. For this reason, building
+    Qt as standard "dylibs" or statically is no longer supported.
+
+    \endlist
+
+*/