Boost C++ Libraries: Ticket #3929: Property.tree - outdated "Five Minute Tutorial" https://svn.boost.org/trac10/ticket/3929 <p> The documentation of "Property tree" does not correspond current version of library: </p> <p> 1)"Five Minute Tutorial" (<a href="http://www.boost.org/doc/libs/1_42_0/doc/html/boost_propertytree/tutorial.html">http://www.boost.org/doc/libs/1_42_0/doc/html/boost_propertytree/tutorial.html</a>). It is not possible to compile function save(). The problem line is: </p> <pre class="wiki">......... pt.put("debug.modules.module", name, true); ........ </pre><p> 2) I built and ran example <strong>debug_settings.cpp</strong> (<a href="http://www.boost.org/doc/libs/1_42_0/libs/property_tree/examples/debug_settings.cpp">http://www.boost.org/doc/libs/1_42_0/libs/property_tree/examples/debug_settings.cpp</a>). The input file (debug_settings.xml) is not equal to output file (debug_settings_out.xml). </p> <p> As far as understand, library was changed in last version. Specifically, function <strong>put</strong> was changed and new function <strong>add</strong> was introduced. But "Five Minute Tutorial" was not updated. But, ironically, <strong>debug_settings.cpp</strong> was changed by commenting line with <strong>put</strong> function. </p> <p> As result, I spend a lot of time to make the first steps with this library. </p> <p> My suggestions:<br /> 1) Update "Five Minute Tutorial" to current version of library. Explain difference between put and add functions.<br /> 2) Update example. <br /> 3) Expand "Five Minute Tutorial" to more complex usage of library. Or add new chapter to documentation with examples of usage. </p> <p> Best regards </p> <p> Sergey Voropaev </p> en-us Boost C++ Libraries /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/3929 Trac 1.4.3 Sebastian Redl Tue, 27 Apr 2010 12:24:00 GMT status changed; resolution set https://svn.boost.org/trac10/ticket/3929#comment:1 https://svn.boost.org/trac10/ticket/3929#comment:1 <ul> <li><strong>status</strong> <span class="trac-field-old">new</span> → <span class="trac-field-new">closed</span> </li> <li><strong>resolution</strong> → <span class="trac-field-new">fixed</span> </li> </ul> <p> (In <a class="changeset" href="https://svn.boost.org/trac10/changeset/61615" title="Update tutorial and an example to the new functions. Fixes bug 3929.">[61615]</a>) Update tutorial and an example to the new functions. Fixes bug 3929. </p> Ticket