build: add maven publishing and fix some Javadoc issues

Author: netmikey

publishing-build.gradle

@@ -0,0 +1,82 @@
+
+apply plugin: 'maven-publish'
+apply plugin: 'signing'
+
+// Configure these in your $USER_HOME/.gradle/gradle.properties
+if (!project.hasProperty("sonatypeUsername")) {
+    ext.sonatypeUsername = ''
+}
+if (!project.hasProperty("sonatypePassword")) {
+    ext.sonatypePassword = ''
+}
+
+task javadocJar(type: Jar) {
+    classifier = 'javadoc'
+    from javadoc
+}
+
+task sourcesJar(type: Jar) {
+    classifier = 'sources'
+    from sourceSets.main.allSource
+}
+
+artifacts {
+    archives javadocJar, sourcesJar
+}
+
+publishing {
+    publications {
+        mavenJava(MavenPublication) {
+            pom {
+                name = "${project.group}:${project.name}"
+                description = "${project.description}"
+                url = 'https://github.com/netmikey/testprocesses'
+                licenses {
+                    license {
+                        name = 'The Apache License, Version 2.0'
+                        url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+                    }
+                }
+                developers {
+                    developer {
+                        name = 'Mike Meessen'
+                        email = '[email protected]'
+                    }
+                }
+                scm {
+                    connection = 'scm:git:git://github.com/netmikey/testprocesses.git'
+                    developerConnection = 'scm:git:ssh://github.com:netmikey/testprocesses.git'
+                    url = 'https://github.com/netmikey/testprocesses'
+                }
+            }
+
+            from components.java
+            artifact(sourcesJar)
+            artifact(javadocJar)
+
+            versionMapping {
+                usage('java-api') {
+                    fromResolutionOf('runtimeClasspath')
+                }
+                usage('java-runtime') {
+                    fromResolutionResult()
+                }
+            }
+        }
+    }
+
+    repositories {
+        maven {
+            url "https://oss.sonatype.org/service/local/staging/deploy/maven2"
+            credentials {
+                username sonatypeUsername
+                password sonatypePassword
+            }
+        }
+    }
+}
+
+signing {
+    useGpgCmd()
+    sign publishing.publications.mavenJava
+}

testprocesses-core/build.gradle

@@ -3,6 +3,7 @@ plugins {
 }
 
 apply plugin: 'io.spring.dependency-management'
+apply from: new File(rootProject.projectDir, 'publishing-build.gradle')
 
 dependencyManagement {
     imports {

testprocesses-core/src/main/java/io/github/netmikey/testprocesses/TestProcessDefinitionBy.java

@@ -41,6 +41,8 @@ public class TestProcessDefinitionBy<T extends TestProcessDefinition> {
      * @param testProcessDefinitionClass
      *            The concrete {@link TestProcessDefinition} implementation
      *            class.
+     * @param <C>
+     *            The concrete {@link TestProcessDefinition} type.
      * @return The {@link TestProcessDefinitionBy} reference to the clazz.
      */
     public static <C extends TestProcessDefinition> TestProcessDefinitionBy<C> clazz(
@@ -55,6 +57,8 @@ public static <C extends TestProcessDefinition> TestProcessDefinitionBy<C> clazz
      * 
      * @param testProcessDefinition
      *            The {@link TestProcessDefinition} instance.
+     * @param <I>
+     *            The concrete {@link TestProcessDefinition} type.
      * @return The {@link TestProcessDefinitionBy} reference to the instance.
      */
     public static <I extends TestProcessDefinition> TestProcessDefinitionBy<I> instance(I testProcessDefinition) {

testprocesses-core/src/main/java/io/github/netmikey/testprocesses/TestProcessesRegistry.java

@@ -55,6 +55,8 @@ public class TestProcessesRegistry {
      *            started.
      * @param startStrategy
      *            The {@link StartStrategy} to be used.
+     * @param <T>
+     *            The concrete type of the {@link TestProcessDefinition}.
      */
     public <T extends TestProcessDefinition> void start(TestProcessDefinitionBy<T> processDefinitionBy,
         StartStrategy startStrategy) {
@@ -380,6 +382,8 @@ private <T extends TestProcessDefinition> T retrieve(TestProcessDefinitionBy<T>
      * @return The {@link RunningTestProcess} or {@link Optional#empty()} if no
      *         process has been started that matches the specified
      *         {@link TestProcessDefinitionBy} reference.
+     * @param <T>
+     *            The concrete type of the {@link TestProcessDefinition}.
      */
     public <T extends TestProcessDefinition> Optional<RunningTestProcess<T>> retrieveRunningProcess(
         TestProcessDefinitionBy<T> testProcessDefinitionBy) {

testprocesses-core/src/main/java/io/github/netmikey/testprocesses/utils/Tailer.java

@@ -47,8 +47,8 @@
  * <li>Using one of the static helper methods:
  * <ul>
  * <li>{@link Tailer#create(File, TailerListener)}</li>
- * <li>{@link Tailer#create(File, TailerListener, long)}</li>
- * <li>{@link Tailer#create(File, TailerListener, long, boolean)}</li>
+ * <li>{@link Tailer#create(File, TailerListener, long, long)}</li>
+ * <li>{@link Tailer#create(File, TailerListener, long, long, boolean)}</li>
  * </ul>
  * </li>
  * <li>Using an {@link java.util.concurrent.Executor}</li>