"complex" jsdoc example

jsdoc.js

/**
 * sort data
 *
 * @param {String[]} data - data points
 * @param {String[]} labels - labels in same order as data points
 * @param {Object} options - labels in same order as data points
 * @param {Number} sort - direction to short (ascending, descending)
 * @return {Object} sorted - sortedData object
 * @return {Number[]} sorted.data - data sorted in order
 * @return {String[]} sorted.labels - labels for data returned in matching order
 * @return {Number[]} sorted.sortIndex - sorted index of how the array was sorted
 */