Bug 408957 - Improve API doc for Text.getTextChars() and setTextChars()
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 a0999ea..a4270d2 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
@@ -1,5 +1,5 @@
/*******************************************************************************
- * Copyright (c) 2000, 2011 IBM Corporation and others.
+ * Copyright (c) 2000, 2013 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
@@ -1211,7 +1211,12 @@
* The text for a text widget is the characters in the widget, or
* a zero-length array if this has never been set.
* </p>
- *
+ * <p>
+ * Note: Use the API to protect the text, for example, when widget is used as
+ * a password field. However, the text can't be protected if Segment listener
+ * is added to the widget.
+ * </p>
+ *
* @return a character array that contains the widget's text
*
* @exception SWTException <ul>
@@ -2105,7 +2110,12 @@
* Sets the contents of the receiver to the characters in the array. If the receiver
* has style <code>SWT.SINGLE</code> and the argument contains multiple lines of text
* then the result of this operation is undefined and may vary between platforms.
- *
+ * <p>
+ * Note: Use the API to protect the text, for example, when widget is used as
+ * a password field. However, the text can't be protected if Verify or
+ * Segment listener is added to the widget.
+ * </p>
+ *
* @param text a character array that contains the new text
*
* @exception IllegalArgumentException <ul>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java
index 458777e..4aa53ea 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java
@@ -1264,6 +1264,11 @@
* The text for a text widget is the characters in the widget, or
* a zero-length array if this has never been set.
* </p>
+ * <p>
+ * Note: Use the API to protect the text, for example, when widget is used as
+ * a password field. However, the text can't be protected if Segment listener
+ * is added to the widget.
+ * </p>
*
* @return a character array that contains the widget's text
*
@@ -2437,7 +2442,12 @@
* Sets the contents of the receiver to the characters in the array. If the receiver
* has style <code>SWT.SINGLE</code> and the argument contains multiple lines of text
* then the result of this operation is undefined and may vary between platforms.
- *
+ * <p>
+ * Note: Use the API to protect the text, for example, when widget is used as
+ * a password field. However, the text can't be protected if Verify or
+ * Segment listener is added to the widget.
+ * </p>
+ *
* @param text a character array that contains the new text
*
* @exception IllegalArgumentException <ul>
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 dbd7539..5d1ce85 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
@@ -1360,7 +1360,12 @@
* The text for a text widget is the characters in the widget, or
* a zero-length array if this has never been set.
* </p>
- *
+ * <p>
+ * Note: Use the API to protect the text, for example, when widget is used as
+ * a password field. However, the text can't be protected if Segment listener
+ * is added to the widget.
+ * </p>
+ *
* @return a character array that contains the widget's text
*
* @exception SWTException <ul>
@@ -2264,6 +2269,11 @@
* Sets the contents of the receiver to the characters in the array. If the receiver
* has style <code>SWT.SINGLE</code> and the argument contains multiple lines of text
* then the result of this operation is undefined and may vary between platforms.
+ * <p>
+ * Note: Use the API to protect the text, for example, when the widget is used as
+ * a password field. However, the text can't be protected if Verify or
+ * Segment listener is added to the widget.
+ * </p>
*
* @param text a character array that contains the new text
*
