search

dlang / ddox

Advanced D documentation engine
MIT License
63 stars 21 forks source link

DDox ignores modules if there are no comments above the module declaration. #164

Open kayosiii opened 7 years ago

kayosiii commented 7 years ago

This behaviour either needs to change or be documented.

s-ludwig commented 7 years ago

This is actually caused by the behavior of DMD's JSON output AFAICS. So the only way to fix it here would be to push forward the dparse based implementation that circumvents the compiler completely (which is what I intend to do anyway, because the DMD based route has s number of additional issues).

kayosiii commented 7 years ago

can I suggest documenting some of the limitations as an interum measure. It took quite some time to figure out what was going on.