polettix/App-Easer

Please document "sources" subroutine interface

djerius opened this issue · 1 comments

Hi,

The API for a custom locator subroutine isn't defined. Given a locator of

[ \&locator, @opts ]

it seems to be

sub locator( $app, \@opts, \@args );

where @args is an undocumented argument to collect, which receives it from run, which receives it as the list of arguments to parse.

None of the provided source_* routines make use of @args; is its presence in their signature a deprecated pattern?

None of the provided source_* routines make use of @args; is its presence in their signature a deprecated pattern?

I missed that source_CmdLine does use it.