improve documentation

This commit is contained in:
Hervé Boutemy 2021-10-24 11:09:07 +02:00
parent 8784812cf6
commit a5f1bca9ef
6 changed files with 13 additions and 2 deletions

View File

@ -28,6 +28,8 @@
import java.util.stream.Stream; import java.util.stream.Stream;
/** /**
* Maven starter, from a provided Maven home directory.
*
* @author Hans Dockter * @author Hans Dockter
*/ */
public class BootstrapMainStarter public class BootstrapMainStarter

View File

@ -44,6 +44,8 @@
import java.nio.file.Path; import java.nio.file.Path;
/** /**
* Maven distribution downloader.
*
* @author Hans Dockter * @author Hans Dockter
*/ */
public interface Downloader public interface Downloader

View File

@ -40,6 +40,8 @@
/** /**
* Maven distribution installer, eventually using a {@link Downloader} first.
*
* @author Hans Dockter * @author Hans Dockter
*/ */
public class Installer public class Installer

View File

@ -28,6 +28,8 @@
import java.util.Properties; import java.util.Properties;
/** /**
* Main entry point for the Maven Wrapper, delegating wrapper execution to {@link WrapperExecutor}.
*
* @author Hans Dockter * @author Hans Dockter
*/ */
public class MavenWrapperMain public class MavenWrapperMain

View File

@ -28,6 +28,9 @@
import java.util.Properties; import java.util.Properties;
/** /**
* Wrapper executor, running {@link Installer} to get a Maven distribution ready, followed by {@BootstrapMainStarter}
* to launch the Maven bootstrap.
*
* @author Hans Dockter * @author Hans Dockter
*/ */
public class WrapperExecutor public class WrapperExecutor

View File

@ -25,6 +25,6 @@
Maven Wrapper Maven Wrapper
Maven Wrapper dowloads Maven distribution if not already in cache, then launches Maven. Maven Wrapper dowloads Maven distribution if not already in cache, installs it, then launches Maven: Maven distributions installed by Maven Wrapper are stored under <<<~/.m2/wrapper/dists>>> by default.
It is called by {{{../apache-maven-wrapper/}<<<mvnw>>>/<<<mvnw.cmd>>> scripts}} that need to be installed in the project and called instead of <<<mvn>>>/<<<mvn.cmd>>>. Maven Wrapper is called by {{{../apache-maven-wrapper/}<<<mvnw>>>/<<<mvnw.cmd>>> scripts}} that need to be installed in the project source tree and called instead of <<<mvn>>>/<<<mvn.cmd>>>.