Subject: Re: [boost] Help requested for boost documentation for polymorphic_value
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2017-12-11 10:04:55
> -----Original Message-----
> From: Boost [mailto:boost-bounces_at_[hidden]] On Behalf Of Jonathan Coe via Boost
> Sent: 11 December 2017 09:08
> To: boost_at_[hidden]
> Cc: Jonathan Coe
> Subject: [boost] Help requested for boost documentation for polymorphic_value
> I have been preparing polymorphic_value for submission to boost.
> I have draft documentation here:
> but am having problems generating doxygen docs. A forward declaration seems
> to stop generation of docs for methods of polymorphic_value.
> I'm at a loss as to why doxygen is not working properly for boost doc (it
> works fine when run in isolation) and would be grateful for any insight
> anyone can offer. I suspect it's a simple problem but I'm not very
> experienced with doxygen and am new to the boost docs tools.
> source is here: https://github.com/jbcoe/polymorphic_value/tree/boost
I'm not sure if this helps, but I have a dim recollection of trouble with Doxygen and Boost when I had code with a lot of separate
definitions and declarations. Is the problem that Doxygen is seeing the declaration, and finding no Doxygen-syntax comments, ticks
it off as 'done'? When Doxygen reaches the definitions and the Doxygen-syntax comments, it or the later Boost processing ignores
them. I have a dim recollection that I repeated the Doxygen-syntax comments in both places. You could try this quickly?
--- Paul A. Bristow Prizet Farmhouse Kendal UK LA8 8AB +44 (0) 1539 561830
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk