Document String array option type

- Backport #558 as it brings missing option type docs
- Backport #628
- Fixes #629

spring-shell-docs/src/main/asciidoc/using-shell-options-types.adoc

@@ -0,0 +1,137 @@
+[[using-shell-options-types]]
+=== Types
+ifndef::snippets[:snippets: ../../test/java/org/springframework/shell/docs]
+
+This section talks about how particular data type is used as an option value.
+
+==== String
+
+`String` is a most simplest type as there's no conversion involved as what's
+coming in from a user is always a string.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-string-anno]
+----
+====
+
+While it's not strictly required to define type as a `String` it's always
+adviced to do so.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-string-reg]
+----
+====
+
+==== Boolean
+
+Using boolean types is a bit more involved as there are `boolean` and
+`Boolean` where latter can be _null_. Boolean types are usually used as
+flags meaning argument value may not be needed.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-boolean-anno]
+----
+====
+
+====
+[source, bash]
+----
+shell:>example
+arg1=false arg2=true arg3=false arg4=false arg5=true arg6=false
+
+shell:>example --arg4
+arg1=false arg2=true arg3=false arg4=true arg5=true arg6=false
+
+shell:>example --arg4 false
+arg1=false arg2=true arg3=false arg4=false arg5=true arg6=false
+----
+====
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-boolean-reg]
+----
+====
+
+====
+[source, bash]
+----
+shell:>example
+arg1=false arg2=true arg3=false arg4=null arg5=true arg6=false
+
+shell:>example --arg4
+arg1=false arg2=true arg3=false arg4=true arg5=true arg6=false
+
+shell:>example --arg4 false
+arg1=false arg2=true arg3=false arg4=false arg5=true arg6=false
+----
+====
+
+==== Number
+
+Numbers are converted as is.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-integer-anno]
+----
+====
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-integer-reg]
+----
+====
+
+==== Enum
+
+Conversion to enums is possible if given value is exactly matching enum itself.
+Currently you can convert assuming case insensitivity.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-enum-class]
+----
+====
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-enum-anno]
+----
+====
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-enum-reg]
+----
+====
+
+==== Array
+
+Arrays can be used as is with strings and primitive types.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-string-array-anno]
+----
+====
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionTypesSnippets.java[tag=option-type-string-array-reg]
+----
+====

spring-shell-docs/src/main/asciidoc/using-shell-options.adoc

@@ -20,3 +20,7 @@ include::using-shell-options-default.adoc[]
 include::using-shell-options-validation.adoc[]
 
 include::using-shell-options-label.adoc[]
+
+include::using-shell-options-types.adoc[]
+
+include::using-shell-options-naming.adoc[]