updated comments on function descriptions, added missing result parameters;