1. Messages
  2. CMake comments to HTML? (PR #9947 CMake build architecture documentation)

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

Nashif, Anas
 

I think this looks great.

 

9947 is not a PR, it is an enhancement issue, got me confused for a second. So it is an open enhancement issue with not PR associated with it, if you have something , send a PR please.

 

Anas

 

From: devel@... [mailto:devel@...] On Behalf Of Marc Herbert
Sent: Monday, February 11, 2019 7:45 PM
To: devel@...
Cc: Kinder, David B <david.b.kinder@...>
Subject: [Zephyr-devel] CMake comments to HTML? (PR #9947 CMake build architecture documentation)

 

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.