[Issue 7040] New: Phobos must use "version/else version" blocks for proper documentation generation

[d-bugmail at puremagic.com]

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

           Summary: Phobos must use "version/else version" blocks for
                    proper documentation generation
           Product: D
           Version: D2
          Platform: Other
        OS/Version: Windows
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Phobos
        AssignedTo: nobody at puremagic.com
        ReportedBy: andrej.mitrovich at gmail.com


--- Comment #0 from Andrej Mitrovic <andrej.mitrovich at gmail.com> 2011-11-30 17:02:51 PST ---
As reported here:
http://stackoverflow.com/questions/8335202/can-i-rely-on-the-presence-of-shell/8335304#8335304

The real issue is this:

/**
Doc comment..
*/
version (Posix) void test()
{
}

version (Windows) void test()
{
}

If you compile this on Posix, the docs get generated. If you compile it on
Windows, they *don't* get generated (The std.process has the opposite case, on
Windows the docs are generated but not on Posix). You need to use an else
version block instead:

/**
Doc comment..
*/
version (Posix) void test()
{
}
else version (Windows) void test()
{
}

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