Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r66396 - in sandbox/icl/libs/icl: doc doxy_doc doxy_doc/doxygen_input/pages prj_home
From: afojgo_at_[hidden]
Date: 2010-11-04 06:27:09

Next message: afojgo_at_[hidden]: "[Boost-commit] svn:boost r66397 - sandbox/icl/libs/icl/doxy_doc/doxygen_input/pages"
Previous message: dsaritz_at_[hidden]: "[Boost-commit] svn:boost r66395 - sandbox/function/boost/function"

Author: jofaber
Date: 2010-11-04 06:27:04 EDT (Thu, 04 Nov 2010)
New Revision: 66396
URL: http://svn.boost.org/trac/boost/changeset/66396

Log:
Corrections on docs and html pages.
Added:
   sandbox/icl/libs/icl/prj_home/index.html (contents, props changed)
Text files modified:
   sandbox/icl/libs/icl/doc/introduction.qbk | 2
   sandbox/icl/libs/icl/doxy_doc/Doxyfile | 2
   sandbox/icl/libs/icl/doxy_doc/doxygen_input/pages/doxygen_mainpage.hpp | 82 ++++++++++++++++++++++++++++-----------
   3 files changed, 61 insertions(+), 25 deletions(-)

Modified: sandbox/icl/libs/icl/doc/introduction.qbk
==============================================================================
--- sandbox/icl/libs/icl/doc/introduction.qbk (original)
+++ sandbox/icl/libs/icl/doc/introduction.qbk 2010-11-04 06:27:04 EDT (Thu, 04 Nov 2010)
@@ -76,7 +76,7 @@

[section Definition and Basic Example]

-The [*Interval Template Library (ICL)] provides __itvs__ and two kinds of
+The [*Interval Container Library (ICL)] provides __itvs__ and two kinds of
interval containers: __itv_sets__ and __itv_maps__.

* An __itv_bset__ is a *set* that is implemented as a set of intervals.

Modified: sandbox/icl/libs/icl/doxy_doc/Doxyfile
==============================================================================
--- sandbox/icl/libs/icl/doxy_doc/Doxyfile (original)
+++ sandbox/icl/libs/icl/doxy_doc/Doxyfile 2010-11-04 06:27:04 EDT (Thu, 04 Nov 2010)
@@ -15,7 +15,7 @@
ALWAYS_DETAILED_SEC = YES
INLINE_INHERITED_MEMB = NO
FULL_PATH_NAMES = YES
-STRIP_FROM_PATH = D:/cygwin/home/jofa/dev/boost_sandbox/icl
+STRIP_FROM_PATH = D:/cygwin/home/jofa/dev/boost_sandbox/itl
STRIP_FROM_INC_PATH =
SHORT_NAMES = NO
JAVADOC_AUTOBRIEF = NO

Modified: sandbox/icl/libs/icl/doxy_doc/doxygen_input/pages/doxygen_mainpage.hpp
==============================================================================
--- sandbox/icl/libs/icl/doxy_doc/doxygen_input/pages/doxygen_mainpage.hpp (original)
+++ sandbox/icl/libs/icl/doxy_doc/doxygen_input/pages/doxygen_mainpage.hpp 2010-11-04 06:27:04 EDT (Thu, 04 Nov 2010)
@@ -11,12 +11,12 @@
#define BOOST_ICL_DOXYGEN_MAINPAGE_HPP_JOFA_091216

/**
-\mainpage Boost Interval Container Library
+\mainpage Interval Container Library (aka. Interval Template Library)

-\section header_sec Boost Interval Container Library
+\section header_sec Interval Container Library

Author: Joachim Faulhaber\n
-Copyright (c) 2007-2009: Joachim Faulhaber\n
+Copyright (c) 2007-2010: Joachim Faulhaber\n
Copyright (c) 1999-2006: Cortex Software GmbH, Berlin\n

Distributed under the Boost Software License, Version 1.0.\n
@@ -25,26 +25,29 @@

\section overview_sec Overview

-The Boost Interval Container Library (ITL+) is a collection of
+The Interval Container Library (ICL+)
+formerly known as Interval Template Library (ITL)
+is a collection of
generic c++ class templates for computations on intervals,
interval containers, large bitsets and generalized crosstables or cubes.

The complete library constists of three parts.

<ul>
-<li>Core library (itl): Interval containers.
+<li>Core library (Boost.Icl): Interval containers.
+
+The core library is accepted into the
+Boost c++ Libraries Collection
+as Interval Container Library Boost.Icl.
+A detailed boost book documentation for Boost.Icl is
+<a href="http://www.herold-faulhaber.de/boost_icl/doc/libs/icl/doc/html/index.html">

-The core library (ITL) is currently submitted for review at the
-Boost c++ Libraries Collection
-as Boost.IntervalContainer Library.
-A detailed boost book documentation for Boost.IntervalContainers is
-<a href="http://www.herold-faulhaber.de/boost_itl/doc/libs/icl/doc/html/index.html">
online available here</a>.
We recommend to refer to this documentation for all informations related
to interval containers. The boost book documentation also ships with
this release and can be found at "<boost_root>/libs/icl/doc/html/index.html".

-<li>Extended library (itl_xt):
+<li>Extended library (icl_xt):

The extended part contains class templates interval_bitset, product_history, and tupel_computer
(cubes). Those parts are not or not yet intended to be proposed for boost.
@@ -53,14 +56,14 @@

The Law Based Test Automaton (also refered to as \b \i LaBatea) is a tool for an
automated teststing of code on the basis of laws or axioms.
-\b LaBatea has been used to validate the core library (itl)
+\b LaBatea has been used to validate the core library (icl)
for a number of laws.

</ul>

This doxygen generated documentation is provided for the
-additional library parts \b itl_xt and \b validate
+additional library parts \b icl_xt and \b validate
that are not yet covered by a proper boost book documentation.
\n \n

@@ -68,14 +71,47 @@

<ul>

+<li>Changes after the review
+
+A number of changes have been done after the review as a result of the
+reviews and the related discussion.
+
+<ul>
+
+<li>New library name
+
+The library's name has been changed form Interval Template Library
+to Interval Container Library.
+
+<li>Customizability
+
+The library is now customizable for user defined interval types. A user
+defined type can be registered and adapted by
+<a href="http://www.herold-faulhaber.de/boost_icl/doc/libs/icl/doc/html/boost_icl/examples/custom_interval.html">
+partially instantiating a small interval_traits class.</a>
+
+<li>Intervals with static bounds
+
+Intervals with static or fixed bounds can now be used with the library.
+Statically bounded intervals use less memory and perform 25% faster on average
+than dynamically bounded intervals.
+
+<li> Extraction of algorithms to concepts.
+
+Most of the class templates member functions have been extracted to sets of namespace
+global functions that build concepts. Some functions have been have been renamed to
+conform existing standards.
+
+</ul>
+
<li>Interval_bitset.

-The lastest addition to the library are interval_bitsets.
+The lastest addition of a container class template to the library is interval_bitsets.
Interval_bitsets use interval compression and bitset compression
to achieve a very efficient and compact representation of large
bitsets. The idea and implementation of interval_bitsets is
explained in the
-<a href="http://www.herold-faulhaber.de/boost_itl/doc/libs/icl/doc/html/boost_itl/projects.html#boost_itl.projects.large_bitset">
+<a href="http://www.herold-faulhaber.de/boost_icl/doc/libs/icl/doc/html/boost_icl/projects.html#boost_icl.projects.large_bitset">
project section</a>
of the boost book documentation.

@@ -84,9 +120,9 @@
To copy or tranform data from std::containers of intervals or segments into
interval containers you can use an icl::insert_iterator or an icl::add_iterator.
See examples
-<a href="http://www.herold-faulhaber.de/boost_itl/doc/libs/icl/doc/html/boost_itl/examples/std_copy.html">
+<a href="http://www.herold-faulhaber.de/boost_icl/doc/libs/icl/doc/html/boost_icl/examples/std_copy.html">
std_copy</a> and
-<a href="http://www.herold-faulhaber.de/boost_itl/doc/libs/icl/doc/html/boost_itl/examples/std_transform.html">
+<a href="http://www.herold-faulhaber.de/boost_icl/doc/libs/icl/doc/html/boost_icl/examples/std_transform.html">
std_transform.</a>

<li>Element iteration.
@@ -103,27 +139,27 @@
characteristics of the class templates offered by the library. To get an instant
impression you may browse these examples first.

-\subsection examples_itl_subsec Examples on Interval Containers (core library itl)
+\subsection examples_icl_subsec Examples on Interval Containers (core library icl)

<ul>
<li>A collection of examples on interval containers is
included in the
-<a href="http://www.herold-faulhaber.de/boost_itl/doc/libs/icl/doc/html/boost_itl/examples.html">
+<a href="http://www.herold-faulhaber.de/boost_icl/doc/libs/icl/doc/html/boost_icl/examples.html">
boost book documentation</a>.
</ul>
\n \n

-\subsection examples_itl_xt_subsec Examples for the extended library (itl_xt)
+\subsection examples_icl_xt_subsec Examples for the extended library (icl_xt)

<ul>
<li> Interval Bitset

A minimal implementation of \ref interval_bitset together with
sample applications is included in the boost book documentation in the
-<a href="http://www.herold-faulhaber.de/boost_itl/doc/libs/icl/doc/html/boost_itl/projects.html#boost_itl.projects.large_bitset">
+<a href="http://www.herold-faulhaber.de/boost_icl/doc/libs/icl/doc/html/boost_icl/projects.html#boost_icl.projects.large_bitset">
project section</a>. The full implementation of \ref interval_bitset is
-not yet part of the core library (itl). It's in the extended part (itl_xt)
+not yet part of the core library (icl). It's in the extended part (icl_xt)
but it's integration into the core is intended.

@@ -137,7 +173,7 @@
<li> Amount Cube

Cubes or tuple computers allow to perform computations on values associated
-to tuples. A ITL tuple computer works similar to pivot tables (in spreadsheet programs)
+to tuples. A ICL tuple computer works similar to pivot tables (in spreadsheet programs)
olap cubes (online analytic processing) or crosstables (in statistical programs).
Sample amount_cube.cpp presents an application where values are \e 'amounts',
which is the simplest instance.

Added: sandbox/icl/libs/icl/prj_home/index.html
==============================================================================
--- (empty file)
+++ sandbox/icl/libs/icl/prj_home/index.html 2010-11-04 06:27:04 EDT (Thu, 04 Nov 2010)
@@ -0,0 +1,378 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+<title>interval container library: The Interval Container Library</title>
+</head>
+
+<body>
+
+
+
+<table>
+ <tr>
+ <td width="34%">
+ 
+ Welcome to the homepage of 
+
+ 
+ Joachim Faulhaber 
+ 
+ and the 
+ 
+ Interval Container Library 
+ 
+ (aka. Interval Template Library)
+ 
+ </td>
+
+ <td></td>
+
+ <td align="right" aligh="top">
+ 
+ “This can be a really useful class of data structures.
+ I support continued work on getting this into Boost.” 
+ —
+ Dave Abrahams
+ 
+ 
+
+ “A brief reading of this shows the code and documentation to be in mature shape with
+ some interesting examples, that I feel sure will find application elsewhere.
+ Personally, I think this would be a useful addition to Boost.”
+ — Paul A. Bristow, coauthor of
+ <a HREF="http://www.boost.org/doc/libs/1_42_0/libs/math/doc/html/index.html">
+ Boost.Math</a>
+ 
+
+ 
+ “So I love ITL — it really solved the visualization problem I was
+ having. [...] Visualizing that amount of data, in real time, is quite a challenge. I'm
+ using ITL to track pre-rendered regions of this time series data. It
+ does exactly what I want.”
+
+ — Eric M. Jonas, coauthor of
+ The Soma Project
+ 
+ </td>
+ </tr>
+</table>
+
+
+<table cellspacing=12 cellpadding=6 width=100% >
+ 
+ <tr>
+ 
+ <td bgcolor=#CEE3F6> 
+ 
+ The
+ Interval Container Library
+ is an STL based generic c++ library for computations on intervals, interval containers, cubes and more.
+ </tr>
+</table>
+
+
+
+<table>
+ 
+ <tr>
+ <td width=50%>
+ 
+ <ul>
+ <li>The core library
+ ICL
+ provides generic intervals, interval sets and interval maps.
+ <li>The extended library
+ ICL+
+ includes the core library and implements interval bitsets, cubes, histories,
+ and law based testing in addition.
+ <ul>
+ </td>
+
+ <td>
+ 
+ <ul>
+ <li>Efficient stl compatible interval_sets and interval_maps
+ <li>Aggregation of associated values on overlap for interval_maps
+ <li>Set theoretic operations as infix and inplace operators
+ <li>Iterator support on the level of intervals and elements
+ <li>An interval_bitset for very large compressed bitsets
+ </ul>
+ </td>
+ </tr>
+</table>
+
+
+<table cellspacing=12 cellpadding=6>
+ 
+<tr>
+ <td bgcolor=#CEE3F6>News</td>
+ <td colspan=3 bgcolor=#CEE3F6>
+ 
+ The ICL library has been accepted into boost!
+ Many thanks to all the reviewers and review manager Hartmut Kaiser.
+ The library has been renamed and some changes proposed during the review
+ are now implemented.
+ The ICL is now prepared for inclusion into the boost release 1.46.0.
+ </td>
+</tr>
+
+<tr>
+ <td></td>
+ <td colspan=2 bgcolor=#E2F3FF>
+ Read the formal review results
+ by review manager Hartmut Kaiser from April 18, 2010.
+ </td>
+</tr>
+
+<tr>
+ <td></td>
+ <td colspan=2 bgcolor=#E2F3FF>
+ Read the review
+ authored by Eric M. Jonas, PhD Candidate, MIT Brain and Cognitive Sciences.
+ </td>
+</tr>
+
+<tr>
+ <td></td>
+ <td></td>
+ <td></td>
+</tr>
+
+<tr>
+ <td bgcolor=#CEE3F6>Documentation</td>
+ <td bgcolor=#CEEDFF>
+ <a HREF="boost_icl/doc/icl.html">
+ ICL</a>
+ </td>
+ <td bgcolor=#CEE3F6>A detailed boost book documentation of the core library of interval containers.
+ The core library is submitted for review at the boost library collection.</td>
+
+ <td rowspan=6 align="center">
+ 
+<table cellspacing=12 cellpadding=6>
+<tr>
+ <td bgcolor=#CEE3F6 colspan=3>Revision History</td>
+</tr>
+<tr>
+ <td>
+ 
+ 4.0.0
+ </td>
+ <td>
+ 
+ 2010-11-04
+ </td>
+ <td>
+ 
+ 
+ Redesign of all interval container class templates according to
+ boost standards. Replacing virtual functions by means of static
+ polymorphism using the CRT pattern. Adding the self minimizing
+ interval_map and the separating separate_interval_set. Separation
+ of add/subtract from insert/erase semantics. Starting to develop
+ the law based tester and performing law based tests.
+ Improvement of the doxygen generated documentation. Improved
+ and new examples that use boost code particularly boost date and
+ time classes.
+ </td>
+</tr>
+<tr>
+ <td>
+ 
+ 2.0.0
+ </td>
+ <td>
+ 
+ 2008-05-11
+ </td>
+ <td>
+ 
+ 
+ This version is refactored from the initial version for some basic
+ boost standards, like naming conventions, third library
+ dependencies and basic portability. This version has been used for
+ the first proposal on the boost developers list.
+ Improving doxygen generated documentation and examples.
+ </td>
+</tr>
+<tr>
+ <td>
+ 
+ 1.0.0
+ </td>
+ <td>
+ 
+ 2007-05-17
+ </td>
+ <td>
+ 
+ Initial version. Refactored version of the code released as open source by Cortex Software GmbH in 2006.
+ Removed some dangling dependencies. Added initial doxygen generated documentation and some examples.
+ </td>
+</tr>
+</table>
+
+
+
+</body>
+</html>

Next message: afojgo_at_[hidden]: "[Boost-commit] svn:boost r66397 - sandbox/icl/libs/icl/doxy_doc/doxygen_input/pages"
Previous message: dsaritz_at_[hidden]: "[Boost-commit] svn:boost r66395 - sandbox/function/boost/function"

Date view	Thread view	Subject view	Author view

Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk