Skip to content

Commit 8d1e69b

Browse files
committed
Polish Gradle plugin's javadoc
1 parent 703de64 commit 8d1e69b

File tree

11 files changed

+5
-39
lines changed

11 files changed

+5
-39
lines changed

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/dsl/SpringBootExtension.java

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,6 @@ public class SpringBootExtension {
4444
/**
4545
* Creates a new {@code SpringBootPluginExtension} that is associated with the given
4646
* {@code project}.
47-
*
4847
* @param project the project
4948
*/
5049
public SpringBootExtension(Project project) {
@@ -53,7 +52,6 @@ public SpringBootExtension(Project project) {
5352

5453
/**
5554
* Returns the main class name of the application.
56-
*
5755
* @return the name of the application's main class
5856
*/
5957
public String getMainClassName() {
@@ -62,7 +60,6 @@ public String getMainClassName() {
6260

6361
/**
6462
* Sets the main class name of the application.
65-
*
6663
* @param mainClassName the name of the application's main class
6764
*/
6865
public void setMainClassName(String mainClassName) {
@@ -89,7 +86,6 @@ public void buildInfo() {
8986
* By default, the task's destination dir will be a directory named {@code META-INF}
9087
* beneath the main source set's resources output directory, and the task's project
9188
* artifact will be the base name of the {@code bootWar} or {@code bootJar} task.
92-
*
9389
* @param configurer the task configurer
9490
*/
9591
public void buildInfo(Action<BuildInfo> configurer) {

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/plugin/PluginApplicationAction.java

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,6 @@ interface PluginApplicationAction extends Action<Project> {
3131
/**
3232
* The class of the {@code Plugin} that, when applied, will trigger the execution of
3333
* this action. May return {@code null} if the plugin class is not on the classpath.
34-
*
3534
* @return the plugin class or {@code null}
3635
*/
3736
Class<? extends Plugin<? extends Project>> getPluginClass();

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/plugin/SpringBootPlugin.java

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -55,14 +55,12 @@ public class SpringBootPlugin implements Plugin<Project> {
5555

5656
/**
5757
* The name of the default {@link BootJar} task.
58-
*
5958
* @since 2.0.0
6059
*/
6160
public static final String BOOT_JAR_TASK_NAME = "bootJar";
6261

6362
/**
6463
* The name of the default {@link BootWar} task.
65-
*
6664
* @since 2.0.0
6765
*/
6866
public static final String BOOT_WAR_TASK_NAME = "bootWar";

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/tasks/application/CreateBootStartScripts.java

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@
2424
* main class name} optional.
2525
*
2626
* @author Andy Wilkinson
27+
* @since 2.0.0
2728
*/
2829
public class CreateBootStartScripts extends CreateStartScripts {
2930

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/tasks/buildinfo/BuildInfo.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,7 @@
3939
* {@code Project}.
4040
*
4141
* @author Andy Wilkinson
42+
* @since 2.0.0
4243
*/
4344
public class BuildInfo extends ConventionTask {
4445

@@ -73,7 +74,6 @@ public void generateBuildProperties() {
7374
/**
7475
* Returns the directory to which the {@code build-info.properties} file will be
7576
* written. Defaults to the {@link Project#getBuildDir() Project's build directory}.
76-
*
7777
* @return the destination directory
7878
*/
7979
@OutputDirectory

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/tasks/buildinfo/BuildInfoProperties.java

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@
2727
* The properties that are written into the {@code build-info.properties} file.
2828
*
2929
* @author Andy Wilkinson
30+
* @since 2.0.0
3031
*/
3132
@SuppressWarnings("serial")
3233
public class BuildInfoProperties implements Serializable {
@@ -53,7 +54,6 @@ public class BuildInfoProperties implements Serializable {
5354
/**
5455
* Returns the value used for the {@code build.group} property. Defaults to the
5556
* {@link Project#getGroup() Project's group}.
56-
*
5757
* @return the group
5858
*/
5959
public String getGroup() {
@@ -65,7 +65,6 @@ public String getGroup() {
6565

6666
/**
6767
* Sets the value used for the {@code build.group} property.
68-
*
6968
* @param group the group name
7069
*/
7170
public void setGroup(String group) {
@@ -74,7 +73,6 @@ public void setGroup(String group) {
7473

7574
/**
7675
* Returns the value used for the {@code build.artifact} property.
77-
*
7876
* @return the artifact
7977
*/
8078
public String getArtifact() {
@@ -83,7 +81,6 @@ public String getArtifact() {
8381

8482
/**
8583
* Sets the value used for the {@code build.artifact} property.
86-
*
8784
* @param artifact the artifact
8885
*/
8986
public void setArtifact(String artifact) {
@@ -93,7 +90,6 @@ public void setArtifact(String artifact) {
9390
/**
9491
* Returns the value used for the {@code build.version} property. Defaults to the
9592
* {@link Project#getVersion() Project's version}.
96-
*
9793
* @return the version
9894
*/
9995
public String getVersion() {
@@ -105,7 +101,6 @@ public String getVersion() {
105101

106102
/**
107103
* Sets the value used for the {@code build.version} property.
108-
*
109104
* @param version the version
110105
*/
111106
public void setVersion(String version) {
@@ -115,7 +110,6 @@ public void setVersion(String version) {
115110
/**
116111
* Returns the value used for the {@code build.name} property. Defaults to the
117112
* {@link Project#getDisplayName() Project's display name}.
118-
*
119113
* @return the name
120114
*/
121115
public String getName() {
@@ -127,7 +121,6 @@ public String getName() {
127121

128122
/**
129123
* Sets the value used for the {@code build.name} property.
130-
*
131124
* @param name the name
132125
*/
133126
public void setName(String name) {
@@ -154,7 +147,6 @@ public void setTime(Instant time) {
154147
/**
155148
* Returns the additional properties that will be included. When written, the name of
156149
* each additional property is prefixed with {@code build.}.
157-
*
158150
* @return the additional properties
159151
*/
160152
public Map<String, Object> getAdditional() {
@@ -164,7 +156,6 @@ public Map<String, Object> getAdditional() {
164156
/**
165157
* Sets the additional properties that will be included. When written, the name of
166158
* each additional property is prefixed with {@code build.}.
167-
*
168159
* @param additionalProperties the additional properties
169160
*/
170161
public void setAdditional(Map<String, Object> additionalProperties) {

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/tasks/bundling/BootArchive.java

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
/*
2-
* Copyright 2012-2017 the original author or authors.
2+
* Copyright 2012-2018 the original author or authors.
33
*
44
* Licensed under the Apache License, Version 2.0 (the "License");
55
* you may not use this file except in compliance with the License.
@@ -36,7 +36,6 @@ public interface BootArchive extends Task {
3636

3737
/**
3838
* Returns the name of the main class of the application.
39-
*
4039
* @return the main class name
4140
*/
4241
@Input
@@ -45,31 +44,27 @@ public interface BootArchive extends Task {
4544

4645
/**
4746
* Sets the name of the main class of the application.
48-
*
4947
* @param mainClassName the name of the main class of the application
5048
*/
5149
void setMainClassName(String mainClassName);
5250

5351
/**
5452
* Adds Ant-style patterns that identify files that must be unpacked from the archive
5553
* when it is launched.
56-
*
5754
* @param patterns the patterns
5855
*/
5956
void requiresUnpack(String... patterns);
6057

6158
/**
6259
* Adds a spec that identifies files that must be unpacked from the archive when it is
6360
* launched.
64-
*
6561
* @param spec the spec
6662
*/
6763
void requiresUnpack(Spec<FileTreeElement> spec);
6864

6965
/**
7066
* Returns the {@link LaunchScriptConfiguration} that will control the script that is
7167
* prepended to the archive.
72-
*
7368
* @return the launch script configuration, or {@code null} if the launch script has
7469
* not been configured.
7570
*/
@@ -85,14 +80,12 @@ public interface BootArchive extends Task {
8580
/**
8681
* Configures the archive to have a prepended launch script, customizing its
8782
* configuration using the given {@code action}.
88-
*
8983
* @param action the action to apply
9084
*/
9185
void launchScript(Action<LaunchScriptConfiguration> action);
9286

9387
/**
9488
* Returns the classpath that will be included in the archive.
95-
*
9689
* @return the classpath
9790
*/
9891
@Optional
@@ -102,15 +95,13 @@ public interface BootArchive extends Task {
10295
/**
10396
* Adds files to the classpath to include in the archive. The given {@code classpath}
10497
* are evaluated as per {@link Project#files(Object...)}.
105-
*
10698
* @param classpath the additions to the classpath
10799
*/
108100
void classpath(Object... classpath);
109101

110102
/**
111103
* Returns {@code true} if the Devtools jar should be excluded, otherwise
112104
* {@code false}.
113-
*
114105
* @return {@code true} if the Devtools jar should be excluded, or {@code false} if
115106
* not
116107
*/
@@ -119,7 +110,6 @@ public interface BootArchive extends Task {
119110

120111
/**
121112
* Sets whether or not the Devtools jar should be excluded.
122-
*
123113
* @param excludeDevtools {@code true} if the Devtools jar should be excluded, or
124114
* {@code false} if not
125115
*/

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/tasks/bundling/BootJar.java

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -136,7 +136,6 @@ public void setExcludeDevtools(boolean excludeDevtools) {
136136
* <p>
137137
* By default, any file in {@code BOOT-INF/lib/} is stored and all other files are
138138
* deflated.
139-
*
140139
* @param details the details
141140
* @return the compression to use
142141
*/

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/tasks/bundling/BootWar.java

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,6 @@ public void launchScript(Action<LaunchScriptConfiguration> action) {
104104
/**
105105
* Returns the provided classpath, the contents of which will be included in the
106106
* {@code WEB-INF/lib-provided} directory of the war.
107-
*
108107
* @return the provided classpath
109108
*/
110109
@Optional
@@ -116,7 +115,6 @@ public FileCollection getProvidedClasspath() {
116115
* Adds files to the provided classpath to include in the {@code WEB-INF/lib-provided}
117116
* directory of the war. The given {@code classpath} are evaluated as per
118117
* {@link Project#files(Object...)}.
119-
*
120118
* @param classpath the additions to the classpath
121119
*/
122120
public void providedClasspath(Object... classpath) {
@@ -142,7 +140,6 @@ public void setExcludeDevtools(boolean excludeDevtools) {
142140
* <p>
143141
* By default, any file in {@code WEB-INF/lib/} or {@code WEB-INF/lib-provided/} is
144142
* stored and all other files are deflated.
145-
*
146143
* @param details the details
147144
* @return the compression to use
148145
*/

spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/main/java/org/springframework/boot/gradle/tasks/bundling/LaunchScriptConfiguration.java

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,6 @@ public class LaunchScriptConfiguration implements Serializable {
4040
/**
4141
* Returns the properties that are applied to the launch script when it's being
4242
* including in the executable archive.
43-
*
4443
* @return the properties
4544
*/
4645
public Map<String, String> getProperties() {
@@ -50,7 +49,6 @@ public Map<String, String> getProperties() {
5049
/**
5150
* Sets the properties that are applied to the launch script when it's being including
5251
* in the executable archive.
53-
*
5452
* @param properties the properties
5553
*/
5654
public void properties(Map<String, String> properties) {
@@ -60,7 +58,6 @@ public void properties(Map<String, String> properties) {
6058
/**
6159
* Returns the script {@link File} that will be included in the executable archive.
6260
* When {@code null}, the default launch script will be used.
63-
*
6461
* @return the script file
6562
*/
6663
public File getScript() {
@@ -70,7 +67,6 @@ public File getScript() {
7067
/**
7168
* Sets the script {@link File} that will be included in the executable archive. When
7269
* {@code null}, the default launch script will be used.
73-
*
7470
* @param script the script file
7571
*/
7672
public void setScript(File script) {

0 commit comments

Comments
 (0)