Fix inconsistency between JSON output and ddoc output

[yshui]

JSON should include version blocks in templates, same as ddoc.

BTW, I think we should include both branches of static if in ddoc output.

[yshui]

This fixes dlang/ddox#86.

Forum discussion

[yshui]

Oops, huge change in the resulting documents....

How can I see the diffs?

[yshui]

Somehow ddox associate the document to member of the template, not the template itself. Does anybody know why?

[WalterBright]

Since this is fixing a bug, can you please file a bugzilla issue for it? That will make the changelog easier and more organized. Thanks!

[dlang-bot]

Thanks for your pull request, @yshui! We are looking forward to reviewing it, and you should be hearing from a maintainer soon.

Some tips to help speed things up:

• smaller, focused PRs are easier to review than big ones

• try not to mix up refactoring or style changes with bug fixes or feature enhancements

• provide helpful commit messages explaining the rationale behind each change

Bear in mind that large or tricky changes may require multiple rounds of review and revision.

Please see CONTRIBUTING.md for more information.

Bugzilla references

Auto-close	Bugzilla	Description
✓	17256	Inconsistent output between json and ddoc

[yshui]

@WalterBright But this change also has big impact on the ddox output. Can you review the change?

[MartinNowak]

We do have tests for the JSON output, simply add to that.
https://github.com/dlang/dmd/blob/master/test/compilable/json.d
https://github.com/dlang/dmd/blob/master/test/compilable/extra-files/json.out

We can then separaretly check ddox whether it correctly processes those entities.

[andralex]

cc @yshui there seem to be errors in the autotester, please check so we move this forward?

[yshui]

Seems DAutoTest can't find libdparse?

[andralex]

cc @MartinNowak

[schveiguy]

Digger says this caused a regression: https://issues.dlang.org/show_bug.cgi?id=20742

It appears the json output is now putting out MORE than what ddoc puts out, including docs inside a version(none) block. I'll look into how we can make these two systems match.