Re: [boost] Generating documentation

Subject: Re: [boost] Generating documentation
From: Alain Miniussi (alain.miniussi_at_[hidden])
Date: 2015-04-21 09:58:56

On 21/04/2015 15:42, Alain Miniussi wrote:
> And, in addition to the "missing doxygen ;" issue, please note that the
>  > warn: Unable to construct ./standalone
> goes away if I add a "using boostbook ;" statement. Also, more stuff get
> generated.

And while looking through the "git diff" output, I noticed that a lot of 
stuff is git controlled in doc/html/ while it seems to be generated 
documentation. Is that intentional ?

> Regards
>
> Alain
>
> On 21/04/2015 14:51, Alain Miniussi wrote:
>> Thanks,
>>
>> A few more questions:
>>
>> On 20/04/2015 19:50, John Maddock wrote:
>>>
>>>> Just curious, has anyone been able to get the documentation generated
>>>> (on a linux platform) by following the instructions in
>>>> http://www.boost.org/doc/libs/1_58_0/doc/html/boostbook/getting/started.html
>>>>
>>>>
>>>>
>>>>
>>>
>>> Yes, but the setup process isn't straightforward: it is documented here
>>> though: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted
>>>
>>> There is also a test project under /doc/test/ that you can use to verify
>>> you have everything setup correctly before proceeding further.
>>
>> As such, the test fails with:
>>
>> [alainm_at_tagir test]$ ../../b2  -d2
>> Jamfile.v2:71: in modules.load
>> ERROR: rule "doxygen" unknown in module
>> "Jamfile</gpfs/scratch/alainm/view/modular-boost/doc/test>".
>> ...
>>
>> Things go better if I replace "import doxygen ;" with "using doxygen ;"
>> in the test's Jamfile.
>> Is it a typo in the Jamfile or am I missing something ?
>>
>>
>> After that "fix/modification", I get:
>> [alainm_at_tagir test]$ ../../b2
>> Performing configuration checks
>>
>>      - 32-bit                   : no  (cached)
>>      - 64-bit                   : yes (cached)
>>      - arm                      : no  (cached)
>>      - mips1                    : no  (cached)
>>      - power                    : no  (cached)
>>      - sparc                    : no  (cached)
>>      - x86                      : yes (cached)
>>      - symlinks supported       : yes (cached)
>> warn: Unable to construct ./standalone      <========= PROBLEM ??
>> ...patience...
>> ...patience...
>> ...found 4373 targets...
>> ...
>>
>> But eventually the doc (or at least some doc) is generated.
>>
>> Thanks again
>>
>> Alain
>>
>>
>> Thanks,
>>
>>> HTH, John.
>>>
>>> _______________________________________________
>>> Unsubscribe & other changes:
>>> http://lists.boost.org/mailman/listinfo.cgi/boost
>>
>>
>
>

-- 
---
Alain