[Boost-commit] svn:boost r68089 - in sandbox/icl/libs: icl/doc icl_xt/example

Subject: [Boost-commit] svn:boost r68089 - in sandbox/icl/libs: icl/doc icl_xt/example
From: afojgo_at_[hidden]
Date: 2011-01-13 06:20:54

Author: jofaber
Date: 2011-01-13 06:20:51 EST (Thu, 13 Jan 2011)
New Revision: 68089
URL: http://svn.boost.org/trac/boost/changeset/68089

Log:
Correction in introduction.qbk.
Text files modified: 
   sandbox/icl/libs/icl/doc/icl.qbk           |     1                                         
   sandbox/icl/libs/icl/doc/introduction.qbk  |    45 +++++++++++++++++++++++++++++++-------- 
   sandbox/icl/libs/icl_xt/example/Jamfile.v2 |     2                                         
   3 files changed, 37 insertions(+), 11 deletions(-)

Modified: sandbox/icl/libs/icl/doc/icl.qbk
==============================================================================
--- sandbox/icl/libs/icl/doc/icl.qbk	(original)
+++ sandbox/icl/libs/icl/doc/icl.qbk	2011-01-13 06:20:51 EST (Thu, 13 Jan 2011)
@@ -50,6 +50,7 @@
 [def __icl_set__      [@http://www.cplusplus.com/reference/stl/set/ `std::set` ]]
 [def __icl_sets__     [@http://www.cplusplus.com/reference/stl/set/ `std::sets`]]
 [def __std_set__      [@http://www.cplusplus.com/reference/stl/set/ `std::set` ]]
+[def __Std_set__      [@http://www.cplusplus.com/reference/stl/set/ `Std::set` ]]
 [def __std_sets__     [@http://www.cplusplus.com/reference/stl/set/ `std::sets`]]
 [def __std_map__      [@http://www.cplusplus.com/reference/stl/set/ `std::map` ]]
 [def __std_maps__     [@http://www.cplusplus.com/reference/stl/set/ `std::maps`]]

Modified: sandbox/icl/libs/icl/doc/introduction.qbk
==============================================================================
--- sandbox/icl/libs/icl/doc/introduction.qbk	(original)
+++ sandbox/icl/libs/icl/doc/introduction.qbk	2011-01-13 06:20:51 EST (Thu, 13 Jan 2011)
@@ -178,30 +178,55 @@
 
 [section Icl's class templates]
 
-In addition to interval containers the *icl* provides element containers
-__icl_set__ and __icl_map__. 
+In addition to interval containers we can work with
+containers of elements that are ['*behavioral equal*]
+to the interval containers: On the fundamental aspect
+they have exactly the same functionality.
+An __std_set__ of the STL is such an equivalent set implementation.
+Due to the aggregation facilities of the icl's interval maps
+__std_map__ is fundamentally not completely equivalent to an __itv_map__.
+Therefore there is an extra __icl_map__ class template for maps of 
+elements in the icl.
 
-* An __icl_set__ is behavioral equal to __itv_bsets__ on the __bi_conceptual__ aspect.
+
+* The __std_set__ is behavioral equal to __itv_bsets__ on the __bi_conceptual__ aspect.
 
 * An __icl_map__ is behavioral equal to __itv_bmaps__ on the __bi_conceptual__  aspect. 
   Specifically an __icl_map__
   implements ['*aggregate on overlap*], which is
   named ['*aggregate on collision*] for an element container.
 
-The following table gives an overview over the main
+The following tables give an overview over the main
 class templates provided by the *icl*.  
 
-[table Synopsis over the icl's class templates
+[table Interval class templates
+[[group]              [form]      [template]          ]
+[[statically bounded] [asymmetric][__ro_itv__]        ]
+[[ ]                  []          [__lo_itv__]        ]
+[[ ]                  [symmetric] [__cl_itv__]        ]
+[[ ]                  []          [__op_itv__]        ]
+[[dynamically bounded][]          [__dc_itv__]        ]
+[[ ]                  []          [__ct_itv__]        ]
+]
+
+Statically bounded intervals always have the same kind of interval borders, 
+e.g. right open borders`[a..b)` for __ro_itv__. Dynamically bounded intervals
+can have different borders. Refer to the chapter about
+[link boost_icl.interface.class_templates.intervals ['*intervals*]] 
+for details.
+
+[table Container class templates
 [[granularity][style]     [sets]           [maps]           ]
-[[interval]   []          [__itv__]        []               ]            
-[[]           [joining]   [__itv_set__]    [__itv_map__]    ]
+[[interval]   [joining]   [__itv_set__]    [__itv_map__]    ]
 [[]           [separating][__sep_itv_set__][]               ]
 [[]           [splitting] [__spl_itv_set__][__spl_itv_map__]]
-[[element]    []          [__ele_set__]    [__ele_map__]    ]
+[[element]    []          [(__ele_set__)]  [__ele_map__]    ]
 ]                                   
 
-__Itv__ is placed deliberately in column *sets* because an
-interval is a set as well. Column ['*style*] refers to
+__Std_set__ is placed in paretheses, because it is not a class template
+of the *ICL*. It can be used as element container though that is
+behavioral equal to the ICL's interval sets on their fundamental aspect.
+Column ['*style*] refers to
 the different ways in which interval containers combine added
 intervals. These ['*combining styles*] are described in the next
 section.

Modified: sandbox/icl/libs/icl_xt/example/Jamfile.v2
==============================================================================
--- sandbox/icl/libs/icl_xt/example/Jamfile.v2	(original)
+++ sandbox/icl/libs/icl_xt/example/Jamfile.v2	2011-01-13 06:20:51 EST (Thu, 13 Jan 2011)
@@ -24,7 +24,7 @@
 exe time_and_duration
     :
         time_and_duration_/time_and_duration.cpp
-		/boost/date_time//boost_date_time
+        /boost/date_time//boost_date_time
     :
         <include>../../..
         <include>$(BOOST_ROOT)