Fix Issue 22141 - Property .capacity is not listed in the array prope… (#3356)

* Fix Issue 22141 - Property .capacity is not listed in the array properties

* Update spec/arrays.dd

Co-authored-by: Nick Treleaven <ntrel002@gmail.com>

Co-authored-by: Dennis <dkorpel@users.noreply.github.com>
Co-authored-by: Nick Treleaven <ntrel002@gmail.com>

Author: 3 people

spec/arrays.dd

@@ -576,6 +576,8 @@ Returns an array literal with each element of the literal being the $(D .init) p
         the number of bytes per array element.)
         $(TROW $(D .length), Returns the number of elements in the array.
         This is a fixed quantity for static arrays. It is of type $(D size_t).)
+        $(TROW $(D .capacity), Returns the number of elements that can be appended to the array without reallocating.
+        $(D .capacity) is always $(D 0) for static arrays because their size cannot be modified.)
         $(TROW $(D .ptr), Returns a pointer to the first element of the array.)
         $(TROW $(D .dup), Create a dynamic array of the same size and copy the contents of the array into it. The copy will have any immutability or const stripped. If this conversion is invalid the call will not compile.)
         $(TROW $(D .idup), Create a dynamic array of the same size and copy the contents of the array into it. The copy is typed as being immutable. If this conversion is invalid the call will not compile.)
@@ -605,6 +607,7 @@ Returns an array literal with each element of the literal being the $(D .init) p
         which is 8 in 32-bit builds and 16 on 64-bit builds.))
         $(TROW $(D .length), Get/set number of elements in the
         array. It is of type $(D size_t).)
+        $(TROW $(D .capacity), Returns the number of elements that can be appended to the array without reallocating.)
         $(TROW $(D .ptr), Returns a pointer to the first element of the array.)
         $(TROW $(D .dup), Create a dynamic array of the same size and copy the contents of the array into it. The copy will have any immutability or const stripped. If this conversion is invalid the call will not compile.)
         $(TROW $(D .idup), Create a dynamic array of the same size and copy the contents of the array into it. The copy is typed as being immutable. If this conversion is invalid the call will not compile.)