Document default export

[SimenB]

The generated documentation for a default, unnamed export, gets the header of the first argument.

I'm not familiar with JSDoc, so might just be me doing something weird.

Also, any way to properly document that it's the default, as it's not named?

And another thing while I'm here, why does parameters with default values get a = added? And why do I have to document the default value, when it's in the code? From #305 I think it should work, but it doesn't...

Sample: https://github.com/SimenB/wait-until-promise/blob/doc/API.md

[gajus]

Is there any workaround this?

// ./index.js
import replaceFirst from './replaceFirst';

export {
    replaceFirst
};

// ./replaceFirst.js

/**
 * @public
 */
export default (test) => {};

Now the function exported from replaceFirst gets name "test" (first parameter name). Default export ought to be used name of the file (or in case if function is exported from ./src/replaceFirst/index.js - name of the folder).

[gajus]

A simple workaround is to add @name JSDoc attribute.

[tmcw]

This is now resolved with the changes in #435 - if a default export is unnamed, it is named after the file it is declared in. Going to lock this down with a test in es6.input.js