Documentation for Cmake Zephyr module macros

[vChavezB]

Is your feature request related to a problem? Please describe.
No.

Describe the solution you'd like
I have been using the Zephyr modules but most of the Cmake functions seemed obsure to me. I had to dig in the source code to check exactly what zephyr does in the background:

I would suggest a link to the source file so its easier to know what are all the options available for zephyr cmake modules.

For example I did not know about the zephyr_library_named function until I checked the source code.

zephyr/cmake/modules/extensions.cmake

Line 418 in e0fb044

add_library(${name} STATIC "")

I guess its not easy to auto-generate documentation from .cmake files but at least a link to where all the cmake functions to work with modules would be helpful.

If there is a link with documentation (rather than manually looking the source code) it would be nice to know where its located since I did not find it here

https://docs.zephyrproject.org/3.1.0/develop/modules.html

[stephanosio]

cc @tejlmand

[zephyrbot]

Hi @carlescufi, @kartben, @tejlmand,

This issue, marked as an Feature Request, was opened a while ago and did not get any traction. It was just assigned to you based on the labels. If you don't consider yourself the right person to address this issue, please re-assing it to the right person.

Please take a moment to review if the issue is still relevant to the project. If it is, please provide feedback and direction on how to move forward. If it is not, has already been addressed, is a duplicate, or is no longer relevant, please close it with a short comment explaining the reason.

@vChavezB you are also encouraged to help moving this issue forward by providing additional information and confirming this request/issue is still relevant to you.

Thanks!