My short (<2yr) experience of the code gave me the impression that only a small amount of it has proper doxygen comments. We must be frequenting different circles; or I'm somehow blind to them. :-)
Anyway, they're mainly useful when generated websites/documents are readily available, which it seems isn't the case (anymore). So I'm guessing people don't care to write/maintain them, because there is no obvious benefit at the moment. I personally would welcome a push to make doxygen more official, at the very least for headers that get used between modules, but the more the better; and to have an official (or de-facto) generated website. -- Gerald On Monday, February 20, 2017 at 6:06:40 PM UTC+11, Henri Sivonen wrote: > Our comments mostly try to follow the Doxygen format, and MDN says > that the documentation team has a tool for importing Doxygen-formatted > IDL comments into MDN articles. > > Other than that, is Doxygen output from m-c input being published anywhere? > > https://people-mozilla.org/~bgirard/doxygen/gfx/ is 404 these days. > > -- > Henri Sivonen > hsiv...@hsivonen.fi > https://hsivonen.fi/ _______________________________________________ dev-platform mailing list dev-platform@lists.mozilla.org https://lists.mozilla.org/listinfo/dev-platform
