id,summary,reporter,owner,description,type,status,milestone,component,version,severity,resolution,keywords,cc
3929,"Property.tree - outdated ""Five Minute Tutorial""",Sergey Voropaev <Serge-Voropaev@…>,Sebastian Redl,"The documentation of ""Property tree"" does not correspond current version of library:

1)""Five Minute Tutorial"" ([http://www.boost.org/doc/libs/1_42_0/doc/html/boost_propertytree/tutorial.html]). It is not possible to compile function save(). The problem line is:
{{{
.........
      pt.put(""debug.modules.module"", name, true);
........
}}}

2) I built and ran example '''debug_settings.cpp''' ([http://www.boost.org/doc/libs/1_42_0/libs/property_tree/examples/debug_settings.cpp]). The input file (debug_settings.xml) is not equal to output file (debug_settings_out.xml). 

As far as understand, library was changed in last version. Specifically, function '''put''' was changed and new function '''add''' was introduced. But ""Five Minute Tutorial"" was not updated. But, ironically, '''debug_settings.cpp''' was changed by commenting line with '''put''' function.

As result, I spend a lot of time to make the first steps with this library.

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.

Best regards

Sergey Voropaev
",Bugs,closed,Boost 1.43.0,property_tree,Boost 1.42.0,Problem,fixed,,