fixed use of incorrect, hard coded pct_off variable in buy_1_get_y_pct_off_z (code review); fixed a few minor, misleading api_doc strings.