Merge pull request #21579 from OrangeDog

* pr/21579:
  Polish "Polish duration support javadoc"
  Polish duration support javadoc

Closes gh-21579

Author: snicoll

spring-boot-project/spring-boot/src/main/java/org/springframework/boot/convert/DurationStyle.java

@@ -134,7 +134,8 @@ public String print(Duration value) {
 	 * Detect the style then parse the value to return a duration.
 	 * @param value the value to parse
 	 * @return the parsed duration
-	 * @throws IllegalStateException if the value is not a known style or cannot be parsed
+	 * @throws IllegalArgumentException if the value is not a known style or cannot be
+	 * parsed
 	 */
 	public static Duration detectAndParse(String value) {
 		return detectAndParse(value, null);
@@ -146,7 +147,8 @@ public static Duration detectAndParse(String value) {
 	 * @param unit the duration unit to use if the value doesn't specify one ({@code null}
 	 * will default to ms)
 	 * @return the parsed duration
-	 * @throws IllegalStateException if the value is not a known style or cannot be parsed
+	 * @throws IllegalArgumentException if the value is not a known style or cannot be
+	 * parsed
 	 */
 	public static Duration detectAndParse(String value, ChronoUnit unit) {
 		return detect(value).parse(value, unit);
@@ -156,7 +158,7 @@ public static Duration detectAndParse(String value, ChronoUnit unit) {
 	 * Detect the style from the given source value.
 	 * @param value the source value
 	 * @return the duration style
-	 * @throws IllegalStateException if the value is not a known style
+	 * @throws IllegalArgumentException if the value is not a known style
 	 */
 	public static DurationStyle detect(String value) {
 		Assert.notNull(value, "Value must not be null");

spring-boot-project/spring-boot/src/main/java/org/springframework/boot/convert/PeriodStyle.java

@@ -176,7 +176,8 @@ public String print(Period value) {
 	 * Detect the style then parse the value to return a period.
 	 * @param value the value to parse
 	 * @return the parsed period
-	 * @throws IllegalStateException if the value is not a known style or cannot be parsed
+	 * @throws IllegalArgumentException if the value is not a known style or cannot be
+	 * parsed
 	 */
 	public static Period detectAndParse(String value) {
 		return detectAndParse(value, null);
@@ -188,7 +189,8 @@ public static Period detectAndParse(String value) {
 	 * @param unit the period unit to use if the value doesn't specify one ({@code null}
 	 * will default to ms)
 	 * @return the parsed period
-	 * @throws IllegalStateException if the value is not a known style or cannot be parsed
+	 * @throws IllegalArgumentException if the value is not a known style or cannot be
+	 * parsed
 	 */
 	public static Period detectAndParse(String value, ChronoUnit unit) {
 		return detect(value).parse(value, unit);
@@ -198,7 +200,7 @@ public static Period detectAndParse(String value, ChronoUnit unit) {
 	 * Detect the style from the given source value.
 	 * @param value the source value
 	 * @return the period style
-	 * @throws IllegalStateException if the value is not a known style
+	 * @throws IllegalArgumentException if the value is not a known style
 	 */
 	public static PeriodStyle detect(String value) {
 		Assert.notNull(value, "Value must not be null");

spring-boot-project/spring-boot/src/main/java/org/springframework/boot/convert/PeriodToStringConverter.java

@@ -32,7 +32,8 @@
  * @author Eddú Meléndez
  * @author Edson Chávez
  * @since 2.3.0
- * @see Period
+ * @see PeriodFormat
+ * @see PeriodUnit
  */
 public class PeriodToStringConverter implements GenericConverter {
 

spring-boot-project/spring-boot/src/main/java/org/springframework/boot/convert/StringToPeriodConverter.java

@@ -33,6 +33,7 @@
  * @author Eddú Meléndez
  * @author Edson Chávez
  * @since 2.3.0
+ * @see PeriodFormat
  * @see PeriodUnit
  */
 public class StringToPeriodConverter implements GenericConverter {