Document @option long name

- Relates #637

Author: jvalkeal

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

@@ -15,6 +15,16 @@ include::{snippets}/OptionSnippets.java[tag=option-without-annotation]
 ----
 ====
 
+`Option` annotation can be used to define an option name if you
+don't want it to be same as argument name.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionSnippets.java[tag=option-with-option-annotation]
+----
+====
+
 `@ShellOption` annotation can be used to define an option name if you
 don't want it to be same as argument name.
 

spring-shell-docs/src/test/java/org/springframework/shell/docs/OptionSnippets.java

@@ -21,19 +21,28 @@
 import org.springframework.shell.command.CommandRegistration;
 import org.springframework.shell.command.CommandRegistration.OptionArity;
 import org.springframework.shell.command.CommandRegistration.OptionNameModifier;
+import org.springframework.shell.command.annotation.Option;
 import org.springframework.shell.standard.ShellMethod;
 import org.springframework.shell.standard.ShellOption;
 
 public class OptionSnippets {
 
-	class Dump1 {
+	class Dump1Legacy {
 		// tag::option-with-annotation[]
 		public String example(@ShellOption(value = { "--argx" }) String arg1) {
 			return "Hello " + arg1;
 		}
 		// end::option-with-annotation[]
 	}
 
+	class Dump1 {
+		// tag::option-with-option-annotation[]
+		public String example(@Option(longNames = "argx") String arg1) {
+			return "Hello " + arg1;
+		}
+		// end::option-with-option-annotation[]
+	}
+
 	class Dump7 {
 		// tag::option-with-annotation-without-prefix[]
 		public String example(@ShellOption(value = { "argx" }) String arg1) {