Issue parsing 'Returns' in description

[UziTech]

Moved from atom/atom#15101

The Atom Workspace documentation lists a workspace item's required methods but does not list the optional methods listed in the comments of /src/workspace.js.

Once the parser hits the Returns keyword after getTitle() it thinks the description is over.

[UziTech]

this is still an issue. The documentation doesn't show any methods for the "item" interface other than getTitle() (with no description)

The docs should show descriptions for:

• getElement()
• destroy()
• onDidDestroy(callback)
• serialize()
• getURI()
• getLongTitle()
• onDidChangeTitle(callback)
• getIconName()
• onDidChangeIcon(callback)
• getDefaultLocation()
• getAllowedLocations()
• isPermanentDockItem()
• save()
• saveAs(path)
• getPath()
• isModified()
• onDidChangeModified()
• copy()
• getPreferredHeight()
• getPreferredWidth()
• onDidTerminatePendingState(callback)
• shouldPromptToSave()

from the Workspace Comments