fixed more javadoc

Author: Matthias Fuchs

pom.xml

@@ -194,14 +194,29 @@
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-javadoc-plugin</artifactId>
 				<version>3.1.1</version>
-				<executions>
-					<execution>
-						<id>attach-javadocs</id>
-						<goals>
-							<goal>jar</goal>
-						</goals>
-					</execution>
-				</executions>
+				<configuration>
+						<failOnError>false</failOnError>
+						<additionalparam>-Xdoclint:none</additionalparam>
+						<additionalOptions>--allow-script-in-comments</additionalOptions>
+						<quiet>true</quiet>
+						<!-- does not work with revision property! -->
+						<ignoreClirr>true</ignoreClirr>
+						<version>false</version>
+						<nosince>true</nosince>
+						<author>false</author>
+						<defaultAuthor>mojo2012</defaultAuthor>
+						<defaultVersion>1.0</defaultVersion>
+						<level>public</level>
+						
+					</configuration>
+					<executions>
+						<execution>
+							<id>attach-javadocs</id>
+							<goals>
+								<goal>jar</goal>
+							</goals>
+						</execution>
+					</executions>
 			</plugin>
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>

src/main/java/ca/weblite/nativeutils/NativeUtils.java

@@ -13,6 +13,7 @@
  * @see http://frommyplayground.com/how-to-load-native-jni-library-from-jar
  * @author Adam Heirnich <[email protected]>, http://www.adamh.cz
  * @version $Id: $Id
+ * @since 1.1
  */
 public class NativeUtils {
 
@@ -38,11 +39,12 @@ public static void loadLibraryFromJar(String path) throws IOException {
      * The file from JAR is copied into system temporary directory and then loaded. The temporary file is deleted after exiting.
      * Method uses String as filename because the pathname is "abstract", not system-dependent.
      *
-     * @throws java.io.IOException If temporary file creation or read/write operation fails
+     * @throws java.lang.IllegalArgumentException If the path is not absolute or if the filename is shorter than three characters (restriction of {@see File#createTempFile(java.lang.String, java.lang.String)}).
      * @throws java.lang.IllegalArgumentException If the path is not absolute or if the filename is shorter than three characters (restriction of {@see File#createTempFile(java.lang.String, java.lang.String)}).
      * @throws java.lang.IllegalArgumentException If the path is not absolute or if the filename is shorter than three characters (restriction of {@see File#createTempFile(java.lang.String, java.lang.String)}).
      * @param path a {@link java.lang.String} object.
      * @param source a {@link java.lang.Class} object.
+     * @throws java.io.IOException if any.
      */
     public static void loadLibraryFromJar(String path, Class source) throws IOException {
 

src/main/java/ca/weblite/objc/Client.java

@@ -31,6 +31,7 @@
  *
  * @author shannah
  * @version $Id: $Id
+ * @since 1.1
  */
 public class Client {
 

src/main/java/ca/weblite/objc/Constants.java

@@ -10,6 +10,7 @@
  *
  * @author shannah
  * @version $Id: $Id
+ * @since 1.1
  */
 public interface Constants {
     /** Constant <code>VERSION="1.0"</code> */

src/main/java/ca/weblite/objc/Message.java

@@ -1,7 +1,3 @@
-/*
- * To change this template, choose Tools | Templates
- * and open the template in the editor.
- */
 package ca.weblite.objc;
 
 import com.sun.jna.Pointer;
@@ -12,11 +8,12 @@
  * A structure the encapsulates a message.  This is an optional alternative
  * way of sending messages to the Objective-C runtime.
  *
- * @see Client.send(Message...)
- * @see RuntimeUtils.msg(Message...)
- * @see Proxy.send(Message...)
+ * @see Client#send(Message...)
+ * @see RuntimeUtils#msg(Message...)
+ * @see Proxy#send(Message...)
  * @author shannah
  * @version $Id: $Id
+ * @since 1.1
  */
 public class Message {
 

src/main/java/ca/weblite/objc/NSObject.java

@@ -51,9 +51,10 @@
  *
  * <script src="https://gist.github.com/3966989.js?file=output.txt"></script>
  *
- * @see NSOpenPanelSample
+ * @see ca.weblite.objc.NSOpenPanelSample
  * @author shannah
  * @version $Id: $Id
+ * @since 1.1
  */
 public class NSObject extends Proxy implements PeerableRecipient {
     private static final Logger LOG = Logger.getLogger("NSObject");
@@ -177,6 +178,7 @@ public NSObject(Client c, Pointer peer){
      * Initializes this object and registers it with the Objective-C runtime.
      *
      * @return Self for chaining.
+     * @param parent a {@link com.sun.jna.Pointer} object.
      */
     public NSObject init(Pointer parent){
         this.cls = Runtime.INSTANCE.object_getClass(parent);

src/main/java/ca/weblite/objc/NativeLibLoader.java

@@ -11,6 +11,7 @@
  *
  * @author shannah
  * @version $Id: $Id
+ * @since 1.1
  */
 public class NativeLibLoader implements Constants {
 	private boolean loaded;

src/main/java/ca/weblite/objc/Peerable.java

@@ -11,6 +11,7 @@
  *
  * @author shannah
  * @version $Id: $Id
+ * @since 1.1
  */
 public interface Peerable {
     /**

src/main/java/ca/weblite/objc/PeerableRecipient.java

@@ -10,6 +10,7 @@
  *
  * @author shannah
  * @version $Id: $Id
+ * @since 1.1
  */
 public interface PeerableRecipient extends Peerable, Recipient {
 

src/main/java/ca/weblite/objc/Proxy.java

@@ -30,6 +30,7 @@
  * @see <a href="https://github.com/twall/jna">JavaNativeAccess On GitHub</a>
  * @author shannah
  * @version $Id: $Id
+ * @since 1.1
  */
 public class Proxy implements Peerable {