Completed, rewritten and reflow closes #2600
Completed, rewritten and reflow closes #2600

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