Update fs.js

If I do this kind of comments on all public methods would you merge them in?
You can generate documentation out of them plus they provide nice code hinting and completion on a lot of editors.