Code style bikeshedding is great, let's do it, here we go. From bug 541622: > Looks like we are using javadoc/jsdoc style comments to document functions. Oh, meant to mention that. I'm more concerned about documenting functions in the first place than the style we use to do it. Javadoc is definitely widely used in Mozilla for both C++ and JS, so considering that one day other people will be mainta