ENYO-3042: add jsdoc & do not silently discard fs i/o error

Enyo-DCO-1.1-Signed-off-by: Francois-Xavier KOWALSKI <francois-xavier.kowalski@hp.com>