From 1195eb525e324cb501434f370d2f50239168b873 Mon Sep 17 00:00:00 2001
From: Heiko Klare <heiko.klare@vector.com>
Date: Thu, 23 May 2024 15:40:49 +0200
Subject: [PATCH] Add N&N for auto-expand of single child elements in tree
 viewers

See https://github.com/eclipse-platform/eclipse.platform.ui/pull/1072
---
 news/4.32/platform_isv.html | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/news/4.32/platform_isv.html b/news/4.32/platform_isv.html
index dce4412d5..0b539f549 100644
--- a/news/4.32/platform_isv.html
+++ b/news/4.32/platform_isv.html
@@ -38,6 +38,24 @@ <h2>Platform and Equinox API</h2>
   <tr>
     <td id="Platform" class="section" colspan="2"><h2>Platform Changes</h2></td>
   </tr>
+
+  <tr id="treeviewer_autoexpand_singlechild"> <!-- https://github.com/eclipse-platform/eclipse.platform.ui/issues/1063 -->
+    <td class="title">Auto-Expand for Single Child Elements in JFace Tree Viewers</td>
+    <td class="content">
+      <p>
+        The API method
+        <code>org.eclipse.jface.viewers.AbstractTreeViewer.setAutoExpandOnSingleChildLevels(int level)</code> was added to
+        JFace. If this method is called on a tree viewer with some positive value or the constant <code>ALL_LEVELS</code>,
+        expanding a tree item that only has a single child element will lead to a recursive expansion of child items. The
+        recursive expansion stops once an item has more than one child item or the number of expansions reaches the value
+        passed to the method.
+      <p>
+      <p>
+        To ensure backwards compatibility, this feature is disabled by default. Each instantiation of a concrete
+        implementation of <code>AbstractTreeViewer</code> is responsible for enabling this feature if needed.
+      </p>
+    </td>
+  </tr>
   <!-- ******************** End of Platform ********************** -->
 
   <!-- *********************** SWT *********************** -->