Re: [Boost-docs] [poly_collection] Doc not being automatically built

Subject: Re: [Boost-docs] [poly_collection] Doc not being automatically built
From: Edward Diener (eldiener_at_[hidden])
Date: 2017-06-07 15:18:01

On 6/7/2017 3:00 AM, Joaquin M López Muñoz via Boost-docs wrote:
> El 06/06/2017 a las 23:39, Steven Watanabe via Boost-docs escribió:
>> AMDG
>>
>> On 06/06/2017 03:07 PM, Joaquin M López Muñoz via Boost-docs wrote:
>>> <snip>
>>> Help again... This is how the jamfile looks like
>>>
>>> https://github.com/boostorg/poly_collection/blob/develop/doc/Jamfile.v2
>>>
>>> Shared doc building has already cycled through this:
>>>
>>> http://www.boost.org/doc/libs/develop/doc/html/poly_collection/an_efficient_polymorphic_data_st.html 
>>>
>>>
>>>
>>> but the images won't show. I have looked for this img directory, unable
>>> to find it anywhere
>>> below http://www.boost.org/doc/libs/develop/doc/
>>>
>> "alias boostdoc : poly_collection : : <dependency>images_boostdoc ;"
>>
>> Try adding one more ':' before the <dependency>.
>> The interaction between <dependency> and alias is
>> a bit strange, so you need to put it in the usage-requirements
> 
> That did it! Thanks anyone for your help. I'm so glad it's over now and 
> hope won't
> ever touch this again in my lifetime :-)
> 
> On a more serious note, Boost tools such as b2, Quickbook etc. and the 
> integration
> mechanisms around documentation, regression testing, submoduling... feel 
> like an
> arcane science without sensible references: I (and I guess many other 
> authors) resort
> to copy and pasting from what predecessors did in the past without really
> understanding what's going on. I wonder how much of an entry barrier 
> this is for
> potential new Boost authors.

Quickbook syntax itself is well documented.

> 
> Joaquín M López Muñoz