Add release notes for v0.4.2.

beeware · Feb 6, 2024 · 283e763 · 283e763
1 parent da48449
commit 283e763
Show file tree

Hide file tree

Showing 44 changed files with 47 additions and 49 deletions.
diff --git a/changes/1798.doc.rst b/changes/1798.doc.rst
diff --git a/changes/2190.bugfix.rst b/changes/2190.bugfix.rst
diff --git a/changes/2190.feature.1.rst b/changes/2190.feature.1.rst
diff --git a/changes/2190.feature.2.rst b/changes/2190.feature.2.rst
diff --git a/changes/2190.removal.rst b/changes/2190.removal.rst
diff --git a/changes/2211.bugfix.rst b/changes/2211.bugfix.rst
diff --git a/changes/2266.feature.rst b/changes/2266.feature.rst
diff --git a/changes/2298.misc.rst b/changes/2298.misc.rst
diff --git a/changes/2299.misc.rst b/changes/2299.misc.rst
diff --git a/changes/2302.misc.rst b/changes/2302.misc.rst
diff --git a/changes/2312.misc.rst b/changes/2312.misc.rst
diff --git a/changes/2313.misc.rst b/changes/2313.misc.rst
diff --git a/changes/2318.misc.rst b/changes/2318.misc.rst
diff --git a/changes/2319.bugfix.rst b/changes/2319.bugfix.rst
diff --git a/changes/2319.removal.rst b/changes/2319.removal.rst
diff --git a/changes/2331.misc.rst b/changes/2331.misc.rst
diff --git a/changes/2332.misc.rst b/changes/2332.misc.rst
diff --git a/changes/2333.misc.rst b/changes/2333.misc.rst
diff --git a/changes/2336.misc.rst b/changes/2336.misc.rst
diff --git a/changes/2337.misc.rst b/changes/2337.misc.rst
diff --git a/changes/2338.bugfix.rst b/changes/2338.bugfix.rst
diff --git a/changes/2339.misc.rst b/changes/2339.misc.rst
diff --git a/changes/2340.misc.rst b/changes/2340.misc.rst
diff --git a/changes/2346.feature.rst b/changes/2346.feature.rst
diff --git a/changes/2347.bugfix.rst b/changes/2347.bugfix.rst
diff --git a/changes/2348.doc.rst b/changes/2348.doc.rst
diff --git a/changes/2353.feature.rst b/changes/2353.feature.rst
diff --git a/changes/2353.removal.rst b/changes/2353.removal.rst
diff --git a/changes/2355.bugfix.rst b/changes/2355.bugfix.rst
diff --git a/changes/2357.misc.rst b/changes/2357.misc.rst
diff --git a/changes/2358.misc.rst b/changes/2358.misc.rst
diff --git a/changes/2359.misc.rst b/changes/2359.misc.rst
diff --git a/changes/2363.misc.rst b/changes/2363.misc.rst
diff --git a/changes/2367.misc.rst b/changes/2367.misc.rst
diff --git a/changes/2368.misc.rst b/changes/2368.misc.rst
diff --git a/changes/2369.misc.rst b/changes/2369.misc.rst
diff --git a/changes/2370.misc.rst b/changes/2370.misc.rst
diff --git a/changes/2371.misc.rst b/changes/2371.misc.rst
diff --git a/changes/2374.bugfix.rst b/changes/2374.bugfix.rst
diff --git a/changes/2375.misc.rst b/changes/2375.misc.rst
diff --git a/changes/2376.misc.rst b/changes/2376.misc.rst
diff --git a/changes/774.feature.rst b/changes/774.feature.rst
diff --git a/docs/background/project/releases.rst b/docs/background/project/releases.rst
@@ -6,6 +6,48 @@ Release History
 
 .. towncrier release notes start
 
