JSdoc comments improved to meet requirements of JSDoc 3