Javadoc is much pickier now

ws/eclipse/HibIntro/src/main/java/inherit/v1/CreditCard.java

@@ -25,7 +25,7 @@ public class CreditCard extends BillingDetails {
     * Convenience method on top of {@link #setExpiration(Date)}
     * 
     * @param expiration Expiration date provided as "MM/dd/yy"
-    * @throws ParseException
+    * @throws ParseException Date string may be misspelled.
     */
    public void setExpiration(String expiration) throws ParseException {
       setExpiration(new SimpleDateFormat("MM/dd/yy").parse(expiration));}

ws/eclipse/HibIntro/src/main/java/inherit/v1/Persist.java

@@ -17,7 +17,7 @@ public class Persist {
 
    /**
     * @param args not used.
-    * @throws ParseException 
+    * @throws ParseException Credit card expiration may be mis-spelled.
     */
    public static void main(String[] args) throws ParseException {
       final Session session = HibernateUtil.createSessionFactory("inherit/v1/hibernate.cfg.xml").openSession();

ws/eclipse/HibIntro/src/main/java/inherit/v2/CreditCard.java

@@ -25,7 +25,7 @@ public class CreditCard extends BillingDetails {
     * Convenience method on top of {@link #setExpiration(Date)}
     * 
     * @param expiration Expiration date provided as "MM/dd/yy"
-    * @throws ParseException
+    * @throws ParseException Expiration may be mis-spelled.
     */
    public void setExpiration(String expiration) throws ParseException {
       setExpiration(new SimpleDateFormat("MM/dd/yy").parse(expiration));}

ws/eclipse/HibIntro/src/main/java/inherit/v2/Persist.java

@@ -17,7 +17,7 @@ public class Persist {
 
    /**
     * @param args not used.
-    * @throws ParseException 
+    * @throws ParseException Expiration may be mis-spelled.
     */
    public static void main(String[] args) throws ParseException {
       final Session session = HibernateUtil.createSessionFactory("inherit/v2/hibernate.cfg.xml").openSession();

ws/eclipse/HibIntro/src/main/java/inherit/v3/Circle.java

 package inherit.v3;
 
-import java.text.ParseException;
-
 import javax.persistence.DiscriminatorValue;
 import javax.persistence.Entity;
 import javax.persistence.Transient;
@@ -28,7 +26,7 @@ public class Circle extends Figure {
    }
    public Circle(){super();}
    
-   public Circle(final double xCoord, final double yCoord, final double radius) throws ParseException {
+   public Circle(final double xCoord, final double yCoord, final double radius) {
       super(xCoord, yCoord);
       setRadius(radius);
    }

ws/eclipse/HibIntro/src/main/java/inherit/v3/Persist.java

@@ -2,24 +2,21 @@ package inherit.v3;
 
 import hibintro.util.HibernateUtil;
 
-import java.text.ParseException;
-
 import org.hibernate.Session;
 import org.hibernate.Transaction;
 
 /**
  * @author goik
  * 
- * Persisting a simple instance of {@link Figure}
+ * Persisting simple instances of {@link Figure}
  *
  */
 public class Persist {
 
    /**
     * @param args not used.
-    * @throws ParseException 
     */
-   public static void main(String[] args) throws ParseException {
+   public static void main(String[] args) {
       final Session session = HibernateUtil.createSessionFactory("inherit/v3/hibernate.cfg.xml").openSession();
 
       final Transaction transaction = session.beginTransaction();

ws/eclipse/HibIntro/src/main/java/session1/User.java

@@ -52,10 +52,9 @@ public class User {
   public User() {}
 
   /**
-   * @param uid
-   *          See {@link #getUid()}.
-   * @param cname
-   *          See {@link #getCname()}.
+   * @param uidNumber See {@link #getUidNumber()}.
+   * @param uid See {@link #getUid()}.
+   * @param cname See {@link #getCname()}.
    */
   public User(int uidNumber, String uid, String cname) {
     setUidNumber(uidNumber);

ws/eclipse/HibIntro/src/main/java/session2/User.java

@@ -52,10 +52,9 @@ public class User {
   public User() {}
 
   /**
-   * @param uid
-   *          See {@link #getUid()}.
-   * @param cname
-   *          See {@link #getCname()}.
+   * @param uidNumber See {@link #getUidNumber()}.
+   * @param uid See {@link #getUid()}.
+   * @param cname See {@link #getCname()}.
    */
   public User(int uidNumber, String uid, String cname) {
     setUidNumber(uidNumber);

ws/eclipse/Jdbc/.settings/org.eclipse.jdt.core.prefs

 eclipse.preferences.version=1
+org.eclipse.jdt.core.compiler.annotation.inheritNullAnnotations=disabled
+org.eclipse.jdt.core.compiler.annotation.missingNonNullByDefaultAnnotation=ignore
+org.eclipse.jdt.core.compiler.annotation.nonnull=org.eclipse.jdt.annotation.NonNull
+org.eclipse.jdt.core.compiler.annotation.nonnullbydefault=org.eclipse.jdt.annotation.NonNullByDefault
+org.eclipse.jdt.core.compiler.annotation.nullable=org.eclipse.jdt.annotation.Nullable
+org.eclipse.jdt.core.compiler.annotation.nullanalysis=disabled
 org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode=enabled
-org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.7
+org.eclipse.jdt.core.compiler.codegen.methodParameters=do not generate
+org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.8
 org.eclipse.jdt.core.compiler.codegen.unusedLocal=preserve
-org.eclipse.jdt.core.compiler.compliance=1.7
+org.eclipse.jdt.core.compiler.compliance=1.8
 org.eclipse.jdt.core.compiler.debug.lineNumber=generate
 org.eclipse.jdt.core.compiler.debug.localVariable=generate
 org.eclipse.jdt.core.compiler.debug.sourceFile=generate
+org.eclipse.jdt.core.compiler.doc.comment.support=enabled
+org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning
 org.eclipse.jdt.core.compiler.problem.assertIdentifier=error
+org.eclipse.jdt.core.compiler.problem.autoboxing=ignore
+org.eclipse.jdt.core.compiler.problem.comparingIdentical=warning
+org.eclipse.jdt.core.compiler.problem.deadCode=warning
+org.eclipse.jdt.core.compiler.problem.deprecation=warning
+org.eclipse.jdt.core.compiler.problem.deprecationInDeprecatedCode=disabled
+org.eclipse.jdt.core.compiler.problem.deprecationWhenOverridingDeprecatedMethod=disabled
+org.eclipse.jdt.core.compiler.problem.discouragedReference=warning
+org.eclipse.jdt.core.compiler.problem.emptyStatement=ignore
 org.eclipse.jdt.core.compiler.problem.enumIdentifier=error
+org.eclipse.jdt.core.compiler.problem.explicitlyClosedAutoCloseable=ignore
+org.eclipse.jdt.core.compiler.problem.fallthroughCase=ignore
+org.eclipse.jdt.core.compiler.problem.fatalOptionalError=disabled
+org.eclipse.jdt.core.compiler.problem.fieldHiding=ignore
+org.eclipse.jdt.core.compiler.problem.finalParameterBound=warning
+org.eclipse.jdt.core.compiler.problem.finallyBlockNotCompletingNormally=warning
 org.eclipse.jdt.core.compiler.problem.forbiddenReference=warning
-org.eclipse.jdt.core.compiler.source=1.7
+org.eclipse.jdt.core.compiler.problem.hiddenCatchBlock=warning
+org.eclipse.jdt.core.compiler.problem.includeNullInfoFromAsserts=disabled
+org.eclipse.jdt.core.compiler.problem.incompatibleNonInheritedInterfaceMethod=warning
+org.eclipse.jdt.core.compiler.problem.incompleteEnumSwitch=warning
+org.eclipse.jdt.core.compiler.problem.indirectStaticAccess=ignore
+org.eclipse.jdt.core.compiler.problem.invalidJavadoc=error
+org.eclipse.jdt.core.compiler.problem.invalidJavadocTags=enabled
+org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsDeprecatedRef=enabled
+org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsNotVisibleRef=enabled
+org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsVisibility=public
+org.eclipse.jdt.core.compiler.problem.localVariableHiding=ignore
+org.eclipse.jdt.core.compiler.problem.methodWithConstructorName=warning
+org.eclipse.jdt.core.compiler.problem.missingDefaultCase=ignore
+org.eclipse.jdt.core.compiler.problem.missingDeprecatedAnnotation=ignore
+org.eclipse.jdt.core.compiler.problem.missingEnumCaseDespiteDefault=disabled
+org.eclipse.jdt.core.compiler.problem.missingHashCodeMethod=ignore
+org.eclipse.jdt.core.compiler.problem.missingJavadocComments=ignore
+org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsOverriding=disabled
+org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsVisibility=public
+org.eclipse.jdt.core.compiler.problem.missingJavadocTagDescription=all_standard_tags
+org.eclipse.jdt.core.compiler.problem.missingJavadocTags=warning
+org.eclipse.jdt.core.compiler.problem.missingJavadocTagsMethodTypeParameters=disabled
+org.eclipse.jdt.core.compiler.problem.missingJavadocTagsOverriding=disabled
+org.eclipse.jdt.core.compiler.problem.missingJavadocTagsVisibility=public
+org.eclipse.jdt.core.compiler.problem.missingOverrideAnnotation=ignore
+org.eclipse.jdt.core.compiler.problem.missingOverrideAnnotationForInterfaceMethodImplementation=enabled
+org.eclipse.jdt.core.compiler.problem.missingSerialVersion=warning
+org.eclipse.jdt.core.compiler.problem.missingSynchronizedOnInheritedMethod=ignore
+org.eclipse.jdt.core.compiler.problem.noEffectAssignment=warning
+org.eclipse.jdt.core.compiler.problem.noImplicitStringConversion=warning
+org.eclipse.jdt.core.compiler.problem.nonExternalizedStringLiteral=ignore
+org.eclipse.jdt.core.compiler.problem.nonnullParameterAnnotationDropped=warning
+org.eclipse.jdt.core.compiler.problem.nullAnnotationInferenceConflict=error
+org.eclipse.jdt.core.compiler.problem.nullReference=warning
+org.eclipse.jdt.core.compiler.problem.nullSpecViolation=error
+org.eclipse.jdt.core.compiler.problem.nullUncheckedConversion=warning
+org.eclipse.jdt.core.compiler.problem.overridingPackageDefaultMethod=warning
+org.eclipse.jdt.core.compiler.problem.parameterAssignment=ignore
+org.eclipse.jdt.core.compiler.problem.possibleAccidentalBooleanAssignment=ignore
+org.eclipse.jdt.core.compiler.problem.potentialNullReference=ignore
+org.eclipse.jdt.core.compiler.problem.potentiallyUnclosedCloseable=ignore
+org.eclipse.jdt.core.compiler.problem.rawTypeReference=warning
+org.eclipse.jdt.core.compiler.problem.redundantNullAnnotation=warning
+org.eclipse.jdt.core.compiler.problem.redundantNullCheck=ignore
+org.eclipse.jdt.core.compiler.problem.redundantSpecificationOfTypeArguments=ignore
+org.eclipse.jdt.core.compiler.problem.redundantSuperinterface=ignore
+org.eclipse.jdt.core.compiler.problem.reportMethodCanBePotentiallyStatic=ignore
+org.eclipse.jdt.core.compiler.problem.reportMethodCanBeStatic=ignore
+org.eclipse.jdt.core.compiler.problem.specialParameterHidingField=disabled
+org.eclipse.jdt.core.compiler.problem.staticAccessReceiver=warning
+org.eclipse.jdt.core.compiler.problem.suppressOptionalErrors=disabled
+org.eclipse.jdt.core.compiler.problem.suppressWarnings=enabled
+org.eclipse.jdt.core.compiler.problem.syntacticNullAnalysisForFields=disabled
+org.eclipse.jdt.core.compiler.problem.syntheticAccessEmulation=ignore
+org.eclipse.jdt.core.compiler.problem.typeParameterHiding=warning
+org.eclipse.jdt.core.compiler.problem.unavoidableGenericTypeProblems=enabled
+org.eclipse.jdt.core.compiler.problem.uncheckedTypeOperation=warning
+org.eclipse.jdt.core.compiler.problem.unclosedCloseable=warning
+org.eclipse.jdt.core.compiler.problem.undocumentedEmptyBlock=ignore
+org.eclipse.jdt.core.compiler.problem.unhandledWarningToken=warning
+org.eclipse.jdt.core.compiler.problem.unnecessaryElse=ignore
+org.eclipse.jdt.core.compiler.problem.unnecessaryTypeCheck=ignore
+org.eclipse.jdt.core.compiler.problem.unqualifiedFieldAccess=ignore
+org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownException=ignore
+org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionExemptExceptionAndThrowable=enabled
+org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionIncludeDocCommentReference=enabled
+org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionWhenOverriding=disabled
+org.eclipse.jdt.core.compiler.problem.unusedImport=warning
+org.eclipse.jdt.core.compiler.problem.unusedLabel=warning
+org.eclipse.jdt.core.compiler.problem.unusedLocal=warning
+org.eclipse.jdt.core.compiler.problem.unusedObjectAllocation=ignore
+org.eclipse.jdt.core.compiler.problem.unusedParameter=ignore
+org.eclipse.jdt.core.compiler.problem.unusedParameterIncludeDocCommentReference=enabled
+org.eclipse.jdt.core.compiler.problem.unusedParameterWhenImplementingAbstract=disabled
+org.eclipse.jdt.core.compiler.problem.unusedParameterWhenOverridingConcrete=disabled
+org.eclipse.jdt.core.compiler.problem.unusedPrivateMember=warning
+org.eclipse.jdt.core.compiler.problem.unusedTypeParameter=ignore
+org.eclipse.jdt.core.compiler.problem.unusedWarningToken=warning
+org.eclipse.jdt.core.compiler.problem.varargsArgumentNeedCast=warning
+org.eclipse.jdt.core.compiler.source=1.8

ws/eclipse/Jdbc/pom.xml

@@ -22,8 +22,8 @@
 				<artifactId>maven-compiler-plugin</artifactId>
 				<version>2.3.2</version>
 				<configuration>
-					<source>1.7</source>
-					<target>1.7</target>
+					<source>1.8</source>
+					<target>1.8</target>
 				</configuration>
 			</plugin>
 		</plugins>

ws/eclipse/Jdbc/src/main/java/dom/ArticleOrder.java

@@ -24,11 +24,11 @@ public class ArticleOrder {
       builder.setErrorHandler(new MySaxErrorHandler(System.out));
    }
 
-   /** Descending a catalog till its <item> elements. For each product
+   /** Descending a catalog till its &lt;item&gt; elements. For each product
     *  its name and order number are being written to the output.
-    * @param filename
-    * @throws JDOMException 
-    * @throws IOException 
+    * @param filename .
+    * @throws JDOMException General parsing fault
+    * @throws IOException file access problem
     */
    public void process(final String filename) throws JDOMException, IOException {
       

ws/eclipse/Jdbc/src/main/java/dom/ArticleOrderDriver.java

@@ -6,8 +6,8 @@ package dom;
 */
 public class ArticleOrderDriver {
   /**
-   * @param argv Unused cmd argset
-   * @throws Exception
+   * @param argv Unused command arguments
+   * @throws Exception File access problem or corrupt content.
    */
   public static void main(String[] argv) throws Exception {
     final ArticleOrder ao = new ArticleOrder();

ws/eclipse/Jdbc/src/main/java/dom/CreateDoc.java

@@ -15,10 +15,10 @@ import org.jdom2.output.XMLOutputter;
  */
 public class CreateDoc {
    /**
-    * @param args
-    * @throws IOException
+   * @param argv Unused cmd argset
+   * @throws IOException File acces problem or corrupt content.
     */
-   public static void main(String[] args) throws IOException {
+   public static void main(String[] argv) throws IOException {
 
       // Create the root element
       final Element titel = new Element("titel");

ws/eclipse/Jdbc/src/main/java/dom/CreateExtended.java

@@ -14,10 +14,10 @@ import org.jdom2.output.XMLOutputter;
  */
 public class CreateExtended {
   /**
-   * @param args
-   * @throws IOException 
+   * @param argv Unused cmd argset
+   * @throws IOException File acces problem or corrupt content.
    */
-  public static void main(String[] args) throws IOException {
+  public static void main(String[] argv) throws IOException {
      
      final Element titel = new Element("titel"),
            tLong = new Element("long"),

ws/eclipse/Jdbc/src/main/java/dom/MySaxErrorHandler.java

@@ -24,7 +24,7 @@ public class MySaxErrorHandler implements ErrorHandler {
    }
 
    /**
-    * @param out
+    * @param out Report's destination
     */
    public MySaxErrorHandler(final PrintStream out) {
      this.out = out;

ws/eclipse/Jdbc/src/main/java/dom/xpath/CheckExtImage.java

@@ -13,7 +13,7 @@ import org.jdom2.xpath.XPathFactory;
 import dom.MySaxErrorHandler;
 
 /** 
- * How to use XPath expressions to search for <img>
+ * How to use XPath expressions to search for &lt;img&gt;
  *  elements in XHTML document instances.
  *  
  * @author goik
@@ -32,8 +32,8 @@ public class CheckExtImage {
     * Read an XHTML document and search for images. The image filenames will be
     * written to standard out.
     * @param xhtmlFilename The XHTML's filename to be examined.
-    * @throws JDOMException 
-    * @throws IOException
+    * @throws JDOMException General parsing fault
+    * @throws IOException  file access problem
     */
    public void process(final String xhtmlFilename) throws JDOMException, IOException {
 

ws/eclipse/Jdbc/src/main/java/dom/xpath/CheckExtImageDriver.java

@@ -7,10 +7,10 @@ package dom.xpath;
 public class CheckExtImageDriver {
 
   /**
-   * @param args
-   * @throws Exception
+   * @param argv Unused cmd argset
+   * @throws Exception File acces problem or corrupt content.
    */
-  public static void main(String[] args) throws Exception {
+  public static void main(String[] argv) throws Exception {
     final CheckExtImage ao = new CheckExtImage();
     ao.process("Input/Dom/fileextref.html");
   }

ws/eclipse/Jdbc/src/main/java/dom/xpath/DomXpath.java

@@ -13,7 +13,7 @@ import org.jdom2.xpath.XPathFactory;
 import dom.MySaxErrorHandler;
 
 /** 
- * How to use XPath expressions to search for <img>
+ * How to use XPath expressions to search for &lt;img&gt;
  *  elements in XHTML document instances.
  *  
  * @author goik
@@ -31,8 +31,8 @@ public class DomXpath {
     * Read an XHTML document and search for images. The image filenames will be
     * written to standard out.
     * @param xhtmlFilename The XHTML's filename to be examined.
-    * @throws JDOMException 
-    * @throws IOException
+    * @throws JDOMException General parsing fault
+    * @throws IOException file access problem
     */
    public void process(final String xhtmlFilename) throws JDOMException, IOException {
 

ws/eclipse/Jdbc/src/main/java/dom/xpath/DomXpathDriver.java

 package dom.xpath;
 
 /**
- * Driver to test XPath based searching of <img> elements
+ * Driver to test XPath based searching of &lt;img&gt; elements
  * within a given HTML document.
  *
 */
 public class DomXpathDriver {
 
   /**
-   * @param args
-   * @throws Exception
+   * @param argv Unused command arguments
+   * @throws Exception File access problem or corrupt content.
    */
-  public static void main(String[] args) throws Exception {
+  public static void main(String[] argv) throws Exception {
     final DomXpath ao = new DomXpath();
     // The following HTML document is being searched
     // for <img> elements.

ws/eclipse/Jdbc/src/main/java/dom/xsl/DbAccess.java

@@ -10,9 +10,9 @@ import java.sql.*;
 public class DbAccess {
 
   /** Open a connection to a RDBMS.
-   * @param jdbcUrl
-   * @param userName
-   * @param password
+   * @param jdbcUrl The database server's address
+   * @param userName The user's name
+   * @param password The user's password
    */
   public void connect(final String jdbcUrl, 
       final String userName, final String password) {