[Boost-bugs] [Boost C++ Libraries] #7393: documentation suggests to store handle in node, why?

Subject: [Boost-bugs] [Boost C++ Libraries] #7393: documentation suggests to store handle in node, why?
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2012-09-19 12:48:58

#7393: documentation suggests to store handle in node, why?
-------------------------------------------------+--------------------------
 Reporter:  Alex Hagen-Zanker <ahh34@…>          |       Owner:  timblechmann  
     Type:  Tasks                                |      Status:  new           
Milestone:  To Be Determined                     |   Component:  heap          
  Version:  Boost 1.52.0                         |    Severity:  Not Applicable
 Keywords:  documentation, mutability            |  
-------------------------------------------------+--------------------------
 The documentation of the mutability concept includes a section that
 describes how to store handles into values in the heap.

 "Note that handles can be stored inside the value_type (nodes): "

 http://www.boost.org/doc/libs/1_51_0/doc/html/heap/concepts.html#heap.concepts.mutability


 I don't understand the point of this note. Handles are used to access
 nodes. If you store your handles inside nodes and not somewhere else, how
 can you possibly access nodes. If you do store your handles somewhere
 else, why would you also store them in the nodes?

 I got confused trying to make use of this tip in my own code. Perhaps it
 is possible to add some motivation for this note, or just remove it.

-- 
Ticket URL: <https://svn.boost.org/trac/boost/ticket/7393>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.