@@ -0,0 +1,2600 @@
+package picocli.examples.synopsis;%0A%0Aimport picocli.CommandLine;%0Aimport picocli.CommandLine.Command;%0Aimport picocli.CommandLine.Option;%0Aimport picocli.CommandLine.Parameters;%0A%0Aimport java.util.List;%0A%0Apublic class RequiredMultiValueOptionDemo %7B%0A    @Command(name = %22issue688%22, description = %22Synopsis test%22,%0A            optionListHeading = %22Options%25n%22,%0A            parameterListHeading = %22Positional Parameters%25n%22%0A    )%0A    static class App %7B%0A        @Parameters(paramLabel = %22POSITIONAL%22, arity = %221..*%22, split = %22,%22,%0A                description = %22Specify at least one, each value may be a %22 +%0A                        %22comma-separated list of values.%22)%0A        List%3CString%3E positionals;%0A%0A        @Option(names = %7B%22-a%22, %22--aaa%22%7D, paramLabel = %22AAA%22, required = true,%0A                description = %22This required option may be specified multiple times.%22)%0A        List%3CString%3E requiredFoos;%0A%0A        @Option(names = %7B%22-b%22, %22--bbb%22%7D, paramLabel = %22BBB%22, required = true, split = %22,%22,%0A                description = %22This required option may be specified multiple times, %22 +%0A                        %22and each value may be a comma-separated list of values.%22)%0A        List%3CString%3E requiredBars;%0A%0A        @Option(names = %7B%22-c%22, %22--ccc%22%7D, paramLabel = %22CCC%22,%0A                description = %22This option may be specified multiple times.%22)%0A        List%3CString%3E foos;%0A%0A        @Option(names = %7B%22-d%22, %22--ddd%22%7D, paramLabel = %22DDD%22, split = %22,%22,%0A                description = %22This option may be specified multiple times, %22 +%0A                        %22and each value may be a comma-separated list of values.%22)%0A        List%3CString%3E bars;%0A    %7D%0A%0A    public static void main(String%5B%5D args) %7B%0A        new CommandLine(new App()).usage(System.out);%0A    %7D%0A    // Expected output:%0A/*%0AUsage: issue688 -a=AAA %5B-a=AAA%5D... -b=BBB%5B,BBB...%5D %5B-b=BBB%5B,BBB...%5D%5D...%0A                %5B-c=CCC%5D... %5B-d=DDD%5B,DDD...%5D%5D... POSITIONAL%5B,POSITIONAL...%5D...%0ASynopsis test%0APositional Parameters%0A      POSITIONAL%5B,POSITIONAL...%5D...%0A                           Specify at least one, each value may be a comma-separated%0A                             list of values.%0AOptions%0A  -a, --aaa=AAA            This required option may be specified multiple times.%0A  -b, --bbb=BBB%5B,BBB...%5D   This required option may be specified multiple times, and%0A                             each value may be a comma-separated list of values.%0A  -c, --ccc=CCC            This option may be specified multiple times.%0A  -d, --ddd=DDD%5B,DDD...%5D   This option may be specified multiple times, and each%0A                             value may be a comma-separated list of values.%0A*/%0A%7D%0A

add example