Bug 9719 – ddoc isn't generated for inner values unless the outer is documented

struct S { int i; /// not generated } /// This must be present struct A { int i; /// .. for this to be generated }

Isn't this a feature? Since otherwise, there would be nothing to attach the member's docs to. If you just reparent the member's docs into the outer scope, then you get confusing docs: struct S { int i; /// suppose this is generated } struct T { int i; /// suppose this is also generated } Now the output might look confusing: int i; suppose this is generated int i; suppose this is also generated IMO it's not a bug to require the containing scope to at least have an empty /// so that the output would at least contain: struct S int i; suppose this is generated struct T int i; suppose this is also generated