joyent/node — pull request #6980 by gandazgul (2014-01-28 02:36:24+00:00)
Title: Update fs.readdir with JSDoc comment

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.