Re: [Boost-docs] [quickbook] Does import work?

Subject: Re: [Boost-docs] [quickbook] Does import work?
From: Daniel James (dnljms_at_[hidden])
Date: 2011-10-19 20:23:11

On 19 October 2011 05:02, Rene Rivera <grafikrobot_at_[hidden]> wrote:
> On 10/18/2011 1:18 PM, Daniel James wrote:
>>
>> Then you guessed wrong. I listed several reasons, and I wasn't talking
>> about the implementation there. The quickbook *language* doesn't have
>> good file handling capabilities. And it shouldn't. It isn't a language
>> for searching directories.
>
> OK, but semantically the language already does "file searching" even if only
> a singular matched, or not matched, file at a time.

Many is more complicated than one. I've explained why before.

>> What you want has two phases - the first phase is to gather the
>> documentation source out of the headers, the second is the
>> documentation generation phase. These are quite distinct. There's no
>> good reason to squash them together. That's not a "bad excuse", that's
>> separation of concerns.
>
> It seems that your sentiment runs counter to the Literate Programming
> ideals. Or maybe I don't understand the two parts you are referring to.

You'll have to explain how you worked that out because you've lost me.
I'm suggesting your 'weave' could produce quickbook instead of TeX,
that seems consistent with Literate Programming.