Opened 13 years ago
Closed 12 years ago
#3929 closed Bugs (fixed)
Property.tree - outdated "Five Minute Tutorial"
Reported by: | Owned by: | Sebastian Redl | |
---|---|---|---|
Milestone: | Boost 1.43.0 | Component: | property_tree |
Version: | Boost 1.42.0 | Severity: | Problem |
Keywords: | Cc: |
Description
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:
1) Update "Five Minute Tutorial" to current version of library. Explain difference between put and add functions.
2) Update example.
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
(In [61615]) Update tutorial and an example to the new functions. Fixes bug 3929.