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.


Cheers,

Marc


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 devel@lists.zephyrproject.org to automatically receive all group messages.