On Tue, 13 Sep 2016, Shuah Khan [off-list ref] wrote:

On 09/13/2016 03:20 AM, Jani Nikula wrote:

quoted

FWIW, I'm in favor of moving *all* the code away from Documentation, not
just tests. Essentially removing the CONFIG_BUILD_DOCSRC config option,
and reserving Documentation/Makefile for documentation build. After this
series, some of the remaining code belongs under samples, some under
tools.

I am planning another patch series to move all the examples and samples
and tools to their right location.

Great!

quoted

We could make it possible to include the code samples from samples into
the Sphinx built documentation.

I can't say I understand Sphinx, however, it might make sense to include
samples into Sphinx build. Is this approach different from the way they
are built under Documentation via Doc Makfiles now?

It's just that by default Sphinx won't allow including files outside of
its root directory, which is Documentation in this case. It just needs
an extension for this.

BR,
Jani.


-- 
Jani Nikula, Intel Open Source Technology Center