From fb71853bdc3a8389d78c64906d76eb3f448b9663 Mon Sep 17 00:00:00 2001
From: Matthias Becker <ma.becker@sap.com>
Date: Wed, 7 Feb 2024 10:18:01 +0000
Subject: [PATCH] Document "Incremental View Updates" preference (#1775)

Refer to:
https://github.com/eclipse-platform/eclipse.platform.ui/issues/1626
---
 .../reference/ref-10.htm                       | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.user/reference/ref-10.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.user/reference/ref-10.htm
index f826396dcf2..b1b77500a2b 100644
--- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.user/reference/ref-10.htm
+++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.user/reference/ref-10.htm
@@ -22,20 +22,20 @@ <h1 class="Head">General</h1>
   'javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ui.preferencePages.Workbench)")'>
   <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> <strong>General</strong></a> preference
   page.</p>
-  <table width="75%" border="1">
+  <table width="80%" border="1" cellspacing="0" cellpadding="5">
     <tr>
       <td><strong>Option</strong></td>
       <td><strong>Description</strong></td>
       <td><strong>Default</strong></td>
     </tr>
     <tr>
-      <td>Always run in background</td>
+      <td>Always Run in Background</td>
       <td>Turn this option on to perform long running operations in the background without blocking you from doing
       other work.<br></td>
       <td>Off<br></td>
     </tr>
     <tr>
-      <td>Keep next/previous part dialog open</td>
+      <td>Keep Next/Previous Part Dialog Open</td>
       <td>If this option is turned on then the editor and view cycle dialogs will remain open when their activation key
       is let go. Normally the dialog closes as soon as the key combination is release.</td>
       <td>Off</td>
@@ -46,9 +46,17 @@ <h1 class="Head">General</h1>
       <td>Off<br></td>
     </tr>
     <tr>
-      <td>Workbench save interval</td>
+      <td>Initial Maximum Number of Elements Shown in Views</td>
+      <td>Specifies the limit for incremental view updates. Package Explorer, Project Explorer, Problems View, Java Outline View and JUnit View will 
+          limit the number of initially shown children per parent element.<br/>
+          This avoids UI freezes in large viewers, where the limits of the underlying user interface toolkit are hit while trying 
+          to render thousands of elements, leading to minute long UI freezes.<br/>Set it to 0 to disabl this feature.</td>
+      <td>1000<br></td>
+    </tr>
+    <tr>
+      <td>Workbench Save Interval</td>
       <td>The field indicates how often the state of the workbench like perspective layouts and open editors is
-      automatically saved to disk. Set to 0 to disable.<br></td>
+      automatically saved to disk.<br/>Set it to 0 to disable this feature<br></td>
       <td>5<br></td>
     </tr>
     <tr>