fixed javadoc issues

Author: mojo2012

pom.xml

@@ -196,18 +196,19 @@
 				<version>3.1.1</version>
 				<configuration>
 						<failOnError>false</failOnError>
-						<additionalparam>-Xdoclint:none</additionalparam>
+<!-- 						<additionalparam>-Xdoclint:none</additionalparam> -->
 						<additionalOptions>--allow-script-in-comments</additionalOptions>
 						<quiet>true</quiet>
 						<!-- does not work with revision property! -->
 						<ignoreClirr>true</ignoreClirr>
+						
+						<doclint>all,-html,-syntax</doclint>
 						<version>false</version>
 						<nosince>true</nosince>
 						<author>false</author>
 						<defaultAuthor>mojo2012</defaultAuthor>
 						<defaultVersion>1.0</defaultVersion>
 						<level>public</level>
-						
 					</configuration>
 					<executions>
 						<execution>

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

@@ -47,7 +47,7 @@
  *
  * <script src="https://gist.github.com/3966989.js?file=output.txt"></script>
  *
- * @see ca.weblite.objc.NSOpenPanelSample
+ * see NSOpenPanelSample
  * @author shannah
  * @version $Id: $Id
  * @since 1.1
@@ -231,7 +231,7 @@ public Object valueForKey(String key){
      * @param selector The
      * @return The method object that handles the specified selector (or null
      * if none is specified).
-     * @see RuntimeUtils.sel()
+     * @see RuntimeUtils#sel(String)
      */
     public Method methodForSelector(String selector){
         return getMethodMap(this.getClass()).get(selector);
@@ -559,7 +559,7 @@ public void forwardInvocation(long linvocation) {
      * to the selector.
      *
      * @param selector Pointer to the selector to check.
-     * @see RuntimeUtils.sel()
+     * @see RuntimeUtils#sel(Peerable)
      * @see <a href="http://developer.apple.com/library/ios/#documentation/cocoa/conceptual/objectivec/Chapters/ocSelectors.html">Objective-C selectors reference</a>
      * @return a boolean.
      */
@@ -577,7 +577,7 @@ public boolean respondsToSelector(Pointer selector){
      * java method in the class that responds to the selector (based on the @Msg
      * annotation).  Then it will check the parent object to see if it responds
      * to the selector.
-     * @see RuntimeUtils.sel()
+     * @see RuntimeUtils#sel(Peerable)
      * @see <a href="http://developer.apple.com/library/ios/#documentation/cocoa/conceptual/objectivec/Chapters/ocSelectors.html">Objective-C selectors reference</a>
      */
     @Override

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

@@ -36,8 +36,8 @@ public interface Recipient {
      *
      * @param invocation The NSInvocation object.
      * @see <a href="https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foundation/Classes/NSInvocation_Class/Reference/Reference.html#//apple_ref/doc/uid/TP40003671">NSInvocation Class Reference</a>
-     * @see NSObject.methodSignatureForSelector() For a concrete imlementation.
      * @see <a href="https://developer.apple.com/library/mac/#documentation/Cocoa/Reference/Foundation/Classes/NSProxy_Class/Reference/Reference.html#//apple_ref/doc/uid/TP40003719">forwardInvocation: Method reference (from NSProxy)</a>
+     * @see NSObject#methodSignatureForSelector(long) For a concrete imlementation.
      */
     public void forwardInvocation(long invocation);
 

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

@@ -104,7 +104,7 @@ public static Pointer cls(Peerable peer){
      *
      * @param cls The pointer to the class whose name we wish to retrieve.
      * @return The name of the class.
-     * @see Runtime.class_getName()
+     * @see Runtime#class_getName(Pointer)
      */
     public static String clsName(Pointer cls){
         return rt.class_getName(cls);
@@ -115,7 +115,7 @@ public static String clsName(Pointer cls){
      * the class pointer.  This will return the class name.
      *
      * @param peer a {@link ca.weblite.objc.Peerable} object.
-     * @see Runtime.class_getName()
+     * @see Runtime#class_getName(Pointer)
      * @return a {@link java.lang.String} object.
      */
     public static String clsName(Peerable peer){
@@ -181,7 +181,7 @@ public static String selName(Peerable peer){
      * boolean values, as this will automatically choose the correct underlying
      * message function depending on the return type reported by the message
      * signature.
-     * @see msgDouble()
+     * @see #msgDouble(String, String, Object...)
      */
     public static long msg(String cls, String msg, Object... args){
         return msg(cls(cls), msg, args);
@@ -204,7 +204,7 @@ public static long msg(String cls, String msg, Object... args){
      * boolean values, as this will automatically choose the correct underlying
      * message function depending on the return type reported by the message
      * signature.
-     * @see msgDouble()
+     * @see #msgDouble(String, Pointer, Object...)
      */
     public static long msg(String cls, Pointer msg, Object... args){
         return msg(cls(cls), msg, args);
@@ -227,7 +227,7 @@ public static long msg(String cls, Pointer msg, Object... args){
      * boolean values, as this will automatically choose the correct underlying
      * message function depending on the return type reported by the message
      * signature.
-     * @see msgDouble()
+     * @see #msgDouble(Pointer, String, Object...)
      * @param receiver a {@link com.sun.jna.Pointer} object.
      */
     public static long msg(Pointer receiver, String msg, Object... args){
@@ -249,7 +249,7 @@ public static long msg(Pointer receiver, String msg, Object... args){
      * boolean values, as this will automatically choose the correct underlying
      * message function depending on the return type reported by the message
      * signature.
-     * @see msgDouble()
+     * @see #msgDouble(Pointer, Pointer, Object...)
      * @param receiver a {@link com.sun.jna.Pointer} object.
      * @param selector a {@link com.sun.jna.Pointer} object.
      */

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

@@ -128,7 +128,7 @@ public Object cToJ(Object cVar, String signature, TypeMapping root) {
      * specified signature.  By default, this will map scalars straight
      * across without change.  Strings are mapped to NSStrings.
      *
-     * <h5>Example Usage</h5>
+     * <h1>Example Usage</h1>
      * <p>The following is a modified snippet from the NSObject class that shows
      * (roughly) how the jToC method is used to take the output of a Java method
      * and set the return value in an NSInvocation object to a corresponding

src/main/java/ca/weblite/objc/annotations/Msg.java

@@ -35,7 +35,7 @@
      * the NSSavePanel's -setTitle: message, then the selector would be "setTitle:".
      * The -title message, on the other hand would just be "title" (without colon) 
      * because it takes no parameters.
-     * @return 
+     * @return the selector name 
      */
     String selector();
 
@@ -49,8 +49,8 @@
      * 
      *
      * 
-     * <h4>Example Signatures</h4>
-     * <table>
+     * <h1>Example Signatures</h1>
+     * <table summary="Example Signatures">
      * <thead>
      *  <tr>
      *      <th>Method Type</th>