Re: [boost] Help requested for boost documentation for polymorphic_value

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:
> https://drive.google.com/open?id=1xpD8s8zDzedVDDlqjsl1JtYGaJBHWoGy
> 
> 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?

HTH

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal UK LA8 8AB
[phone]