add documentation for alternate syntax