Bug 553769: [Doclet] add support for Java9 Doclet API

  fix correct detection of first documentation sentence

Change-Id: I0d51f6e6e0af5bdd4ee672a0f6590955699f5a18
diff --git a/developers/org.eclipse.ease.helpgenerator/src/org/eclipse/ease/helpgenerator/model/Description.java b/developers/org.eclipse.ease.helpgenerator/src/org/eclipse/ease/helpgenerator/model/Description.java
index c015ca9..78d8993 100644
--- a/developers/org.eclipse.ease.helpgenerator/src/org/eclipse/ease/helpgenerator/model/Description.java
+++ b/developers/org.eclipse.ease.helpgenerator/src/org/eclipse/ease/helpgenerator/model/Description.java
@@ -27,8 +27,17 @@
 		if (isEmpty())
 			return null;
 
-		final int pos = getComment().indexOf('.');
-		return (pos > 0) ? getComment().substring(0, pos + 1) : getComment();
+		int pos = getComment().indexOf(".");
+		while (pos > 0) {
+			final String sentence = getComment().substring(0, pos + 1);
+
+			if (sentence.split("\\{@").length == sentence.split("\\}").length)
+				return sentence;
+
+			pos = getComment().indexOf(".", pos + 1);
+		}
+
+		return getComment();
 	}
 
 	@Override