[Issue 9719] ddoc isn't generated for inner values unless the outer is documented

d-bugmail at puremagic.com d-bugmail at puremagic.com
Fri Mar 15 10:33:03 PDT 2013


http://d.puremagic.com/issues/show_bug.cgi?id=9719


hsteoh at quickfur.ath.cx changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |hsteoh at quickfur.ath.cx


--- Comment #1 from hsteoh at quickfur.ath.cx 2013-03-15 10:33:02 PDT ---
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

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------


More information about the Digitalmars-d-bugs mailing list