[Issue 12097] New: Ddoc unittest should generate consistent result with 'ditto' declarations

d-bugmail at puremagic.com d-bugmail at puremagic.com
Fri Feb 7 02:51:24 PST 2014


https://d.puremagic.com/issues/show_bug.cgi?id=12097

           Summary: Ddoc unittest should generate consistent result with
                    'ditto' declarations
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Keywords: ddoc
          Severity: normal
          Priority: P2
         Component: DMD
        AssignedTo: nobody at puremagic.com
        ReportedBy: k.hara.pg at gmail.com


--- Comment #0 from Kenji Hara <k.hara.pg at gmail.com> 2014-02-07 02:51:15 PST ---
This example code:

  /// declaration
  struct S
  {
      /// method
      void foo() {}
  }

  /// ddoc code
  unittest
  {
      int a = 1;
  }

Will generate following doc:

  struct S;
    declaration

    Examples:
    ddoc code
    int a = 1;

    void foo();
      method

====

However, if you add a 'ditto' declaration immediately after 'S':

  /// declaration
  struct S
  {
      /// method
      void foo() {}
  }

  /// ditto
  void f() {}

  /// ddoc code
  unittest
  {
      int a = 1;
  }

In generated ddoc, 'Examples' section will be moved after the members of S.

  struct S; 
  void f();
    declaration

    void foo();
      method

    Examples:   <--- Moved after S.foo
    ddoc code
    int a = 1;

It should be:

  struct S; 
  void f();
    declaration

    Examples:
    ddoc code
    int a = 1;

    void foo();
      method

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


More information about the Digitalmars-d-bugs mailing list