Migrate Structure

spring-shell-docs/modules/ROOT/pages/using-shell-options.adoc

@@ -0,0 +1,38 @@
+[[using-shell-options]]
+== Options
+ifndef::snippets[:snippets: ../../test/java/org/springframework/shell/docs]
+
+Command line arguments can be separated into options and positional parameters.
+Following sections describes features how options are defined and used. We first
+go through some basics about using options and then go into details about
+various ways how options and arguments works.
+
+Generally speaking an _option_ is something after a commands prefixed with
+either `-` or `--`. An _option_ can either have a value or not depending
+on its context.
+
+Options can be defined with a target method using annotations with a method
+arguments or with programmatically using `CommandRegistration`.
+
+NOTE: In below sections `@ShellOption` refer to a _legacy annotation model_
+and `@Option` refer to an _annotation model_.
+
+include::using-shell-options-basics.adoc[]
+
+include::using-shell-options-short.adoc[]
+
+include::using-shell-options-arity.adoc[]
+
+include::using-shell-options-positional.adoc[]
+
+include::using-shell-options-optional.adoc[]
+
+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[]