What is the current practice for providing examples in CPAN distributions? I mean things that are more than you can insert into POD - like examples involving many files. Is creating an examples subdir a common practice here? Is it the best one? Not everyone finds it very intuitive.
Update: How about a tool, or an option for CPAN (perl -MCPAN -e 'install_examples Distro::Name') that would install the examples in current directory? So that they could be installed and tweaked many times.