CMake comments to HTML? (PR #9947 CMake build architecture documentation)

Marc Herbert

I tried the “moderncmakedomain” sphinx extension to prototype extracting CMake comments into html and it seems to work, see screenshot and PR below.

Dave (cc:) seems to like it.

Just a quick hack for now, Linux only. Two questions:
- Is the approach generally acceptable? Notably: is sphinx-moderncmakedomain acceptable as an additional pip3 requirement?
- If yes then is Sebastian's PR #9947 the correct place for this? I asked him privately but he’s either off or busy. If yes then let’s discuss there and not on the mailing-list.



Begin forwarded message:

Subject: Re: [zephyrproject-rtos/zephyr] CMake build architecture documentation (#9947)
Date: 11 February 2019 at 16:21:45 GMT-8

This is what the above commit produces:

You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub, or mute the thread.

Join to automatically receive all group messages.