[Boost-commit] svn:boost r64017 - trunk/libs/graph/doc

Subject: [Boost-commit] svn:boost r64017 - trunk/libs/graph/doc
From: jewillco_at_[hidden]
Date: 2010-07-14 14:57:46

Author: jewillco
Date: 2010-07-14 14:57:45 EDT (Wed, 14 Jul 2010)
New Revision: 64017
URL: http://svn.boost.org/trac/boost/changeset/64017

Log:
Added warnings about subclassing BGL graph types and fixed a typo
Text files modified: 
   trunk/libs/graph/doc/graph_concepts.html |     9 +++++++--                               
   trunk/libs/graph/doc/graph_traits.html   |     4 ++++                                    
   2 files changed, 11 insertions(+), 2 deletions(-)

Modified: trunk/libs/graph/doc/graph_concepts.html
==============================================================================
--- trunk/libs/graph/doc/graph_concepts.html	(original)
+++ trunk/libs/graph/doc/graph_concepts.html	2010-07-14 14:57:45 EDT (Wed, 14 Jul 2010)
@@ -36,11 +36,16 @@
 kind of graph operation, typically only a small subset.  Furthermore,
 there are many graph data-structures that can not provide efficient
 implementations of all the operations, but provide highly efficient
-implementations of the operations necessary for a particular algorithm
-. By factoring the graph interface into many smaller concepts we
+implementations of the operations necessary for a particular algorithm.
+By factoring the graph interface into many smaller concepts we
 provide the graph algorithm writer with a good selection from which to
 choose the concept that is the closest match for their algorithm.
 
+Note that because of the use of traits classes rather than member
+types, it is not safe (and often will not work) to define subclasses of BGL
+graph types; those types may be missing important traits and properties that
+were defined externally to the class definition.
+
 <H2>Graph Structure Concepts Overview</H2>
 
 <P>

Modified: trunk/libs/graph/doc/graph_traits.html
==============================================================================
--- trunk/libs/graph/doc/graph_traits.html	(original)
+++ trunk/libs/graph/doc/graph_traits.html	2010-07-14 14:57:45 EDT (Wed, 14 Jul 2010)
@@ -34,6 +34,10 @@
 (when using nested typedefs inside the graph class), or to leave the
 typedef out of the <tt>graph_traits</tt> specialization for the graph
 class.
+Note that because of the use of traits classes rather than member
+types, it is not safe (and often will not work) to define subclasses of BGL
+graph types; those types may be missing important traits and properties that
+were defined externally to the class definition.
 
 <pre>
   template &lt;typename Graph&gt;