Есть разные системы документации NetBeans - одобряет следующую (пример - собирать документацию какой либо системой ещё не пробовал):
/**
* Меняет параметр сортировки в скрытом блоке и
* вызывает loadRecalls()
*
* @param {number} newso - new sorting order - значения тут 0,1 или 2 -
* о них можно почить в описании ajax_recall() (php backend)
* */
function changeOrderAndLoadRecalls(newso){
