Conflicts resolved:

- eg/SourceGenerator/NavalFate/NavalFate.csproj
- eg/SourceGenerator/NavalFate/Program.cs
- eg/SourceGenerator/NavalFate/Program.docopt.txt

For example:

    // Required:
    //   Either:
    //     Required:
    //       Command(ship, False) -> CommandNode ship Bool
    //       Command(new, False) -> CommandNode new Bool
    //       OneOrMore:
    //         Argument(<name>, []) -> ArgumentNode <name> List
    //     Required:
    //       Command(ship, False) -> CommandNode ship Bool
    //       Argument(<name>, []) -> ArgumentNode <name> List
    //       Command(move, False) -> CommandNode move Bool
    //       Argument(<x>, ) -> ArgumentNode <x> String
    //       Argument(<y>, ) -> ArgumentNode <y> String
    //       Optional:
    //         Option(,--speed,1,10) -> OptionNode speed String
    //     Required:
    //       Command(ship, False) -> CommandNode ship Bool
    //       Command(shoot, False) -> CommandNode shoot Bool
    //       Argument(<x>, ) -> ArgumentNode <x> String
    //       Argument(<y>, ) -> ArgumentNode <y> String
    //     Required:
    //       Command(mine, False) -> CommandNode mine Bool
    //       Required:
    //         Either:
    //           Command(set, False) -> CommandNode set Bool
    //           Command(remove, False) -> CommandNode remove Bool
    //       Argument(<x>, ) -> ArgumentNode <x> String
    //       Argument(<y>, ) -> ArgumentNode <y> String
    //       Optional:
    //         Either:
    //           Option(,--moored,0,False) -> OptionNode moored Bool
    //           Option(,--drifting,0,False) -> OptionNode drifting Bool
    //     Required:
    //       Required:
    //         Option(-h,--help,0,False) -> OptionNode help Bool
    //     Required:
    //       Option(,--version,0,False) -> OptionNode version Bool

Example of what's generated:

    static readonly Pattern Pattern =
        new Required(ImmutableArray.Create<Pattern>(
            new Either(ImmutableArray.Create<Pattern>(
                new Required(ImmutableArray.Create<Pattern>(
                    new Command("ship"),
                    new Command("new"),
                    new OneOrMore(
                        new Argument("<name>", null)))),
                new Required(ImmutableArray.Create<Pattern>(
                    new Command("ship"),
                    new Argument("<name>", null),
                    new Command("move"),
                    new Argument("<x>", null),
                    new Argument("<y>", null),
                    new Optional(ImmutableArray.Create<Pattern>(
                        new Option("", "--speed", 1, null))))),
                new Required(ImmutableArray.Create<Pattern>(
                    new Command("ship"),
                    new Command("shoot"),
                    new Argument("<x>", null),
                    new Argument("<y>", null))),
                new Required(ImmutableArray.Create<Pattern>(
                    new Command("mine"),
                    new Required(ImmutableArray.Create<Pattern>(
                        new Either(ImmutableArray.Create<Pattern>(
                            new Command("set"),
                            new Command("remove"))))),
                    new Argument("<x>", null),
                    new Argument("<y>", null),
                    new Optional(ImmutableArray.Create<Pattern>(
                        new Either(ImmutableArray.Create<Pattern>(
                            new Option("", "--moored", 0, null),
                            new Option("", "--drifting", 0, null))))))),
                new Required(ImmutableArray.Create<Pattern>(
                    new Required(ImmutableArray.Create<Pattern>(
                        new Option("-h", "--help", 0, null))))),
                new Required(ImmutableArray.Create<Pattern>(
                    new Option("", "--version", 0, null)))))));

where:

- error CS0826: No best type found for implicitly-typed array

Otherwise "System.NotSupportedException" error would result with the
message, "Collection was of a fixed size."

where:

- error CS1525: Invalid expression term ','

Belonged with "Remove need for support module for generated code" or
commit 04d585a.

https://github.com/docopt/docopt/blob/20b9c4ffec71d17cee9fd963238c8ec240905b65/examples/arguments_example.py

The new project type GUID is "9A19103F-16F7-4668-BE54-9A1E7A4F7556".
For more information, see:

- https://github.com/dotnet/project-system/blob/main/docs/opening-with-new-project-system.md#project-type-guids

Requires Visual Studio 2019 version 16.10.

See also:

- https://docs.microsoft.com/en-us/visualstudio/releases/2019/release-notes#NETProductivity
- https://twitter.com/raboof/status/1397296571801288704

This is in support of additional examples that allow a command and/or
option to be specified multiple times.

https://github.com/docopt/docopt/blob/20b9c4ffec71d17cee9fd963238c8ec240905b65/examples/calculator_example.py

https://github.com/docopt/docopt/blob/20b9c4ffec71d17cee9fd963238c8ec240905b65/examples/counted_example.py

https://github.com/docopt/docopt/blob/20b9c4ffec71d17cee9fd963238c8ec240905b65/examples/odd_even_example.py

https://github.com/docopt/docopt/blob/20b9c4ffec71d17cee9fd963238c8ec240905b65/examples/options_example.py

https://github.com/docopt/docopt/blob/20b9c4ffec71d17cee9fd963238c8ec240905b65/examples/options_shortcut_example.py

https://github.com/docopt/docopt/blob/20b9c4ffec71d17cee9fd963238c8ec240905b65/examples/quick_example.py

This reverts commit 57675df.

F5 debugging support of source generators seems to require
.NET SDK 5.0.300 otherwise it causes errors along the lines of:

> CSC : error CS8032: An instance of analyzer
>   DocoptNet.CodeGeneration.SourceGenerator cannot be created from
>   A:\docopt\dotnet\test\src\DocoptNet.CodeGeneration\bin\Release\netstandard2.0\DocoptNet.CodeGeneration.dll :
>   Could not load file or assembly 'Microsoft.CodeAnalysis,
>   Version=3.10.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35'.
>   The system cannot find the file specified.

Requires Visual Studio 2019 version 16.10.

F5 debugging support of source generators seems to also require
.NET SDK 5.0.300 otherwise it causes errors along the lines of:

> CSC : error CS8032: An instance of analyzer
>   DocoptNet.CodeGeneration.SourceGenerator cannot be created from
>   A:\docopt\dotnet\test\src\DocoptNet.CodeGeneration\bin\Release\netstandard2.0\DocoptNet.CodeGeneration.dll :
>   Could not load file or assembly 'Microsoft.CodeAnalysis,
>   Version=3.10.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35'.
>   The system cannot find the file specified.

See also:

- https://docs.microsoft.com/en-us/visualstudio/releases/2019/release-notes#NETProductivity
- https://twitter.com/raboof/status/1397296571801288704

Conflicts resolved:

- src/DocoptNet/PatternMatcher.cs