sun/innerXHTML — comment on commit 739c514be6c419e8918001be58a5ebb0e8db5973
File:  line 0
By TwoD:

Based on http://www.2ality.com/2011/08/jsdoc-intro.html and what JSDoc actually produced, I think something more along

```javascript
/**
* Reads or writes a DOM tree from or to a DOM element.
*
* @param {Node|string} source
* A node or HTML ID string of a node to read from, or write to if string is
* passed.
* @param {string} [string]
* A string containing HTML to replace or append to source. If omitted, source
* is parsed and returned as a string.
* @param {boolean|Node|string} [appendage=false]
* Controls where string is injected, one of:
* - false: (default) Replaces all children of source.
* - Node: A DOM node. string is inserted before it.
* - ID: A HTML ID string suitable for document.getElementById(). string is
* inserted before it.
* - true: Appends string to source.
*
* @return {string|false}
* A text string of the contained XHTML markup of source, or false if source
* is not a Node.
*/
````

and

````javascript
/**
* Translates a string containing XHTML and XML markup into nodes for insertion into the DOM.
*
* @param {string} string
* A string containing XHTML.
*
* @return {Array}
* An array containing
* - the new DOM element structure parsed out of string, or false if string
* was not translated.
* - the new XHTML string parsed out of string.
*/
````
will work better.