Adds clarification fixes #1770
Adds clarification fixes #1770

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