This file contains some do's and dont's for the Qt2 frontend.
-Random crashes
---------------
-
-Both xforms and Qt use X error handlers which collide - if you get
-crashes, try lyx -sync, which seems to help.
-
General rules
-------------
Every non-trivial widget should have a tooltip. If you don't know
what to write, write "FIXME", and it can fixed later. Don't be afraid
to use QWhatsThis too, but this must be done in the derived class's
-constructor, and use _("...").
+constructor, and use _("..."). Non-trivial means that things like "OK"
+/must not/ have a tooltip.
+
+*DO NOT USE DESIGNER FROM Qt 3*. You must use a designer from Qt 2 to
+maintain compatibility.
+
+Remember to check tab order on a dialog (third icon, with blue bars in designer).
+Remember to check sensible resizing behaviour on a dialog.
+
+Remember to use Edit->Check Accelerators
+
If necessary, you should override Qt2Base::isValid() for determining the validity
of the current dialog's contents.
(FIXME: complete this)
-Dialog Maintainer MVC conversion
-----------------------------------------------
-About John Done
-Bibitem John Done
-Bibtex John Done
-Character Edwin Done
-Citation Kalle Done
-Document Kalle Waiting for MVC
-ERT John Done
-Error John Done
-External John Done
-Graphics John Done
-Include John Done
-Index Kalle Done
-Log John Done
-Minipage John Done
-Paragraph Edwin Waiting for MVC
-Preamble John Done
-Print Edwin Done
-Ref Kalle Done
-Search Edwin Done
-Spellchecker John Done
-Splash Edwin
-Tabular Waiting for MVC
-TabularCreate Edwin Done
-Thesaurus John Done
-Toc Kalle Waiting to be updated
-Url Kalle Done
-VCLog John Done
+Stuff to be aware of
+--------------------
+
+The connect statement in Qt is a macro and its arguments does not follow
+the C++ standard as it should. Using the construct "Type const &" as
+argument will lead to runtime-errors, use "const Type &" instead.
+
+ex.
+
+--right--
+
+ connect(list, SIGNAL(selected(const QString &)),
+ this, SLOT(complete_selected(const QString &)));
+
+--wrong--
+
+ connect(list, SIGNAL(selected(QString const &)),
+ this, SLOT(complete_selected(QString const &)));
+
+Qt, Unicode, and LyX
+--------------------
+
+LyX isn't unicoded yet. But you should follow these simple rules :
+
+o Use qt_() not _() in code
+o Use fromqstr and toqstr NOT .latin1() / .c_str()
+
+Using these functions (in qt_helpers.h) will make sure we use
+the right locale for converting to Qt's QString, which is unicode.