[Issue 2272] New: synchronized attribute documentation

[d-bugmail at puremagic.com]

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

           Summary: synchronized attribute documentation
           Product: D
           Version: unspecified
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P3
         Component: www.digitalmars.com
        AssignedTo: bugzilla at digitalmars.com
        ReportedBy: o.dathe at gmx.de


The synchronized attribute for class methods should be documented somewhere in
attribute.html and/or in class.html.

Most importantly it should be mentioned that it represents a monitor operation
and thus behaves like in Java or like synchronized(this). There seems to be
confusion about that quite often. Additionally the case for static synchronized
methods should be mentioned (uses classinfo?).

Since one might assume the synchronized attribute works like the synchronized{}
statement one might also assume the synchronized method becomes a distinct
critical section. This misunderstanding should also be cleared out in
statement.html.


--