Boost-Commit :

Date view	Thread view	Subject view	Author view

From: joel_at_[hidden]
Date: 2008-07-07 07:37:55

Next message: joel_at_[hidden]: "[Boost-commit] svn:boost r47179 - branches/release/libs/spirit/phoenix/doc/html/phoenix"
Previous message: asutton_at_[hidden]: "[Boost-commit] svn:boost r47177 - in sandbox/SOC/2008/graphs/trunk: boost boost/graphs libs/graphs"

Author: djowel
Date: 2008-07-07 07:37:54 EDT (Mon, 07 Jul 2008)
New Revision: 47178
URL: http://svn.boost.org/trac/boost/changeset/47178

Log:
merged from release branch
Added:
   trunk/libs/spirit/doc/concepts_template.qbk (contents, props changed)
   trunk/libs/spirit/doc/reference_template.qbk (contents, props changed)
   trunk/libs/spirit/example/qi/mini_xml_samples/1.toyxml
      - copied unchanged from r47127, /trunk/libs/spirit/example/qi/mini_xml_samples/1.xml
   trunk/libs/spirit/example/qi/mini_xml_samples/2.toyxml
      - copied unchanged from r47127, /trunk/libs/spirit/example/qi/mini_xml_samples/2.xml
   trunk/libs/spirit/example/qi/mini_xml_samples/3.toyxml
      - copied unchanged from r47127, /trunk/libs/spirit/example/qi/mini_xml_samples/3.xml
   trunk/libs/spirit/phoenix/doc/html/phoenix/container.html (contents, props changed)
Removed:
   trunk/libs/spirit/doc/_concepts_template_.qbk
   trunk/libs/spirit/doc/_reference_template_.qbk
   trunk/libs/spirit/example/qi/mini_xml_samples/1.xml
   trunk/libs/spirit/example/qi/mini_xml_samples/2.xml
   trunk/libs/spirit/example/qi/mini_xml_samples/3.xml

Deleted: trunk/libs/spirit/doc/_concepts_template_.qbk
==============================================================================
--- trunk/libs/spirit/doc/_concepts_template_.qbk 2008-07-07 07:37:54 EDT (Mon, 07 Jul 2008)
+++ (empty file)
@@ -1,46 +0,0 @@
-[/==============================================================================
- Copyright (C) 2001-2008 Joel de Guzman
- Copyright (C) 2001-2008 Hartmut Kaiser
-
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
-===============================================================================/]
-
-[section XXX]
-
-[heading Description]
-
-Description of XXX concept
-
-[variablelist Notation
- [[`xxx`] [An XXX]]
-]
-
-[heading Valid Expressions]
-
-(For any Forward Sequence the following expressions must be valid:)
-
-In addition to the requirements defined in _XXX-Basic_concept_, for any
-XXX the following must be met:
-
-[table
- [[Expression] [Semantics] [Return type] [Complexity]]
- [[`xxx`] [Semantics of `xxx`] [XXX] [Constant]]
-]
-
-[heading Type Requirements]
-
-[table
- [[Expression] [Requirements]]
- [[`xxx`] [Requirements for `xxx`]]
-]
-
-[heading Invariants]
-
-For any XXX xxx the following invariants always hold:
-
-[heading Models]
-
-Links to models of XXX concept
-
-[endsect]

