diff --git a/docs/xml/lcl/dbctrls.xml b/docs/xml/lcl/dbctrls.xml
index 61ec19abcc..e01af9d22c 100644
--- a/docs/xml/lcl/dbctrls.xml
+++ b/docs/xml/lcl/dbctrls.xml
@@ -1418,7 +1418,50 @@ Calls the UpdateRecord method in the internal
TFieldDataLink instance when it is in an edit state.
+
+For the macOS (Darwin) platform, additional virtual key codes are detected (and
+discarded) if the contents of the field in the linked dataset cannot be
+modified. These keys include:
+
+
+
VK_0..VK_9
+
numeric characters not on the numeric keypad
+
VK_A..VK_Z
+
alphabetic characters
+
VK_NUMPAD0..VK_NUMPAD9
+
numeric digits on the numeric keypad
+
VK_MULTIPLY, VK_DIVIDE, VK_ADD, VK_SUBTRACT
+
operators on the numeric keypad
+
VK_SEPARATOR, VK_DECIMAL
+
padded and non-padded Decimal separators
+
VK_OEM_1
+
';:' keycap on the US standard keyboard
+
VK_OEM_2
+
'/?' keycap on the US standard keyboard
+
VK_OEM_3
+
'`~' keycap on the US standard keyboard
+
VK_OEM_4
+
'[{' keycap on the US standard keyboard
+
VK_OEM_5
+
'\|' keycap on the US standard keyboard
+
VK_OEM_6
+
']}' keycap on the US standard keyboard
+
VK_OEM_7
+
+''"' (Apostrophe and Quote) keycap on the US standard keyboard
+
+
VK_OEM_8
+
miscellaneous character; varies by keyboard layout
+
+
+For these macOS-specific keys, the value in Key is set to 0 if the field cannot
+be modified.
+
+
+Modified in LCL version 3.6 to handle additional data keys on the macOS
+(Darwin) platform.
+
@@ -6878,6 +6921,7 @@ other handlers implemented in the ancestor class.
TCustomEdit.OnChange
+
Handles key down events in the data-aware control.
@@ -6910,7 +6954,50 @@ internal TFieldDataLink is not editable, the value in Key is set
VK_UNKNOWN.
+
+For the macOS (Darwin) platform, additional virtual key codes are detected (and
+discarded) if the contents of the field in the linked dataset cannot be
+modified. These keys include:
+
+
+
VK_0..VK_9
+
numeric characters not on the numeric keypad
+
VK_A..VK_Z
+
alphabetic characters
+
VK_NUMPAD0..VK_NUMPAD9
+
numeric digits on the numeric keypad
+
VK_MULTIPLY, VK_DIVIDE, VK_ADD, VK_SUBTRACT
+
operators on the numeric keypad
+
VK_SEPARATOR, VK_DECIMAL
+
padded and non-padded Decimal separators
+
VK_OEM_1
+
';:' keycap on the US standard keyboard
+
VK_OEM_2
+
'/?' keycap on the US standard keyboard
+
VK_OEM_3
+
'`~' keycap on the US standard keyboard
+
VK_OEM_4
+
'[{' keycap on the US standard keyboard
+
VK_OEM_5
+
'\|' keycap on the US standard keyboard
+
VK_OEM_6
+
']}' keycap on the US standard keyboard
+
VK_OEM_7
+
+''"' (Apostrophe and Quote) keycap on the US standard keyboard
+
+
VK_OEM_8
+
miscellaneous character; varies by keyboard layout
+
+
+For these macOS-specific keys, the value in Key is set to 0 if the field cannot
+be modified.
+
+
+Modified in LCL version 3.6 to handle additional data keys on the macOS
+(Darwin) platform.
+
TWinControl.KeyDown