Property Tree Library status?
Is this finally going to make it into a release? 1.36? -- Jon Biggar Floorboard Software jon@floorboard.com jon@biggar.org
Jonathan Biggar <jon <at> biggar.org> writes:
Is this finally going to make it into a release? 1.36?
I had the same question a couple months back. The reply I received pointed me to the following interesting message from Marcin: http://article.gmane.org/gmane.comp.lib.boost.devel/171825 Basically, it appears that there is some work that still is required for this library, especially on moving the documentation to Boost.Book. My reply (and more information on the delay) is here: http://article.gmane.org/gmane.comp.lib.boost.devel/173006/ As you can see I mentioned that I might be able to help out with the documentation if I could find some time to learn about the doc chain. Fortunately, I was finally able to find some time recently to do this. Currently I have converted Marcin's original docs to QuickBook format. I also ran into issues with the reference section looking horrible. I am currently working around bugs(?) in doxygen's xml generation and trying to improve this. It's starting to near an acceptable state and I hope to have a couple patches to upload in a few days. The documentation would still require further work as the old docs on which this is based are fairly out-of-date, but this can probably be dealt with before release. Anyhow, I'll upload some patches for the docs in a few days for review. If they're somewhat acceptable then hopefully we can move forward with fixing the remaining blockers for this library and get it included in 1.36. At least this is the hope that I have.
My reply (and more information on the delay) is here:
http://article.gmane.org/gmane.comp.lib.boost.devel/173006/
As you can see I mentioned that I might be able to help out with the documentation if I could find some time to learn about the doc chain.
Fortunately, I was finally able to find some time recently to do this. Currently I have converted Marcin's original docs to QuickBook format.
Anyhow, I'll upload some patches for the docs in a few days for review. If they're somewhat acceptable then hopefully we can move forward with fixing the remaining blockers for this library and get it included in 1.36. At least this is the hope that I have.
Fantastic news Ryan. I and many other property tree users will be very pleased!
Paul Baxter <pauljbaxter <at> hotmail.com> writes:
Ryan wrote:
My reply (and more information on the delay) is here:
http://article.gmane.org/gmane.comp.lib.boost.devel/173006/
As you can see I mentioned that I might be able to help out with the documentation if I could find some time to learn about the doc chain.
Fortunately, I was finally able to find some time recently to do this. Currently I have converted Marcin's original docs to QuickBook format.
Anyhow, I'll upload some patches for the docs in a few days for review. If they're somewhat acceptable then hopefully we can move forward with fixing the remaining blockers for this library and get it included in 1.36. At least this is the hope that I have.
Fantastic news Ryan. I and many other property tree users will be very pleased!
Patch and quickbook files uploaded in bug 1989 attachments: http://svn.boost.org/trac/boost/ticket/1989 As the bug describes, more work is needed on this. Some updates for recent library changes including removing some sections need to be made at least. Also, linking with main boost docs still needs to be done. These patches are based upon Marcin's original docs. Unfortunately, there are some sections (e.g. property tree synopsis) that don't seem quite as good with the new docs (in this case because the class synopsis itself isn't embedded in this section, just the reference section). These and other polish items could be done, but a better understanding of quickbook/boostbook is needed. I can continue to look into this when I get a chance, but it might be a little while before I can do it. Anyhow, whoever is interested, feel free to build and review the docs based upon these patches. Hopefully this is at least a starting point, but let me know if there are any major issues. -Ryan
Patch and quickbook files uploaded in bug 1989 attachments: http://svn.boost.org/trac/boost/ticket/1989
As the bug describes, more work is needed on this. Some updates for recent library changes including removing some sections need to be made at least. Also, linking with main boost docs still needs to be done.
Might be worth posting to dev and user under a brand new subject line to make sure people don't miss it? Paul
participants (3)
-
Jonathan Biggar -
Paul Baxter -
Ryan Gallagher