Bug 11608 – Inadequate documentation for std.getopt.config.passThrough

It works by rewriting the args[] so that only the unrecognized elements are left in args[] when getopt is through with it. But the documentation doesn't say that, and could use an illuminating example.

This is now thoroughly explained in the paragraph in after the first example and the passThrough example. Particularly: "In all cases, the command-line options that were parsed and used by getopt are removed from args. Whatever in the arguments did not look like an option is left in args for further processing by the program."