Merge pull request Kotlin#110 from KrystianUjma/add-ant-example-update-dokka-maven-example

add ant example, update dokka maven example

Author: semoro

ant/dokka-ant/README.md

@@ -0,0 +1,16 @@
+# kotlinant
+
+Example configuration using Ant for Dokka.
+
+1. Install Ant.
+2. Set path to Dokka's fatjar in build.xml. 
+3. Run in console: 
+```
+ant document
+```
+your documentation will be located at `ant/dokka-ant/doc`.
+
+To clean, run:
+```
+ant clean
+```

ant/dokka-ant/build.xml

@@ -0,0 +1,11 @@
+<project default="document">
+    <target name="clean">
+        <delete dir="doc"/>
+    </target>
+    <typedef resource="dokka-antlib.xml" classpath="/path/to/fatjar/dokka-fatjar-0.9.19.jar"/>
+    <target name="document">
+        <dokka format="javadoc" outputdir="doc">
+            <passConfig src="src" moduleName="dokka-ant"/>
+        </dokka>
+    </target>
+</project>

ant/dokka-ant/src/commonMain/kotlin/org/foo/someFile.kt

@@ -0,0 +1,10 @@
+package commonMain.kotlin.org.foo
+
+
+/**
+ * just foo class
+ */
+class Foo {
+
+    fun bar(): Int = 0
+}

maven/dokka-maven-example/pom.xml

@@ -9,7 +9,7 @@
     <version>1.0-SNAPSHOT</version>
     <properties>
         <kotlin.version>1.0.3</kotlin.version>
-        <dokka.version>0.9.9</dokka.version>
+        <dokka.version>0.9.19</dokka.version>
     </properties>
 
     <dependencies>
@@ -41,7 +41,9 @@
                     <execution>
                         <id>test-compile</id>
                         <phase>test-compile</phase>
-                        <goals> <goal>test-compile</goal> </goals>
+                        <goals>
+                          <goal>test-compile</goal>
+                        </goals>
                     </execution>
                 </executions>
             </plugin>
@@ -65,9 +67,9 @@
                     </includes>
                     <sourceLinks>
                         <link>
-                            <dir>${project.basedir}</dir>
+                            <path>${project.basedir}</path>
                             <url>https://github.com/JetBrains/kotlin-examples/blob/master/maven/dokka-maven-example</url>
-                            <urlSuffix>#L</urlSuffix>
+                            <lineSuffix>#L</lineSuffix>
                         </link>
                     </sourceLinks>
                 </configuration>