reformatted primary docs readme to fix mixed tabs/spaces, also changed the function synopsis form to include the introduction of the '**' form for arrays of arrays.
format/typo/cleanup fixes for doc/master