Opened 13 years ago

Closed 12 years ago

#3929 closed Bugs (fixed)

Property.tree - outdated "Five Minute Tutorial"

Reported by: Sergey Voropaev <Serge-Voropaev@…> 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

Change History (1)

comment:1 by Sebastian Redl, 12 years ago

Resolution: fixed
Status: newclosed

(In [61615]) Update tutorial and an example to the new functions. Fixes bug 3929.

Note: See TracTickets for help on using tickets.