[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