[Issue 23432] New: document when array capacity is zero and capacity performance

[d-bugmail at puremagic.com]

https://issues.dlang.org/show_bug.cgi?id=23432

          Issue ID: 23432
           Summary: document when array capacity is zero and capacity
                    performance
           Product: D
           Version: D2
          Hardware: x86
                OS: Windows
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: dlang.org
          Assignee: nobody at puremagic.com
          Reporter: nick at geany.org

The spec should document that reducing array length will set capacity to zero.
(This was already reported as an invalid issue #11561).

The spec should warn that capacity needs a global lock and table lookup.

PR incoming.

--