www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 5335] New: DDoc ignores member when it is on the same line as open curly brace

reply d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=5335

           Summary: DDoc ignores member when it is on the same line as
                    open curly brace
           Product: D
           Version: D2
          Platform: Other
        OS/Version: Windows
            Status: NEW
          Severity: trivial
          Priority: P2
         Component: DMD
        AssignedTo: nobody puremagic.com
        ReportedBy: michal.minich gmail.com



PST ---
DMD 2.050

Only in C5 is member 'a' documented

///
class C1
{///
int a; }

///
class C2 {///
int a; }

///
class C3 {/** */ int a; }

///
class C4
{ /** */ int a; }

///
class C5 {
///
int a; }

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
Dec 09 2010
parent d-bugmail puremagic.com writes:
http://d.puremagic.com/issues/show_bug.cgi?id=5335


Stewart Gordon <smjg iname.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Keywords|                            |ddoc
                 CC|                            |smjg iname.com
            Summary|DDoc ignores member when it |DDoc ignores documentation
                   |is on the same line as open |comment that begins on the
                   |curly brace                 |same line as the open curly
                   |                            |brace



It's actually the documentation comment it ignores, not the member.  So if a
member's documentation is split across multiple single-line comments, it will
use all except the one that is on the same line as the {.  Try this at home:

///
class C1
{/// abc
/// def
int a; }

///
class C2
{/** abc
def
*/
int a; }

generated documentation:

class C1;

    int a;
        def

class C2;

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