diff --git a/tools/build_api.py b/tools/build_api.py
index 4d87711930..276bfcd61c 100644
--- a/tools/build_api.py
+++ b/tools/build_api.py
@@ -1076,6 +1076,7 @@ def build_mbed_libs(target, toolchain_name, clean=False, macros=None,
         #   - mbed_overrides.o: this contains platform overrides of various
         #                       weak SDK functions
         #   - mbed_main.o: this contains main redirection
+        #   - PeripheralPins.o: PinMap can be weak
         separate_names, separate_objects = ['PeripheralPins.o', 'mbed_retarget.o', 'mbed_board.o',
                                             'mbed_overrides.o', 'mbed_main.o', 'mbed_sdk_boot.o'], []