Update docs in preparation for a 7.4.0 release. (#1916)

* Update docs in preparation for a 7.4.0 release. * Forgot a contributor. * Add a last-minute bugfix. * Update wording for EnumEditor separators. * Update CHANGES.txt Co-authored-by: Mark Dickinson <[email protected]> Co-authored-by: Mark Dickinson <[email protected]>
enthought · Jun 29, 2022 · db42349 · db42349
1 parent fe429e5
commit db42349
Show file tree

Hide file tree

Showing 10 changed files with 59 additions and 8 deletions.
diff --git a/CHANGES.txt b/CHANGES.txt
@@ -1,6 +1,48 @@
 Traits UI Changelog
 ===================
 
+Release 7.4.0
+-------------
+
+This is a minor release which fixes a number of bugs and adds a couple of
+small features.  The most significant changes are the ability to add separators
+to EnumEditor comboboxes, the ability to use Pyface action Schemas for menu bars
+and toolbars in Views, and getting the VideoEditor working against the new
+QtMultimedia APIs in Qt6.
+
+Thanks To
+~~~~~~~~~
+
+* Aaron Ayres
+* Mark Dickinson
+* Rahul Poruri
+* PyHannes
+* Prabhu Ramachandran
+* Ioannis Tziakos
+* Corran Webster
+* John Wiggins
+* Hai Yan
+
+Features
+~~~~~~~~
+* Separators in Combobox EnumEditors. (#1885)
+* Allow the use of Pyface Schemas for View menus and toolbars. (#1827)
+
+Fixes
+~~~~~
+* Delay imports which force toolkit selection (#1883)
+* Fix ImageEditor paintEvent when image is None. (#1907)
+* Fix VideoEditor for Qt6 (#1908)
+* Fix the ImageEnumEditor on Qt5+ (#1910)
+* Fix some height and width calls for Qt and Python 3.10+ (#1911)
+* Fix a crash on PyQt5 when a Group has no content (#1914)
+* Numerous fixes for tests and CI (#1897, #1893, #1889, #1894, #1898, #1899,
+  #1990, #1902, #1903)
+
+Documentation changes
+~~~~~~~~~~~~~~~~~~~~~
+* Add a copy button to code blocks in documentation (#1904)
+
 Release 7.3.1
 -------------
 

diff --git a/docs/releases/upcoming/1827.feature.rst b/docs/releases/upcoming/1827.feature.rst
diff --git a/docs/releases/upcoming/1904.doc.rst b/docs/releases/upcoming/1904.doc.rst
diff --git a/docs/releases/upcoming/1907.bugfix.rst b/docs/releases/upcoming/1907.bugfix.rst
diff --git a/docs/releases/upcoming/1908.bugfix.rst b/docs/releases/upcoming/1908.bugfix.rst
diff --git a/docs/releases/upcoming/1910.bugfix.rst b/docs/releases/upcoming/1910.bugfix.rst
diff --git a/docs/releases/upcoming/1911.bugfix.rst b/docs/releases/upcoming/1911.bugfix.rst
diff --git a/docs/source/traitsui_user_manual/factories_basic.rst b/docs/source/traitsui_user_manual/factories_basic.rst
@@ -474,7 +474,8 @@ EnumEditor()
 :Required parameters:
     for non-Enum traits: *values* or *name*
 :Optional parameters:
-    *cols*, *evaluate*, *mode*, *completion_mode* (Qt only)
+    *cols*, *evaluate*, *mode*, *completion_mode* (Qt only), *use_separator*
+    (Qt only), *separator* (Qt only)
 
 The editors generated by EnumEditor() enable the user to pick a single value
 from a closed set of values.
@@ -503,7 +504,10 @@ If the trait attribute that is being edited is not an enumeration, you must
 specify either the trait attribute (with the *name* parameter), or the set of
 values to display (with the *values* parameter). The *name* parameter can be an
 extended trait name. The *values* parameter can be a list, tuple, or dictionary,
-or a "mapped" trait.
+or a "mapped" trait.  When using *names* or *values*, the *use_separator* flag
+replaces any occurences of the value specified by *separator* with a separator
+in the pop-up menu, allowing grouping of entries (this is currently only
+supported in the Qt backend).
 
 By default, an enumeration editor sorts its values alphabetically. To specify a
 different order for the items, give it a mapping from the normal values to ones

diff --git a/docs/source/traitsui_user_manual/handler.rst b/docs/source/traitsui_user_manual/handler.rst
@@ -561,6 +561,16 @@ created, as in the following code::
        toolbar=ToolBar(my_action),
     )
 
+Schemas
+:::::::
+
+Pyface also provides action Schemas as a way to specify MenuBars, Toolbars and
+their components without instantiating them.  These are particularly used in
+the Tasks framework.  TraitsUI supports their use in Views, permitting better
+interoperability.  The primary advantage of Schemas is that the deferred
+instantiation makes it less likely to have unintentionally shared state between
+declarative Views.
+
 
 .. _undo_redo:
 

diff --git a/traitsui/tree_node.py b/traitsui/tree_node.py
@@ -100,6 +100,7 @@ class TreeNode(HasPrivateTraits):
 
     #: List of object classes than can be added or copied. Elements of the list
     #: can be either:
+    #:
     #: - the klass itself that can be added or copied
     #: - 2-tuples of the form (klass, prompt) in which case klass is as above
     #:   and prompt is a boolean indicating whether or not to prompt the user