Re: Google Season of Docs

From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2020-04-23 18:16:36

On Thu, Apr 23, 2020 at 1:10 PM Bjorn Reese via Boost <boost_at_[hidden]>
wrote:

> On 2020-04-20 22:52, Rene Rivera via Boost wrote:
>
> > My long standing solution is to move the manual reference documentation
> as
> > close as possible to the code itself. For example Predef uses asciidoctor
> > and has a reference section. Which is embedded in the source code...
>
> How does this work? Does asciidoctor scan the C++ header files and pick
> the stuff that looks like asciidoc?
>

You have to tell it what parts of the source code, it's language agnostic,
to include in your asciidoctor output. <
https://asciidoctor.org/docs/user-manual/#include-partial>

-- 
-- Rene Rivera
-- Grafik - Don't Assume Anything
-- Robot Dreams - http://robot-dreams.net