If the caret is within a collapsed region, this function expands all parent elements so that the caret is visible. The function can be directed to operate on a specific document by supplying the optional doc parameter. If doc is omitted, then the current document is used. If the current view is a document map, the hierarchy will be expanded sufficient levels to display the element containing the text caret.