From 8ab7a0a4080884fb25ce51806d12c3f8b6808539 Mon Sep 17 00:00:00 2001
From: Bruno Sinou <bsinou@argeo.org>
Date: Mon, 20 Jan 2014 20:28:34 +0000
Subject: [PATCH] Remove weird deprecation Tag and enhence comments.

git-svn-id: https://svn.argeo.org/commons/trunk@6734 4cfe0d0a-d680-48aa-b62c-e0a02a3f76cc
---
 .../org/argeo/eclipse/ui/EclipseUiUtils.java  | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/base/runtime/org.argeo.eclipse.ui/src/main/java/org/argeo/eclipse/ui/EclipseUiUtils.java b/base/runtime/org.argeo.eclipse.ui/src/main/java/org/argeo/eclipse/ui/EclipseUiUtils.java
index d6e62d3e5..8e1c7e632 100644
--- a/base/runtime/org.argeo.eclipse.ui/src/main/java/org/argeo/eclipse/ui/EclipseUiUtils.java
+++ b/base/runtime/org.argeo.eclipse.ui/src/main/java/org/argeo/eclipse/ui/EclipseUiUtils.java
@@ -39,9 +39,10 @@ public class EclipseUiUtils {
 	 *            be null
 	 * @return the created text
 	 * 
-	 * @deprecated use {@link #createGridLT(Composite, String)} instead
 	 */
-	@Deprecated
+	// FIXME why was this deprecated.
+	// * @ deprecated use { @ link #createGridLT(Composite, String)} instead
+	// @ Deprecated
 	public static Text createGridLT(Composite parent, String label,
 			ModifyListener modifyListener) {
 		Label lbl = new Label(parent, SWT.LEAD);
@@ -54,6 +55,10 @@ public class EclipseUiUtils {
 		return txt;
 	}
 
+	/**
+	 * Create a label and a text field for a grid layout, the text field
+	 * grabbing excess horizontal
+	 */
 	public static Text createGridLT(Composite parent, String label) {
 		return createGridLT(parent, label, null);
 	}
@@ -70,6 +75,10 @@ public class EclipseUiUtils {
 		return txt;
 	}
 
+	/**
+	 * Create a label and a text field with password display for a grid layout,
+	 * the text field grabbing excess horizontal
+	 */
 	public static Text createGridLP(Composite parent, String label,
 			ModifyListener modifyListener) {
 		Label lbl = new Label(parent, SWT.LEAD);
@@ -82,20 +91,22 @@ public class EclipseUiUtils {
 		return txt;
 	}
 
+	/** Shortcut to retrieve default italic font from display */
 	public static Font getItalicFont(Composite parent) {
 		return JFaceResources.getFontRegistry().defaultFontDescriptor()
 				.setStyle(SWT.ITALIC).createFont(parent.getDisplay());
 	}
 
+	/** Shortcut to retrieve default bold font from display */
 	public static Font getBoldFont(Composite parent) {
 		return JFaceResources.getFontRegistry().defaultFontDescriptor()
 				.setStyle(SWT.BOLD).createFont(parent.getDisplay());
 	}
 
+	/** Shortcut to retrieve default bold italic font from display */
 	public static Font getBoldItalicFont(Composite parent) {
 		return JFaceResources.getFontRegistry().defaultFontDescriptor()
 				.setStyle(SWT.BOLD | SWT.ITALIC)
 				.createFont(parent.getDisplay());
 	}
-
-}
+}
\ No newline at end of file
-- 
2.30.2