Adds definition + examples closes #2342
Adds definition + examples closes #2342

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