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 regards, Jon
On 11 December 2017 at 09:07, Jonathan Coe
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
regards,
Jon
Please disregard my request for help. Doxygen does not create the docs in one HTML document like I had anticipated; the generated documents look right. Apologies for the noise. Jon
-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Jonathan Coe via Boost Sent: 11 December 2017 09:08 To: boost@lists.boost.org 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 +44 (0) 1539 561830
participants (2)
-
Jonathan Coe -
Paul A. Bristow