+0.4.2 (2024-02-06)
+==================
+
+Features
+--------
+
+* Buttons can now be created with an icon, instead of a text label. (`#774 <https://github.com/beeware/toga/issues/774>`__)
+* Widgets and Windows can now be sorted. The ID of the widget is used for the sorting order. (`#2190 <https://github.com/beeware/toga/issues/2190>`__)
+* The main window generated by the default ``startup()`` method of an app now has an ID of ``main``. (`#2190 <https://github.com/beeware/toga/issues/2190>`__)
+* A cross-platform API for camera access was added. (`#2266 <https://github.com/beeware/toga/issues/2266>`__, `#2353 <https://github.com/beeware/toga/issues/2353>`__)
+* An OptionContainer widget was added for Android. (`#2346 <https://github.com/beeware/toga/issues/2346>`__)
+
+Bugfixes
+--------
+
+* New widgets with an ID matching an ID that was previously used no longer cause an error. (`#2190 <https://github.com/beeware/toga/issues/2190>`__)
+* ``App.current_window`` on GTK now returns ``None`` when all windows are hidden. (`#2211 <https://github.com/beeware/toga/issues/2211>`__)
+* Selection widgets on macOS can now include duplicated titles. (`#2319 <https://github.com/beeware/toga/issues/2319>`__)
+* The padding around DetailedList on Android has been reduced. (`#2338 <https://github.com/beeware/toga/issues/2338>`__)
+* The error returned when an Image is created with no source has been clarified. (`#2347 <https://github.com/beeware/toga/issues/2347>`__)
+* On macOS, ``toga.Image`` objects can now be created from raw data that didn't originate from a file. (`#2355 <https://github.com/beeware/toga/issues/2355>`__)
+* Winforms no longer generates a system beep when pressing Enter in a TextInput. (`#2374 <https://github.com/beeware/toga/issues/2374>`__)
+
+Backward Incompatible Changes
+-----------------------------
+
+* Widgets must now be added to a window to be available in the widget registry for lookup by ID. (`#2190 <https://github.com/beeware/toga/issues/2190>`__)
+* If the label for a Selection contains newlines, only the text up to the first newline will be displayed. (`#2319 <https://github.com/beeware/toga/issues/2319>`__)
+* The internal Android method ``intent_result`` has been deprecated. This was an internal API, and not formally documented, but it was the easiest mechanism for invoking Intents on the Android backend. It has been replaced by the synchronous ``start_activity`` method that allows you to register a callback when the intent completes. (`#2353 <https://github.com/beeware/toga/issues/2353>`__)
+
+Documentation
+-------------
+
+* Initial documentation of backend-specific features has been added. (`#1798 <https://github.com/beeware/toga/issues/1798>`__)
+* The difference between Icon and Image was clarified, and a note about the lack of an ``on_press`` handler on ImageView was added. (`#2348 <https://github.com/beeware/toga/issues/2348>`__)
+
+Misc
+----
+
+* `#2298 <https://github.com/beeware/toga/issues/2298>`__, `#2299 <https://github.com/beeware/toga/issues/2299>`__, `#2302 <https://github.com/beeware/toga/issues/2302>`__, `#2312 <https://github.com/beeware/toga/issues/2312>`__, `#2313 <https://github.com/beeware/toga/issues/2313>`__, `#2318 <https://github.com/beeware/toga/issues/2318>`__, `#2331 <https://github.com/beeware/toga/issues/2331>`__, `#2332 <https://github.com/beeware/toga/issues/2332>`__, `#2333 <https://github.com/beeware/toga/issues/2333>`__, `#2336 <https://github.com/beeware/toga/issues/2336>`__, `#2337 <https://github.com/beeware/toga/issues/2337>`__, `#2339 <https://github.com/beeware/toga/issues/2339>`__, `#2340 <https://github.com/beeware/toga/issues/2340>`__, `#2357 <https://github.com/beeware/toga/issues/2357>`__, `#2358 <https://github.com/beeware/toga/issues/2358>`__, `#2359 <https://github.com/beeware/toga/issues/2359>`__, `#2363 <https://github.com/beeware/toga/issues/2363>`__, `#2367 <https://github.com/beeware/toga/issues/2367>`__, `#2368 <https://github.com/beeware/toga/issues/2368>`__, `#2369 <https://github.com/beeware/toga/issues/2369>`__, `#2370 <https://github.com/beeware/toga/issues/2370>`__, `#2371 <https://github.com/beeware/toga/issues/2371>`__, `#2375 <https://github.com/beeware/toga/issues/2375>`__, `#2376 <https://github.com/beeware/toga/issues/2376>`__
+
+
 0.4.1 (2023-12-21)
 ==================
 

diff --git a/docs/how-to/internal/release.rst b/docs/how-to/internal/release.rst
@@ -37,16 +37,14 @@ The procedure for cutting a new release is as follows:
 
  $ tox -e towncrier
 
- to generate the updated release notes. After doing any edits that may be
- required, run:
+ to generate the updated release notes.
 
- .. code-block:: console
+#. Build the documentation to ensure that the new release notes don't include any
+ spelling errors or markup problems:
 
-  $ tox -r -e docs-lint,docs
+ .. code-block:: console
 
- to confirm that there are no spelling errors or formatting problems with the
- new release notes, and the docs build using the current documentation tool
- versions.
+ $ tox -e docs-lint,docs
 
 #. Tag the release, and push the branch and tag upstream: