parse_1usage_text(text)
parse_usage_text(text)parse_1usage_text
parse_usage_text does some preprocessing of text then
calls parse_1usage_text for each usage statement. The preprocessing changes "\dots" to "..." and converts
S3 method descriptions to a form suitable for parse(). The text
is then parsed (with parse) and "srcref" attribute
removed from the parsed object.
todo: currently no checks is made for Rd comments in text.