Re: [boost] Asciidoc, an alternative for documentation

Subject: Re: [boost] Asciidoc, an alternative for documentation
From: Vinnie Falco (vinnie.falco_at_[hidden])
Date: 2017-10-08 03:06:01

On Sat, Oct 7, 2017 at 7:58 PM, Steven Watanabe via Boost
<boost_at_[hidden]> wrote:
> I find this rather lacking.

Obviously a single item from a reference, without the surrounding
context, is going to appear lacking.
> - What is a "known-scheme?"

You'd have to examine the surrounding context

> - Why are these schemes special?
>   What does it mean for a scheme to be special?
>   why should I care whether it's special?

Great questions, which I do not yet know the answer to :)
As I said, "in the middle of writing."

And yet, it does not invalidate my original point which is

    1. Write whatever you know at the time you declare the function
    2. Use extraction tools to generate a reference that accompanies
        exposition (but does not attempt to replace it).

Thanks