Deleted: trunk/libs/spirit/doc/_reference_template_.qbk
==============================================================================
--- trunk/libs/spirit/doc/_reference_template_.qbk 2008-07-07 07:37:54 EDT (Mon, 07 Jul 2008)
+++ (empty file)
@@ -1,56 +0,0 @@
-[/==============================================================================
- Copyright (C) 2001-2008 Joel de Guzman
- Copyright (C) 2001-2008 Hartmut Kaiser
-
- Distributed under the Boost Software License, Version 1.0. (See accompanying
- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
-===============================================================================/]
-
-[section XXX]
-
-[heading Description]
-
-Description of XXX
-
-[heading Header]
-
- #include <boost/spirit/xxx.hpp>
-
-[heading Synopsis]
-
- template <typename T>
- struct XXX;
-
-[heading Template parameters]
-
-[table
- [[Parameter] [Description] [Default]]
- [[`T`] [What is T] []]
-]
-
-[heading Model of]
-
-Link to concept
-
-[heading Objects]
-
-Objects provided by the library
-
-[variablelist Notation
- [[`xxx`] [An XXX]]
-]
-
-Semantics of an expression is defined only where it differs from, or is not
-defined in _concept-of_XXX_.
-
-[table
- [[Expression] [Semantics] [Return type] [Complexity]]
- [[`xxx`] [Semantics of `xxx`] [XXX] [Constant]]
-]
-
-[heading Example]
-
-Real example code. Use Quickbook import mechanism to link to actual
-working code snippets here.
-
-[endsect]

Added: trunk/libs/spirit/doc/concepts_template.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/spirit/doc/concepts_template.qbk 2008-07-07 07:37:54 EDT (Mon, 07 Jul 2008)
@@ -0,0 +1,46 @@
+[/==============================================================================
+ Copyright (C) 2001-2008 Joel de Guzman
+ Copyright (C) 2001-2008 Hartmut Kaiser
+
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+===============================================================================/]
+
+[section XXX]
+
+[heading Description]
+
+Description of XXX concept
+
+[variablelist Notation
+ [[`xxx`] [An XXX]]
+]
+
+[heading Valid Expressions]
+
+(For any Forward Sequence the following expressions must be valid:)
+
+In addition to the requirements defined in _XXX-Basic_concept_, for any
+XXX the following must be met:
+
+[table
+ [[Expression] [Semantics] [Return type] [Complexity]]
+ [[`xxx`] [Semantics of `xxx`] [XXX] [Constant]]
+]
+
+[heading Type Requirements]
+
+[table
+ [[Expression] [Requirements]]
+ [[`xxx`] [Requirements for `xxx`]]
+]
+
+[heading Invariants]
+
+For any XXX xxx the following invariants always hold:
+
+[heading Models]
+
+Links to models of XXX concept
+
+[endsect]

Added: trunk/libs/spirit/doc/reference_template.qbk
==============================================================================
--- (empty file)
+++ trunk/libs/spirit/doc/reference_template.qbk 2008-07-07 07:37:54 EDT (Mon, 07 Jul 2008)
@@ -0,0 +1,56 @@
+[/==============================================================================
+ Copyright (C) 2001-2008 Joel de Guzman
+ Copyright (C) 2001-2008 Hartmut Kaiser
+
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+===============================================================================/]
+
+[section XXX]
+
+[heading Description]
+
+Description of XXX
+
+[heading Header]
+
+ #include <boost/spirit/xxx.hpp>
+
+[heading Synopsis]
+
+ template <typename T>
+ struct XXX;
+
+[heading Template parameters]
+
+[table
+ [[Parameter] [Description] [Default]]
+ [[`T`] [What is T] []]
+]
+
+[heading Model of]
+
+Link to concept
+
+[heading Objects]
+
+Objects provided by the library
+
+[variablelist Notation
+ [[`xxx`] [An XXX]]
+]
+
+Semantics of an expression is defined only where it differs from, or is not
+defined in _concept-of_XXX_.
+
+[table
+ [[Expression] [Semantics] [Return type] [Complexity]]
+ [[`xxx`] [Semantics of `xxx`] [XXX] [Constant]]
+]
+
+[heading Example]
+
+Real example code. Use Quickbook import mechanism to link to actual
+working code snippets here.
+
+[endsect]

Deleted: trunk/libs/spirit/example/qi/mini_xml_samples/1.xml
==============================================================================
--- trunk/libs/spirit/example/qi/mini_xml_samples/1.xml 2008-07-07 07:37:54 EDT (Mon, 07 Jul 2008)
+++ (empty file)
@@ -1 +0,0 @@
-<foo></foo>
\ No newline at end of file

Deleted: trunk/libs/spirit/example/qi/mini_xml_samples/2.xml
==============================================================================
--- trunk/libs/spirit/example/qi/mini_xml_samples/2.xml 2008-07-07 07:37:54 EDT (Mon, 07 Jul 2008)
+++ (empty file)
@@ -1 +0,0 @@
-<foo><bar></bar></foo>
\ No newline at end of file

Deleted: trunk/libs/spirit/example/qi/mini_xml_samples/3.xml
==============================================================================
--- trunk/libs/spirit/example/qi/mini_xml_samples/3.xml 2008-07-07 07:37:54 EDT (Mon, 07 Jul 2008)
+++ (empty file)
@@ -1,5 +0,0 @@
-<foo>
- <bar>bar 1</bar>
- <bar>bar 2</bar>
- <bar>bar 3</bar>
-</foo>
\ No newline at end of file

Added: trunk/libs/spirit/phoenix/doc/html/phoenix/container.html
==============================================================================
--- (empty file)
+++ trunk/libs/spirit/phoenix/doc/html/phoenix/container.html 2008-07-07 07:37:54 EDT (Mon, 07 Jul 2008)
@@ -0,0 +1,568 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Container</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.66.1">
+<link rel="start" href="../index.html" title="Chapter 1. Phoenix 2.0">
+<link rel="up" href="../index.html" title="Chapter 1. Phoenix 2.0">
+<link rel="prev" href="composite.html" title="Composite">
+<link rel="next" href="algorithm.html" title="Algorithm">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="composite.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="algorithm.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="phoenix.container"></a>Container</h2></div></div></div>
+<pre class="programlisting">
+#include <boost/spirit/phoenix/container.hpp>
+</pre>
+
+ The container module predefines a set of lazy functions that work on STL containers.
+ These functions provide a mechanism for the lazy evaluation of the public member
+ functions of the STL containers. The lazy functions are thin wrappers that
+ simply forward to their respective counterparts in the STL library.
+ 
+
+ Lazy functions are provided for all of the member functions of the following
+ containers:
+ 
+<div class="itemizedlist"><ul type="disc">
+<li>
+ deque
+ </li>
+<li>
+ list
+ </li>
+<li>
+ map
+ </li>
+<li>
+ multimap
+ </li>
+<li>
+ vector
+ </li>
+</ul></div>
+
+ Indeed, should your class have member functions with the same names and signatures
+ as those listed below, then it will automatically be supported. To summarize,
+ lazy functions are provided for member functions:
+ 
+<div class="itemizedlist"><ul type="disc">
+<li>
+ assign
+ </li>
+<li>
+ at
+ </li>
+<li>
+ back
+ </li>
+<li>
+ begin
+ </li>
+<li>
+ capacity
+ </li>
+<li>
+ clear
+ </li>
+<li>
+ empty
+ </li>
+<li>
+ end
+ </li>
+<li>
+ erase
+ </li>
+<li>
+ front
+ </li>
+<li>
+ get_allocator
+ </li>
+<li>
+ insert
+ </li>
+<li>
+ key_comp
+ </li>
+<li>
+ max_size
+ </li>
+<li>
+ pop_back
+ </li>
+<li>
+ pop_front
+ </li>
+<li>
+ push_back
+ </li>
+<li>
+ push_front
+ </li>
+<li>
+ rbegin
+ </li>
+<li>
+ rend
+ </li>
+<li>
+ reserve
+ </li>
+<li>
+ resize
+ </li>
+<li>
+ size
+ </li>
+<li>
+ splice
+ </li>
+<li>
+ value_comp
+ </li>
+</ul></div>
+
+ The lazy functions' names are the same as the corresponding member function.
+ The difference is that the lazy functions are free functions and therefore
+ does not use the member "dot" syntax.
+ 
+<div class="table">
+<a name="id482406"></a>Table 1.5. Sample usage
+<table class="table" summary="Sample usage">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ "Normal" version
+ 
+ </th>
+<th>
+ 
+ "Lazy" version
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">my_vector.at(5)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">at(arg1, 5)</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">my_list.size()</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">size(arg1)</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">my_vector1.swap(my_vector2)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">swap(arg1, arg2)</tt>
+ 
+ </td>
+</tr>
+</tbody>
+</table>
+</div>
+
+ Notice that member functions with names that clash with stl algorithms are
+ absent. This will be provided in Phoenix's algorithm module.
+ 
+
+ No support is provided here for lazy versions of <tt class="computeroutput">operator+=</tt>, <tt class="computeroutput">operator[]</tt> etc. Such operators are not specific to STL
+ containers and lazy versions can therefore be found in operators.
+ 
+
+ The following table describes the container functions and their semantics.
+ 
+<div class="sidebar">
+ <img src="../images/tip.png" alt="tip"> Arguments in brackets denote optional parameters.
+ </div>
+<div class="table">
+<a name="id482784"></a>Table 1.6. Lazy STL Container Functions
+<table class="table" summary="Lazy STL Container Functions">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Function
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">assign(c, a[, b, c])</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.assign(a[, b, c])</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">at(c, i)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.at(i)</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">back(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.back()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">begin(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.begin()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">capacity(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.capacity()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">clear(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.clear()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">empty(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.empty()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">end(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.end()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">erase(c, a[, b])</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.erase(a[, b])</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">front(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.front()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">get_allocator(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.get_allocator()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">insert(c, a[, b, c])</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.insert(a[, b, c])</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">key_comp(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.key_comp()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">max_size(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.max_size()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">pop_back(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.pop_back()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">pop_front(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.pop_front()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">push_back(c, d)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.push_back(d)</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">push_front(c, d)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.push_front(d)</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">pop_front(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.pop_front()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">rbegin(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.rbegin()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">rend(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.rend()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">reserve(c, n)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.reserve(n)</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">resize(c, a[, b])</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.resize(a[, b])</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">size(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.size()</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">splice(c, a[, b, c, d])</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.splice(a[, b, c, d])</tt>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <tt class="computeroutput">value_comp(c)</tt>
+ 
+ </td>
+<td>
+ 
+ <tt class="computeroutput">c.value_comp()</tt>
+ 
+ </td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2002-2005 Joel
+ de Guzman, Dan Marsden
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="composite.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="algorithm.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Next message: joel_at_[hidden]: "[Boost-commit] svn:boost r47179 - branches/release/libs/spirit/phoenix/doc/html/phoenix"
Previous message: asutton_at_[hidden]: "[Boost-commit] svn:boost r47177 - in sandbox/SOC/2008/graphs/trunk: boost boost/graphs libs/graphs"

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