javadoc fixes

Author: Matthias Fuchs

pom.xml

@@ -39,6 +39,7 @@
 	</profiles>
 
 	<properties>
+		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 		<maven.compiler.target>11</maven.compiler.target>
 		<maven.compiler.source>11</maven.compiler.source>
 		<xcodeScheme>Debug</xcodeScheme>
@@ -219,11 +220,15 @@
 					<configuration>
 						<failOnError>false</failOnError>
 						<!-- <additionalparam>-Xdoclint:none</additionalparam> -->
-						<additionalOptions>--allow-script-in-comments</additionalOptions>
+						<additionalOptions>--allow-script-in-comments </additionalOptions>
+						<useStandardDocletOptions>false</useStandardDocletOptions>
+
 						<quiet>true</quiet>
 						<!-- does not work with revision property! -->
 						<ignoreClirr>true</ignoreClirr>
 
+						<detectLinks>false</detectLinks>
+						<detectOfflineLinks>false</detectOfflineLinks>
 						<doclint>all,-html,-syntax</doclint>
 						<version>false</version>
 						<nosince>true</nosince>

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

@@ -32,7 +32,7 @@
  * <p>The parent object is used as a sort of superclass so that messages that aren't
  * explicitly handled by the Java class can be handled by the superclass.</p>
  *
- * <h3>Simple Example</h3>
+ * <h2>Simple Example</h2>
  *
  * <p>The following example shows a subclass of NSObject that is used as a delegate
  * for an NSOpenPanel.  Notice, that, by using the {@literal @}Msg annotation, the

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

@@ -11,7 +11,7 @@
  * A wrapper around a native (Objective-C) object that allows for sending
  * messages from Java.
  *
- * <h3>Example Wrapping NSMutableArray Object</h3>
+ * <h2>Example Wrapping NSMutableArray Object</h2>
  *
  * <p>The following snippet is taken from a unit test, to give you an idea
  * of how to use the Proxy class to wrap an Objective-C object.</p>

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

@@ -9,7 +9,7 @@
  * A JNA wrapper around the objective-c runtime.  This contains all of the functions
  * needed to interact with the runtime (e.g. send messages, etc..).
  *
- * <h3>Sample Usage</h3>
+ * <h2>Sample Usage</h2>
  * <script src="https://gist.github.com/3974488.js?file=SampleLowLevelAPI.java"></script>
  *
  * @author shannah

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.
      *
-     * <h1>Example Usage</h1>
+     * <h4>Example Usage</h4>
      * <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

@@ -10,7 +10,7 @@
  * messages.  This annotation is only useful for subclasses of ca.weblite.objc.NSObject.
  *
  *
- * <h3>Example Class Using Annotation TO Handle Objective-C messages</h3>
+ * <h2>Example Class Using Annotation TO Handle Objective-C messages</h2>
  *
  * <script src="https://gist.github.com/3969983.js?file=TestCustomClass.java"></script>
  *
@@ -49,7 +49,7 @@
      * 
      *
      * 
-     * <h1>Example Signatures</h1>
+     * <h4>Example Signatures</h4>
      * <table summary="Example Signatures">
      * <thead>
      *  <tr>