After Javadoc Bash for 3.4RC4
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/ByteArrayTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/ByteArrayTransfer.java
index bb4585b..d47fc52 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/ByteArrayTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/ByteArrayTransfer.java
@@ -14,8 +14,7 @@
/**
* The class <code>ByteArrayTransfer</code> provides a platform specific
* mechanism for converting a java <code>byte[]</code> to a platform
- * specific representation of the byte array and vice versa. See
- * <code>Transfer</code> for additional information.
+ * specific representation of the byte array and vice versa.
*
* <p><code>ByteArrayTransfer</code> is never used directly but is sub-classed
* by transfer agents that convert between data in a java format such as a
@@ -115,7 +114,7 @@
* }
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public abstract class ByteArrayTransfer extends Transfer {
@@ -140,14 +139,13 @@
/**
* This implementation of <code>javaToNative</code> converts a java
- * <code>byte[]</code> to a platform specific representation. For additional
- * information see <code>Transfer#javaToNative</code>.
- *
- * @see Transfer#javaToNative
+ * <code>byte[]</code> to a platform specific representation.
*
* @param object a java <code>byte[]</code> containing the data to be converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
protected void javaToNative (Object object, TransferData transferData) {
if (!checkByteArray(object) && !isSupportedType(transferData)) {
@@ -164,14 +162,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a byte array to a java <code>byte[]</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @see Transfer#nativeToJava
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>byte[]</code> containing the converted data if the conversion was
+ * successful; otherwise null
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>byte[]</code> containing the converted data if the
- * conversion was successful; otherwise null
+ * @see Transfer#javaToNative
*/
protected Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/FileTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/FileTransfer.java
index ba7123a..79aa5c6 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/FileTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/FileTransfer.java
@@ -20,7 +20,6 @@
* platform specific representation of the data and vice versa.
* Each <code>String</code> in the array contains the absolute path for a single
* file or directory.
- * See <code>Transfer</code> for additional information.
*
* <p>An example of a java <code>String[]</code> containing a list of files is shown
* below:</p>
@@ -33,7 +32,7 @@
* fileData[1] = file2.getAbsolutePath();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class FileTransfer extends ByteArrayTransfer {
@@ -58,13 +57,13 @@
* This implementation of <code>javaToNative</code> converts a list of file names
* represented by a java <code>String[]</code> to a platform specific representation.
* Each <code>String</code> in the array contains the absolute path for a single
- * file or directory. For additional information see
- * <code>Transfer#javaToNative</code>.
+ * file or directory.
*
- * @param object a java <code>String[]</code> containing the file names to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>String[]</code> containing the file names to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
if (!checkFile(object) || !isSupportedType(transferData)) {
@@ -126,12 +125,12 @@
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a list of file names to a java <code>String[]</code>.
* Each String in the array contains the absolute path for a single file or directory.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String[]</code> containing a list of file names if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String[]</code> containing a list of file names if the conversion
+ * was successful; otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/HTMLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/HTMLTransfer.java
index 142ea24..638a39e 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/HTMLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/HTMLTransfer.java
@@ -15,8 +15,7 @@
/**
* The class <code>HTMLTransfer</code> provides a platform specific mechanism
* for converting text in HTML format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing HTML text is shown
* below:</p>
@@ -25,7 +24,7 @@
* String htmlData = "<p>This is a paragraph of text.</p>";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class HTMLTransfer extends ByteArrayTransfer {
@@ -47,11 +46,12 @@
/**
* This implementation of <code>javaToNative</code> converts HTML-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing HTML text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
if (!checkHTML(object) || !isSupportedType(transferData)) {
@@ -71,12 +71,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of HTML text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing HTML text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing HTML text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/ImageTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/ImageTransfer.java
index 51155ad..467bfc1 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/ImageTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/ImageTransfer.java
@@ -18,19 +18,17 @@
/**
* The class <code>ImageTransfer</code> provides a platform specific mechanism
- * for converting a Image represented as a java <code>ImageData</code> to a
+ * for converting an Image represented as a java <code>ImageData</code> to a
* platform specific representation of the data and vice versa.
- * See <code>Transfer</code> for additional information.
*
- * <p>An example of a java <code>ImageData</code> is shown
- * below:</p>
+ * <p>An example of a java <code>ImageData</code> is shown below:</p>
*
* <code><pre>
- * Image image = new Image("C:\temp\img1.gif");
+ * Image image = new Image(display, "C:\temp\img1.gif");
* ImageData imgData = image.getImageData();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*
* @since 3.4
*/
@@ -57,12 +55,12 @@
/**
* This implementation of <code>javaToNative</code> converts an ImageData object represented
* by java <code>ImageData</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
- * @param object a java <code>ImageData</code> containing the ImageData to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>ImageData</code> containing the ImageData to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
if (!checkImage(object) || !isSupportedType(transferData)) {
@@ -117,12 +115,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of an image to java <code>ImageData</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>ImageData</code> of the image if
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>ImageData</code> of the image if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.data == null)
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/RTFTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/RTFTransfer.java
index a60bf23..7558bc6 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/RTFTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/RTFTransfer.java
@@ -16,8 +16,7 @@
/**
* The class <code>RTFTransfer</code> provides a platform specific mechanism
* for converting text in RTF format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing RTF text is shown
* below:</p>
@@ -26,7 +25,7 @@
* String rtfData = "{\\rtf1{\\colortbl;\\red255\\green0\\blue0;}\\uc1\\b\\i Hello World}";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class RTFTransfer extends ByteArrayTransfer {
@@ -48,11 +47,12 @@
/**
* This implementation of <code>javaToNative</code> converts RTF-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing RTF text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
if (!checkRTF(object) || !isSupportedType(transferData)) {
@@ -86,12 +86,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of RTF text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing RTF text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing RTF text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/TextTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/TextTransfer.java
index 4ff2324..1b323e4 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/TextTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/TextTransfer.java
@@ -26,7 +26,6 @@
* </code></pre>
*
* @see Transfer
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
*/
public class TextTransfer extends ByteArrayTransfer {
@@ -54,10 +53,10 @@
* represented by a java <code>String</code> to a platform specific representation.
*
* @param object a java <code>String</code> containing text
- * @param transferData an empty <code>TransferData</code> object; this object
- * will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
*
- * @see Transfer#javaToNative
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData) {
if (!checkText(object) || !isSupportedType(transferData)) {
@@ -109,7 +108,7 @@
* @param transferData the platform specific representation of the data to be converted
* @return a java <code>String</code> containing text if the conversion was successful; otherwise null
*
- * @see Transfer#nativeToJava
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/URLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/URLTransfer.java
index a1e97aa..af8fcc6 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/URLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/carbon/org/eclipse/swt/dnd/URLTransfer.java
Binary files differ
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/ByteArrayTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/ByteArrayTransfer.java
index bb4585b..d47fc52 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/ByteArrayTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/ByteArrayTransfer.java
@@ -14,8 +14,7 @@
/**
* The class <code>ByteArrayTransfer</code> provides a platform specific
* mechanism for converting a java <code>byte[]</code> to a platform
- * specific representation of the byte array and vice versa. See
- * <code>Transfer</code> for additional information.
+ * specific representation of the byte array and vice versa.
*
* <p><code>ByteArrayTransfer</code> is never used directly but is sub-classed
* by transfer agents that convert between data in a java format such as a
@@ -115,7 +114,7 @@
* }
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public abstract class ByteArrayTransfer extends Transfer {
@@ -140,14 +139,13 @@
/**
* This implementation of <code>javaToNative</code> converts a java
- * <code>byte[]</code> to a platform specific representation. For additional
- * information see <code>Transfer#javaToNative</code>.
- *
- * @see Transfer#javaToNative
+ * <code>byte[]</code> to a platform specific representation.
*
* @param object a java <code>byte[]</code> containing the data to be converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
protected void javaToNative (Object object, TransferData transferData) {
if (!checkByteArray(object) && !isSupportedType(transferData)) {
@@ -164,14 +162,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a byte array to a java <code>byte[]</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @see Transfer#nativeToJava
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>byte[]</code> containing the converted data if the conversion was
+ * successful; otherwise null
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>byte[]</code> containing the converted data if the
- * conversion was successful; otherwise null
+ * @see Transfer#javaToNative
*/
protected Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/FileTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/FileTransfer.java
index ba7123a..79aa5c6 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/FileTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/FileTransfer.java
@@ -20,7 +20,6 @@
* platform specific representation of the data and vice versa.
* Each <code>String</code> in the array contains the absolute path for a single
* file or directory.
- * See <code>Transfer</code> for additional information.
*
* <p>An example of a java <code>String[]</code> containing a list of files is shown
* below:</p>
@@ -33,7 +32,7 @@
* fileData[1] = file2.getAbsolutePath();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class FileTransfer extends ByteArrayTransfer {
@@ -58,13 +57,13 @@
* This implementation of <code>javaToNative</code> converts a list of file names
* represented by a java <code>String[]</code> to a platform specific representation.
* Each <code>String</code> in the array contains the absolute path for a single
- * file or directory. For additional information see
- * <code>Transfer#javaToNative</code>.
+ * file or directory.
*
- * @param object a java <code>String[]</code> containing the file names to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>String[]</code> containing the file names to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
if (!checkFile(object) || !isSupportedType(transferData)) {
@@ -126,12 +125,12 @@
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a list of file names to a java <code>String[]</code>.
* Each String in the array contains the absolute path for a single file or directory.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String[]</code> containing a list of file names if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String[]</code> containing a list of file names if the conversion
+ * was successful; otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/HTMLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/HTMLTransfer.java
index 142ea24..638a39e 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/HTMLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/HTMLTransfer.java
@@ -15,8 +15,7 @@
/**
* The class <code>HTMLTransfer</code> provides a platform specific mechanism
* for converting text in HTML format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing HTML text is shown
* below:</p>
@@ -25,7 +24,7 @@
* String htmlData = "<p>This is a paragraph of text.</p>";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class HTMLTransfer extends ByteArrayTransfer {
@@ -47,11 +46,12 @@
/**
* This implementation of <code>javaToNative</code> converts HTML-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing HTML text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
if (!checkHTML(object) || !isSupportedType(transferData)) {
@@ -71,12 +71,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of HTML text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing HTML text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing HTML text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/ImageTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/ImageTransfer.java
index 51155ad..467bfc1 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/ImageTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/ImageTransfer.java
@@ -18,19 +18,17 @@
/**
* The class <code>ImageTransfer</code> provides a platform specific mechanism
- * for converting a Image represented as a java <code>ImageData</code> to a
+ * for converting an Image represented as a java <code>ImageData</code> to a
* platform specific representation of the data and vice versa.
- * See <code>Transfer</code> for additional information.
*
- * <p>An example of a java <code>ImageData</code> is shown
- * below:</p>
+ * <p>An example of a java <code>ImageData</code> is shown below:</p>
*
* <code><pre>
- * Image image = new Image("C:\temp\img1.gif");
+ * Image image = new Image(display, "C:\temp\img1.gif");
* ImageData imgData = image.getImageData();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*
* @since 3.4
*/
@@ -57,12 +55,12 @@
/**
* This implementation of <code>javaToNative</code> converts an ImageData object represented
* by java <code>ImageData</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
- * @param object a java <code>ImageData</code> containing the ImageData to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>ImageData</code> containing the ImageData to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
if (!checkImage(object) || !isSupportedType(transferData)) {
@@ -117,12 +115,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of an image to java <code>ImageData</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>ImageData</code> of the image if
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>ImageData</code> of the image if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.data == null)
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/RTFTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/RTFTransfer.java
index a60bf23..7558bc6 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/RTFTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/RTFTransfer.java
@@ -16,8 +16,7 @@
/**
* The class <code>RTFTransfer</code> provides a platform specific mechanism
* for converting text in RTF format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing RTF text is shown
* below:</p>
@@ -26,7 +25,7 @@
* String rtfData = "{\\rtf1{\\colortbl;\\red255\\green0\\blue0;}\\uc1\\b\\i Hello World}";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class RTFTransfer extends ByteArrayTransfer {
@@ -48,11 +47,12 @@
/**
* This implementation of <code>javaToNative</code> converts RTF-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing RTF text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
if (!checkRTF(object) || !isSupportedType(transferData)) {
@@ -86,12 +86,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of RTF text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing RTF text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing RTF text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/TextTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/TextTransfer.java
index 6b0f1de..dad30d6 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/TextTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/TextTransfer.java
@@ -26,7 +26,6 @@
* </code></pre>
*
* @see Transfer
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
*/
public class TextTransfer extends ByteArrayTransfer {
@@ -52,10 +51,10 @@
* represented by a java <code>String</code> to a platform specific representation.
*
* @param object a java <code>String</code> containing text
- * @param transferData an empty <code>TransferData</code> object; this object
- * will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
*
- * @see Transfer#javaToNative
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData) {
if (!checkText(object) || !isSupportedType(transferData)) {
@@ -106,7 +105,7 @@
* @param transferData the platform specific representation of the data to be converted
* @return a java <code>String</code> containing text if the conversion was successful; otherwise null
*
- * @see Transfer#nativeToJava
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.data == null) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/URLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/URLTransfer.java
index 7330434..01c4161 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/URLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/cocoa/org/eclipse/swt/dnd/URLTransfer.java
Binary files differ
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/ByteArrayTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/ByteArrayTransfer.java
index fac09a7..fce2e57 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/ByteArrayTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/ByteArrayTransfer.java
@@ -14,8 +14,7 @@
/**
* The class <code>ByteArrayTransfer</code> provides a platform specific
* mechanism for converting a java <code>byte[]</code> to a platform
- * specific representation of the byte array and vice versa. See
- * <code>Transfer</code> for additional information.
+ * specific representation of the byte array and vice versa.
*
* <p><code>ByteArrayTransfer</code> is never used directly but is sub-classed
* by transfer agents that convert between data in a java format such as a
@@ -115,7 +114,7 @@
* }
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public abstract class ByteArrayTransfer extends Transfer {
@@ -129,14 +128,13 @@
/**
* This implementation of <code>javaToNative</code> converts a java
- * <code>byte[]</code> to a platform specific representation. For additional
- * information see <code>Transfer#javaToNative</code>.
- *
- * @see Transfer#javaToNative
+ * <code>byte[]</code> to a platform specific representation.
*
* @param object a java <code>byte[]</code> containing the data to be converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
protected void javaToNative (Object object, TransferData transferData) {
}
@@ -144,14 +142,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a byte array to a java <code>byte[]</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @see Transfer#nativeToJava
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>byte[]</code> containing the converted data if the conversion was
+ * successful; otherwise null
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>byte[]</code> containing the converted data if the
- * conversion was successful; otherwise null
+ * @see Transfer#javaToNative
*/
protected Object nativeToJava(TransferData transferData) {
return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/FileTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/FileTransfer.java
index 16b6400..e2a5395 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/FileTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/FileTransfer.java
@@ -17,7 +17,6 @@
* platform specific representation of the data and vice versa.
* Each <code>String</code> in the array contains the absolute path for a single
* file or directory.
- * See <code>Transfer</code> for additional information.
*
* <p>An example of a java <code>String[]</code> containing a list of files is shown
* below:</p>
@@ -30,7 +29,7 @@
* fileData[1] = file2.getAbsolutePath();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class FileTransfer extends ByteArrayTransfer {
@@ -47,13 +46,13 @@
* This implementation of <code>javaToNative</code> converts a list of file names
* represented by a java <code>String[]</code> to a platform specific representation.
* Each <code>String</code> in the array contains the absolute path for a single
- * file or directory. For additional information see
- * <code>Transfer#javaToNative</code>.
+ * file or directory.
*
- * @param object a java <code>String[]</code> containing the file names to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>String[]</code> containing the file names to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
}
@@ -61,12 +60,12 @@
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a list of file names to a java <code>String[]</code>.
* Each String in the array contains the absolute path for a single file or directory.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String[]</code> containing a list of file names if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String[]</code> containing a list of file names if the conversion
+ * was successful; otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/HTMLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/HTMLTransfer.java
index dc6472c..6b77424 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/HTMLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/HTMLTransfer.java
@@ -13,8 +13,7 @@
/**
* The class <code>HTMLTransfer</code> provides a platform specific mechanism
* for converting text in HTML format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing HTML text is shown
* below:</p>
@@ -23,7 +22,7 @@
* String htmlData = "<p>This is a paragraph of text.</p>";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class HTMLTransfer extends ByteArrayTransfer {
@@ -46,23 +45,24 @@
/**
* This implementation of <code>javaToNative</code> converts HTML-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing HTML text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
}
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of HTML text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing HTML text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing HTML text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/ImageTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/ImageTransfer.java
index 0aba6cd..2ba21c0 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/ImageTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/ImageTransfer.java
@@ -12,19 +12,17 @@
/**
* The class <code>ImageTransfer</code> provides a platform specific mechanism
- * for converting a Image represented as a java <code>ImageData</code> to a
+ * for converting an Image represented as a java <code>ImageData</code> to a
* platform specific representation of the data and vice versa.
- * See <code>Transfer</code> for additional information.
*
- * <p>An example of a java <code>ImageData</code> is shown
- * below:</p>
+ * <p>An example of a java <code>ImageData</code> is shown below:</p>
*
* <code><pre>
- * Image image = new Image("C:\temp\img1.gif");
+ * Image image = new Image(display, "C:\temp\img1.gif");
* ImageData imgData = image.getImageData();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*
* @since 3.4
*/
@@ -44,12 +42,12 @@
/**
* This implementation of <code>javaToNative</code> converts an ImageData object represented
* by java <code>ImageData</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
- * @param object a java <code>ImageData</code> containing the ImageData to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>ImageData</code> containing the ImageData to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
}
@@ -57,12 +55,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of an image to java <code>ImageData</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>ImageData</code> of the image if
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>ImageData</code> of the image if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/RTFTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/RTFTransfer.java
index e1dd9f0..b3a4179 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/RTFTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/RTFTransfer.java
@@ -14,8 +14,7 @@
/**
* The class <code>RTFTransfer</code> provides a platform specific mechanism
* for converting text in RTF format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing RTF text is shown
* below:</p>
@@ -24,7 +23,7 @@
* String rtfData = "{\\rtf1{\\colortbl;\\red255\\green0\\blue0;}\\uc1\\b\\i Hello World}";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class RTFTransfer extends ByteArrayTransfer {
@@ -49,23 +48,24 @@
/**
* This implementation of <code>javaToNative</code> converts RTF-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing RTF text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
}
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of RTF text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing RTF text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing RTF text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/TextTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/TextTransfer.java
index 99f7411..eb3f21d 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/TextTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/TextTransfer.java
@@ -24,7 +24,6 @@
* </code></pre>
*
* @see Transfer
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
*/
public class TextTransfer extends ByteArrayTransfer {
@@ -51,10 +50,10 @@
* represented by a java <code>String</code> to a platform specific representation.
*
* @param object a java <code>String</code> containing text
- * @param transferData an empty <code>TransferData</code> object; this object
- * will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
*
- * @see Transfer#javaToNative
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
}
@@ -65,7 +64,7 @@
* @param transferData the platform specific representation of the data to be converted
* @return a java <code>String</code> containing text if the conversion was successful; otherwise null
*
- * @see Transfer#nativeToJava
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/URLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/URLTransfer.java
index 0beb83d..d0cfe6e 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/URLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/URLTransfer.java
@@ -13,18 +13,16 @@
/**
* The class <code>URLTransfer</code> provides a platform specific mechanism
* for converting text in URL format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information. The string
+ * to a platform specific representation of the data and vice versa. The string
* must contain a fully specified url.
*
- * <p>An example of a java <code>String</code> containing a URL is shown
- * below:</p>
+ * <p>An example of a java <code>String</code> containing a URL is shown below:</p>
*
* <code><pre>
* String url = "http://www.eclipse.org";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class URLTransfer extends ByteArrayTransfer {
@@ -42,24 +40,25 @@
/**
* This implementation of <code>javaToNative</code> converts a URL
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing a URL
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
}
/**
- * This implementation of <code>nativeToJava</code> converts a platform specific
- * representation of a URL to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
+ * This implementation of <code>nativeToJava</code> converts a platform
+ * specific representation of a URL to a java <code>String</code>.
*
- * @param transferData the platform specific representation of the data to be
- * converted
- * @return a java <code>String</code> containing a URL if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing a URL if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/ByteArrayTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/ByteArrayTransfer.java
index f077436..8ec57d7 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/ByteArrayTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/ByteArrayTransfer.java
@@ -15,8 +15,7 @@
/**
* The class <code>ByteArrayTransfer</code> provides a platform specific
* mechanism for converting a java <code>byte[]</code> to a platform
- * specific representation of the byte array and vice versa. See
- * <code>Transfer</code> for additional information.
+ * specific representation of the byte array and vice versa.
*
* <p><code>ByteArrayTransfer</code> is never used directly but is sub-classed
* by transfer agents that convert between data in a java format such as a
@@ -116,7 +115,7 @@
* }
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public abstract class ByteArrayTransfer extends Transfer {
@@ -141,14 +140,13 @@
/**
* This implementation of <code>javaToNative</code> converts a java
- * <code>byte[]</code> to a platform specific representation. For additional
- * information see <code>Transfer#javaToNative</code>.
- *
- * @see Transfer#javaToNative
+ * <code>byte[]</code> to a platform specific representation.
*
* @param object a java <code>byte[]</code> containing the data to be converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
protected void javaToNative (Object object, TransferData transferData) {
transferData.result = 0;
@@ -169,14 +167,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a byte array to a java <code>byte[]</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @see Transfer#nativeToJava
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>byte[]</code> containing the converted data if the conversion was
+ * successful; otherwise null
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>byte[]</code> containing the converted data if the
- * conversion was successful; otherwise null
+ * @see Transfer#javaToNative
*/
protected Object nativeToJava(TransferData transferData) {
if ( !isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/FileTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/FileTransfer.java
index 7106f12..a592b56 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/FileTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/FileTransfer.java
@@ -18,7 +18,6 @@
* platform specific representation of the data and vice versa.
* Each <code>String</code> in the array contains the absolute path for a single
* file or directory.
- * See <code>Transfer</code> for additional information.
*
* <p>An example of a java <code>String[]</code> containing a list of files is shown
* below:</p>
@@ -31,7 +30,7 @@
* fileData[1] = file2.getAbsolutePath();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class FileTransfer extends ByteArrayTransfer {
@@ -55,13 +54,13 @@
* This implementation of <code>javaToNative</code> converts a list of file names
* represented by a java <code>String[]</code> to a platform specific representation.
* Each <code>String</code> in the array contains the absolute path for a single
- * file or directory. For additional information see
- * <code>Transfer#javaToNative</code>.
+ * file or directory.
*
- * @param object a java <code>String[]</code> containing the file names to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>String[]</code> containing the file names to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
transferData.result = 0;
@@ -115,12 +114,12 @@
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a list of file names to a java <code>String[]</code>.
* Each String in the array contains the absolute path for a single file or directory.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String[]</code> containing a list of file names if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String[]</code> containing a list of file names if the conversion
+ * was successful; otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if ( !isSupportedType(transferData) || transferData.pValue == 0 || transferData.length <= 0 ) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/HTMLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/HTMLTransfer.java
index 65a1493..67f62de 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/HTMLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/HTMLTransfer.java
@@ -15,8 +15,7 @@
/**
* The class <code>HTMLTransfer</code> provides a platform specific mechanism
* for converting text in HTML format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing HTML text is shown
* below:</p>
@@ -25,7 +24,7 @@
* String htmlData = "<p>This is a paragraph of text.</p>";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class HTMLTransfer extends ByteArrayTransfer {
@@ -49,11 +48,12 @@
/**
* This implementation of <code>javaToNative</code> converts HTML-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing HTML text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
transferData.result = 0;
@@ -77,12 +77,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of HTML text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing HTML text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing HTML text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if ( !isSupportedType(transferData) || transferData.pValue == 0 ) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/ImageTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/ImageTransfer.java
index 360244a..d030689 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/ImageTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/ImageTransfer.java
@@ -18,19 +18,17 @@
/**
* The class <code>ImageTransfer</code> provides a platform specific mechanism
- * for converting a Image represented as a java <code>ImageData</code> to a
+ * for converting an Image represented as a java <code>ImageData</code> to a
* platform specific representation of the data and vice versa.
- * See <code>Transfer</code> for additional information.
*
- * <p>An example of a java <code>ImageData</code> is shown
- * below:</p>
+ * <p>An example of a java <code>ImageData</code> is shown below:</p>
*
* <code><pre>
- * Image image = new Image("C:\temp\img1.gif");
+ * Image image = new Image(display, "C:\temp\img1.gif");
* ImageData imgData = image.getImageData();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*
* @since 3.4
*/
@@ -75,12 +73,12 @@
/**
* This implementation of <code>javaToNative</code> converts an ImageData object represented
* by java <code>ImageData</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
- * @param object a java <code>ImageData</code> containing the ImageData to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>ImageData</code> containing the ImageData to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
if (!checkImage(object) || !isSupportedType(transferData)) {
@@ -127,12 +125,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of an image to java <code>ImageData</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>ImageData</code> of the image if
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>ImageData</code> of the image if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
ImageData imgData = null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/RTFTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/RTFTransfer.java
index f3de70b..1941ebb 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/RTFTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/RTFTransfer.java
@@ -16,8 +16,7 @@
/**
* The class <code>RTFTransfer</code> provides a platform specific mechanism
* for converting text in RTF format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing RTF text is shown
* below:</p>
@@ -26,7 +25,7 @@
* String rtfData = "{\\rtf1{\\colortbl;\\red255\\green0\\blue0;}\\uc1\\b\\i Hello World}";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class RTFTransfer extends ByteArrayTransfer {
@@ -52,11 +51,12 @@
/**
* This implementation of <code>javaToNative</code> converts RTF-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing RTF text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
transferData.result = 0;
@@ -77,12 +77,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of RTF text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing RTF text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing RTF text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if ( !isSupportedType(transferData) || transferData.pValue == 0 ) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/TextTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/TextTransfer.java
index 988351b..80a6015 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/TextTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/TextTransfer.java
@@ -26,7 +26,6 @@
* </code></pre>
*
* @see Transfer
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
*/
public class TextTransfer extends ByteArrayTransfer {
@@ -54,10 +53,10 @@
* represented by a java <code>String</code> to a platform specific representation.
*
* @param object a java <code>String</code> containing text
- * @param transferData an empty <code>TransferData</code> object; this object
- * will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
*
- * @see Transfer#javaToNative
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData) {
transferData.result = 0;
@@ -107,7 +106,7 @@
* @param transferData the platform specific representation of the data to be converted
* @return a java <code>String</code> containing text if the conversion was successful; otherwise null
*
- * @see Transfer#nativeToJava
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/URLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/URLTransfer.java
index 6dedda0..7797370 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/URLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/gtk/org/eclipse/swt/dnd/URLTransfer.java
@@ -15,18 +15,16 @@
/**
* The class <code>URLTransfer</code> provides a platform specific mechanism
* for converting text in URL format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information. The string
+ * to a platform specific representation of the data and vice versa. The string
* must contain a fully specified url.
*
- * <p>An example of a java <code>String</code> containing a URL is shown
- * below:</p>
+ * <p>An example of a java <code>String</code> containing a URL is shown below:</p>
*
* <code><pre>
* String url = "http://www.eclipse.org";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class URLTransfer extends ByteArrayTransfer {
@@ -50,11 +48,12 @@
/**
* This implementation of <code>javaToNative</code> converts a URL
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing a URL
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
transferData.result = 0;
@@ -76,14 +75,14 @@
}
/**
- * This implementation of <code>nativeToJava</code> converts a platform specific
- * representation of a URL to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
+ * This implementation of <code>nativeToJava</code> converts a platform
+ * specific representation of a URL to a java <code>String</code>.
*
- * @param transferData the platform specific representation of the data to be
- * converted
- * @return a java <code>String</code> containing a URL if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing a URL if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/ByteArrayTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/ByteArrayTransfer.java
index 1b1b9a8..670f738 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/ByteArrayTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/ByteArrayTransfer.java
@@ -15,8 +15,7 @@
/**
* The class <code>ByteArrayTransfer</code> provides a platform specific
* mechanism for converting a java <code>byte[]</code> to a platform
- * specific representation of the byte array and vice versa. See
- * <code>Transfer</code> for additional information.
+ * specific representation of the byte array and vice versa.
*
* <p><code>ByteArrayTransfer</code> is never used directly but is sub-classed
* by transfer agents that convert between data in a java format such as a
@@ -116,7 +115,7 @@
* }
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public abstract class ByteArrayTransfer extends Transfer {
@@ -141,14 +140,13 @@
/**
* This implementation of <code>javaToNative</code> converts a java
- * <code>byte[]</code> to a platform specific representation. For additional
- * information see <code>Transfer#javaToNative</code>.
- *
- * @see Transfer#javaToNative
+ * <code>byte[]</code> to a platform specific representation.
*
* @param object a java <code>byte[]</code> containing the data to be converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
protected void javaToNative (Object object, TransferData transferData) {
transferData.result = 0;
@@ -168,14 +166,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a byte array to a java <code>byte[]</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @see Transfer#nativeToJava
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>byte[]</code> containing the converted data if the conversion was
+ * successful; otherwise null
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>byte[]</code> containing the converted data if the
- * conversion was successful; otherwise null
+ * @see Transfer#javaToNative
*/
protected Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/FileTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/FileTransfer.java
index 6a97716..233b9ac 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/FileTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/FileTransfer.java
@@ -19,7 +19,6 @@
* platform specific representation of the data and vice versa.
* Each <code>String</code> in the array contains the absolute path for a single
* file or directory.
- * See <code>Transfer</code> for additional information.
*
* <p>An example of a java <code>String[]</code> containing a list of files is shown
* below:</p>
@@ -32,7 +31,7 @@
* fileData[1] = file2.getAbsolutePath();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class FileTransfer extends ByteArrayTransfer {
@@ -57,13 +56,13 @@
* This implementation of <code>javaToNative</code> converts a list of file names
* represented by a java <code>String[]</code> to a platform specific representation.
* Each <code>String</code> in the array contains the absolute path for a single
- * file or directory. For additional information see
- * <code>Transfer#javaToNative</code>.
+ * file or directory.
*
- * @param object a java <code>String[]</code> containing the file names to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>String[]</code> containing the file names to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
transferData.result = 0;
@@ -90,12 +89,12 @@
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a list of file names to a java <code>String[]</code>.
* Each String in the array contains the absolute path for a single file or directory.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String[]</code> containing a list of file names if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String[]</code> containing a list of file names if the conversion
+ * was successful; otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/HTMLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/HTMLTransfer.java
index 35ccb70..f8054f1 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/HTMLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/HTMLTransfer.java
@@ -15,8 +15,7 @@
/**
* The class <code>HTMLTransfer</code> provides a platform specific mechanism
* for converting text in HTML format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing HTML text is shown
* below:</p>
@@ -25,7 +24,7 @@
* String htmlData = "<p>This is a paragraph of text.</p>";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class HTMLTransfer extends ByteArrayTransfer {
@@ -49,11 +48,12 @@
/**
* This implementation of <code>javaToNative</code> converts HTML-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing HTML text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
transferData.result = 0;
@@ -77,12 +77,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of HTML text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing HTML text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing HTML text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if ( !isSupportedType(transferData) || transferData.pValue == 0 ) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/ImageTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/ImageTransfer.java
index f180f5f..6a6fe56 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/ImageTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/ImageTransfer.java
@@ -17,19 +17,17 @@
/**
* The class <code>ImageTransfer</code> provides a platform specific mechanism
- * for converting a Image represented as a java <code>ImageData</code> to a
+ * for converting an Image represented as a java <code>ImageData</code> to a
* platform specific representation of the data and vice versa.
- * See <code>Transfer</code> for additional information.
*
- * <p>An example of a java <code>ImageData</code> is shown
- * below:</p>
+ * <p>An example of a java <code>ImageData</code> is shown below:</p>
*
* <code><pre>
- * Image image = new Image("C:\temp\img1.gif");
+ * Image image = new Image(display, "C:\temp\img1.gif");
* ImageData imgData = image.getImageData();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*
* @since 3.4
*/
@@ -54,12 +52,12 @@
/**
* This implementation of <code>javaToNative</code> converts an ImageData object represented
* by java <code>ImageData</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
- * @param object a java <code>ImageData</code> containing the ImageData to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>ImageData</code> containing the ImageData to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
if (!checkImage(object) || !isSupportedType(transferData)) {
@@ -81,12 +79,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of an image to java <code>ImageData</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>ImageData</code> of the image if
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>ImageData</code> of the image if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/RTFTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/RTFTransfer.java
index 5c634a6..00b822b 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/RTFTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/RTFTransfer.java
@@ -16,8 +16,7 @@
/**
* The class <code>RTFTransfer</code> provides a platform specific mechanism
* for converting text in RTF format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing RTF text is shown
* below:</p>
@@ -26,7 +25,7 @@
* String rtfData = "{\\rtf1{\\colortbl;\\red255\\green0\\blue0;}\\uc1\\b\\i Hello World}";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class RTFTransfer extends ByteArrayTransfer {
@@ -52,11 +51,12 @@
/**
* This implementation of <code>javaToNative</code> converts RTF-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing RTF text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
transferData.result = 0;
@@ -77,12 +77,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of RTF text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing RTF text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing RTF text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if ( !isSupportedType(transferData) || transferData.pValue == 0 ) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/TextTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/TextTransfer.java
index 197d6bf..dfd8b7e 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/TextTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/TextTransfer.java
@@ -28,7 +28,6 @@
* </code></pre>
*
* @see Transfer
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
*/
public class TextTransfer extends ByteArrayTransfer {
@@ -54,10 +53,10 @@
* represented by a java <code>String</code> to a platform specific representation.
*
* @param object a java <code>String</code> containing text
- * @param transferData an empty <code>TransferData</code> object; this object
- * will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
*
- * @see Transfer#javaToNative
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData) {
transferData.result = 0;
@@ -109,7 +108,7 @@
* @param transferData the platform specific representation of the data to be converted
* @return a java <code>String</code> containing text if the conversion was successful; otherwise null
*
- * @see Transfer#nativeToJava
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/URLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/URLTransfer.java
index 40ed069..95379c6 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/URLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/motif/org/eclipse/swt/dnd/URLTransfer.java
@@ -15,18 +15,16 @@
/**
* The class <code>URLTransfer</code> provides a platform specific mechanism
* for converting text in URL format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information. The string
+ * to a platform specific representation of the data and vice versa. The string
* must contain a fully specified url.
*
- * <p>An example of a java <code>String</code> containing a URL is shown
- * below:</p>
+ * <p>An example of a java <code>String</code> containing a URL is shown below:</p>
*
* <code><pre>
* String url = "http://www.eclipse.org";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class URLTransfer extends ByteArrayTransfer {
@@ -51,11 +49,12 @@
/**
* This implementation of <code>javaToNative</code> converts a URL
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing a URL
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
transferData.result = 0;
@@ -77,14 +76,14 @@
}
/**
- * This implementation of <code>nativeToJava</code> converts a platform specific
- * representation of a URL to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
+ * This implementation of <code>nativeToJava</code> converts a platform
+ * specific representation of a URL to a java <code>String</code>.
*
- * @param transferData the platform specific representation of the data to be
- * converted
- * @return a java <code>String</code> containing a URL if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing a URL if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if ( !isSupportedType(transferData) || transferData.pValue == 0 ) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/ByteArrayTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/ByteArrayTransfer.java
index 3a947db..a6e20dc 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/ByteArrayTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/ByteArrayTransfer.java
@@ -16,8 +16,7 @@
/**
* The class <code>ByteArrayTransfer</code> provides a platform specific
* mechanism for converting a java <code>byte[]</code> to a platform
- * specific representation of the byte array and vice versa. See
- * <code>Transfer</code> for additional information.
+ * specific representation of the byte array and vice versa.
*
* <p><code>ByteArrayTransfer</code> is never used directly but is sub-classed
* by transfer agents that convert between data in a java format such as a
@@ -117,7 +116,7 @@
* }
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public abstract class ByteArrayTransfer extends Transfer {
@@ -141,14 +140,13 @@
/**
* This implementation of <code>javaToNative</code> converts a java
- * <code>byte[]</code> to a platform specific representation. For additional
- * information see <code>Transfer#javaToNative</code>.
- *
- * @see Transfer#javaToNative
+ * <code>byte[]</code> to a platform specific representation.
*
* @param object a java <code>byte[]</code> containing the data to be converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
protected void javaToNative (Object object, TransferData transferData){
if (!checkByteArray(object) || !isSupportedType(transferData)) {
@@ -164,14 +162,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a byte array to a java <code>byte[]</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @see Transfer#nativeToJava
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>byte[]</code> containing the converted data if the conversion was
+ * successful; otherwise null
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>byte[]</code> containing the converted data if the
- * conversion was successful; otherwise null
+ * @see Transfer#javaToNative
*/
protected Object nativeToJava(TransferData transferData){
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/FileTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/FileTransfer.java
index d2ab481..0b1fa27 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/FileTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/FileTransfer.java
@@ -18,7 +18,6 @@
* platform specific representation of the data and vice versa.
* Each <code>String</code> in the array contains the absolute path for a single
* file or directory.
- * See <code>Transfer</code> for additional information.
*
* <p>An example of a java <code>String[]</code> containing a list of files is shown
* below:</p>
@@ -31,7 +30,7 @@
* fileData[1] = file2.getAbsolutePath();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class FileTransfer extends ByteArrayTransfer {
@@ -52,13 +51,13 @@
* This implementation of <code>javaToNative</code> converts a list of file names
* represented by a java <code>String[]</code> to a platform specific representation.
* Each <code>String</code> in the array contains the absolute path for a single
- * file or directory. For additional information see
- * <code>Transfer#javaToNative</code>.
+ * file or directory.
*
- * @param object a java <code>String[]</code> containing the file names to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>String[]</code> containing the file names to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
if (!checkFile(object) || !isSupportedType(transferData)) {
@@ -80,12 +79,12 @@
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a list of file names to a java <code>String[]</code>.
* Each String in the array contains the absolute path for a single file or directory.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String[]</code> containing a list of file names if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String[]</code> containing a list of file names if the conversion
+ * was successful; otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/HTMLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/HTMLTransfer.java
index 64ce6bf..9426e60 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/HTMLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/HTMLTransfer.java
@@ -16,8 +16,7 @@
/**
* The class <code>HTMLTransfer</code> provides a platform specific mechanism
* for converting text in HTML format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing HTML text is shown
* below:</p>
@@ -26,7 +25,7 @@
* String htmlData = "<p>This is a paragraph of text.</p>";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class HTMLTransfer extends ByteArrayTransfer {
@@ -47,11 +46,12 @@
/**
* This implementation of <code>javaToNative</code> converts HTML-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing HTML text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
if (!checkHTML(object) || !isSupportedType(transferData)) {
@@ -64,12 +64,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of HTML text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing HTML text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing HTML text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/ImageTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/ImageTransfer.java
index 0aba6cd..2ba21c0 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/ImageTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/ImageTransfer.java
@@ -12,19 +12,17 @@
/**
* The class <code>ImageTransfer</code> provides a platform specific mechanism
- * for converting a Image represented as a java <code>ImageData</code> to a
+ * for converting an Image represented as a java <code>ImageData</code> to a
* platform specific representation of the data and vice versa.
- * See <code>Transfer</code> for additional information.
*
- * <p>An example of a java <code>ImageData</code> is shown
- * below:</p>
+ * <p>An example of a java <code>ImageData</code> is shown below:</p>
*
* <code><pre>
- * Image image = new Image("C:\temp\img1.gif");
+ * Image image = new Image(display, "C:\temp\img1.gif");
* ImageData imgData = image.getImageData();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*
* @since 3.4
*/
@@ -44,12 +42,12 @@
/**
* This implementation of <code>javaToNative</code> converts an ImageData object represented
* by java <code>ImageData</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
- * @param object a java <code>ImageData</code> containing the ImageData to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>ImageData</code> containing the ImageData to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
}
@@ -57,12 +55,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of an image to java <code>ImageData</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>ImageData</code> of the image if
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>ImageData</code> of the image if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/RTFTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/RTFTransfer.java
index bcccfe9..691fd43 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/RTFTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/RTFTransfer.java
@@ -17,8 +17,7 @@
/**
* The class <code>RTFTransfer</code> provides a platform specific mechanism
* for converting text in RTF format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing RTF text is shown
* below:</p>
@@ -27,7 +26,7 @@
* String rtfData = "{\\rtf1{\\colortbl;\\red255\\green0\\blue0;}\\uc1\\b\\i Hello World}";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class RTFTransfer extends ByteArrayTransfer {
@@ -48,11 +47,12 @@
/**
* This implementation of <code>javaToNative</code> converts RTF-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing RTF text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
if (!checkRTF(object) || !isSupportedType(transferData)) {
@@ -65,12 +65,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of RTF text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing RTF text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing RTF text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/TextTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/TextTransfer.java
index 69a89c3..da5f66d 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/TextTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/TextTransfer.java
@@ -27,7 +27,6 @@
* </code></pre>
*
* @see Transfer
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
*/
public class TextTransfer extends ByteArrayTransfer {
@@ -50,10 +49,10 @@
* represented by a java <code>String</code> to a platform specific representation.
*
* @param object a java <code>String</code> containing text
- * @param transferData an empty <code>TransferData</code> object; this object
- * will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
*
- * @see Transfer#javaToNative
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
if (!checkText(object) || !isSupportedType(transferData)) {
@@ -70,7 +69,7 @@
* @param transferData the platform specific representation of the data to be converted
* @return a java <code>String</code> containing text if the conversion was successful; otherwise null
*
- * @see Transfer#nativeToJava
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/URLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/URLTransfer.java
index 0beb83d..d0cfe6e 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/URLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/photon/org/eclipse/swt/dnd/URLTransfer.java
@@ -13,18 +13,16 @@
/**
* The class <code>URLTransfer</code> provides a platform specific mechanism
* for converting text in URL format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information. The string
+ * to a platform specific representation of the data and vice versa. The string
* must contain a fully specified url.
*
- * <p>An example of a java <code>String</code> containing a URL is shown
- * below:</p>
+ * <p>An example of a java <code>String</code> containing a URL is shown below:</p>
*
* <code><pre>
* String url = "http://www.eclipse.org";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class URLTransfer extends ByteArrayTransfer {
@@ -42,24 +40,25 @@
/**
* This implementation of <code>javaToNative</code> converts a URL
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing a URL
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
}
/**
- * This implementation of <code>nativeToJava</code> converts a platform specific
- * representation of a URL to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
+ * This implementation of <code>nativeToJava</code> converts a platform
+ * specific representation of a URL to a java <code>String</code>.
*
- * @param transferData the platform specific representation of the data to be
- * converted
- * @return a java <code>String</code> containing a URL if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing a URL if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/ByteArrayTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/ByteArrayTransfer.java
index 1e5bbfb..3643bb1 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/ByteArrayTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/ByteArrayTransfer.java
@@ -16,8 +16,7 @@
/**
* The class <code>ByteArrayTransfer</code> provides a platform specific
* mechanism for converting a java <code>byte[]</code> to a platform
- * specific representation of the byte array and vice versa. See
- * <code>Transfer</code> for additional information.
+ * specific representation of the byte array and vice versa.
*
* <p><code>ByteArrayTransfer</code> is never used directly but is sub-classed
* by transfer agents that convert between data in a java format such as a
@@ -117,7 +116,7 @@
* }
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public abstract class ByteArrayTransfer extends Transfer {
@@ -155,14 +154,13 @@
/**
* This implementation of <code>javaToNative</code> converts a java
- * <code>byte[]</code> to a platform specific representation. For additional
- * information see <code>Transfer#javaToNative</code>.
- *
- * @see Transfer#javaToNative
+ * <code>byte[]</code> to a platform specific representation.
*
* @param object a java <code>byte[]</code> containing the data to be converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
protected void javaToNative (Object object, TransferData transferData) {
if (!checkByteArray(object) || !isSupportedType(transferData)) {
@@ -181,14 +179,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a byte array to a java <code>byte[]</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @see Transfer#nativeToJava
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>byte[]</code> containing the converted data if the conversion was
+ * successful; otherwise null
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>byte[]</code> containing the converted data if the
- * conversion was successful; otherwise null
+ * @see Transfer#javaToNative
*/
protected Object nativeToJava(TransferData transferData) {
if ( !isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/FileTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/FileTransfer.java
index ebf9a92..83ca6da 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/FileTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/FileTransfer.java
@@ -18,7 +18,6 @@
* platform specific representation of the data and vice versa.
* Each <code>String</code> in the array contains the absolute path for a single
* file or directory.
- * See <code>Transfer</code> for additional information.
*
* <p>An example of a java <code>String[]</code> containing a list of files is shown
* below:</p>
@@ -31,7 +30,7 @@
* fileData[1] = file2.getAbsolutePath();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class FileTransfer extends ByteArrayTransfer {
@@ -73,13 +72,13 @@
* This implementation of <code>javaToNative</code> converts a list of file names
* represented by a java <code>String[]</code> to a platform specific representation.
* Each <code>String</code> in the array contains the absolute path for a single
- * file or directory. For additional information see
- * <code>Transfer#javaToNative</code>.
+ * file or directory.
*
- * @param object a java <code>String[]</code> containing the file names to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>String[]</code> containing the file names to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
if (!checkFile(object) || !isSupportedType(transferData)) {
@@ -102,12 +101,12 @@
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of a list of file names to a java <code>String[]</code>.
* Each String in the array contains the absolute path for a single file or directory.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String[]</code> containing a list of file names if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String[]</code> containing a list of file names if the conversion
+ * was successful; otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/HTMLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/HTMLTransfer.java
index 3949fef..462ab89 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/HTMLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/HTMLTransfer.java
@@ -15,8 +15,7 @@
/**
* The class <code>HTMLTransfer</code> provides a platform specific mechanism
* for converting text in HTML format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing HTML text is shown
* below:</p>
@@ -25,7 +24,7 @@
* String htmlData = "<p>This is a paragraph of text.</p>";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class HTMLTransfer extends ByteArrayTransfer {
@@ -62,11 +61,12 @@
/**
* This implementation of <code>javaToNative</code> converts HTML-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing HTML text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
if (!checkHTML(object) || !isSupportedType(transferData)) {
@@ -78,12 +78,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of HTML text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing HTML text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing HTML text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/ImageTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/ImageTransfer.java
index 173d9d4..cbd3a8c 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/ImageTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/ImageTransfer.java
@@ -16,19 +16,17 @@
/**
* The class <code>ImageTransfer</code> provides a platform specific mechanism
- * for converting a Image represented as a java <code>ImageData</code> to a
+ * for converting an Image represented as a java <code>ImageData</code> to a
* platform specific representation of the data and vice versa.
- * See <code>Transfer</code> for additional information.
*
- * <p>An example of a java <code>ImageData</code> is shown
- * below:</p>
+ * <p>An example of a java <code>ImageData</code> is shown below:</p>
*
* <code><pre>
- * Image image = new Image("C:\temp\img1.gif");
+ * Image image = new Image(display, "C:\temp\img1.gif");
* ImageData imgData = image.getImageData();
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*
* @since 3.4
*/
@@ -58,12 +56,12 @@
/**
* This implementation of <code>javaToNative</code> converts an ImageData object represented
* by java <code>ImageData</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
- * @param object a java <code>ImageData</code> containing the ImageData to be
- * converted
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param object a java <code>ImageData</code> containing the ImageData to be converted
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative(Object object, TransferData transferData) {
if (!checkImage(object) || !isSupportedType(transferData)) {
@@ -79,12 +77,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of an image to java <code>ImageData</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>ImageData</code> of the image if
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>ImageData</code> of the image if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/RTFTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/RTFTransfer.java
index 0d07c6b..36dbbe8 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/RTFTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/RTFTransfer.java
@@ -16,8 +16,7 @@
/**
* The class <code>RTFTransfer</code> provides a platform specific mechanism
* for converting text in RTF format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information.
+ * to a platform specific representation of the data and vice versa.
*
* <p>An example of a java <code>String</code> containing RTF text is shown
* below:</p>
@@ -26,7 +25,7 @@
* String rtfData = "{\\rtf1{\\colortbl;\\red255\\green0\\blue0;}\\uc1\\b\\i Hello World}";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class RTFTransfer extends ByteArrayTransfer {
@@ -63,11 +62,12 @@
/**
* This implementation of <code>javaToNative</code> converts RTF-formatted text
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing RTF text
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData) {
if (!checkRTF(object) || !isSupportedType(transferData)) {
@@ -79,12 +79,12 @@
/**
* This implementation of <code>nativeToJava</code> converts a platform specific
* representation of RTF text to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
*
- * @param transferData the platform specific representation of the data to be
- * been converted
- * @return a java <code>String</code> containing RTF text if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing RTF text if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/TextTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/TextTransfer.java
index 591a840..cb69118 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/TextTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/TextTransfer.java
@@ -26,7 +26,6 @@
* </code></pre>
*
* @see Transfer
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
*/
public class TextTransfer extends ByteArrayTransfer {
@@ -65,10 +64,10 @@
* represented by a java <code>String</code> to a platform specific representation.
*
* @param object a java <code>String</code> containing text
- * @param transferData an empty <code>TransferData</code> object; this object
- * will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
*
- * @see Transfer#javaToNative
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData) {
if (!checkText(object) || !isSupportedType(transferData)) {
@@ -84,7 +83,7 @@
* @param transferData the platform specific representation of the data to be converted
* @return a java <code>String</code> containing text if the conversion was successful; otherwise null
*
- * @see Transfer#nativeToJava
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData) {
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/URLTransfer.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/URLTransfer.java
index 5075979..df701b8 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/URLTransfer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/wpf/org/eclipse/swt/dnd/URLTransfer.java
@@ -15,18 +15,16 @@
/**
* The class <code>URLTransfer</code> provides a platform specific mechanism
* for converting text in URL format represented as a java <code>String</code>
- * to a platform specific representation of the data and vice versa. See
- * <code>Transfer</code> for additional information. The string
+ * to a platform specific representation of the data and vice versa. The string
* must contain a fully specified url.
*
- * <p>An example of a java <code>String</code> containing a URL is shown
- * below:</p>
+ * <p>An example of a java <code>String</code> containing a URL is shown below:</p>
*
* <code><pre>
* String url = "http://www.eclipse.org";
* </code></pre>
*
- * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
+ * @see Transfer
*/
public class URLTransfer extends ByteArrayTransfer {
@@ -48,11 +46,12 @@
/**
* This implementation of <code>javaToNative</code> converts a URL
* represented by a java <code>String</code> to a platform specific representation.
- * For additional information see <code>Transfer#javaToNative</code>.
*
* @param object a java <code>String</code> containing a URL
- * @param transferData an empty <code>TransferData</code> object; this
- * object will be filled in on return with the platform specific format of the data
+ * @param transferData an empty <code>TransferData</code> object that will
+ * be filled in on return with the platform specific format of the data
+ *
+ * @see Transfer#nativeToJava
*/
public void javaToNative (Object object, TransferData transferData){
if (!checkURL(object) || !isSupportedType(transferData)) {
@@ -73,14 +72,14 @@
}
/**
- * This implementation of <code>nativeToJava</code> converts a platform specific
- * representation of a URL to a java <code>String</code>.
- * For additional information see <code>Transfer#nativeToJava</code>.
+ * This implementation of <code>nativeToJava</code> converts a platform
+ * specific representation of a URL to a java <code>String</code>.
*
- * @param transferData the platform specific representation of the data to be
- * converted
- * @return a java <code>String</code> containing a URL if the
- * conversion was successful; otherwise null
+ * @param transferData the platform specific representation of the data to be converted
+ * @return a java <code>String</code> containing a URL if the conversion was successful;
+ * otherwise null
+ *
+ * @see Transfer#javaToNative
*/
public Object nativeToJava(TransferData transferData){
if (!isSupportedType(transferData) || transferData.pValue == 0) return null;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/ProgressBar.java b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/ProgressBar.java
index 3562de6..462d4be 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/ProgressBar.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/ProgressBar.java
@@ -153,8 +153,12 @@
}
/**
- * Returns the state of the receiver. The value will be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Returns the state of the receiver. The value will be one of:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @return the state
*
@@ -240,8 +244,12 @@
}
/**
- * Sets the state of the receiver. The state is be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Sets the state of the receiver. The state must be one of these values:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @param state the new state
*
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/ProgressBar.java b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/ProgressBar.java
index ad6aab9..df11c79 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/ProgressBar.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/ProgressBar.java
@@ -156,8 +156,12 @@
}
/**
- * Returns the state of the receiver. The value will be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Returns the state of the receiver. The value will be one of:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @return the state
*
@@ -229,8 +233,12 @@
}
/**
- * Sets the state of the receiver. The state is be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Sets the state of the receiver. The state must be one of these values:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @param state the new state
*
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/ProgressBar.java b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/ProgressBar.java
index 3ea95df..4cf7447 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/ProgressBar.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/ProgressBar.java
@@ -139,8 +139,12 @@
}
/**
- * Returns the state of the receiver. The value will be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Returns the state of the receiver. The value will be one of:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @return the state
*
@@ -245,8 +249,12 @@
}
/**
- * Sets the state of the receiver. The state is be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Sets the state of the receiver. The state must be one of these values:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @param state the new state
*
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/ProgressBar.java b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/ProgressBar.java
index ce33f37..9dc714e 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/ProgressBar.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/ProgressBar.java
@@ -196,8 +196,12 @@
return minimum + (foreground != -1 ? 0 : sliderSize);
}
/**
- * Returns the state of the receiver. The value will be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Returns the state of the receiver. The value will be one of:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @return the state
*
@@ -318,8 +322,12 @@
update ();
}
/**
- * Sets the state of the receiver. The state is be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Sets the state of the receiver. The state must be one of these values:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @param state the new state
*
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/ProgressBar.java b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/ProgressBar.java
index 9475bb6..ded5b8f 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/ProgressBar.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/ProgressBar.java
@@ -177,8 +177,12 @@
}
/**
- * Returns the state of the receiver. The value will be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Returns the state of the receiver. The value will be one of:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @return the state
*
@@ -254,8 +258,12 @@
}
/**
- * Sets the state of the receiver. The state is be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Sets the state of the receiver. The state must be one of these values:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @param state the new state
*
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/ProgressBar.java b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/ProgressBar.java
index b5908e9..52fa2fe 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/ProgressBar.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/ProgressBar.java
@@ -148,8 +148,12 @@
}
/**
- * Returns the state of the receiver. The value will be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Returns the state of the receiver. The value will be one of:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @return the state
*
@@ -232,8 +236,12 @@
}
/**
- * Sets the state of the receiver. The state is be one of
- * <code>NORMAL</code>, <code>ERROR</code> or <code>PAUSED</code>.
+ * Sets the state of the receiver. The state must be one of these values:
+ * <ul>
+ * <li>{@link SWT#NORMAL}</li>
+ * <li>{@link SWT#ERROR}</li>
+ * <li>{@link SWT#PAUSED}</li>
+ * </ul>
*
* @param state the new state
*
