|
|
Boost-Commit : |
Subject: [Boost-commit] svn:boost r68273 - in sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html: . phoenix/reference phoenix/reference/core_mechanisms phoenix/reference/core_mechanisms/evaluator phoenix/reference/core_mechanisms/terminals phoenix/reference/the_language phoenix/reference/the_language/core phoenix/starter_kit phoenix/starter_kit/composites phoenix/starter_kit/primitives
From: thom.heller_at_[hidden]
Date: 2011-01-19 06:08:23
Author: theller
Date: 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
New Revision: 68273
URL: http://svn.boost.org/trac/boost/changeset/68273
Log:
more doc work
Added:
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/_actor_.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/_meta_grammar_.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/arity.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/default_actions.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/is_nullary.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/expression.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression_ext.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression_vararg.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression_vararg_ext.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/_custom_terminal_.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/_is_custom_terminal_.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/placeholders.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/arguments.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/reference.html (contents, props changed)
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/value.html (contents, props changed)
Text files modified:
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/index.html | 2
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language.html | 404 +--------------------------------------
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core.html | 39 +++
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites.html | 291 +---------------------------
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/construct__new__delete__casts.html | 10
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_functions.html | 20
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_operators.html | 20
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_statements.html | 10
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/more.html | 10
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives.html | 171 ---------------
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/arguments.html | 10
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/references.html | 10
sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/values.html | 14
13 files changed, 127 insertions(+), 884 deletions(-)
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/index.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/index.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/index.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -249,7 +249,7 @@
</h3>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"><p><small>Last revised: January 19, 2011 at 10:54:16 GMT</small></p></td>
+<td align="left"><p><small>Last revised: January 19, 2011 at 11:04:53 GMT</small></p></td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,58 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Core Mechanisms</title>
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="../reference.html" title="Reference">
+<link rel="next" href="core_mechanisms/_actor_.html" title="actor">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../reference.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="core_mechanisms/_actor_.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="phoenix.reference.core_mechanisms"></a><a class="link" href="core_mechanisms.html" title="Core Mechanisms">Core Mechanisms</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><span class="section">actor</span></dt>
+<dt><span class="section">meta_grammar</span></dt>
+<dt><span class="section">evaluator</span></dt>
+<dd><dl>
+<dt><span class="section">default_actions</span></dt>
+<dt><span class="section">is_nullary</span></dt>
+<dt><span class="section">arity</span></dt>
+</dl></dd>
+<dt><span class="section">expression</span></dt>
+<dt><span class="section">PHOENIX_DEFINE_EXPRESSION</span></dt>
+<dt><span class="section">PHOENIX_DEFINE_EXPRESSION_VARARG</span></dt>
+<dt><span class="section">PHOENIX_DEFINE_EXPRESSION_EXT</span></dt>
+<dt><span class="section">PHOENIX_DEFINE_EXPRESSION_VARARG_EXT</span></dt>
+<dt><span class="section">Terminals</span></dt>
+<dd><dl>
+<dt><span class="section">Placeholders</span></dt>
+<dt><span class="section">is_custom_terminal</span></dt>
+<dt><span class="section">custom_terminal</span></dt>
+</dl></dd>
+</dl></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../reference.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="core_mechanisms/_actor_.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/_actor_.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/_actor_.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,206 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>actor</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="prev" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="next" href="_meta_grammar_.html" title="meta_grammar">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../core_mechanisms.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="_meta_grammar_.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="phoenix.reference.core_mechanisms._actor_"></a><a class="link" href="_actor_.html" title="actor"><code class="computeroutput"><span class="identifier">actor</span></code></a>
+</h4></div></div></div>
+<a name="phoenix.reference.core_mechanisms._actor_.description"></a><h6>
+<a name="id2826699"></a>
+ <a class="link" href="_actor_.html#phoenix.reference.core_mechanisms._actor_.description">Description</a>
+ </h6>
+<p>
+ <code class="computeroutput"><span class="identifier">actor</span></code> is main interface
+ to evaluate any Phoenix expression. It is used to wrap the Phoenix Expression
+ Templates and provides various operator() overloads.
+ </p>
+<a name="phoenix.reference.core_mechanisms._actor_.synopsis"></a><h6>
+<a name="id2826733"></a>
+ <a class="link" href="_actor_.html#phoenix.reference.core_mechanisms._actor_.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting"><span class="keyword">namespace</span> <span class="identifier">result_of</span>
+<span class="special">{</span>
+ <span class="keyword">template</span> <span class="special"><</span>
+ <span class="keyword">typename</span> <span class="identifier">Expr</span>
+ <span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">A0</span> <span class="special">=</span> <span class="keyword">void</span>
+ <span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">A1</span> <span class="special">=</span> <span class="keyword">void</span>
+ <span class="special">...</span>
+ <span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">AN</span> <span class="special">=</span> <span class="keyword">void</span>
+ <span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">Dummy</span> <span class="special">=</span> <span class="keyword">void</span>
+ <span class="special">></span>
+ <span class="keyword">struct</span> <span class="identifier">actor</span>
+ <span class="special">{</span>
+ <span class="keyword">typedef</span> <span class="emphasis"><em>unspecified</em></span> <span class="identifier">type</span><span class="special">;</span>
+ <span class="special">};</span>
+<span class="special">}</span>
+
+<span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">Expr</span><span class="special">></span>
+<span class="keyword">struct</span> <span class="identifier">actor</span><span class="special">;</span>
+</pre>
+<a name="phoenix.reference.core_mechanisms._actor_.template_parameters"></a><h6>
+<a name="id2826990"></a>
+ <a class="link" href="_actor_.html#phoenix.reference.core_mechanisms._actor_.template_parameters">Template
+ Parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ <p>
+ Parameter
+ </p>
+ </th>
+<th>
+ <p>
+ Description
+ </p>
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">Expr</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ The type of the expression
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">A0</span></code>...<code class="computeroutput"><span class="identifier">AN</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ The type of the supplied arguments
+ </p>
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="variablelist">
+<p class="title"><b>Notation</b></p>
+<dl>
+<dt><span class="term"><code class="computeroutput"><span class="identifier">expr</span></code></span></dt>
+<dd><p>
+ An instance of a Phoenix actor
+ </p></dd>
+<dt><span class="term"><code class="computeroutput"><span class="identifier">a0</span></code>...<code class="computeroutput"><span class="identifier">a1</span></code></span></dt>
+<dd><p>
+ Heterogenous values
+ </p></dd>
+</dl>
+</div>
+<a name="phoenix.reference.core_mechanisms._actor_.expression_semantics"></a><h6>
+<a name="id2827166"></a>
+ <a class="link" href="_actor_.html#phoenix.reference.core_mechanisms._actor_.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ <p>
+ Expression
+ </p>
+ </th>
+<th>
+ <p>
+ Semantic
+ </p>
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">actor</span><span class="special"><</span><span class="identifier">Expr</span><span class="special">,</span>
+ <span class="identifier">A0</span><span class="special">...</span><span class="identifier">AN</span><span class="special">>::</span><span class="identifier">type</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ The result type of the evaluated expression
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">result_of</span><span class="special"><</span><span class="identifier">actor</span><span class="special"><</span><span class="identifier">Expr</span><span class="special">>(</span><span class="identifier">A0</span><span class="special">...</span><span class="identifier">AN</span><span class="special">)>::</span><span class="identifier">type</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Same as <code class="computeroutput"><span class="identifier">result_of</span><span class="special">::</span><span class="identifier">actor</span><span class="special"><</span><span class="identifier">Expr</span><span class="special">,</span> <span class="identifier">A0</span><span class="special">...</span><span class="identifier">AN</span><span class="special">>::</span><span class="identifier">type</span></code>
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">expr</span><span class="special">(</span><span class="identifier">a0</span><span class="special">...</span><span class="identifier">aN</span><span class="special">)</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Evaluates the expression
+ </p>
+ </td>
+</tr>
+</tbody>
+</table></div>
+<p>
+ The expression is evaluated using the defined <a class="link" href="evaluator/default_actions.html" title="default_actions">Default
+ Actions</a>.
+ </p>
+<a name="phoenix.reference.core_mechanisms._actor_.example"></a><h6>
+<a name="id2827473"></a>
+ <a class="link" href="_actor_.html#phoenix.reference.core_mechanisms._actor_.example">Example</a>
+ </h6>
+<p>
+ See the <a class="link" href="../../starter_kit.html" title="Starter Kit">Starter Kit</a> and the
+ <a class="link" href="../the_language.html" title="The Language">Phoenix Language Reference</a>
+ for examples
+ </p>
+</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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../core_mechanisms.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="_meta_grammar_.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/_meta_grammar_.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/_meta_grammar_.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,187 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>meta_grammar</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="prev" href="_actor_.html" title="actor">
+<link rel="next" href="evaluator.html" title="evaluator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="_actor_.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="evaluator.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="phoenix.reference.core_mechanisms._meta_grammar_"></a><a class="link" href="_meta_grammar_.html" title="meta_grammar"><code class="computeroutput"><span class="identifier">meta_grammar</span></code></a>
+</h4></div></div></div>
+<a name="phoenix.reference.core_mechanisms._meta_grammar_.description"></a><h6>
+<a name="id2827530"></a>
+ <a class="link" href="_meta_grammar_.html#phoenix.reference.core_mechanisms._meta_grammar_.description">Description</a>
+ </h6>
+<p>
+ <code class="computeroutput"><span class="identifier">meta_grammar</span></code> is an open
+ extensible set of Boost.Proto
+ grammar rules. It is used to define what valid Phoenix Expressions are.
+ </p>
+<a name="phoenix.reference.core_mechanisms._meta_grammar_.synopsis"></a><h6>
+<a name="id2827569"></a>
+ <a class="link" href="_meta_grammar_.html#phoenix.reference.core_mechanisms._meta_grammar_.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting"><span class="keyword">struct</span> <span class="identifier">meta_grammar</span>
+ <span class="special">:</span> <span class="identifier">proto</span><span class="special">::</span><span class="keyword">switch</span><span class="special"><</span><span class="identifier">meta_grammar</span><span class="special">></span>
+<span class="special">{</span>
+ <span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">Tag</span><span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">Dummy</span> <span class="special">=</span> <span class="keyword">void</span><span class="special">></span>
+ <span class="keyword">struct</span> <span class="identifier">case_</span>
+ <span class="special">:</span> <span class="identifier">proto</span><span class="special">::</span><span class="keyword">not</span><span class="special"><</span><span class="identifier">proto</span><span class="special">::</span><span class="identifier">_</span><span class="special">></span>
+ <span class="special">{};</span>
+<span class="special">};</span>
+</pre>
+<a name="phoenix.reference.core_mechanisms._meta_grammar_.template_parameters"></a><h6>
+<a name="id2827749"></a>
+ <a class="link" href="_meta_grammar_.html#phoenix.reference.core_mechanisms._meta_grammar_.template_parameters">Template
+ Parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ <p>
+ Parameter
+ </p>
+ </th>
+<th>
+ <p>
+ Description
+ </p>
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">Tag</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ The tag of the phoenix expression
+ </p>
+ </td>
+</tr></tbody>
+</table></div>
+<a name="phoenix.reference.core_mechanisms._meta_grammar_.expression_semantics"></a><h6>
+<a name="id2827831"></a>
+ <a class="link" href="_meta_grammar_.html#phoenix.reference.core_mechanisms._meta_grammar_.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+<div class="variablelist">
+<p class="title"><b>Notation</b></p>
+<dl>
+<dt><span class="term"><code class="computeroutput"><span class="identifier">Expr</span></code></span></dt>
+<dd><p>
+ Any type
+ </p></dd>
+</dl>
+</div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ <p>
+ Expression
+ </p>
+ </th>
+<th>
+ <p>
+ Semantic
+ </p>
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">proto</span><span class="special">::</span><span class="identifier">matches</span><span class="special"><</span><span class="identifier">Expr</span><span class="special">,</span>
+ <span class="identifier">meta_grammar</span><span class="special">>::</span><span class="identifier">type</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Calculates wether <code class="computeroutput"><span class="identifier">Expr</span></code>
+ matches meta_grammar
+ </p>
+ </td>
+</tr></tbody>
+</table></div>
+<p>
+ By default, <code class="computeroutput"><span class="identifier">meta_grammar</span></code>
+ matches nothing. By including the headers described in the <a class="link" href="../the_language.html" title="The Language">Phoenix
+ Language Reference</a> section, the appropriate rules are added to the
+ grammar.
+ </p>
+<a name="phoenix.reference.core_mechanisms._meta_grammar_.example"></a><h6>
+<a name="id2828003"></a>
+ <a class="link" href="_meta_grammar_.html#phoenix.reference.core_mechanisms._meta_grammar_.example">Example</a>
+ </h6>
+<pre class="programlisting"><span class="comment">// Adding terminals to the set of valid Phoenix expressions
+</span><span class="keyword">template</span> <span class="special"><></span>
+<span class="keyword">struct</span> <span class="identifier">meta_grammar</span><span class="special">::</span><span class="identifier">case_</span><span class="special"><</span><span class="identifier">proto</span><span class="special">::</span><span class="identifier">tag</span><span class="special">::</span><span class="identifier">terminal</span><span class="special">></span>
+ <span class="special">:</span> <span class="identifier">proto</span><span class="special">::</span><span class="identifier">terminal</span><span class="special"><</span><span class="identifier">proto</span><span class="special">::</span><span class="identifier">_</span><span class="special">></span>
+<span class="special">{};</span>
+
+<span class="comment">// Adding terminals to the set of valid Phoenix expressions and supply a
+</span><span class="comment">// transform that is called whenever a terminal is found
+</span><span class="keyword">template</span> <span class="special"><></span>
+<span class="keyword">struct</span> <span class="identifier">meta_grammar</span><span class="special">::</span><span class="identifier">case_</span><span class="special"><</span><span class="identifier">proto</span><span class="special">::</span><span class="identifier">tag</span><span class="special">::</span><span class="identifier">terminal</span><span class="special">></span>
+ <span class="special">:</span> <span class="identifier">proto</span><span class="special">::</span><span class="identifier">when</span><span class="special"><</span>
+ <span class="identifier">proto</span><span class="special">::</span><span class="identifier">terminal</span><span class="special"><</span><span class="identifier">proto</span><span class="special">::</span><span class="identifier">_</span><span class="special">></span>
+ <span class="special">,</span> <span class="identifier">proto</span><span class="special">::</span><span class="identifier">_value</span> <span class="comment">// return the value of the terminal
+</span> <span class="special">></span>
+<span class="special">{};</span>
+
+<span class="comment">// Adding terminals to the set of valid Phoenix expressions and supply a
+</span><span class="comment">// transform that is supplied by an external transform.
+</span><span class="keyword">template</span> <span class="special"><></span>
+<span class="keyword">struct</span> <span class="identifier">meta_grammar</span><span class="special">::</span><span class="identifier">case_</span><span class="special"><</span><span class="identifier">proto</span><span class="special">::</span><span class="identifier">tag</span><span class="special">::</span><span class="identifier">terminal</span><span class="special">></span>
+ <span class="special">:</span> <span class="identifier">proto</span><span class="special">::</span><span class="identifier">when</span><span class="special"><</span>
+ <span class="identifier">proto</span><span class="special">::</span><span class="identifier">terminal</span><span class="special"><</span><span class="identifier">proto</span><span class="special">::</span><span class="identifier">_</span><span class="special">></span>
+ <span class="special">,</span> <span class="identifier">proto</span><span class="special">::</span><span class="identifier">external_transform</span>
+ <span class="special">></span>
+<span class="special">{};</span>
+</pre>
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ The last form is how phoenix grammar rules are defined in the library.
+ See <a class="link" href="evaluator.html" title="evaluator">Evaluator</a>
+ for more details
+ </p></td></tr>
+</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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="_actor_.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="evaluator.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,42 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>evaluator</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="prev" href="_meta_grammar_.html" title="meta_grammar">
+<link rel="next" href="evaluator/default_actions.html" title="default_actions">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="_meta_grammar_.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="evaluator/default_actions.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="phoenix.reference.core_mechanisms.evaluator"></a><a class="link" href="evaluator.html" title="evaluator"><code class="computeroutput"><span class="identifier">evaluator</span></code></a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><span class="section">default_actions</span></dt>
+<dt><span class="section">is_nullary</span></dt>
+<dt><span class="section">arity</span></dt>
+</dl></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="_meta_grammar_.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="evaluator/default_actions.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/arity.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/arity.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>arity</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../evaluator.html" title="evaluator">
+<link rel="prev" href="is_nullary.html" title="is_nullary">
+<link rel="next" href="../expression.html" title="expression">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="is_nullary.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../evaluator.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="../expression.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title">
+<a name="phoenix.reference.core_mechanisms.evaluator.arity"></a><a class="link" href="arity.html" title="arity"><code class="computeroutput"><span class="identifier">arity</span></code></a>
+</h5></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="is_nullary.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../evaluator.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="../expression.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/default_actions.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/default_actions.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>default_actions</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../evaluator.html" title="evaluator">
+<link rel="prev" href="../evaluator.html" title="evaluator">
+<link rel="next" href="is_nullary.html" title="is_nullary">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../evaluator.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../evaluator.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="is_nullary.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title">
+<a name="phoenix.reference.core_mechanisms.evaluator.default_actions"></a><a class="link" href="default_actions.html" title="default_actions"><code class="computeroutput"><span class="identifier">default_actions</span></code></a>
+</h5></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../evaluator.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../evaluator.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="is_nullary.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/is_nullary.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/evaluator/is_nullary.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>is_nullary</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../evaluator.html" title="evaluator">
+<link rel="prev" href="default_actions.html" title="default_actions">
+<link rel="next" href="arity.html" title="arity">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="default_actions.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../evaluator.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="arity.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title">
+<a name="phoenix.reference.core_mechanisms.evaluator.is_nullary"></a><a class="link" href="is_nullary.html" title="is_nullary"><code class="computeroutput"><span class="identifier">is_nullary</span></code></a>
+</h5></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="default_actions.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../evaluator.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="arity.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/expression.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/expression.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>expression</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="prev" href="evaluator/arity.html" title="arity">
+<link rel="next" href="phoenix_define_expression.html" title="PHOENIX_DEFINE_EXPRESSION">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="evaluator/arity.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="phoenix_define_expression.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<a name="phoenix.reference.core_mechanisms.expression"></a><a class="link" href="expression.html" title="expression"><code class="computeroutput"><span class="identifier">expression</span></code></a>
+</h4></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="evaluator/arity.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="phoenix_define_expression.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>PHOENIX_DEFINE_EXPRESSION</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="prev" href="expression.html" title="expression">
+<link rel="next" href="phoenix_define_expression_vararg.html" title="PHOENIX_DEFINE_EXPRESSION_VARARG">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="expression.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="phoenix_define_expression_vararg.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<a name="phoenix.reference.core_mechanisms.phoenix_define_expression"></a><a class="link" href="phoenix_define_expression.html" title="PHOENIX_DEFINE_EXPRESSION"><code class="computeroutput"><span class="identifier">PHOENIX_DEFINE_EXPRESSION</span></code></a>
+</h4></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="expression.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="phoenix_define_expression_vararg.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression_ext.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression_ext.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>PHOENIX_DEFINE_EXPRESSION_EXT</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="prev" href="phoenix_define_expression_vararg.html" title="PHOENIX_DEFINE_EXPRESSION_VARARG">
+<link rel="next" href="phoenix_define_expression_vararg_ext.html" title="PHOENIX_DEFINE_EXPRESSION_VARARG_EXT">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="phoenix_define_expression_vararg.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="phoenix_define_expression_vararg_ext.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<a name="phoenix.reference.core_mechanisms.phoenix_define_expression_ext"></a><a class="link" href="phoenix_define_expression_ext.html" title="PHOENIX_DEFINE_EXPRESSION_EXT"><code class="computeroutput"><span class="identifier">PHOENIX_DEFINE_EXPRESSION_EXT</span></code></a>
+</h4></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="phoenix_define_expression_vararg.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="phoenix_define_expression_vararg_ext.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression_vararg.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression_vararg.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>PHOENIX_DEFINE_EXPRESSION_VARARG</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="prev" href="phoenix_define_expression.html" title="PHOENIX_DEFINE_EXPRESSION">
+<link rel="next" href="phoenix_define_expression_ext.html" title="PHOENIX_DEFINE_EXPRESSION_EXT">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="phoenix_define_expression.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="phoenix_define_expression_ext.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<a name="phoenix.reference.core_mechanisms.phoenix_define_expression_vararg"></a><a class="link" href="phoenix_define_expression_vararg.html" title="PHOENIX_DEFINE_EXPRESSION_VARARG"><code class="computeroutput"><span class="identifier">PHOENIX_DEFINE_EXPRESSION_VARARG</span></code></a>
+</h4></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="phoenix_define_expression.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="phoenix_define_expression_ext.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression_vararg_ext.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/phoenix_define_expression_vararg_ext.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>PHOENIX_DEFINE_EXPRESSION_VARARG_EXT</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="prev" href="phoenix_define_expression_ext.html" title="PHOENIX_DEFINE_EXPRESSION_EXT">
+<link rel="next" href="terminals.html" title="Terminals">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="phoenix_define_expression_ext.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="terminals.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<a name="phoenix.reference.core_mechanisms.phoenix_define_expression_vararg_ext"></a><a class="link" href="phoenix_define_expression_vararg_ext.html" title="PHOENIX_DEFINE_EXPRESSION_VARARG_EXT"><code class="computeroutput"><span class="identifier">PHOENIX_DEFINE_EXPRESSION_VARARG_EXT</span></code></a>
+</h4></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="phoenix_define_expression_ext.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="terminals.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,42 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Terminals</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core_mechanisms.html" title="Core Mechanisms">
+<link rel="prev" href="phoenix_define_expression_vararg_ext.html" title="PHOENIX_DEFINE_EXPRESSION_VARARG_EXT">
+<link rel="next" href="terminals/placeholders.html" title="Placeholders">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="phoenix_define_expression_vararg_ext.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="terminals/placeholders.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="phoenix.reference.core_mechanisms.terminals"></a><a class="link" href="terminals.html" title="Terminals">Terminals</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><span class="section">Placeholders</span></dt>
+<dt><span class="section">is_custom_terminal</span></dt>
+<dt><span class="section">custom_terminal</span></dt>
+</dl></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="phoenix_define_expression_vararg_ext.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core_mechanisms.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="terminals/placeholders.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/_custom_terminal_.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/_custom_terminal_.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>custom_terminal</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../terminals.html" title="Terminals">
+<link rel="prev" href="_is_custom_terminal_.html" title="is_custom_terminal">
+<link rel="next" href="../../the_language.html" title="The Language">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="_is_custom_terminal_.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../terminals.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="../../the_language.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title">
+<a name="phoenix.reference.core_mechanisms.terminals._custom_terminal_"></a><a class="link" href="_custom_terminal_.html" title="custom_terminal"><code class="computeroutput"><span class="identifier">custom_terminal</span></code></a>
+</h5></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="_is_custom_terminal_.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../terminals.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="../../the_language.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/_is_custom_terminal_.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/_is_custom_terminal_.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>is_custom_terminal</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../terminals.html" title="Terminals">
+<link rel="prev" href="placeholders.html" title="Placeholders">
+<link rel="next" href="_custom_terminal_.html" title="custom_terminal">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="placeholders.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../terminals.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="_custom_terminal_.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title">
+<a name="phoenix.reference.core_mechanisms.terminals._is_custom_terminal_"></a><a class="link" href="_is_custom_terminal_.html" title="is_custom_terminal"><code class="computeroutput"><span class="identifier">is_custom_terminal</span></code></a>
+</h5></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="placeholders.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../terminals.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="_custom_terminal_.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/placeholders.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/core_mechanisms/terminals/placeholders.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Placeholders</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../terminals.html" title="Terminals">
+<link rel="prev" href="../terminals.html" title="Terminals">
+<link rel="next" href="_is_custom_terminal_.html" title="is_custom_terminal">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../terminals.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../terminals.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="_is_custom_terminal_.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title">
+<a name="phoenix.reference.core_mechanisms.terminals.placeholders"></a><a class="link" href="placeholders.html" title="Placeholders">Placeholders</a>
+</h5></div></div></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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../terminals.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../terminals.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="_is_custom_terminal_.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,412 +3,42 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>The Language</title>
-<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="../reference.html" title="Reference">
-<link rel="next" href="../ebnf.html" title="EBNF">
+<link rel="prev" href="core_mechanisms/terminals/_custom_terminal_.html" title="custom_terminal">
+<link rel="next" href="the_language/core.html" title="Core">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../reference.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="../ebnf.html"><img src="../../images/next.png" alt="Next"></a>
+<a accesskey="p" href="core_mechanisms/terminals/_custom_terminal_.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="the_language/core.html"><img src="../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="phoenix.reference.the_language"></a><a class="link" href="the_language.html" title="The Language">The Language</a>
</h3></div></div></div>
<div class="toc"><dl>
-<dt><span class="section">Terminal</span></dt>
-<dt><span class="section">Actor</span></dt>
+<dt><span class="section">Core</span></dt>
+<dd><dl>
+<dt><span class="section">Value</span></dt>
+<dt><span class="section">Reference</span></dt>
+<dt><span class="section">Arguments</span></dt>
+</dl></dd>
</dl></div>
<p>
The definition of the language is split into the following parts:
</p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem">
+<div class="itemizedlist"><ul type="disc">
+<li>
formal language definition of the Phoenix Generators in EBNF notation
</li>
-<li class="listitem">
+<li>
Synopsis of the C++ expressions
</li>
</ul></div>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.reference.the_language.terminal"></a><a class="link" href="the_language.html#phoenix.reference.the_language.terminal" title="Terminal">Terminal</a>
-</h4></div></div></div>
-<pre class="programlisting"><span class="identifier">terminal</span> <span class="special">:=</span> <span class="identifier">value</span> <span class="special">|</span> <span class="identifier">reference</span> <span class="special">|</span> <span class="identifier">placeholder</span>
-
-<span class="identifier">value</span> <span class="special">:=</span> <span class="string">"val"</span> <span class="string">"("</span> <span class="identifier">expression</span> <span class="string">")"</span>
-
-<span class="identifier">reference</span> <span class="special">:=</span> <span class="string">"ref"</span> <span class="string">"("</span> <span class="identifier">C</span><span class="special">++</span> <span class="identifier">expression</span> <span class="string">")"</span>
- <span class="special">|</span> <span class="string">"cref"</span> <span class="string">"("</span> <span class="identifier">C</span><span class="special">++</span> <span class="identifier">expression</span> <span class="string">")"</span>
-
-<span class="identifier">placeholder</span> <span class="special">:=</span> <span class="identifier">_1</span> <span class="special">|</span> <span class="identifier">_2</span> <span class="special">|</span> <span class="identifier">_3</span> <span class="special">|</span> <span class="special">...</span> <span class="special">|</span> <span class="identifier">_PHOENIX_ARG_LIMIT</span>
-</pre>
-<p>
- Terminals are the core building blocks. Phoenix, by default distinguishes
- between 3 types of terminals:
- </p>
-<div class="orderedlist"><ol class="orderedlist" type="1">
-<li class="listitem">
- Value Terminals
- </li>
-<li class="listitem">
- Reference Terminals
- </li>
-<li class="listitem">
- Placeholders
- </li>
-</ol></div>
-<p>
- The last two terminal types are handled by the terminal customization points.
- </p>
-<div class="section">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="phoenix.reference.the_language.terminal.value"></a><a class="link" href="the_language.html#phoenix.reference.the_language.terminal.value" title="Value">Value</a>
-</h5></div></div></div>
-<p>
- Whenever we see a constant in a partially applied function, an
- </p>
-<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
-</pre>
-<p>
- (where T is the type of the constant) is automatically created for us.
- For instance:
- </p>
-<pre class="programlisting"><span class="identifier">add</span><span class="special">(</span><span class="identifier">arg1</span><span class="special">,</span> <span class="number">6</span><span class="special">)</span>
-</pre>
-<p>
- Passing a second argument, <code class="computeroutput"><span class="number">6</span></code>,
- an <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="keyword">int</span><span class="special">>::</span><span class="identifier">type</span></code> is implicitly created behind the
- scenes. This is also equivalent to:
- </p>
-<pre class="programlisting"><span class="identifier">add</span><span class="special">(</span><span class="identifier">arg1</span><span class="special">,</span> <span class="identifier">val</span><span class="special">(</span><span class="number">6</span><span class="special">))</span>
-</pre>
-<p>
- <code class="computeroutput"><span class="identifier">val</span><span class="special">(</span><span class="identifier">x</span><span class="special">)</span></code>
- generates an <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
- where <code class="computeroutput"><span class="identifier">T</span></code> is the type of
- <code class="computeroutput"><span class="identifier">x</span></code>. In most cases, there's
- no need to explicitly use <code class="computeroutput"><span class="identifier">val</span></code>,
- but, as we'll see later on, there are situations where this is unavoidable.
- </p>
-<a name="phoenix.reference.the_language.terminal.value.synopsis"></a><h6>
-<a name="id762763"></a>
- <a class="link" href="the_language.html#phoenix.reference.the_language.terminal.value.synopsis">Synopsis</a>
- </h6>
-<pre class="programlisting"><span class="keyword">namespace</span> <span class="identifier">expression</span>
-<span class="special">{</span>
- <span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
- <span class="keyword">struct</span> <span class="identifier">value</span>
- <span class="special">{</span>
- <span class="keyword">typedef</span> <span class="emphasis"><em>unspecified</em></span> <span class="identifier">type</span><span class="special">;</span>
-
- <span class="keyword">static</span> <span class="identifier">type</span> <span class="identifier">make</span><span class="special">(</span><span class="identifier">T</span> <span class="identifier">t</span><span class="special">);</span>
- <span class="special">};</span>
-<span class="special">}</span>
-
-<span class="keyword">namespace</span> <span class="identifier">rule</span>
-<span class="special">{</span>
- <span class="keyword">struct</span> <span class="identifier">value</span> <span class="special">:</span> <span class="identifier">proto</span><span class="special">::</span><span class="identifier">terminal</span><span class="special"><</span><span class="identifier">proto</span><span class="special">::</span><span class="identifier">_</span><span class="special">></span> <span class="special">{};</span>
-<span class="special">}</span>
-
-<span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
-<span class="keyword">typename</span> <span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
-<span class="identifier">val</span><span class="special">(</span><span class="identifier">T</span> <span class="identifier">t</span><span class="special">);</span>
-</pre>
-<a name="phoenix.reference.the_language.terminal.value.parameters"></a><h6>
-<a name="id763058"></a>
- <a class="link" href="the_language.html#phoenix.reference.the_language.terminal.value.parameters">Parameters</a>
- </h6>
-<div class="informaltable"><table class="table">
-<colgroup>
-<col>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>
- <p>
- Parameter
- </p>
- </th>
-<th>
- <p>
- Requirement
- </p>
- </th>
-<th>
- <p>
- Description
- </p>
- </th>
-</tr></thead>
-<tbody>
-<tr>
-<td>
- <p>
- <code class="computeroutput"><span class="identifier">T</span></code>
- </p>
- </td>
-<td>
- <p>
- Model of Copy Constructible
- </p>
- </td>
-<td>
- <p>
- Operation's Argument
- </p>
- </td>
-</tr>
-<tr>
-<td>
- <p>
- <code class="computeroutput"><span class="identifier">t</span></code>
- </p>
- </td>
-<td>
- <p>
- Object of type T
- </p>
- </td>
-<td>
- <p>
- Operation's Argument
- </p>
- </td>
-</tr>
-</tbody>
-</table></div>
-<a name="phoenix.reference.the_language.terminal.value.expression_semantics"></a><h6>
-<a name="id763181"></a>
- <a class="link" href="the_language.html#phoenix.reference.the_language.terminal.value.expression_semantics">Expression
- Semantics</a>
- </h6>
-<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
-</pre>
-<p>
- <span class="bold"><strong>Return type</strong></span>: Returns a Phoenix Actor
- representing a terminal expression
- </p>
-<p>
- <span class="bold"><strong>Semantics</strong></span>: A metafunction for generating
- a Phoenix value expression type
- </p>
-<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
-</pre>
-<p>
- <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
- </p>
-<p>
- <span class="bold"><strong>Semantics</strong></span>: Creates a Phoenix Value expression
- initialized with a copy of of the supplied argument
- </p>
-<pre class="programlisting"><span class="identifier">val</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
-</pre>
-<p>
- <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
- </p>
-<p>
- <span class="bold"><strong>Semantics</strong></span>: Calls <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">)</span></code>, Automatically deduces type T
- </p>
-<p>
- [header Header] #include <boost/phoenix/core/value.hpp>
- </p>
-<p>
- [header Example]
- </p>
-<p>
- TODO
- </p>
-</div>
-<div class="section">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="phoenix.reference.the_language.terminal.reference"></a><a class="link" href="the_language.html#phoenix.reference.the_language.terminal.reference" title="Reference">Reference</a>
-</h5></div></div></div>
-<p>
- References are one of the core building blocks of Phoenix.
- </p>
-<a name="phoenix.reference.the_language.terminal.reference.synopsis"></a><h6>
-<a name="id763489"></a>
- <a class="link" href="the_language.html#phoenix.reference.the_language.terminal.reference.synopsis">Synopsis</a>
- </h6>
-<pre class="programlisting"><span class="keyword">namespace</span> <span class="identifier">expression</span>
-<span class="special">{</span>
- <span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
- <span class="keyword">struct</span> <span class="identifier">reference</span>
- <span class="special">{</span>
- <span class="keyword">typedef</span> <span class="emphasis"><em>unspecified</em></span> <span class="identifier">type</span><span class="special">;</span>
-
- <span class="keyword">static</span> <span class="identifier">type</span> <span class="identifier">make</span><span class="special">(</span><span class="identifier">T</span> <span class="special">&</span><span class="identifier">t</span><span class="special">);</span>
- <span class="special">};</span>
-<span class="special">}</span>
-
-<span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
-<span class="keyword">typename</span> <span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
-<span class="identifier">ref</span><span class="special">(</span><span class="identifier">T</span> <span class="special">&</span> <span class="identifier">t</span><span class="special">);</span>
-
-<span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
-<span class="keyword">typename</span> <span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">>::</span><span class="identifier">type</span>
-<span class="identifier">cref</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">t</span><span class="special">);</span>
-</pre>
-<a name="phoenix.reference.the_language.terminal.reference.parameters"></a><h6>
-<a name="id763816"></a>
- <a class="link" href="the_language.html#phoenix.reference.the_language.terminal.reference.parameters">Parameters</a>
- </h6>
-<div class="informaltable"><table class="table">
-<colgroup>
-<col>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>
- <p>
- Parameter
- </p>
- </th>
-<th>
- <p>
- Requirement
- </p>
- </th>
-<th>
- <p>
- Description
- </p>
- </th>
-</tr></thead>
-<tbody>
-<tr>
-<td>
- <p>
- T
- </p>
- </td>
-<td>
- </td>
-<td>
- <p>
- Operation's Argument
- </p>
- </td>
-</tr>
-<tr>
-<td>
- <p>
- t
- </p>
- </td>
-<td>
- <p>
- Object of type T
- </p>
- </td>
-<td>
- <p>
- Operation's Argument
- </p>
- </td>
-</tr>
-</tbody>
-</table></div>
-<a name="phoenix.reference.the_language.terminal.reference.expression_semantics"></a><h6>
-<a name="id763916"></a>
- <a class="link" href="the_language.html#phoenix.reference.the_language.terminal.reference.expression_semantics">Expression
- Semantics</a>
- </h6>
-<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
-</pre>
-<p>
- <span class="bold"><strong>Return type</strong></span>: Returns a Phoenix Actor
- representing a terminal expression
- </p>
-<p>
- <span class="bold"><strong>Semantics</strong></span>: A metafunction for generating
- a Phoenix reference expression type
- </p>
-<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
-</pre>
-<p>
- <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
- </p>
-<p>
- <span class="bold"><strong>Semantics</strong></span>: Creates a Phoenix reference
- expression initialized with the supplied argument
- </p>
-<pre class="programlisting"><span class="identifier">ref</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
-</pre>
-<p>
- <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
- </p>
-<p>
- <span class="bold"><strong>Semantics</strong></span>: Calls <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">)</span></code>, Automatically deduces type T
- </p>
-<pre class="programlisting"><span class="identifier">cref</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
-</pre>
-<p>
- <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">>::</span><span class="identifier">type</span></code>
- </p>
-<p>
- <span class="bold"><strong>Semantics</strong></span>: Calls <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">)</span></code>,
- Automatically deduces type T
- </p>
-<a name="phoenix.reference.the_language.terminal.reference.header"></a><h6>
-<a name="id764328"></a>
- <a class="link" href="the_language.html#phoenix.reference.the_language.terminal.reference.header">Header</a>
- </h6>
-<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">phoenix</span><span class="special">/</span><span class="identifier">core</span><span class="special">/</span><span class="identifier">reference</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span>
-</pre>
-<a name="phoenix.reference.the_language.terminal.reference.example"></a><h6>
-<a name="id764401"></a>
- <a class="link" href="the_language.html#phoenix.reference.the_language.terminal.reference.example">Example</a>
- </h6>
-<p>
- TODO
- </p>
-</div>
-<div class="section">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="phoenix.reference.the_language.terminal.placeholder"></a><a class="link" href="the_language.html#phoenix.reference.the_language.terminal.placeholder" title="Placeholder">Placeholder</a>
-</h5></div></div></div>
-<a name="phoenix.reference.the_language.terminal.placeholder.synopsis"></a><h6>
-<a name="id764433"></a>
- <a class="link" href="the_language.html#phoenix.reference.the_language.terminal.placeholder.synopsis">Synopsis</a>
- </h6>
-<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">int</span> <span class="identifier">I</span><span class="special">></span>
-<span class="keyword">struct</span> <span class="identifier">argument</span>
- <span class="special">:</span> <span class="identifier">mpl</span><span class="special">::</span><span class="identifier">int_</span><span class="special"><</span><span class="identifier">I</span><span class="special">></span>
-<span class="special">{</span>
- <span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">==(</span><span class="identifier">argument</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
-
- <span class="keyword">template</span> <span class="special"><</span><span class="keyword">int</span> <span class="identifier">I2</span><span class="special">></span>
- <span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">==(</span><span class="identifier">argument</span><span class="special"><</span><span class="identifier">I2</span><span class="special">>)</span> <span class="keyword">const</span><span class="special">;</span>
-<span class="special">};</span>
-
-<span class="keyword">namespace</span> <span class="identifier">placeholders</span>
-<span class="special">{</span>
-
-<span class="special">}</span>
-</pre>
-</div>
-<div class="section"><div class="titlepage"><div><div><h5 class="title">
-<a name="phoenix.reference.the_language.terminal.customization_points"></a><a class="link" href="the_language.html#phoenix.reference.the_language.terminal.customization_points" title="Customization Points">Customization
- Points</a>
-</h5></div></div></div></div>
-</div>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.reference.the_language.actor"></a><a class="link" href="the_language.html#phoenix.reference.the_language.actor" title="Actor">Actor</a>
-</h4></div></div></div>
-<p>
- bla
- </p>
-</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
@@ -420,7 +50,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../reference.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="../ebnf.html"><img src="../../images/next.png" alt="Next"></a>
+<a accesskey="p" href="core_mechanisms/terminals/_custom_terminal_.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="the_language/core.html"><img src="../../images/next.png" alt="Next"></a>
</div>
</body>
</html>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,25 +3,54 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Core</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../the_language.html" title="The Language">
<link rel="prev" href="../the_language.html" title="The Language">
-<link rel="next" href="actor.html" title="Actor">
+<link rel="next" href="core/value.html" title="Value">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../the_language.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../the_language.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="actor.html"><img src="../../../images/next.png" alt="Next"></a>
+<a accesskey="p" href="../the_language.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../the_language.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="core/value.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="phoenix.reference.the_language.core"></a><a class="link" href="core.html" title="Core">Core</a>
</h4></div></div></div>
+<div class="toc"><dl>
+<dt><span class="section">Value</span></dt>
+<dt><span class="section">Reference</span></dt>
+<dt><span class="section">Arguments</span></dt>
+</dl></div>
+<pre class="programlisting"><span class="identifier">terminal</span> <span class="special">:=</span> <span class="identifier">value</span> <span class="special">|</span> <span class="identifier">reference</span> <span class="special">|</span> <span class="identifier">placeholder</span>
+
+<span class="identifier">value</span> <span class="special">:=</span> <span class="string">"val"</span> <span class="string">"("</span> <span class="identifier">expression</span> <span class="string">")"</span>
+
+<span class="identifier">reference</span> <span class="special">:=</span> <span class="string">"ref"</span> <span class="string">"("</span> <span class="identifier">C</span><span class="special">++</span> <span class="identifier">expression</span> <span class="string">")"</span>
+ <span class="special">|</span> <span class="string">"cref"</span> <span class="string">"("</span> <span class="identifier">C</span><span class="special">++</span> <span class="identifier">expression</span> <span class="string">")"</span>
+
+<span class="identifier">placeholder</span> <span class="special">:=</span> <span class="identifier">_1</span> <span class="special">|</span> <span class="identifier">_2</span> <span class="special">|</span> <span class="identifier">_3</span> <span class="special">|</span> <span class="special">...</span> <span class="special">|</span> <span class="identifier">_PHOENIX_ARG_LIMIT</span>
+</pre>
<p>
- blubbv
+ Terminals are the core building blocks. Phoenix, by default distinguishes
+ between 3 types of terminals:
+ </p>
+<div class="orderedlist"><ol type="1">
+<li>
+ Value Terminals
+ </li>
+<li>
+ Reference Terminals
+ </li>
+<li>
+ Placeholders
+ </li>
+</ol></div>
+<p>
+ The last two terminal types are handled by the terminal customization points.
</p>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
@@ -34,7 +63,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../the_language.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../the_language.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="actor.html"><img src="../../../images/next.png" alt="Next"></a>
+<a accesskey="p" href="../the_language.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../the_language.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="core/value.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
</body>
</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/arguments.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/arguments.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,41 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Arguments</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core.html" title="Core">
+<link rel="prev" href="reference.html" title="Reference">
+<link rel="next" href="../../../ebnf.html" title="EBNF">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="reference.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="../../../ebnf.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="phoenix.reference.the_language.core.arguments"></a><a class="link" href="arguments.html" title="Arguments">Arguments</a>
+</h5></div></div></div>
+<a name="phoenix.reference.the_language.core.arguments.synopsis"></a><h6>
+<a name="id2831519"></a>
+ <a class="link" href="arguments.html#phoenix.reference.the_language.core.arguments.synopsis">Synopsis</a>
+ </h6>
+</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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="reference.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="../../../ebnf.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/reference.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/reference.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,215 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Reference</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core.html" title="Core">
+<link rel="prev" href="value.html" title="Value">
+<link rel="next" href="arguments.html" title="Arguments">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="value.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="arguments.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="phoenix.reference.the_language.core.reference"></a><a class="link" href="reference.html" title="Reference">Reference</a>
+</h5></div></div></div>
+<p>
+ Values are immutable constants. Attempting to modify a value will result
+ in a compile time error. When we want the function to modify the parameter,
+ we use a reference instead. For instance, imagine a lazy function <code class="computeroutput"><span class="identifier">add_assign</span></code>:
+ </p>
+<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">add_assign</span><span class="special">(</span><span class="identifier">T</span><span class="special">&</span> <span class="identifier">x</span><span class="special">,</span> <span class="identifier">T</span> <span class="identifier">y</span><span class="special">)</span> <span class="special">{</span> <span class="identifier">x</span> <span class="special">+=</span> <span class="identifier">y</span><span class="special">;</span> <span class="special">}</span> <span class="comment">// pseudo code
+</span></pre>
+<p>
+ Here, we want the first function argument, x, to be mutable. Obviously,
+ we cannot write:
+ </p>
+<pre class="programlisting"><span class="identifier">add_assign</span><span class="special">(</span><span class="number">1</span><span class="special">,</span> <span class="number">2</span><span class="special">)</span> <span class="comment">// error first argument is immutable
+</span></pre>
+<p>
+ In C++, we can pass in a reference to a variable as the first argument
+ in our example above. Yet, by default, the library forces arguments passed
+ to partially applied functions functions to be immutable values (see
+ <a class="link" href="../../../../">__phoenix_reference_value__</a>
+ ). To achieve our intent, we use:
+ </p>
+<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
+</pre>
+<p>
+ This is similar to <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
+ before but instead holds a reference to a variable.
+ </p>
+<p>
+ We normally don't instantiate <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
+ objects directly. Instead we use <code class="computeroutput"><span class="identifier">ref</span></code>.
+ For example (where <code class="computeroutput"><span class="identifier">i</span></code>
+ is an <code class="computeroutput"><span class="keyword">int</span></code> variable):
+ </p>
+<pre class="programlisting"><span class="identifier">add_assign</span><span class="special">(</span><span class="identifier">ref</span><span class="special">(</span><span class="identifier">i</span><span class="special">),</span> <span class="number">2</span><span class="special">)</span>
+</pre>
+<p>
+ Another free function <code class="computeroutput"><span class="identifier">cref</span><span class="special">(</span><span class="identifier">cv</span><span class="special">)</span></code> may also be used. <code class="computeroutput"><span class="identifier">cref</span><span class="special">(</span><span class="identifier">cv</span><span class="special">)</span></code> creates an <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">>::</span><span class="identifier">type</span></code> object. This is similar to <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span
></code> but when the data to be passed
+ as argument to a function is heavy and expensive to copy by value, the
+ <code class="computeroutput"><span class="identifier">cref</span><span class="special">(</span><span class="identifier">cv</span><span class="special">)</span></code>
+ offers a lighter alternative.
+ </p>
+<a name="phoenix.reference.the_language.core.reference.synopsis"></a><h6>
+<a name="id2830544"></a>
+ <a class="link" href="reference.html#phoenix.reference.the_language.core.reference.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting"><span class="keyword">namespace</span> <span class="identifier">expression</span>
+<span class="special">{</span>
+ <span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
+ <span class="keyword">struct</span> <span class="identifier">reference</span>
+ <span class="special">{</span>
+ <span class="keyword">typedef</span> <span class="emphasis"><em>unspecified</em></span> <span class="identifier">type</span><span class="special">;</span>
+
+ <span class="keyword">static</span> <span class="identifier">type</span> <span class="identifier">make</span><span class="special">(</span><span class="identifier">T</span> <span class="special">&</span><span class="identifier">t</span><span class="special">);</span>
+ <span class="special">};</span>
+<span class="special">}</span>
+
+<span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
+<span class="keyword">typename</span> <span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
+<span class="identifier">ref</span><span class="special">(</span><span class="identifier">T</span> <span class="special">&</span> <span class="identifier">t</span><span class="special">);</span>
+
+<span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
+<span class="keyword">typename</span> <span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">>::</span><span class="identifier">type</span>
+<span class="identifier">cref</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">t</span><span class="special">);</span>
+</pre>
+<a name="phoenix.reference.the_language.core.reference.parameters"></a><h6>
+<a name="id2830871"></a>
+ <a class="link" href="reference.html#phoenix.reference.the_language.core.reference.parameters">Parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ <p>
+ Parameter
+ </p>
+ </th>
+<th>
+ <p>
+ Requirement
+ </p>
+ </th>
+<th>
+ <p>
+ Description
+ </p>
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ <p>
+ T
+ </p>
+ </td>
+<td>
+ </td>
+<td>
+ <p>
+ Operation's Argument
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ t
+ </p>
+ </td>
+<td>
+ <p>
+ Object of type T
+ </p>
+ </td>
+<td>
+ <p>
+ Operation's Argument
+ </p>
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="phoenix.reference.the_language.core.reference.expression_semantics"></a><h6>
+<a name="id2830981"></a>
+ <a class="link" href="reference.html#phoenix.reference.the_language.core.reference.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
+</pre>
+<p>
+ <span class="bold"><strong>Return type</strong></span>: Returns a Phoenix Actor
+ representing a terminal expression
+ </p>
+<p>
+ <span class="bold"><strong>Semantics</strong></span>: A metafunction for generating
+ a Phoenix reference expression type
+ </p>
+<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
+</pre>
+<p>
+ <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
+ </p>
+<p>
+ <span class="bold"><strong>Semantics</strong></span>: Creates a Phoenix reference
+ expression initialized with the supplied argument
+ </p>
+<pre class="programlisting"><span class="identifier">ref</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
+</pre>
+<p>
+ <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
+ </p>
+<p>
+ <span class="bold"><strong>Semantics</strong></span>: Calls <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">)</span></code>, Automatically deduces type T
+ </p>
+<pre class="programlisting"><span class="identifier">cref</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
+</pre>
+<p>
+ <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">>::</span><span class="identifier">type</span></code>
+ </p>
+<p>
+ <span class="bold"><strong>Semantics</strong></span>: Calls <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">reference</span><span class="special"><</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">)</span></code>,
+ Automatically deduces type T
+ </p>
+<a name="phoenix.reference.the_language.core.reference.header"></a><h6>
+<a name="id2831405"></a>
+ <a class="link" href="reference.html#phoenix.reference.the_language.core.reference.header">Header</a>
+ </h6>
+<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">phoenix</span><span class="special">/</span><span class="identifier">core</span><span class="special">/</span><span class="identifier">reference</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span>
+</pre>
+<a name="phoenix.reference.the_language.core.reference.example"></a><h6>
+<a name="id2831481"></a>
+ <a class="link" href="reference.html#phoenix.reference.the_language.core.reference.example">Example</a>
+ </h6>
+<p>
+ TODO
+ </p>
+</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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="value.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="arguments.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Added: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/value.html
==============================================================================
--- (empty file)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/reference/the_language/core/value.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -0,0 +1,192 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Value</title>
+<link rel="stylesheet" href="../../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="up" href="../core.html" title="Core">
+<link rel="prev" href="../core.html" title="Core">
+<link rel="next" href="reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../core.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="reference.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="phoenix.reference.the_language.core.value"></a><a class="link" href="value.html" title="Value">Value</a>
+</h5></div></div></div>
+<p>
+ Whenever we see a constant in a partially applied function, an
+ </p>
+<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
+</pre>
+<p>
+ (where T is the type of the constant) is automatically created for us.
+ For instance:
+ </p>
+<pre class="programlisting"><span class="identifier">add</span><span class="special">(</span><span class="identifier">arg1</span><span class="special">,</span> <span class="number">6</span><span class="special">)</span>
+</pre>
+<p>
+ Passing a second argument, <code class="computeroutput"><span class="number">6</span></code>,
+ an <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="keyword">int</span><span class="special">>::</span><span class="identifier">type</span></code> is implicitly created behind the
+ scenes. This is also equivalent to:
+ </p>
+<pre class="programlisting"><span class="identifier">add</span><span class="special">(</span><span class="identifier">arg1</span><span class="special">,</span> <span class="identifier">val</span><span class="special">(</span><span class="number">6</span><span class="special">))</span>
+</pre>
+<p>
+ <code class="computeroutput"><span class="identifier">val</span><span class="special">(</span><span class="identifier">x</span><span class="special">)</span></code>
+ generates an <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
+ where <code class="computeroutput"><span class="identifier">T</span></code> is the type of
+ <code class="computeroutput"><span class="identifier">x</span></code>. In most cases, there's
+ no need to explicitly use <code class="computeroutput"><span class="identifier">val</span></code>,
+ but, as we'll see later on, there are situations where this is unavoidable.
+ </p>
+<a name="phoenix.reference.the_language.core.value.synopsis"></a><h6>
+<a name="id2829312"></a>
+ <a class="link" href="value.html#phoenix.reference.the_language.core.value.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting"><span class="keyword">namespace</span> <span class="identifier">expression</span>
+<span class="special">{</span>
+ <span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
+ <span class="keyword">struct</span> <span class="identifier">value</span>
+ <span class="special">{</span>
+ <span class="keyword">typedef</span> <span class="emphasis"><em>unspecified</em></span> <span class="identifier">type</span><span class="special">;</span>
+
+ <span class="keyword">static</span> <span class="identifier">type</span> <span class="identifier">make</span><span class="special">(</span><span class="identifier">T</span> <span class="identifier">t</span><span class="special">);</span>
+ <span class="special">};</span>
+<span class="special">}</span>
+
+<span class="keyword">namespace</span> <span class="identifier">rule</span>
+<span class="special">{</span>
+ <span class="keyword">struct</span> <span class="identifier">value</span> <span class="special">:</span> <span class="identifier">proto</span><span class="special">::</span><span class="identifier">terminal</span><span class="special"><</span><span class="identifier">proto</span><span class="special">::</span><span class="identifier">_</span><span class="special">></span> <span class="special">{};</span>
+<span class="special">}</span>
+
+<span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
+<span class="keyword">typename</span> <span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
+<span class="identifier">val</span><span class="special">(</span><span class="identifier">T</span> <span class="identifier">t</span><span class="special">);</span>
+</pre>
+<a name="phoenix.reference.the_language.core.value.parameters"></a><h6>
+<a name="id2829609"></a>
+ <a class="link" href="value.html#phoenix.reference.the_language.core.value.parameters">Parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ <p>
+ Parameter
+ </p>
+ </th>
+<th>
+ <p>
+ Requirement
+ </p>
+ </th>
+<th>
+ <p>
+ Description
+ </p>
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">T</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Model of Copy Constructible
+ </p>
+ </td>
+<td>
+ <p>
+ Operation's Argument
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ <code class="computeroutput"><span class="identifier">t</span></code>
+ </p>
+ </td>
+<td>
+ <p>
+ Object of type T
+ </p>
+ </td>
+<td>
+ <p>
+ Operation's Argument
+ </p>
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="phoenix.reference.the_language.core.value.expression_semantics"></a><h6>
+<a name="id2829739"></a>
+ <a class="link" href="value.html#phoenix.reference.the_language.core.value.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span>
+</pre>
+<p>
+ <span class="bold"><strong>Return type</strong></span>: Returns a Phoenix Actor
+ representing a terminal expression
+ </p>
+<p>
+ <span class="bold"><strong>Semantics</strong></span>: A metafunction for generating
+ a Phoenix value expression type
+ </p>
+<pre class="programlisting"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
+</pre>
+<p>
+ <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
+ </p>
+<p>
+ <span class="bold"><strong>Semantics</strong></span>: Creates a Phoenix Value expression
+ initialized with a copy of of the supplied argument
+ </p>
+<pre class="programlisting"><span class="identifier">val</span><span class="special">(</span><span class="identifier">t</span><span class="special">);</span>
+</pre>
+<p>
+ <span class="bold"><strong>Return type</strong></span>: <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">type</span></code>
+ </p>
+<p>
+ <span class="bold"><strong>Semantics</strong></span>: Calls <code class="computeroutput"><span class="identifier">expression</span><span class="special">::</span><span class="identifier">value</span><span class="special"><</span><span class="identifier">T</span><span class="special">>::</span><span class="identifier">make</span><span class="special">(</span><span class="identifier">t</span><span class="special">)</span></code>, Automatically deduces type T
+ </p>
+<p>
+ [header Header] #include <boost/phoenix/core/value.hpp>
+ </p>
+<p>
+ [header Example]
+ </p>
+<p>
+ TODO
+ </p>
+</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, 2010 Joel de Guzman, Dan Marsden, Thomas Heller<p>
+ 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)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../core.html"><img src="../../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../core.html"><img src="../../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../images/home.png" alt="Home"></a><a accesskey="n" href="reference.html"><img src="../../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,304 +3,39 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Composites</title>
-<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../starter_kit.html" title="Starter Kit">
-<link rel="prev" href="primitives.html" title="Primitives">
-<link rel="next" href="../reference.html" title="Reference">
+<link rel="prev" href="primitives/arguments.html" title="Arguments">
+<link rel="next" href="composites/lazy_operators.html" title="Lazy Operators">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="primitives.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../starter_kit.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../images/next.png" alt="Next"></a>
+<a accesskey="p" href="primitives/arguments.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../starter_kit.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="composites/lazy_operators.html"><img src="../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="phoenix.starter_kit.composites"></a><a class="link" href="composites.html" title="Composites">Composites</a>
</h3></div></div></div>
<div class="toc"><dl>
-<dt><span class="section"><a href="composites.html#phoenix.starter_kit.composites.lazy_operators">Lazy
+<dt><span class="section"><a href="composites/lazy_operators.html">Lazy
Operators</a></span></dt>
-<dt><span class="section"><a href="composites.html#phoenix.starter_kit.composites.lazy_statements">Lazy
+<dt><span class="section"><a href="composites/lazy_statements.html">Lazy
Statements</a></span></dt>
-<dt><span class="section"><a href="composites.html#phoenix.starter_kit.composites.construct__new__delete__casts">Construct,
+<dt><span class="section"><a href="composites/construct__new__delete__casts.html">Construct,
New, Delete, Casts</a></span></dt>
-<dt><span class="section"><a href="composites.html#phoenix.starter_kit.composites.lazy_functions">Lazy
+<dt><span class="section"><a href="composites/lazy_functions.html">Lazy
Functions</a></span></dt>
-<dt><span class="section">More</span></dt>
+<dt><span class="section">More</span></dt>
</dl></div>
<p>
Things start to get interesting when we start <span class="emphasis"><em>composing</em></span>
primitives to form <span class="bold"><strong>composites</strong></span>. The composites
can, in turn, be composed to form even more complex composites.
</p>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.starter_kit.composites.lazy_operators"></a><a class="link" href="composites.html#phoenix.starter_kit.composites.lazy_operators" title="Lazy Operators">Lazy
- Operators</a>
-</h4></div></div></div>
-<p>
- You can use the usual set of operators to form composites. Examples:
- </p>
-<pre class="programlisting"><span class="identifier">arg1</span> <span class="special">*</span> <span class="identifier">arg1</span>
-<span class="identifier">ref</span><span class="special">(</span><span class="identifier">x</span><span class="special">)</span> <span class="special">=</span> <span class="identifier">arg1</span> <span class="special">+</span> <span class="identifier">ref</span><span class="special">(</span><span class="identifier">z</span><span class="special">)</span>
-<span class="identifier">arg1</span> <span class="special">=</span> <span class="identifier">arg2</span> <span class="special">+</span> <span class="special">(</span><span class="number">3</span> <span class="special">*</span> <span class="identifier">arg3</span><span class="special">)</span>
-<span class="identifier">ref</span><span class="special">(</span><span class="identifier">x</span><span class="special">)</span> <span class="special">=</span> <span class="identifier">arg1</span><span class="special">[</span><span class="identifier">arg2</span><span class="special">]</span> <span class="comment">// assuming arg1 is indexable and arg2 is a valid index
-</span></pre>
-<p>
- Note the expression: <code class="computeroutput"><span class="number">3</span> <span class="special">*</span>
- <span class="identifier">arg3</span></code>. This expression is actually
- a short-hand equivalent to: <code class="computeroutput"><span class="identifier">val</span><span class="special">(</span><span class="number">3</span><span class="special">)</span>
- <span class="special">*</span> <span class="identifier">arg3</span></code>.
- In most cases, like above, you can get away with it. But in some cases,
- you will have to explicitly wrap your values in <code class="computeroutput"><span class="identifier">val</span></code>.
- Rules of thumb:
- </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem">
- In a binary expression (e.g. <code class="computeroutput"><span class="number">3</span>
- <span class="special">*</span> <span class="identifier">arg3</span></code>),
- at least one of the operands must be a phoenix primitive or composite.
- </li>
-<li class="listitem">
- In a unary expression (e.g. <code class="computeroutput"><span class="identifier">arg1</span><span class="special">++</span></code>), the single operand must be a phoenix
- primitive or composite.
- </li>
-</ul></div>
-<p>
- If these basic rules are not followed, the result is either an error, or
- is immediately evaluated. Some examples:
- </p>
-<pre class="programlisting"><span class="identifier">ref</span><span class="special">(</span><span class="identifier">x</span><span class="special">)</span> <span class="special">=</span> <span class="number">123</span> <span class="comment">// lazy
-</span><span class="identifier">x</span> <span class="special">=</span> <span class="number">123</span> <span class="comment">// immediate
-</span>
-<span class="identifier">ref</span><span class="special">(</span><span class="identifier">x</span><span class="special">)[</span><span class="number">0</span><span class="special">]</span> <span class="comment">// lazy
-</span><span class="identifier">x</span><span class="special">[</span><span class="number">0</span><span class="special">]</span> <span class="comment">// immediate
-</span>
-<span class="identifier">ref</span><span class="special">(</span><span class="identifier">x</span><span class="special">)[</span><span class="identifier">ref</span><span class="special">(</span><span class="identifier">i</span><span class="special">)]</span> <span class="comment">// lazy
-</span><span class="identifier">ref</span><span class="special">(</span><span class="identifier">x</span><span class="special">)[</span><span class="identifier">i</span><span class="special">]</span> <span class="comment">// lazy (equivalent to ref(x)[val(i)])
-</span><span class="identifier">x</span><span class="special">[</span><span class="identifier">ref</span><span class="special">(</span><span class="identifier">i</span><span class="special">)]</span> <span class="comment">// illegal (x is not a phoenix primitive or composite)
-</span><span class="identifier">ref</span><span class="special">(</span><span class="identifier">x</span><span class="special">[</span><span class="identifier">ref</span><span class="special">(</span><span class="identifier">i</span><span class="special">)])</span> <span class="comment">// illegal (x is not a phoenix primitive or composite)
-</span></pre>
-<div class="sidebar">
-<div class="titlepage"></div>
-<p>
- <span class="inlinemediaobject"><img src="../../images/tip.png" alt="tip"></span> Learn more about operators <a class="link" href="../../">here.</a>
- </p>
-</div>
-<a name="phoenix.starter_kit.composites.lazy_operators.first_practical_example"></a><h6>
-<a name="id760714"></a>
- <a class="link" href="composites.html#phoenix.starter_kit.composites.lazy_operators.first_practical_example">First
- Practical Example</a>
- </h6>
-<p>
- We've covered enough ground to present a real world example. We want to
- find the first odd number in an STL container. Normally we use a functor
- (function object) or a function pointer and pass that in to STL's <code class="computeroutput"><span class="identifier">find_if</span></code> generic function:
- </p>
-<p>
- Write a function:
- </p>
-<pre class="programlisting"><span class="keyword">bool</span>
-<span class="identifier">is_odd</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">arg1</span><span class="special">)</span>
-<span class="special">{</span>
- <span class="keyword">return</span> <span class="identifier">arg1</span> <span class="special">%</span> <span class="number">2</span> <span class="special">==</span> <span class="number">1</span><span class="special">;</span>
-<span class="special">}</span>
-</pre>
-<p>
- Pass a pointer to the function to STL's <code class="computeroutput"><span class="identifier">find_if</span></code>
- algorithm:
- </p>
-<pre class="programlisting"><span class="identifier">std</span><span class="special">::</span><span class="identifier">find_if</span><span class="special">(</span><span class="identifier">c</span><span class="special">.</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">c</span><span class="special">.</span><span class="identifier">end</span><span class="special">(),</span> <span class="special">&</span><span class="identifier">is_odd</span><span class="special">)</span>
-</pre>
-<p>
- Using Phoenix, the same can be achieved directly with a one-liner:
- </p>
-<pre class="programlisting"><span class="identifier">std</span><span class="special">::</span><span class="identifier">find_if</span><span class="special">(</span><span class="identifier">c</span><span class="special">.</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">c</span><span class="special">.</span><span class="identifier">end</span><span class="special">(),</span> <span class="identifier">arg1</span> <span class="special">%</span> <span class="number">2</span> <span class="special">==</span> <span class="number">1</span><span class="special">)</span>
-</pre>
-<p>
- The expression <code class="computeroutput"><span class="identifier">arg1</span> <span class="special">%</span>
- <span class="number">2</span> <span class="special">==</span> <span class="number">1</span></code> automagically creates a functor with the
- expected behavior. In FP, this unnamed function is called a lambda function.
- Unlike the function pointer version, which is monomorphic (expects and
- works only with a fixed type int argument), the Phoenix version is fully
- polymorphic and works with any container (of ints, of longs, of bignum,
- etc.) as long as its elements can handle the <code class="computeroutput"><span class="identifier">arg1</span>
- <span class="special">%</span> <span class="number">2</span> <span class="special">==</span> <span class="number">1</span></code> expression.
- </p>
-<p>
- (See find_if.cpp)
- </p>
-<div class="sidebar">
-<div class="titlepage"></div>
-<p>
- <span class="inlinemediaobject"><img src="../../images/tip.png" alt="tip"></span> ...<span class="bold"><strong>That's it, we're done</strong></span>.
- Well if you wish to know a little bit more, read on...
- </p>
-</div>
-</div>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.starter_kit.composites.lazy_statements"></a><a class="link" href="composites.html#phoenix.starter_kit.composites.lazy_statements" title="Lazy Statements">Lazy
- Statements</a>
-</h4></div></div></div>
-<p>
- Lazy statements? Sure. There are lazy versions of the C++ statements we
- all know and love. For example:
- </p>
-<pre class="programlisting"><span class="identifier">if_</span><span class="special">(</span><span class="identifier">arg1</span> <span class="special">></span> <span class="number">5</span><span class="special">)</span>
-<span class="special">[</span>
- <span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special"><<</span> <span class="identifier">arg1</span>
-<span class="special">]</span>
-</pre>
-<p>
- Say, for example, we wish to print all the elements that are greater than
- 5 (separated by a comma) in a vector. Here's how we write it:
- </p>
-<pre class="programlisting"><span class="identifier">std</span><span class="special">::</span><span class="identifier">for_each</span><span class="special">(</span><span class="identifier">v</span><span class="special">.</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">v</span><span class="special">.</span><span class="identifier">end</span><span class="special">(),</span>
- <span class="identifier">if_</span><span class="special">(</span><span class="identifier">arg1</span> <span class="special">></span> <span class="number">5</span><span class="special">)</span>
- <span class="special">[</span>
- <span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special"><<</span> <span class="identifier">arg1</span> <span class="special"><<</span> <span class="string">", "</span>
- <span class="special">]</span>
-<span class="special">);</span>
-</pre>
-<p>
- (See if.cpp)
- </p>
-<div class="sidebar">
-<div class="titlepage"></div>
-<p>
- <span class="inlinemediaobject"><img src="../../images/tip.png" alt="tip"></span> Learn more about statements <a class="link" href="../../">here.</a>
- </p>
-</div>
-</div>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.starter_kit.composites.construct__new__delete__casts"></a><a class="link" href="composites.html#phoenix.starter_kit.composites.construct__new__delete__casts" title="Construct, New, Delete, Casts">Construct,
- New, Delete, Casts</a>
-</h4></div></div></div>
-<p>
- You'll probably want to work with objects. There are lazy versions of constructor
- calls, <code class="computeroutput"><span class="keyword">new</span></code>, <code class="computeroutput"><span class="keyword">delete</span></code> and the suite of C++ casts. Examples:
- </p>
-<pre class="programlisting"><span class="identifier">construct</span><span class="special"><</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">>(</span><span class="identifier">arg1</span><span class="special">,</span> <span class="identifier">arg2</span><span class="special">)</span> <span class="comment">// constructs a std::string from arg1, arg2
-</span><span class="identifier">new_</span><span class="special"><</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">>(</span><span class="identifier">arg1</span><span class="special">,</span> <span class="identifier">arg2</span><span class="special">)</span> <span class="comment">// makes a new std::string from arg1, arg2
-</span><span class="identifier">delete_</span><span class="special">(</span><span class="identifier">arg1</span><span class="special">)</span> <span class="comment">// deletes arg1 (assumed to be a pointer)
-</span><span class="identifier">static_cast_</span><span class="special"><</span><span class="keyword">int</span><span class="special">*>(</span><span class="identifier">arg1</span><span class="special">)</span> <span class="comment">// static_cast's arg1 to an int*
-</span></pre>
-<div class="note"><table border="0" summary="Note">
-<tr>
-<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../images/note.png"></td>
-<th align="left">Note</th>
-</tr>
-<tr><td align="left" valign="top"><p>
- Take note that, by convention, names that conflict with C++ reserved
- words are appended with a single trailing underscore <code class="computeroutput"><span class="char">'_'</span></code>
- </p></td></tr>
-</table></div>
-<div class="sidebar">
-<div class="titlepage"></div>
-<p>
- <span class="inlinemediaobject"><img src="../../images/tip.png" alt="tip"></span> Learn more about this <a class="link" href="../../">here.</a>
- </p>
-</div>
-</div>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.starter_kit.composites.lazy_functions"></a><a class="link" href="composites.html#phoenix.starter_kit.composites.lazy_functions" title="Lazy Functions">Lazy
- Functions</a>
-</h4></div></div></div>
-<p>
- As you write more lambda functions, you'll notice certain patterns that
- you wish to refactor as reusable functions. When you reach that point,
- you'll wish that ordinary functions can co-exist with phoenix functions.
- Unfortunately, the <span class="emphasis"><em>immediate</em></span> nature of plain C++ functions
- make them incompatible.
- </p>
-<p>
- Lazy functions are your friends. The library provides a facility to make
- lazy functions. The code below is a rewrite of the <code class="computeroutput"><span class="identifier">is_odd</span></code>
- function using the facility:
- </p>
-<pre class="programlisting"><span class="keyword">struct</span> <span class="identifier">is_odd_impl</span>
-<span class="special">{</span>
- <span class="keyword">typedef</span> <span class="keyword">bool</span> <span class="identifier">result_type</span><span class="special">;</span>
-
- <span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">Arg</span><span class="special">></span>
- <span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">()(</span><span class="identifier">Arg</span> <span class="identifier">arg1</span><span class="special">)</span> <span class="keyword">const</span>
- <span class="special">{</span>
- <span class="keyword">return</span> <span class="identifier">arg1</span> <span class="special">%</span> <span class="number">2</span> <span class="special">==</span> <span class="number">1</span><span class="special">;</span>
- <span class="special">}</span>
-<span class="special">};</span>
-
-<span class="identifier">function</span><span class="special"><</span><span class="identifier">is_odd_impl</span><span class="special">></span> <span class="identifier">is_odd</span><span class="special">;</span>
-</pre>
-<a name="phoenix.starter_kit.composites.lazy_functions.things_to_note_"></a><h6>
-<a name="id761792"></a>
- <a class="link" href="composites.html#phoenix.starter_kit.composites.lazy_functions.things_to_note_">Things
- to note:</a>
- </h6>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem">
- Result type deduction is implemented with the help of the result_of
- protocol. For more information see <a href="http://www.boost.org/doc/libs/1_43_0/libs/utility/utility.htm#result_of" target="_top">Boost.Result
- Of</a>
- </li>
-<li class="listitem">
- <code class="computeroutput"><span class="identifier">is_odd_impl</span></code> implements
- the function.
- </li>
-<li class="listitem">
- <code class="computeroutput"><span class="identifier">is_odd</span></code>, an instance
- of <code class="computeroutput"><span class="identifier">function</span><span class="special"><</span><span class="identifier">is_odd_impl</span><span class="special">></span></code>,
- is the lazy function.
- </li>
-</ul></div>
-<p>
- Now, <code class="computeroutput"><span class="identifier">is_odd</span></code> is a truly
- lazy function that we can use in conjunction with the rest of phoenix.
- Example:
- </p>
-<pre class="programlisting"><span class="identifier">std</span><span class="special">::</span><span class="identifier">find_if</span><span class="special">(</span><span class="identifier">c</span><span class="special">.</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">c</span><span class="special">.</span><span class="identifier">end</span><span class="special">(),</span> <span class="identifier">is_odd</span><span class="special">(</span><span class="identifier">arg1</span><span class="special">));</span>
-</pre>
-<p>
- (See function.cpp)
- </p>
-<a name="phoenix.starter_kit.composites.lazy_functions.predefined_lazy_functions"></a><h6>
-<a name="id761971"></a>
- <a class="link" href="composites.html#phoenix.starter_kit.composites.lazy_functions.predefined_lazy_functions">Predefined
- Lazy Functions</a>
- </h6>
-<p>
- The library is chock full of STL savvy, predefined lazy functions covering
- the whole of the STL containers, iterators and algorithms. For example,
- there are lazy versions of container related operations such as assign,
- at, back, begin, pop_back, pop_front, push_back, push_front, etc. (See
- <a class="link" href="../../">STL</a>).
- </p>
-</div>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.starter_kit.composites.more"></a><a class="link" href="composites.html#phoenix.starter_kit.composites.more" title="More">More</a>
-</h4></div></div></div>
-<p>
- As mentioned earlier, this chapter is not a thorough discourse of the library.
- It is meant only to cover enough ground to get you into high gear as quickly
- as possible. Some advanced stuff is not discussed here (e.g. <a class="link" href="../../">Scopes</a>);
- nor are features that provide alternative (short-hand) ways to do the same
- things (e.g. <a class="link" href="../../">Bind</a>
- vs. <a class="link" href="../../">Lazy Functions</a>).
- </p>
-<div class="sidebar">
-<div class="titlepage"></div>
-<p>
- <span class="inlinemediaobject"><img src="../../images/tip.png" alt="tip"></span> ...<span class="bold"><strong>If you still wish to learn
- more, the read on...</strong></span>
- </p>
-</div>
-</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
@@ -312,7 +47,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="primitives.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../starter_kit.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../images/next.png" alt="Next"></a>
+<a accesskey="p" href="primitives/arguments.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../starter_kit.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="composites/lazy_operators.html"><img src="../../images/next.png" alt="Next"></a>
</div>
</body>
</html>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/construct__new__delete__casts.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/construct__new__delete__casts.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/construct__new__delete__casts.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,9 +3,9 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Construct, New, Delete, Casts</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../composites.html" title="Composites">
<link rel="prev" href="lazy_statements.html" title="Lazy Statements">
<link rel="next" href="lazy_functions.html" title="Lazy Functions">
@@ -16,7 +16,7 @@
<div class="spirit-nav">
<a accesskey="p" href="lazy_statements.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../composites.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="lazy_functions.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="phoenix.starter_kit.composites.construct__new__delete__casts"></a><a class="link" href="construct__new__delete__casts.html" title="Construct, New, Delete, Casts">Construct,
New, Delete, Casts</a>
@@ -41,7 +41,7 @@
</p></td></tr>
</table></div>
<div class="sidebar">
-<div class="titlepage"></div>
+<p class="title"><b></b></p>
<p>
<span class="inlinemediaobject"><img src="../../../images/tip.png" alt="tip"></span> Learn more about this <a class="link" href="../../../">here.</a>
</p>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_functions.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_functions.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_functions.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,9 +3,9 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Lazy Functions</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../composites.html" title="Composites">
<link rel="prev" href="construct__new__delete__casts.html" title="Construct, New, Delete, Casts">
<link rel="next" href="more.html" title="More">
@@ -16,7 +16,7 @@
<div class="spirit-nav">
<a accesskey="p" href="construct__new__delete__casts.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../composites.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="more.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="phoenix.starter_kit.composites.lazy_functions"></a><a class="link" href="lazy_functions.html" title="Lazy Functions">Lazy
Functions</a>
@@ -47,21 +47,21 @@
<span class="identifier">function</span><span class="special"><</span><span class="identifier">is_odd_impl</span><span class="special">></span> <span class="identifier">is_odd</span><span class="special">;</span>
</pre>
<a name="phoenix.starter_kit.composites.lazy_functions.things_to_note_"></a><h6>
-<a name="id3246447"></a>
+<a name="id2826176"></a>
<a class="link" href="lazy_functions.html#phoenix.starter_kit.composites.lazy_functions.things_to_note_">Things
to note:</a>
</h6>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem">
+<div class="itemizedlist"><ul type="disc">
+<li>
Result type deduction is implemented with the help of the result_of
protocol. For more information see <a href="http://www.boost.org/doc/libs/1_43_0/libs/utility/utility.htm#result_of" target="_top">Boost.Result
Of</a>
</li>
-<li class="listitem">
+<li>
<code class="computeroutput"><span class="identifier">is_odd_impl</span></code> implements
the function.
</li>
-<li class="listitem">
+<li>
<code class="computeroutput"><span class="identifier">is_odd</span></code>, an instance
of <code class="computeroutput"><span class="identifier">function</span><span class="special"><</span><span class="identifier">is_odd_impl</span><span class="special">></span></code>,
is the lazy function.
@@ -78,7 +78,7 @@
(See function.cpp)
</p>
<a name="phoenix.starter_kit.composites.lazy_functions.predefined_lazy_functions"></a><h6>
-<a name="id3246638"></a>
+<a name="id2826367"></a>
<a class="link" href="lazy_functions.html#phoenix.starter_kit.composites.lazy_functions.predefined_lazy_functions">Predefined
Lazy Functions</a>
</h6>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_operators.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_operators.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_operators.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,9 +3,9 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Lazy Operators</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../composites.html" title="Composites">
<link rel="prev" href="../composites.html" title="Composites">
<link rel="next" href="lazy_statements.html" title="Lazy Statements">
@@ -16,7 +16,7 @@
<div class="spirit-nav">
<a accesskey="p" href="../composites.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../composites.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="lazy_statements.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="phoenix.starter_kit.composites.lazy_operators"></a><a class="link" href="lazy_operators.html" title="Lazy Operators">Lazy
Operators</a>
@@ -38,13 +38,13 @@
you will have to explicitly wrap your values in <code class="computeroutput"><span class="identifier">val</span></code>.
Rules of thumb:
</p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem">
+<div class="itemizedlist"><ul type="disc">
+<li>
In a binary expression (e.g. <code class="computeroutput"><span class="number">3</span>
<span class="special">*</span> <span class="identifier">arg3</span></code>),
at least one of the operands must be a phoenix primitive or composite.
</li>
-<li class="listitem">
+<li>
In a unary expression (e.g. <code class="computeroutput"><span class="identifier">arg1</span><span class="special">++</span></code>), the single operand must be a phoenix
primitive or composite.
</li>
@@ -65,13 +65,13 @@
</span><span class="identifier">ref</span><span class="special">(</span><span class="identifier">x</span><span class="special">[</span><span class="identifier">ref</span><span class="special">(</span><span class="identifier">i</span><span class="special">)])</span> <span class="comment">// illegal (x is not a phoenix primitive or composite)
</span></pre>
<div class="sidebar">
-<div class="titlepage"></div>
+<p class="title"><b></b></p>
<p>
<span class="inlinemediaobject"><img src="../../../images/tip.png" alt="tip"></span> Learn more about operators <a class="link" href="../../../">here.</a>
</p>
</div>
<a name="phoenix.starter_kit.composites.lazy_operators.first_practical_example"></a><h6>
-<a name="id3245318"></a>
+<a name="id2825046"></a>
<a class="link" href="lazy_operators.html#phoenix.starter_kit.composites.lazy_operators.first_practical_example">First
Practical Example</a>
</h6>
@@ -114,7 +114,7 @@
(See find_if.cpp)
</p>
<div class="sidebar">
-<div class="titlepage"></div>
+<p class="title"><b></b></p>
<p>
<span class="inlinemediaobject"><img src="../../../images/tip.png" alt="tip"></span> ...<span class="bold"><strong>That's it, we're done</strong></span>.
Well if you wish to know a little bit more, read on...
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_statements.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_statements.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/lazy_statements.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,9 +3,9 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Lazy Statements</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../composites.html" title="Composites">
<link rel="prev" href="lazy_operators.html" title="Lazy Operators">
<link rel="next" href="construct__new__delete__casts.html" title="Construct, New, Delete, Casts">
@@ -16,7 +16,7 @@
<div class="spirit-nav">
<a accesskey="p" href="lazy_operators.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../composites.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="construct__new__delete__casts.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="phoenix.starter_kit.composites.lazy_statements"></a><a class="link" href="lazy_statements.html" title="Lazy Statements">Lazy
Statements</a>
@@ -45,7 +45,7 @@
(See if.cpp)
</p>
<div class="sidebar">
-<div class="titlepage"></div>
+<p class="title"><b></b></p>
<p>
<span class="inlinemediaobject"><img src="../../../images/tip.png" alt="tip"></span> Learn more about statements <a class="link" href="../../../">here.</a>
</p>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/more.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/more.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/composites/more.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,9 +3,9 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>More</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../composites.html" title="Composites">
<link rel="prev" href="lazy_functions.html" title="Lazy Functions">
<link rel="next" href="../../reference.html" title="Reference">
@@ -16,7 +16,7 @@
<div class="spirit-nav">
<a accesskey="p" href="lazy_functions.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../composites.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="../../reference.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="phoenix.starter_kit.composites.more"></a><a class="link" href="more.html" title="More">More</a>
</h4></div></div></div>
@@ -29,7 +29,7 @@
vs. <a class="link" href="../../../">Lazy Functions</a>).
</p>
<div class="sidebar">
-<div class="titlepage"></div>
+<p class="title"><b></b></p>
<p>
<span class="inlinemediaobject"><img src="../../../images/tip.png" alt="tip"></span> ...<span class="bold"><strong>If you still wish to learn
more, the read on...</strong></span>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,184 +3,33 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Primitives</title>
-<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../starter_kit.html" title="Starter Kit">
<link rel="prev" href="../starter_kit.html" title="Starter Kit">
-<link rel="next" href="composites.html" title="Composites">
+<link rel="next" href="primitives/values.html" title="Values">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../starter_kit.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../starter_kit.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="composites.html"><img src="../../images/next.png" alt="Next"></a>
+<a accesskey="p" href="../starter_kit.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../starter_kit.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="primitives/values.html"><img src="../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="phoenix.starter_kit.primitives"></a><a class="link" href="primitives.html" title="Primitives">Primitives</a>
</h3></div></div></div>
<div class="toc"><dl>
-<dt><span class="section">Values</span></dt>
-<dt><span class="section">References</span></dt>
-<dt><span class="section">Arguments</span></dt>
+<dt><span class="section">Values</span></dt>
+<dt><span class="section">References</span></dt>
+<dt><span class="section">Arguments</span></dt>
</dl></div>
<p>
We start with some core functions that are called <span class="bold"><strong>primitives</strong></span>.
You can think of primitives (such as values, references and arguments) as
atoms.
</p>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.starter_kit.primitives.values"></a><a class="link" href="primitives.html#phoenix.starter_kit.primitives.values" title="Values">Values</a>
-</h4></div></div></div>
-<p>
- Values are functions! Examples:
- </p>
-<pre class="programlisting"><span class="identifier">val</span><span class="special">(</span><span class="number">3</span><span class="special">)</span>
-<span class="identifier">val</span><span class="special">(</span><span class="string">"Hello, World"</span><span class="special">)</span>
-</pre>
-<p>
- The first evaluates to a nullary function (a function taking no arguments)
- that returns an <code class="computeroutput"><span class="keyword">int</span></code>, <code class="computeroutput"><span class="number">3</span></code>. The second evaluates to a nullary function
- that returns a <code class="computeroutput"><span class="keyword">char</span> <span class="keyword">const</span><span class="special">(&)[</span><span class="number">13</span><span class="special">]</span></code>, <code class="computeroutput"><span class="string">"Hello,
- World"</span></code>.
- </p>
-<a name="phoenix.starter_kit.primitives.values.lazy_evaluation"></a><h6>
-<a name="id759125"></a>
- <a class="link" href="primitives.html#phoenix.starter_kit.primitives.values.lazy_evaluation">Lazy
- Evaluation</a>
- </h6>
-<p>
- Confused? <code class="computeroutput"><span class="identifier">val</span><span class="special">(</span><span class="number">3</span><span class="special">)</span></code> is a unary
- function, you say? Yes it is. However, read carefully: <span class="emphasis"><em>"evaluates
- to a nullary function"</em></span>. <code class="computeroutput"><span class="identifier">val</span><span class="special">(</span><span class="number">3</span><span class="special">)</span></code>
- evaluates to (returns) a nullary function. Aha! <code class="computeroutput"><span class="identifier">val</span><span class="special">(</span><span class="number">3</span><span class="special">)</span></code>
- returns a function! So, since <code class="computeroutput"><span class="identifier">val</span><span class="special">(</span><span class="number">3</span><span class="special">)</span></code>
- returns a function, you can invoke it. Example:
- </p>
-<pre class="programlisting"><span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special"><<</span> <span class="identifier">val</span><span class="special">(</span><span class="number">3</span><span class="special">)()</span> <span class="special"><<</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span>
-</pre>
-<p>
- (See values.cpp)
- </p>
-<div class="sidebar">
-<div class="titlepage"></div>
-<p>
- <span class="inlinemediaobject"><img src="../../images/tip.png" alt="tip"></span> Learn more about values <a class="link" href="../../">here.</a>
- </p>
-</div>
-<p>
- The second function call (the one with no arguments) calls the nullary
- function which then returns <code class="computeroutput"><span class="number">3</span></code>.
- The need for a second function call is the reason why the function is said
- to be <span class="bold"><strong><span class="emphasis"><em>Lazily Evaluated</em></span></strong></span>.
- The first call doesn't do anything. You need a second call to finally evaluate
- the thing. The first call lazily evaluates the function; i.e. doesn't do
- anything and defers the evaluation for later.
- </p>
-<a name="phoenix.starter_kit.primitives.values.callbacks"></a><h6>
-<a name="id759350"></a>
- <a class="link" href="primitives.html#phoenix.starter_kit.primitives.values.callbacks">Callbacks</a>
- </h6>
-<p>
- It may not be immediately apparent how lazy evaluation can be useful by
- just looking at the example above. Putting the first and second function
- call in a single line is really not very useful. However, thinking of
- <code class="computeroutput"><span class="identifier">val</span><span class="special">(</span><span class="number">3</span><span class="special">)</span></code> as a callback
- function (and in most cases they are actually used that way), will make
- it clear. Example:
- </p>
-<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">F</span><span class="special">></span>
-<span class="keyword">void</span> <span class="identifier">print</span><span class="special">(</span><span class="identifier">F</span> <span class="identifier">f</span><span class="special">)</span>
-<span class="special">{</span>
- <span class="identifier">cout</span> <span class="special"><<</span> <span class="identifier">f</span><span class="special">()</span> <span class="special"><<</span> <span class="identifier">endl</span><span class="special">;</span>
-<span class="special">}</span>
-
-<span class="keyword">int</span>
-<span class="identifier">main</span><span class="special">()</span>
-<span class="special">{</span>
- <span class="identifier">print</span><span class="special">(</span><span class="identifier">val</span><span class="special">(</span><span class="number">3</span><span class="special">));</span>
- <span class="identifier">print</span><span class="special">(</span><span class="identifier">val</span><span class="special">(</span><span class="string">"Hello World"</span><span class="special">));</span>
- <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
-<span class="special">}</span>
-</pre>
-<p>
- (See callback.cpp)
- </p>
-</div>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.starter_kit.primitives.references"></a><a class="link" href="primitives.html#phoenix.starter_kit.primitives.references" title="References">References</a>
-</h4></div></div></div>
-<p>
- References are functions. They hold a reference to a value stored somewhere.
- For example, given:
- </p>
-<pre class="programlisting"><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">3</span><span class="special">;</span>
-<span class="keyword">char</span> <span class="keyword">const</span><span class="special">*</span> <span class="identifier">s</span> <span class="special">=</span> <span class="string">"Hello World"</span><span class="special">;</span>
-</pre>
-<p>
- we create <code class="computeroutput"><span class="identifier">references</span></code> to
- <code class="computeroutput"><span class="identifier">i</span></code> and <code class="computeroutput"><span class="identifier">s</span></code>
- this way:
- </p>
-<pre class="programlisting"><span class="identifier">ref</span><span class="special">(</span><span class="identifier">i</span><span class="special">)</span>
-<span class="identifier">ref</span><span class="special">(</span><span class="identifier">s</span><span class="special">)</span>
-</pre>
-<p>
- Like <code class="computeroutput"><span class="identifier">val</span></code>, the expressions
- above evaluates to a nullary function; the first one returning an <code class="computeroutput"><span class="keyword">int</span><span class="special">&</span></code>,
- and the second one returning a <code class="computeroutput"><span class="keyword">char</span>
- <span class="keyword">const</span><span class="special">*&</span></code>.
- </p>
-<p>
- (See references.cpp)
- </p>
-<div class="sidebar">
-<div class="titlepage"></div>
-<p>
- <span class="inlinemediaobject"><img src="../../images/tip.png" alt="tip"></span> Learn more about references <a class="link" href="../../">here.</a>
- </p>
-</div>
-</div>
-<div class="section">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="phoenix.starter_kit.primitives.arguments"></a><a class="link" href="primitives.html#phoenix.starter_kit.primitives.arguments" title="Arguments">Arguments</a>
-</h4></div></div></div>
-<p>
- Arguments are also functions? You bet!
- </p>
-<p>
- Until now, we have been dealing with expressions returning a nullary function.
- Arguments, on the other hand, evaluate to an N-ary function. An argument
- represents the Nth argument. There are a few predefined arguments arg1,
- arg2, arg3, arg4 and so on (and it's BLL
- counterparts: _1, _2, _3, _4 and so on). Examples:
- </p>
-<pre class="programlisting"><span class="identifier">arg1</span> <span class="comment">// one-or-more argument function that returns its first argument
-</span><span class="identifier">arg2</span> <span class="comment">// two-or-more argument function that returns its second argument
-</span><span class="identifier">arg3</span> <span class="comment">// three-or-more argument function that returns its third argument
-</span></pre>
-<p>
- <code class="computeroutput"><span class="identifier">argN</span></code> returns the Nth argument.
- Examples:
- </p>
-<pre class="programlisting"><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">3</span><span class="special">;</span>
-<span class="keyword">char</span> <span class="keyword">const</span><span class="special">*</span> <span class="identifier">s</span> <span class="special">=</span> <span class="string">"Hello World"</span><span class="special">;</span>
-<span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special"><<</span> <span class="identifier">arg1</span><span class="special">(</span><span class="identifier">i</span><span class="special">)</span> <span class="special"><<</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span> <span class="comment">// prints 3
-</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special"><<</span> <span class="identifier">arg2</span><span class="special">(</span><span class="identifier">i</span><span class="special">,</span> <span class="identifier">s</span><span class="special">)</span> <span class="special"><<</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span> <span class="comment">// prints "Hello World"
-</span></pre>
-<p>
- (See arguments.cpp)
- </p>
-<div class="sidebar">
-<div class="titlepage"></div>
-<p>
- <span class="inlinemediaobject"><img src="../../images/tip.png" alt="tip"></span> Learn more about arguments <a class="link" href="../../">here.</a>
- </p>
-</div>
-</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
@@ -192,7 +41,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../starter_kit.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../starter_kit.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="composites.html"><img src="../../images/next.png" alt="Next"></a>
+<a accesskey="p" href="../starter_kit.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../starter_kit.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="primitives/values.html"><img src="../../images/next.png" alt="Next"></a>
</div>
</body>
</html>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/arguments.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/arguments.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/arguments.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,9 +3,9 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Arguments</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../primitives.html" title="Primitives">
<link rel="prev" href="references.html" title="References">
<link rel="next" href="../composites.html" title="Composites">
@@ -16,7 +16,7 @@
<div class="spirit-nav">
<a accesskey="p" href="references.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitives.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="../composites.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="phoenix.starter_kit.primitives.arguments"></a><a class="link" href="arguments.html" title="Arguments">Arguments</a>
</h4></div></div></div>
@@ -47,7 +47,7 @@
(See arguments.cpp)
</p>
<div class="sidebar">
-<div class="titlepage"></div>
+<p class="title"><b></b></p>
<p>
<span class="inlinemediaobject"><img src="../../../images/tip.png" alt="tip"></span> Learn more about arguments <a class="link" href="../../../">here.</a>
</p>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/references.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/references.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/references.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,9 +3,9 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>References</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../primitives.html" title="Primitives">
<link rel="prev" href="values.html" title="Values">
<link rel="next" href="arguments.html" title="Arguments">
@@ -16,7 +16,7 @@
<div class="spirit-nav">
<a accesskey="p" href="values.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitives.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="arguments.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="phoenix.starter_kit.primitives.references"></a><a class="link" href="references.html" title="References">References</a>
</h4></div></div></div>
@@ -45,7 +45,7 @@
(See references.cpp)
</p>
<div class="sidebar">
-<div class="titlepage"></div>
+<p class="title"><b></b></p>
<p>
<span class="inlinemediaobject"><img src="../../../images/tip.png" alt="tip"></span> Learn more about references <a class="link" href="../../../">here.</a>
</p>
Modified: sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/values.html
==============================================================================
--- sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/values.html (original)
+++ sandbox/SOC/2010/phoenix3/libs/phoenix/doc/html/phoenix/starter_kit/primitives/values.html 2011-01-19 06:08:18 EST (Wed, 19 Jan 2011)
@@ -3,9 +3,9 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Values</title>
-<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
-<link rel="home" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../../index.html" title="Chapter 1. Phoenix 3.0">
<link rel="up" href="../primitives.html" title="Primitives">
<link rel="prev" href="../primitives.html" title="Primitives">
<link rel="next" href="references.html" title="References">
@@ -16,7 +16,7 @@
<div class="spirit-nav">
<a accesskey="p" href="../primitives.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitives.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="references.html"><img src="../../../images/next.png" alt="Next"></a>
</div>
-<div class="section">
+<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="phoenix.starter_kit.primitives.values"></a><a class="link" href="values.html" title="Values">Values</a>
</h4></div></div></div>
@@ -33,7 +33,7 @@
World"</span></code>.
</p>
<a name="phoenix.starter_kit.primitives.values.lazy_evaluation"></a><h6>
-<a name="id3193586"></a>
+<a name="id2773495"></a>
<a class="link" href="values.html#phoenix.starter_kit.primitives.values.lazy_evaluation">Lazy
Evaluation</a>
</h6>
@@ -51,7 +51,7 @@
(See values.cpp)
</p>
<div class="sidebar">
-<div class="titlepage"></div>
+<p class="title"><b></b></p>
<p>
<span class="inlinemediaobject"><img src="../../../images/tip.png" alt="tip"></span> Learn more about values <a class="link" href="../../../">here.</a>
</p>
@@ -66,7 +66,7 @@
anything and defers the evaluation for later.
</p>
<a name="phoenix.starter_kit.primitives.values.callbacks"></a><h6>
-<a name="id3193850"></a>
+<a name="id2823616"></a>
<a class="link" href="values.html#phoenix.starter_kit.primitives.values.callbacks">Callbacks</a>
</h6>
<p>
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