[Issue 18074] New: Struct members missing from docs when the struct has a ditto ddoc comment

d-bugmail at puremagic.com d-bugmail at puremagic.com
Thu Dec 14 00:43:08 UTC 2017


https://issues.dlang.org/show_bug.cgi?id=18074

          Issue ID: 18074
           Summary: Struct members missing from docs when the struct has a
                    ditto ddoc comment
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: normal
          Priority: P1
         Component: dmd
          Assignee: nobody at puremagic.com
          Reporter: issues.dlang at jmdavisProg.com

If ddoc is generated for this code:

================
/// Something about foo.
auto foo() { return 42; }

/// Ditto
struct Foo
{
    /// Something about bar.
    auto bar() { return "str"; }
}
================

then the documentation for the function foo and the struct Foo is shown,
correctly merged together. However, the documentation for Foo.bar does not show
up. In contrast, if the struct is documented first, and ditto is used on the
fnuction, then all of the struct's members show up correctly in the
documentation. So, something about documenting a struct with ditto makes it so
that none of its members show up in the documentation.

--


More information about the Digitalmars-d-bugs mailing list