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

Subject: Re: [Boost-docs] [quickbook] Does import work?
From: Dave Abrahams (dave_at_[hidden])
Date: 2011-10-16 20:46:13

on Sun Oct 16 2011, Rene Rivera <grafikrobot-AT-gmail.com> wrote:

> On 10/16/2011 11:38 AM, Daniel James wrote:
>> On Sunday, 16 October 2011, Rene Rivera wrote:
>
>>>
>>>
>>> Right. I'm trying to have "[import ..]" work as easy as Doxygen does, but
>>> for quickbook. As documenting the library I'm working on would otherwise be
>>> a serious PITA. And I'd rather avoid using Doxygen for it as it's much
>>> easier to deal with quickbook directly. Ultimately I want to be able to:
>>>
>>> ===
>>> [import boost/predef/*.h]
>>> [import boost/predef/*/*.h]
>>> [import boost/predef/*/*/*.h]
>>> ===
>>>
>>> And have all the documentation that's embedded in those source files
>>> injected into the quickbook stream. Without me having to maintain what the
>>> files are, or what they contain.
>>>
>>
>> So you don't want to include the whole headers, just the documentation
>> embedded in them?
>
> Right.
>
>> This feels like a bit of an odd thing to do in quickbook
>> itself,
>
> Is it any odder than the existing import facility?

Seems like a natural bit of Literate Programming functionality to me.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com