Its is very unlikely we will use closure docs I would say avoiding custom tags unless we have some good reason to do so. The JS doc tags are here: http://code.google.com/p/jsdoc-toolkit/wiki/TagReference.

(As of today nowhere in the gecko or gaia codebase we use any api documentation generators).