Revises and clarifies examples refs #2277
Revises and clarifies examples refs #2277

perl6/doc,tbrowder/doc,jonathanstowe/doc,jonathanstowe/doc,tbrowder/doc,MasterDuke17/doc,stmuk/doc,jonathanstowe/doc,perl6/doc,MasterDuke17/doc,stmuk/doc,perl6/doc,tbrowder/doc,jonathanstowe/doc,perl6/doc,perl6/doc,tbrowder/doc,MasterDuke17/doc,jonathanstowe/doc,stmuk/doc,stmuk/doc,stmuk/doc,MasterDuke17/doc