CMake targets: porting

Update from review

Co-authored-by: Hugues Kamba-Mpiana <[email protected]>

Author: 0xc0170

docs/porting/target/cmake.md

@@ -15,9 +15,9 @@ Note: All the CMake variables above are generated by mbed-tools and their values
 
 ## Mbed targets CMake input file structure
 
-We still support mbed-cli 1 and its requirements for the folders naming. To stay backward compatible, we still use the same naming even with CMake.
+As we are still supporting Mbed CLI 1, we have maintained the directory naming scheme that use prefixes (`FEATURE_`, `COMPONENT_`, `TARGET_`).
 
-Each Mbed OS target should be prefixed with `mbed-`. We translate automatically Mbed OS target names from targets.json to CMake targets. A target from targets.json named `CYSBSYSKIT_01` has CMake target `mbed-cysbsyskit-01`.
+Every Mbed CMake target should be prefixed with `mbed-`. Mbed boards listed in `targets.json` are translated in CMake to add the prefix and replace `_` with `-`. For example, the Mbed board `CYSBSYSKIT_01` is represented by the CMake target `mbed-cysbsyskit-01`.
 
 ### Vendor selection
 
@@ -46,36 +46,34 @@ add_subdirectory(TARGET_CY8CKIT_062S2_43012 EXCLUDE_FROM_ALL)
 
 add_library(mbed-psoc6 INTERFACE)
 
-# Add the include directories accessible from this directory that are not specific to an MCU family or Mbed target
+# Add the include directories accessible from this directory that are specific to this MCU family or Mbed target
 target_include_directories(mbed-psoc6
     INTERFACE
         ...
 )
 
-# Add the source files accessible from this directory that are not specific to an MCU family or Mbed target
+# Add the source files accessible from this directory that are specific to this MCU family or Mbed target
 target_sources(mbed-psoc6
     INTERFACE
         ...
 )
 ```
 
-The board target can link to `mbed-psoc6`. Let's take `mbed-cysbsyskit-01` target:
+The board CMake targets should link to `mbed-psoc6`:
 
 ```
 add_library(mbed-cysbsyskit-01 INTERFACE)
 
 target_include_directories(mbed-cysbsyskit-01
     INTERFACE
-        .
-        device
+        ...
 )
 
 target_sources(mbed-cysbsyskit-01
     INTERFACE
-        PeripheralPins.c
-        cybsp.c
+        ...
 )
-
+# Other libraries that the Mbed board depends on
 target_link_libraries(mbed-cysbsyskit-01
     INTERFACE
         mbed-cat1a
@@ -93,7 +91,7 @@ target_compile_definitions(mbed-cysbsyskit-01
 mbed_post_build_psoc6_merge_hex("CYSBSYSKIT_01")
 ```
 
-## Add target's CMakeLists.txt
+## Add Mbed board CMake input source file
 
 Add `CMakeLists.txt` files to the top level directory of a given vendor directory. List all files found in the directory in this CMake input source file, adding additional CMake input source file if it is MCU or Mbed target specific and has a great number of files which will make the top level `CMakeLists.txt` too complex. Think when you decide to create functions in a computer software code to remove complexity.