From 9fec50c140864dcf2e10ac7a371e188ff971fc9d Mon Sep 17 00:00:00 2001
From: Deepika Udayagiri <deepika.udayagiri@in.ibm.com>
Date: Mon, 17 Nov 2025 15:59:02 +0530
Subject: [PATCH] SWT Javadoc bash for 4.38

Fixes https://github.com/eclipse-platform/eclipse.platform.swt/issues/2788
---
 .../Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java  | 8 ++++++--
 .../Eclipse SWT/cocoa/org/eclipse/swt/widgets/Text.java   | 8 ++++++--
 .../Eclipse SWT/win32/org/eclipse/swt/widgets/Combo.java  | 8 ++++++--
 .../Eclipse SWT/win32/org/eclipse/swt/widgets/Text.java   | 8 ++++++--
 4 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java
index 5cd1adc7731..ebff28ba0c5 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java	
+++ b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Combo.java	
@@ -478,7 +478,6 @@ public Point computeSize (int wHint, int hHint, boolean changed) {
  * <p>
  * The current selection is copied to the clipboard.
  * </p>
- *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1154,7 +1153,12 @@ void mouseDown(long id, long sel, long theEvent) {
  * The selected text is deleted from the widget
  * and new text inserted from the clipboard.
  * </p>
- *
+ * <p>
+ * <strong>Note:</strong> Pasting data to controls may occurs asynchronously. The widget
+ * text may not reflect the updated value immediately after calling this method.
+ * The new text will appear once pending events are processed in the event loop.
+ * Use {@link Display#asyncExec(Runnable)} before accessing <code>getText()</code>.
+ * </p>
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Text.java
index c8f1c744033..4cd3d99b13a 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Text.java	
+++ b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Text.java	
@@ -477,7 +477,6 @@ public Rectangle computeTrim (int x, int y, int width, int height) {
  * <p>
  * The current selection is copied to the clipboard.
  * </p>
- *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1519,7 +1518,12 @@ boolean isNeeded(ScrollBar scrollbar) {
  * The selected text is deleted from the widget
  * and new text inserted from the clipboard.
  * </p>
- *
+ * <p>
+ * <strong>Note:</strong> Pasting data to controls may occurs asynchronously. The widget
+ * text may not reflect the updated value immediately after calling this method.
+ * The new text will appear once pending events are processed in the event loop.
+ * Use {@link Display#asyncExec(Runnable)} before accessing <code>getText()</code>.
+ * </p>
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Combo.java b/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Combo.java
index 3b6d2b4eb23..63d749968d0 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Combo.java	
+++ b/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Combo.java	
@@ -676,7 +676,6 @@ Point computeSizeInPixels (Point hintInPoints, int zoom, boolean changed) {
  * <p>
  * The current selection is copied to the clipboard.
  * </p>
- *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1494,7 +1493,12 @@ public int indexOf (String string, int start) {
  * The selected text is deleted from the widget
  * and new text inserted from the clipboard.
  * </p>
- *
+ * <p>
+ * <strong>Note:</strong> Pasting data to controls may occurs asynchronously. The widget
+ * text may not reflect the updated value immediately after calling this method.
+ * The new text will appear once pending events are processed in the event loop.
+ * Use {@link Display#asyncExec(Runnable)} before accessing <code>getText()</code>.
+ * </p>
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Text.java
index 8c92da7efb2..d2399d764d9 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Text.java	
+++ b/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Text.java	
@@ -790,7 +790,6 @@ Point computeSizeInPixels (Point hintInPoints, int zoom, boolean changed) {
  * <p>
  * The current selection is copied to the clipboard.
  * </p>
- *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1629,7 +1628,12 @@ boolean isUseWsBorder () {
  * The selected text is deleted from the widget
  * and new text inserted from the clipboard.
  * </p>
- *
+ * <p>
+ * <strong>Note:</strong> Pasting data to controls may occurs asynchronously. The widget
+ * text may not reflect the updated value immediately after calling this method.
+ * The new text will appear once pending events are processed in the event loop.
+ * Use {@link Display#asyncExec(Runnable)} before accessing <code>getText()</code>.
+ * </p>
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>