How do I document an attribute should either be present or absent?

[csaftoiu]

I want to create a directive which takes a parameter based on whether an attribute is present. That is:

<foo some-attr></foo>

Should do one thing, while:

<foo></foo>

Should do another thing. I know how to accomplish this in code.

The question is, how do I document this with ngdoc? Currently I have:

/**
 * @ngdoc directive
 * @name someModule.directive:foo
 * @restrict E
 * @param {boolean=} someAttr If present, will do something.
 */

However, when the documentation is generated with ngdocs, it looks like this:

Usage

as element:

<foo
     [some-attr="{boolean}"]>
</foo>

This doesn't really convey what I want, which would be something like:

Usage

as element:

<foo
     [some-attr]>
</foo>

Is there any way to make the generated documentation look like that?

[wingedfox]

Hi,

Take a look at Dgeni-alive generator, it is based on the recent dgeni-packages and provides more features than ngdocs (demo).

[petebacondarwin]

@csaftoiu can you just do the following?

@param [someAttr] If present, will do something.