Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r56190 - in branches/release/libs/spirit/doc/html: . spirit spirit/abstracts spirit/karma spirit/karma/performance_measurements spirit/karma/performance_measurements/numeric_performance spirit/karma/quick_reference spirit/karma/quick_reference/primitive_generators spirit/karma/reference spirit/karma/reference/auxiliary spirit/karma/reference/binary spirit/karma/reference/char spirit/karma/reference/directive spirit/karma/reference/generator_concepts spirit/karma/reference/numeric spirit/karma/reference/operator spirit/karma/reference/stream spirit/karma/reference/string spirit/karma/tutorials spirit/lex spirit/lex/abstracts spirit/lex/abstracts/lexer_primitives spirit/lex/quick_reference spirit/lex/reference spirit/lex/reference/lexer_concepts spirit/lex/reference/primitives spirit/lex/tutorials spirit/notes spirit/qi spirit/qi/quick_reference spirit/qi/quick_reference/qi_parsers spirit/qi/reference spirit/qi/reference/auxiliary spirit/qi/reference/binary spirit/qi/reference/char spirit/qi/reference/directive spirit/qi/reference/numeric spirit/qi/reference/operator spirit/qi/reference/parser_concepts spirit/qi/reference/string spirit/qi/tutorials spirit/structure spirit/support
From: hartmut.kaiser_at_[hidden]
Date: 2009-09-14 12:52:02

Author: hkaiser
Date: 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
New Revision: 56190
URL: http://svn.boost.org/trac/boost/changeset/56190

Log:
Spirit: replacing docs
Added:
   branches/release/libs/spirit/doc/html/spirit/abstracts/
   branches/release/libs/spirit/doc/html/spirit/abstracts.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/abstracts/parsing_expression_grammar.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/abstracts/syntax_diagram.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/acknowledgments.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/faq.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/introduction.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/
   branches/release/libs/spirit/doc/html/spirit/karma.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/
   branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/
   branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/double_performance.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/format_performance.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/int_performance.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/common_notation.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/compound_attribute_rules.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/non_terminals.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/phoenix.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/auxiliary.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/binary.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/char.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/directives.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/operators.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/real_number.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/signed_int.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/stream.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/string.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/unsigned_int.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/semantic_actions.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/
   branches/release/libs/spirit/doc/html/spirit/karma/reference.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/
   branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/eol.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/eps.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/lazy.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/
   branches/release/libs/spirit/doc/html/spirit/karma/reference/binary.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/binary_big.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/binary_little.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/binary_native.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/char/
   branches/release/libs/spirit/doc/html/spirit/karma/reference/char.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/char/char_class.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/char/char_generator.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/
   branches/release/libs/spirit/doc/html/spirit/karma/reference/directive.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/alignment.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/buffer.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/delimit.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/maxwidth.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/omit.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/repeat.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/upperlower.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/
   branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/binarygenerator.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/generator.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/narygenerator.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/primitivegenerator.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/unarygenerator.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/karma_basics.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/
   branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/real_number.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/signed_int.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/unsigned_int.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/alternative.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/and_predicate.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/kleene.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/list.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/not_predicate.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/optional.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/plus.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/sequence.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/stream/
   branches/release/libs/spirit/doc/html/spirit/karma/reference/stream.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/stream/stream.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/string/
   branches/release/libs/spirit/doc/html/spirit/karma/reference/string.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/reference/string/string.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/tutorials/
   branches/release/libs/spirit/doc/html/spirit/karma/tutorials.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/tutorials/karma_attributes.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/tutorials/karma_complex.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/tutorials/karma_easier_complex.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/tutorials/quick_start.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/tutorials/semantic_actions.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/karma/tutorials/warming_up.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/
   branches/release/libs/spirit/doc/html/spirit/lex.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_attributes.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_parsing.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_primitives.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_token_definition.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_token_values.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_semantic_actions.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_states.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_static_model.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_tokenizing.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/lexer_introduction.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/
   branches/release/libs/spirit/doc/html/spirit/lex/quick_reference.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/common_notation.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/lexers.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/phoenix.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/semantic_actions.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/
   branches/release/libs/spirit/doc/html/spirit/lex/reference.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/lex_basics.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/
   branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/lexer.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/narylexer.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/primitivelexer.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/unarylexer.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/primitives/
   branches/release/libs/spirit/doc/html/spirit/lex/reference/primitives.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/primitives/char_tokendef.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/token.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/reference/tokendef.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/tutorials/
   branches/release/libs/spirit/doc/html/spirit/lex/tutorials.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart1.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart2.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart3.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_tutorials.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/notes/
   branches/release/libs/spirit/doc/html/spirit/notes.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/notes/porting_from_spirit_1_8_x.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/notes/style_guide.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/preface.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/
   branches/release/libs/spirit/doc/html/spirit/qi.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/common_notation.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/compound_attribute_rules.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/non_terminals.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/phoenix.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/action.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/auxiliary.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/binary.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/char.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/directive.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/numeric.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/operator.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/string.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/semantic_actions.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/
   branches/release/libs/spirit/doc/html/spirit/qi/reference.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/
   branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/attr.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eoi.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eol.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eps.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/lazy.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/basics.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/
   branches/release/libs/spirit/doc/html/spirit/qi/reference/binary.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/binary_big.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/binary_little.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/binary_native.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/char/
   branches/release/libs/spirit/doc/html/spirit/qi/reference/char.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/char/char.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/char/char_class.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/
   branches/release/libs/spirit/doc/html/spirit/qi/reference/directive.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/lexeme.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/no_case.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/omit.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/raw.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/repeat.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/skip.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/
   branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/int.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/real.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/uint.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/alternative.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/and_predicate.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/difference.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/expect.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/kleene.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/list.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/not_predicate.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/optional.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/permutation.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/plus.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/sequence.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/sequential_or.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/
   branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/binaryparser.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/naryparser.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/parser.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/primitiveparser.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/unaryparser.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/string/
   branches/release/libs/spirit/doc/html/spirit/qi/reference/string.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/string/string.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/reference/string/symbols.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/complex___our_first_complex_parser.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/employee___parsing_into_structs.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/mini_xml___asts_.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/mini_xml___error_handling.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/number_list___stuffing_numbers_into_a_std__vector.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/number_list_attribute___one_more__with_style.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/number_list_redux___list_syntax.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/quick_start.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/roman_numerals.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/semantic_actions.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/sum___adding_numbers.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/qi/tutorials/warming_up.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/references.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/repository.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/structure/
   branches/release/libs/spirit/doc/html/spirit/structure.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/structure/include.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/support/
   branches/release/libs/spirit/doc/html/spirit/support.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/support/multi_pass.html (contents, props changed)
   branches/release/libs/spirit/doc/html/spirit/what_s_new.html (contents, props changed)
Text files modified:
   branches/release/libs/spirit/doc/html/index.html | 552 +++++++++------------------------------
   1 files changed, 130 insertions(+), 422 deletions(-)

Modified: branches/release/libs/spirit/doc/html/index.html
==============================================================================
--- branches/release/libs/spirit/doc/html/index.html (original)
+++ branches/release/libs/spirit/doc/html/index.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -1,11 +1,11 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Spirit 2.0</title>
+<title>Spirit 2.1</title>
<link rel="stylesheet" href="../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.66.1">
-<link rel="start" href="index.html" title="Spirit 2.0">
-<link rel="next" href="spirit/what_s_new.html" title="What's New">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="index.html" title="Spirit 2.1">
+<link rel="next" href="spirit/preface.html" title="Preface">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -17,12 +17,12 @@
<td align="center">More</td>
</tr></table>
<hr>
-<div class="spirit-nav"><a accesskey="n" href="spirit/what_s_new.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a></div>
-<div class="article" lang="en">
+<div class="spirit-nav"><a accesskey="n" href="spirit/preface.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a></div>
+<div class="article" title="Spirit 2.1">
<div class="titlepage">
<div>
<div><h2 class="title">
-<a name="spirit"></a>Spirit 2.0</h2></div>
+<a name="spirit"></a>Spirit 2.1</h2></div>
<div><div class="authorgroup">
<div class="author"><h3 class="author">
Joel de Guzman
@@ -31,10 +31,10 @@
Hartmut Kaiser
</h3></div>
</div></div>
-<div>Copyright © 2001-2008 Joel de Guzman,
- Hartmut Kaiser</div>
-<div><div class="legalnotice">
-<a name="id386666"></a>
+<div>Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser</div>
+<div><div class="legalnotice" title="Legal Notice">
+<a name="id585949"></a>
 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)
 
@@ -45,81 +45,117 @@
<div class="toc">
Table of Contents
<dl>
-<dt>Preface</dt>
+<dt>Preface</dt>
<dt>What's New</dt>
<dt>Introduction</dt>
-<dt>Qi and Karma</dt>
-<dd><dl>
-<dt>Tutorials</dt>
-<dd><dl>
-<dt>Quick Start</dt>
-<dt>Warming up</dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.semantic_actions">Semantic
- Actions</a></dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.complex___our_first_complex_parser">Complex
+<dt>Structure</dt>
+<dd><dl><dt>Include</dt></dl></dd>
+<dt>Abstracts</dt>
+<dd><dl>
+<dt>Syntax Diagram</dt>
+<dt><a href="spirit/abstracts/parsing_expression_grammar.html">Parsing
+ Expression Grammar</a></dt>
+</dl></dd>
+<dt> Qi - Writing Parsers</dt>
+<dd><dl>
+<dt>Tutorials</dt>
+<dd><dl>
+<dt>Quick Start</dt>
+<dt>Warming up</dt>
+<dt>Semantic Actions</dt>
+<dt><a href="spirit/qi/tutorials/complex___our_first_complex_parser.html">Complex
 - Our first complex parser</a></dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.sum___adding_numbers">Sum
- - adding numbers</a></dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.number_list___stuffing_numbers_into_a_std__vector">Number
+<dt><a href="spirit/qi/tutorials/sum___adding_numbers.html">Sum - adding
+ numbers</a></dt>
+<dt><a href="spirit/qi/tutorials/number_list___stuffing_numbers_into_a_std__vector.html">Number
 List - stuffing numbers into a std::vector</a></dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.number_list_redux___list_syntax">Number
+<dt><a href="spirit/qi/tutorials/number_list_redux___list_syntax.html">Number
 List Redux - list syntax</a></dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.number_list_attribute___one_more__with_style">Number
+<dt><a href="spirit/qi/tutorials/number_list_attribute___one_more__with_style.html">Number
 List Attribute - one more, with style</a></dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.roman_numerals">Roman
- Numerals</a></dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.employee___parsing_into_structs">Employee
+<dt>Roman Numerals</dt>
+<dt><a href="spirit/qi/tutorials/employee___parsing_into_structs.html">Employee
 - Parsing into structs</a></dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.mini_xml___asts_">Mini
- XML - ASTs!</a></dt>
-<dt><a href="spirit/qi_and_karma.html#spirit.qi_and_karma.tutorials.mini_xml___error_handling">Mini
+<dt>Mini XML - ASTs!</dt>
+<dt><a href="spirit/qi/tutorials/mini_xml___error_handling.html">Mini
 XML - Error Handling</a></dt>
</dl></dd>
-<dt>Abstracts</dt>
+<dt>Quick Reference</dt>
<dd><dl>
-<dt><a href="spirit/qi_and_karma/abstracts.html#spirit.qi_and_karma.abstracts.parsing_expression_grammar">Parsing
- Expression Grammar</a></dt>
-<dt>Parsing</dt>
-<dt><a href="spirit/qi_and_karma/abstracts/parsing_and_generating.html">Parsing
- and Generating</a></dt>
-<dt>Primitives</dt>
-<dt>Operators</dt>
-<dt>Attributes</dt>
-<dt><a href="spirit/qi_and_karma/abstracts/semantic_actions.html">Semantic
+<dt>Common Notation</dt>
+<dt>Qi Parsers</dt>
+<dt><a href="spirit/qi/quick_reference/compound_attribute_rules.html">Compound
+ Attribute Rules</a></dt>
+<dt>Non-terminals</dt>
+<dt><a href="spirit/qi/quick_reference/semantic_actions.html">Semantic
 Actions</a></dt>
-<dt>Directives</dt>
-<dt>Rules</dt>
-<dt>Grammars</dt>
-<dt>Debugging</dt>
-<dt><a href="spirit/qi_and_karma/abstracts/mini_xml___error_handling.html">Mini
- XML - Error Handling</a></dt>
-<dt><a href="spirit/qi_and_karma/abstracts/parse_trees_and_asts.html">Parse
- Trees and ASTs</a></dt>
+<dt>Phoenix</dt>
</dl></dd>
-<dt>Quick Reference</dt>
-<dt>Reference</dt>
+<dt>Reference</dt>
<dd><dl>
-<dt>Concepts</dt>
-<dt>Char</dt>
-<dt>String</dt>
-<dt>Numeric</dt>
-<dt>Binary</dt>
-<dt>Directive</dt>
-<dt>Action</dt>
-<dt>Nonterminal</dt>
-<dt>Operators</dt>
-<dt>Stream</dt>
-<dt>Auxiliary</dt>
-<dt>Debug</dt>
+<dt>Parser Concepts</dt>
+<dt>Basics</dt>
+<dt>Auxiliary</dt>
+<dt> Binary</dt>
+<dt>Char</dt>
+<dt> Directive</dt>
+<dt>Numeric</dt>
+<dt>Operator</dt>
+<dt>String</dt>
+</dl></dd>
+</dl></dd>
+<dt> Karma - Writing Generators</dt>
+<dd><dl>
+<dt>Tutorials</dt>
+<dd><dl>
+<dt>Quick Start</dt>
+<dt>Warming up</dt>
+<dt>Semantic Actions</dt>
+<dt><a href="spirit/karma/tutorials/karma_complex.html"> Complex - A
+ first more complex generator</a></dt>
+<dt><a href="spirit/karma/tutorials/karma_attributes.html"> Understanding
+ Generator Attributes</a></dt>
+<dt><a href="spirit/karma/tutorials/karma_easier_complex.html"> Complex
+ - Made easier</a></dt>
+</dl></dd>
+<dt>Quick Reference</dt>
+<dd><dl>
+<dt><a href="spirit/karma/quick_reference/common_notation.html">Common
+ Notation</a></dt>
+<dt><a href="spirit/karma/quick_reference/primitive_generators.html">
+ Karma Generators</a></dt>
+<dt><a href="spirit/karma/quick_reference/compound_attribute_rules.html">Compound
+ Attribute Rules</a></dt>
+<dt>Non-terminals</dt>
+<dt><a href="spirit/karma/quick_reference/semantic_actions.html">Semantic
+ Actions</a></dt>
+<dt>Phoenix</dt>
</dl></dd>
+<dt>Reference</dt>
+<dd><dl>
+<dt><a href="spirit/karma/reference/generator_concepts.html">Generator
+ Concepts</a></dt>
+<dt> Basics</dt>
+<dt> Char</dt>
+<dt>String</dt>
+<dt> Numeric</dt>
+<dt>Stream</dt>
+<dt> Binary</dt>
+<dt>Auxiliary</dt>
+<dt> Directive</dt>
+<dt>Operator</dt>
+</dl></dd>
+<dt>Performance Measurements</dt>
+<dd><dl><dt><a href="spirit/karma/performance_measurements/numeric_performance.html">
+ Performance of Numeric Generators</a></dt></dl></dd>
</dl></dd>
-<dt> Spirit.Lex</dt>
+<dt> Lex - Writing Lexical Analyzers</dt>
<dd><dl>
-<dt> Introduction to Spirit.Lex</dt>
+<dt> Introduction to Spirit.Lex</dt>
<dt><a href="spirit/lex/tutorials.html"> Spirit.Lex
 Tutorials</a></dt>
<dd><dl>
-<dt><a href="spirit/lex/tutorials.html#spirit.lex.tutorials.lexer_tutorials"> Spirit.Lex
+<dt><a href="spirit/lex/tutorials/lexer_tutorials.html"> Spirit.Lex
 Tutorials Overview</a></dt>
<dt><a href="spirit/lex/tutorials/lexer_quickstart1.html"> Quickstart
 1 - A word counter using Spirit.Lex</a></dt>
@@ -130,7 +166,7 @@
</dl></dd>
<dt> Abstracts</dt>
<dd><dl>
-<dt>Lexer Primitives</dt>
+<dt>Lexer Primitives</dt>
<dt><a href="spirit/lex/abstracts/lexer_tokenizing.html"> Tokenizing
 Input Data</a></dt>
<dt><a href="spirit/lex/abstracts/lexer_semantic_actions.html"> Lexer
@@ -143,379 +179,51 @@
<dt> Lexer States</dt>
</dl></dd>
<dt> Quick Reference</dt>
+<dd><dl>
+<dt><a href="spirit/lex/quick_reference/common_notation.html">Common
+ Notation</a></dt>
+<dt><a href="spirit/lex/quick_reference/lexers.html"> Primitive Lexer
+ Components</a></dt>
+<dt><a href="spirit/lex/quick_reference/semantic_actions.html">Semantic
+ Actions</a></dt>
+<dt>Phoenix</dt>
+</dl></dd>
<dt> Reference</dt>
<dd><dl>
-<dt> Concepts</dt>
-<dt>Lexer Class</dt>
-<dt>Token Class</dt>
-<dt>TokenDef Class</dt>
-<dt>TokenSet Class</dt>
+<dt> Lexer Concepts</dt>
+<dt> Basics</dt>
+<dt><a href="spirit/lex/reference/primitives.html"> Token definition
+ Primitives</a></dt>
+<dt> Lexer Class</dt>
+<dt> Token Class</dt>
+<dt> TokenDef Class</dt>
</dl></dd>
</dl></dd>
-<dt>FAQ</dt>
+<dt> Supporting libraries</dt>
+<dd><dl><dt> The multi pass iterator</dt></dl></dd>
+<dt> Spirit FAQ</dt>
<dt>Notes</dt>
<dd><dl>
-<dt>Portability</dt>
<dt><a href="spirit/notes/porting_from_spirit_1_8_x.html">Porting from
 Spirit 1.8.x</a></dt>
<dt>Style Guide</dt>
-<dt>Techniques</dt>
</dl></dd>
-<dt>Rationale</dt>
+<dt> Spirit Repository</dt>
<dt>Acknowledgments</dt>
<dt>References</dt>
</dl>
</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="spirit.preface"></a>Preface</h2></div></div></div>
-<div class="blockquote"><blockquote class="blockquote">
-
- 
-
- “Examples of designs that meet most of the criteria for
- "goodness" (easy to understand, flexible, efficient) are a recursive-
- descent parser, which is traditional procedural code. Another example is
- the STL, which is a generic library of containers and algorithms depending
- crucially on both traditional procedural code and on parametric polymorphism.”
- --Bjarne Stroustrup
- 
-
- 
-</blockquote></div>
-<a name="spirit.preface.history"></a><h3>
-<a name="id388764"></a>
- History
- </h3>
-<a name="spirit.preface._emphasis_80s__emphasis_"></a><h3>
-<a name="id386336"></a>
- 80s
- </h3>
-
- In the Mid 80s, Joel wrote his first calculator in Pascal. It has been an unforgettable
- coding experience. He was amazed how a mutually recursive set of functions
- can model a grammar specification. In time, the skills he acquired from that
- academic experience became very practical. Periodically Joel was tasked to
- do some parsing. For instance, whenever he needs to perform any form of I/O,
- even in binary, he tries to approach the task somewhat formally by writing
- a grammar using Pascal- like syntax diagrams and then write a corresponding
- recursive-descent parser. This worked very well.
- 
-<a name="spirit.preface._emphasis_90s__emphasis_"></a><h3>
-<a name="id386375"></a>
- 90s
- </h3>
-
- The arrival of the Internet and the World Wide Web magnified this thousand-fold.
- At one point Joel had to write an HTML parser for a Web browser project. He
- got a recursive-descent HTML parser working based on the W3C formal specifications
- easily. He was certainly glad that HTML had a formal grammar specification.
- Because of the influence of the Internet, Joel then had to do more parsing.
- RFC specifications were everywhere. SGML, HTML, XML, even email addresses and
- those seemingly trivial URLs were all formally specified using small EBNF-
- style grammar specifications. This made him wish for a tool similar to big-
- time parser generators such as YACC and ANTLR, where a parser is built automatically
- from a grammar specification. Yet, he wants it to be extremely small; small
- enough to fit in my pocket, yet scalable.
- 
-
- It must be able to practically parse simple grammars such as email addresses
- to moderately complex grammars such as XML and perhaps some small to medium-sized
- scripting languages. Scalability is a prime goal. You should be able to use
- it for small tasks such as parsing command lines without incurring a heavy
- payload, as you do when you are using YACC or PCCTS. Even now that it has evolved
- and matured to become a multi-module library, true to its original intent,
- Spirit can still be used for extreme micro-parsing tasks. You only pay for
- features that you need. The power of Spirit comes from its modularity and extensibility.
- Instead of giving you a sledgehammer, it gives you the right ingredients to
- create a sledgehammer easily.
- 

- The result was Spirit. Spirit was a personal project that was conceived when
- Joel was doing R&D in Japan. Inspired by the GoF's composite and interpreter
- patterns, he realized that he can model a recursive-descent parser with hierarchical-object
- composition of primitives (terminals) and composites (productions). The original
- version was implemented with run-time polymorphic classes. A parser is generated
- at run time by feeding in production rule strings such as:
- 
-<pre class="programlisting">"prod ::= {'A' | 'B'} 'C';"
-</pre>
-
- A compile function compiled the parser, dynamically creating a hierarchy of
- objects and linking semantic actions on the fly. A very early text can be found
- here: pre-Spirit.
- 
-<a name="spirit.preface._emphasis_2001_to_2006__emphasis_"></a><h3>
-<a name="id388110"></a>
- <a href="index.html#spirit.preface._emphasis_2001_to_2006__emphasis_">2001
- to 2006</a>
- </h3>
-
- Version 1.0 to 1.8 was a complete rewrite of the original Spirit parser using
- expression templates and static polymorphism, inspired by the works of Todd
- Veldhuizen (<a href="http://ubiety.uwaterloo.ca/~tveldhui/papers/Expression-Templates/exprtmpl.html" target="_top">Expression
- Templates</a>, C++ Report, June 1995). Initially, the static-Spirit version
- was meant only to replace the core of the original dynamic-Spirit. Dynamic-spirit
- needed a parser to implement itself anyway. The original employed a hand-coded
- recursive-descent parser to parse the input grammar specification strings.
- Incidentially it was the time, when Hartmut joined the Spirit development.
- 
-
- After its initial "open-source" debut in May 2001, static-Spirit
- became a success. At around November 2001, the Spirit website had an activity
- percentile of 98%, making it the number one parser tool at Source Forge at
- the time. Not bad for such a niche project such as a parser library. The "static"
- portion of Spirit was forgotten and static-Spirit simply became Spirit. The
- library soon evolved to acquire more dynamic features.
- 
-
- Spirit was formally accepted into Boost
- in October 2002. Boost is a peer-reviewed, open collaborative development effort
- that is a collection of free Open Source C++ libraries covering a wide range
- of domains. The Boost Libraries have become widely known as an industry standard
- for design and implementation quality, robustness, and reusability.
- 
-<a name="spirit.preface._emphasis_2007__emphasis_"></a><h3>
-<a name="id387263"></a>
- 2007
- </h3>
-
- Over the years, especially after Spirit was accepted into Boost, Spirit has
- served its purpose quite admirably. The focus of what we'll now call Classic-Spirit (versions prior
- to 2.0) was on transduction parsing where the input string is merely translated
- to an output string. A lot of parsers are of the transduction type. When the
- time came to add attributes to the parser library, it was done rather in an
- ad-hoc manner, with the goal being 100% backward compatible with classic Spirit.
- Some parsers have attributes, some don't.
- 
-
- Spirit V2 is another major rewrite. Spirit V2 grammars are fully attributed
- (see <a href="http://en.wikipedia.org/wiki/Attribute_grammar" target="_top">Attribute
- Grammar</a>). All parser components have attributes. To do this efficiently
- and ellegantly, we had to use a couple of infrastructure libraries. Some of
- which haven't been written yet at the time, some were quite new when Spirit
- debuted, and some needed work. MPL
- is an important infrastructure library, yet is not sufficient to implement
- Spirit V2. Another library had to be written: Fusion.
- Fusion sits between MPL and STL --between compile time and runtime -- mapping
- types to values. Fusion is a direct descendant of both MPL and Boost.Tuples
- (Fusion is now a full fledged Boost
- library). Phoenix also
- had to be beefed up to support Spirit V2. The result is Phoenix2.
- Last but not least, Spirit V2 uses an <a href="http://ubiety.uwaterloo.ca/~tveldhui/papers/Expression-Templates/exprtmpl.html" target="_top">Expression
- Templates</a> library called -Boost.Proto-.
- 
-<a name="spirit.preface.new_ideas__spirit_v2"></a><h3>
-<a name="id387382"></a>
- New Ideas: Spirit V2
- </h3>
-
- Just before the development of Spirit V2 began, Hartmut came across the StringTemplate library which is
- a part of the ANTLR parser framework. It is a Java template engine (with ports
- for C# and Python) for generating source code, web pages, emails, or any other
- formatted text output. With it, he got the the idea of using a formal notation
- (a grammar) to describe the expected structure of an input character sequence.
- The same grammar may be used to formalize the structure of a corresponding
- output character sequence. This is possible because parsing, most of the time,
- is implemented by comparing the input with the patterns defined by the grammar.
- If we use the same patterns to format a matching output, the generated sequence
- will follow the rules of the grammar as well.
- 
-
- This insight lead to the implementation of a grammar driven output generation
- library compatibile with the Spirit parser library. As it turned out, parsing
- and generation are tightly connected and have very similar concepts. The duality
- of these two sides of the same medal is ubiquitous, which allowed us to build
- the parser library Spirit.Qi and the generator library
- Spirit.Karma using the same component infastructure.
- 
-
- The idea of creating a lexer library well integrated with the Spirit parsers
- is not new. This has been discussed almost for the whole time of the existence
- of Classic-Spirit (pre V2) now. Several attempts to integrate existing lexer
- libraries and frameworks with Spirit have been made and served as a proof of
- concept and usability (for example see Wave:
- The Boost C/C++ Preprocessor Library, and SLex:
- a fully dynamic C++ lexer implemented with Spirit). Based on these experiences
- we added Spirit.Lex: a fully integrated lexer library
- to the mix, allowing to take advantage of the power of regular expressions
- for token matching, removing pressure from the parser components, simplifying
- parser grammars. Again, Spirit's modular structure allowed us to reuse the
- same underlying component library as for the parser and generator libraries.
- 
-<a name="spirit.preface.how_to_use_this_manual"></a><h3>
-<a name="id387485"></a>
- How to use this manual
- </h3>
-
- Each major section (there are two: <a href="spirit/qi_and_karma.html" title="Qi and Karma">Qi and
- Karma</a>, and Lex) is roughly divided
- into 3 parts:
- 
-<div class="orderedlist"><ol type="1">
-<li>
- Tutorials: A step by step guide with heavily annotated code. These are meant
- to get the user acquainted with the library as quickly as possible. The objective
- is to build the confidence of the user in using the library using abundant
- examples and detailed instructions. Examples speak volumes.
- </li>
-<li>
- Abstracts: A high level summary of key topics. The objective is to give the
- user a high level view of the library, the key concepts, background and theories.
- </li>
-<li>
- Reference: Detailed formal technical reference. We start with a quick reference
- -- an easy to use table that maps into the reference proper. The reference
- proper starts with C++ Concepts
- followed by models of the concepts.
- </li>
-</ol></div>
-
- Some icons are used to mark certain topics indicative of their relevance. These
- icons precede some text to indicate:
- 
-<div class="table">
-<a name="id387571"></a>Table 1. Icons
-<table class="table" summary="Icons">
-<colgroup>
-<col>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>
- 
- Icon
- 
- </th>
-<th>
- 
- Name
- 
- </th>
-<th>
- 
- Meaning
- 
- </th>
-</tr></thead>
-<tbody>
-<tr>
-<td>
- 
- <img src="images/note.png" alt="note">
- 
- </td>
-<td>
- 
- Note
- 
- </td>
-<td>
- 
- Generally useful information (an aside that doesn't fit in the flow of
- the text)
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <img src="images/tip.png" alt="tip">
- 
- </td>
-<td>
- 
- Tip
- 
- </td>
-<td>
- 
- Suggestion on how to do something (especially something that not be obvious)
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <img src="images/important.png" alt="important">
- 
- </td>
-<td>
- 
- Important
- 
- </td>
-<td>
- 
- Important note on something to take particular notice of
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <img src="images/caution.png" alt="caution">
- 
- </td>
-<td>
- 
- Caution
- 
- </td>
-<td>
- 
- Take special care with this - it may not be what you expect and may cause
- bad results
- 
- </td>
-</tr>
-<tr>
-<td>
- 
- <img src="images/alert.png" alt="alert">
- 
- </td>
-<td>
- 
- Danger
- 
- </td>
-<td>
- 
- This is likely to cause serious trouble if ignored
- 
- </td>
-</tr>
-</tbody>
-</table>
-</div>
-
- This documentation is automatically generated by Boost QuickBook documentation
- tool. QuickBook can be found in the <a href="http://www.boost.org/tools/index.html" target="_top">Boost
- Tools</a>.
- 
-<a name="spirit.preface.support"></a><h3>
-<a name="id386631"></a>
- Support
- </h3>
-
- Please direct all questions to Spirit's mailing list. You can subscribe to
- the <a href="http://www.nabble.com/The-Spirit-Parser-Library-f3430.html" target="_top">Spirit
- General List</a>. The mailing list has a searchable archive. A search link
- to this archive is provided in Spirit's
- home page. You may also read and post messages to the mailing list through
- <a href="news://news.gmane.org/gmane.comp.spirit.general" target="_top">Spirit General
- NNTP news portal</a> (thanks to Gmane).
- The news group mirrors the mailing list. Here is a link to the archives: http://news.gmane.org/gmane.comp.parsers.spirit.general.
- 
-</div>
+ This is the documentation of the newest version of Spirit
+ (currently, V2.1). If you're looking for the documentation of Spirit's previous
+ version (formerly Spirit V1.8), see Spirit.Classic.
+ 
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left">Last revised: December 23, 2008 at 09:37:55 GMT</td>
+<td align="left">Last revised: September 14, 2009 at 14:47:16 GMT</td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
-<div class="spirit-nav"><a accesskey="n" href="spirit/what_s_new.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a></div>
+<div class="spirit-nav"><a accesskey="n" href="spirit/preface.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a></div>
</body>
</html>

Added: branches/release/libs/spirit/doc/html/spirit/abstracts.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/abstracts.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,49 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Abstracts</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="structure/include.html" title="Include">
+<link rel="next" href="abstracts/syntax_diagram.html" title="Syntax Diagram">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="structure/include.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="abstracts/syntax_diagram.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Abstracts">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.abstracts"></a><a class="link" href="abstracts.html" title="Abstracts">Abstracts</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt>Syntax Diagram</dt>
+<dt><a href="abstracts/parsing_expression_grammar.html">Parsing
+ Expression Grammar</a></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="structure/include.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="abstracts/syntax_diagram.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/abstracts/parsing_expression_grammar.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/abstracts/parsing_expression_grammar.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,231 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Parsing Expression Grammar</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="syntax_diagram.html" title="Syntax Diagram">
+<link rel="next" href="../qi.html" title="Qi - Writing Parsers">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="syntax_diagram.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../qi.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Parsing Expression Grammar">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.abstracts.parsing_expression_grammar"></a><a class="link" href="parsing_expression_grammar.html" title="Parsing Expression Grammar">Parsing
+ Expression Grammar</a>
+</h3></div></div></div>
+
+ Parsing Expression Grammars (PEG)
+ [<a name="id595910" href="#ftn.id595910" class="footnote">5</a>]
+ are a derivative of Extended Backus-Naur Form (EBNF)
+ [<a name="id595922" href="#ftn.id595922" class="footnote">6</a>]
+ with a different interpretation, designed to represent a recursive descent
+ parser. A PEG can be directly represented as a recursive-descent parser.
+ 
+
+ Like EBNF, PEG is a formal grammar for describing a formal language in terms
+ of a set of rules used to recognize strings of this language. Unlike EBNF,
+ PEGs have an exact interpretation. There is only one valid parse tree (see
+ Abstract Syntax Tree) for each PEG grammar.
+ 
+<a name="spirit.abstracts.parsing_expression_grammar.sequences"></a><h5>
+<a name="id595942"></a>
+ <a class="link" href="parsing_expression_grammar.html#spirit.abstracts.parsing_expression_grammar.sequences">Sequences</a>
+ </h5>
+
+ Sequences are represented by juxtaposition like in EBNF:
+ 
+<pre class="programlisting">a b
+</pre>
+
+ The PEG expression above states that, in order for this to succeed, <code class="computeroutput">a</code> must follow <code class="computeroutput">b</code>.
+ Here's the syntax diagram:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/sequence.png" alt="sequence">
+ 
+
+ 
+</blockquote></div>
+
+ Here's a trivial example:
+ 
+<pre class="programlisting">'x' digit
+</pre>
+
+ which means the character <code class="computeroutput">x</code>
+ must be followed by a digit.
+ 
+<div class="note" title="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">
+ In Spirit.Qi, we use the <code class="computeroutput">>></code>
+ for sequences since C++ does not allow juxtaposition
+ </td></tr>
+</table></div>
+<a name="spirit.abstracts.parsing_expression_grammar.alternatives"></a><h5>
+<a name="id596060"></a>
+ <a class="link" href="parsing_expression_grammar.html#spirit.abstracts.parsing_expression_grammar.alternatives">Alternatives</a>
+ </h5>
+
+ Alternatives are represented in PEG using the slash:
+ 
+<pre class="programlisting">a / b
+</pre>
+<div class="note" title="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">
+ In Spirit.Qi, we use the <code class="computeroutput">|</code>
+ for alternatives just as in EBNF
+ </td></tr>
+</table></div>
+
+ Alternatives allow for choices. The expression above reads: try to match
+ <code class="computeroutput">a</code>. If <code class="computeroutput">a</code>
+ succeeds, success, if not try to match <code class="computeroutput">b</code>.
+ This is a bit of a deviation from the usual EBNF interpretation where you
+ simply match <code class="computeroutput">a</code> or <code class="computeroutput">b</code>.
+ Here's the syntax diagram:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/alternative.png" alt="alternative">
+ 
+
+ 
+</blockquote></div>
+
+ PEGs allow for ambiguity in the alternatives. In the expression above, both
+ <code class="computeroutput">a</code> or <code class="computeroutput">b</code>
+ can both match an input string. However, only the first matching alternative
+ is valid. As noted, there can only be one valid parse tree ($$$ explain more
+ about this $$$).
+ 
+<a name="spirit.abstracts.parsing_expression_grammar.loops"></a><h5>
+<a name="id596199"></a>
+ <a class="link" href="parsing_expression_grammar.html#spirit.abstracts.parsing_expression_grammar.loops">Loops</a>
+ </h5>
+
+ Again, like EBNF, PEG uses the regular-expression Kleene star and the plus
+ loops:
+ 
+<pre class="programlisting">a*
+a+
+</pre>
+<div class="note" title="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">
+ Spirit.Qi uses the prefix star and plus since there is no postfix star
+ or plus in C++.
+ </td></tr>
+</table></div>
+
+ Here are the syntax diagrams:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/kleene.png" alt="kleene">
+ 
+
+ 
+</blockquote></div>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/plus.png" alt="plus">
+ 
+
+ 
+</blockquote></div>
+
+ The first, called the Kleene star, matches zero or more of its subject <code class="computeroutput">a</code>. The second, plus, matches one ore more
+ of its subject <code class="computeroutput">a</code>.
+ 
+
+ Unlike EBNF, PEGs have greedy loops. It will match as much as it can until
+ its subject fails to match without regard to what follows. The following
+ is a classic example of a fairly common EBNF/reg-ex expression failing to
+ match in PEG:
+ 
+<pre class="programlisting">alnum* digit
+</pre>
+
+ In PEG, alnum will eat as much alpha-numeric characters as it can leaving
+ nothing more left behind. Thus, the trailing digit will get nothing. Loops
+ are simply implemented in recursive descent code as for/while loops making
+ them extremely efficient. That is a definite advantage. On the other hand,
+ those who are familiar with EBNF and regex behavior might find the behavior
+ a major gotcha. PEG provides a couple of other mechanisms to circumvent this.
+ We will see more of these other mechanisms shortly.
+ 
+<a name="spirit.abstracts.parsing_expression_grammar.difference"></a><h5>
+<a name="id596886"></a>
+ <a class="link" href="parsing_expression_grammar.html#spirit.abstracts.parsing_expression_grammar.difference">Difference</a>
+ </h5>
+
+ In certain cases, you may want to restrict a certain expression. You can
+ think of a PEG expression as a match for a potentially infinite set of strings.
+ The difference operator allows you to restrict this set:
+ 
+<pre class="programlisting">a - b
+</pre>
+
+ The expression reads: match <code class="computeroutput">a</code>
+ but not <code class="computeroutput">b</code>.
+ 
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a name="ftn.id595910" href="#id595910" class="para">5</a>] 
+ Bryan Ford: Parsing Expression Grammars: A Recognition-Based Syntactic
+ Foundation, http://pdos.csail.mit.edu/~baford/packrat/popl04/
+ </div>
+<div class="footnote">[<a name="ftn.id595922" href="#id595922" class="para">6</a>] 
+ Richard E. Pattis: EBNF: A Notation to Describe Syntax, http://www.cs.cmu.edu/~pattis/misc/ebnf.pdf
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="syntax_diagram.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../qi.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/abstracts/syntax_diagram.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/abstracts/syntax_diagram.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,240 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Syntax Diagram</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="../abstracts.html" title="Abstracts">
+<link rel="next" href="parsing_expression_grammar.html" title="Parsing Expression Grammar">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../abstracts.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="parsing_expression_grammar.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Syntax Diagram">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.abstracts.syntax_diagram"></a><a class="link" href="syntax_diagram.html" title="Syntax Diagram">Syntax Diagram</a>
+</h3></div></div></div>
+
+ In the next section, we will deal with Parsing Expression Grammars (PEG)
+ [<a name="id595483" href="#ftn.id595483" class="footnote">2</a>]
+ , a variant of Extended Backus-Naur Form (EBNF)
+ [<a name="id595495" href="#ftn.id595495" class="footnote">3</a>]
+ with a different interpretation. It is easier to understand PEG using Syntax
+ Diagrams. Syntax diagrams represent a grammar graphically. It was used extensibly
+ by Niklaus Wirth
+ [<a name="id595507" href="#ftn.id595507" class="footnote">4</a>]
+ in the "Pascal User Manual". Syntax Diagrams are easily understandable
+ with programmers due to its similarity to flow charts. The isomorphism of
+ the diagrams and functions make it ideal for representing Recursive Descent
+ parsers which are essentially mutually recursive functions.
+ 
+<a name="spirit.abstracts.syntax_diagram.elements"></a><h5>
+<a name="id595519"></a>
+ <a class="link" href="syntax_diagram.html#spirit.abstracts.syntax_diagram.elements">Elements</a>
+ </h5>
+
+ All diagrams have one entry and exit point. Arrows connect all possible paths
+ through the grammar from the entry point to the exit point.
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/start_stop.png" alt="start_stop">
+ 
+
+ 
+</blockquote></div>
+
+ Terminals are represented by round boxes. Terminals are atomic and usually
+ represent plain characters, strings or tokens.
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/terminal.png" alt="terminal">
+ 
+
+ 
+</blockquote></div>
+
+ Non-terminals are represented by boxes. Diagrams are modularized using named
+ non-terminals. A complex diagram can be broken down into a set of non-terminals.
+ Non-terminals also allow recursion (i.e. a non-terminal can call itself).
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/non-terminal.png" alt="non-terminal">
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.abstracts.syntax_diagram.constructs"></a><h5>
+<a name="id595618"></a>
+ <a class="link" href="syntax_diagram.html#spirit.abstracts.syntax_diagram.constructs">Constructs</a>
+ </h5>
+
+ The most basic composition is the Sequence. B follows A:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/sequence.png" alt="sequence">
+ 
+
+ 
+</blockquote></div>
+
+ The ordered choice, henceforth we will call alternatives.
+ In PEG, ordered choice and alternatives are not quite the same. PEG allows
+ ambiguity of choice where one or more branches can succeed. In PEG, in case
+ of ambiguity, the first one always wins.
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/alternative.png" alt="alternative">
+ 
+
+ 
+</blockquote></div>
+
+ The optional (zero-or-one):
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/optional.png" alt="optional">
+ 
+
+ 
+</blockquote></div>
+
+ Now, the loops. We have the zero-or-more and one-or-more:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/kleene.png" alt="kleene">
+ 
+
+ 
+</blockquote></div>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/plus.png" alt="plus">
+ 
+
+ 
+</blockquote></div>
+
+ Take note that, as in PEG, these loops behave greedily. If there is another
+ 'A' just before the end-point, it will always fail because the preceding
+ loop has already exhausted all 'A's and there is nothing more left. This
+ is a crucial difference between PEG and general Context Free Grammars (CFGs).
+ This behavior is quite obvious with syntax diagrams as they resemble flow-charts.
+ 
+<a name="spirit.abstracts.syntax_diagram.predicates"></a><h5>
+<a name="id595779"></a>
+ <a class="link" href="syntax_diagram.html#spirit.abstracts.syntax_diagram.predicates">Predicates</a>
+ </h5>
+
+ Now, the following are Syntax Diagram versions of PEG predicates. These are
+ not traditionally found in Syntax Diagrams. These are special extensions
+ we invented to closely follow PEGs.
+ 
+
+ First, we introduce a new element, the Predicate:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/predicate.png" alt="predicate">
+ 
+
+ 
+</blockquote></div>
+
+ This is similar to the conditionals in flow charts where the 'No' branch
+ is absent and always signals a failed parse.
+ 
+
+ We have two versions of the predicate, the And-Predicate
+ and the Not-Predicate:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/and_predicate.png" alt="and_predicate">
+ 
+
+ 
+</blockquote></div>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../images/not_predicate.png" alt="not_predicate">
+ 
+
+ 
+</blockquote></div>
+
+ The And-Predicate tries the predicate, P, and succeeds
+ if P succeeds, or otherwise fail. The opposite is true with the Not-Predicate.
+ It tries the predicate, P, and fails if P succeeds, or otherwise succeeds.
+ Both versions do a look-ahead but do not consume any input regardless if
+ P succeeds or not.
+ 
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a name="ftn.id595483" href="#id595483" class="para">2</a>] 
+ Bryan Ford: Parsing Expression Grammars: A Recognition-Based Syntactic
+ Foundation, http://pdos.csail.mit.edu/~baford/packrat/popl04/
+ </div>
+<div class="footnote">[<a name="ftn.id595495" href="#id595495" class="para">3</a>] 
+ Richard E. Pattis: EBNF: A Notation to Describe Syntax, http://www.cs.cmu.edu/~pattis/misc/ebnf.pdf
+ </div>
+<div class="footnote">[<a name="ftn.id595507" href="#id595507" class="para">4</a>] 
+ Niklaus Wirth: The Programming Language Pascal. (July 1973)
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../abstracts.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="parsing_expression_grammar.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/acknowledgments.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/acknowledgments.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,240 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Acknowledgments</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="repository.html" title="Spirit Repository">
+<link rel="next" href="references.html" title="References">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="repository.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="references.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Acknowledgments">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.acknowledgments"></a><a class="link" href="acknowledgments.html" title="Acknowledgments">Acknowledgments</a>
+</h2></div></div></div>
+
+ This version of Spirit is a complete rewrite of the classic
+ Spirit many people have been contributing to (see below). But there are a couple
+ of people who already managed to help significantly during this rewrite. We
+ would like to express our special acknowledgement to:
+ 
+
+ Eric Niebler for writing Boost.Proto, without
+ which this rewrite wouldn't have been possible, and helping with examples,
+ advices, and suggestions on how to use Boost.Proto in the best possible way.
+ 
+
+ Ben Hanson for providing us with an early
+ version of his Lexertl library, which is proposed to be included into Boost
+ (as Boost.Lexer), but at the time of this writing the Boost review for this
+ library is still pending.
+ 
+
+ FIXME: Add more people
+ 
+<a name="spirit.acknowledgments.acknowledgements_from_the_spirit_v1__emphasis_classic__emphasis__documentation"></a><h4>
+<a name="id900895"></a>
+ <a class="link" href="acknowledgments.html#spirit.acknowledgments.acknowledgements_from_the_spirit_v1__emphasis_classic__emphasis__documentation">Acknowledgements
+ from the Spirit V1 classic Documentation</a>
+ </h4>
+
+ Special thanks for working on Spirit classic to:
+ 
+
+ Dan Nuffer for his work on lexers, parse trees,
+ ASTs, XML parsers, the multi-pass iterator as well as administering Spirit's
+ site, editing, maintaining the CVS and doing the releases plus a zillion of
+ other chores that were almost taken for granted.
+ 
+
+ Hartmut Kaiser for his work on the C parser,
+ the work on the C/C++ preprocessor, utility parsers, the original port to Intel
+ 5.0, various work on Phoenix, porting to v1.5, the meta-parsers, the grouping-parsers,
+ extensive testing and painstaking attention to details.
+ 
+
+ Martin Wille who improved grammar multi thread
+ safety, contributed the eol_p parser, the dynamic parsers, documentation and
+ for taking an active role in almost every aspect from brainstorming and design
+ to coding. And, as always, helps keep the regression tests for g++ on Linux
+ as green as ever :-).
+ 
+
+ Martijn W. Van Der Lee our Web site administrator
+ and for contributing the RFC821 parser.
+ 
+
+ Giovanni Bajo for last minute tweaks of Spirit
+ 1.8.0 for CodeWarrior 8.3. Actually, I'm ashamed Giovanni was not in this list
+ already. He's done a lot since Spirit 1.5, the first Boost.Spirit release.
+ He's instrumental in the porting of the Spirit iterators stuff to the new Boost
+ Iterators Library (version 2). He also did various bug fixes and wrote some
+ tests here and there.
+ 
+
+ Juan Carlos Arevalo-Baeza (JCAB)* for his
+ work on the C++ parser, the position iterator, ports to v1.5 and keeping the
+ mailing list discussions alive and kicking.
+ 
+
+ Vaclav Vesely, lots of stuff, the no_actions
+ directive, various patches fixes, the distinct parsers, the lazy parser, some
+ phoenix tweaks and add-ons (e.g. new_). Also, *Stefan Slapeta] and wife for
+ editing Vaclav's distinct parser doc.
+ 
+
+ Raghavendra Satish for doing the original
+ v1.3 port to VC++ and his work on Phoenix.
+ 
+
+ Noah Stein for following up and helping Ragav
+ on the VC++ ports.
+ 
+
+ Hakki Dogusan, for his original v1.0 Pascal
+ parser.
+ 
+
+ John (EBo) David for his work on the VM and
+ watching over my shoulder as I code giving the impression of distance eXtreme
+ programming.
+ 
+
+ Chris Uzdavinis for feeding in comments and
+ valuable suggestions as well as editing the documentation.
+ 
+
+ Carsten Stoll, for his work on dynamic parsers.
+ 
+
+ Andy Elvey and his conifer parser.
+ 
+
+ Bruce Florman, who did the original v1.0 port
+ to VC++.
+ 
+
+ Jeff Westfahl for porting the loop parsers
+ to v1.5 and contributing the file iterator.
+ 
+
+ Peter Simons for the RFC date parser example
+ and tutorial plus helping out with some nitty gritty details.
+ 
+
+ Markus Schöpflin for suggesting the end_p parser
+ and lots of other nifty things and his active presence in the mailing list.
+ 
+
+ Doug Gregor for mentoring and his ability
+ to see things that others don't.
+ 
+
+ David Abrahams for giving Joel a job that
+ allows him to still work on Spirit, plus countless advice and help on C++ and
+ specifically template metaprogramming.
+ 
+
+ Aleksey Gurtovoy for his MPL library from
+ which we stole many metaprogramming tricks especially for less conforming compilers
+ such as Borland and VC6/7.
+ 
+
+ Gustavo Guerra for his last minute review
+ of Spirit and constant feedback, plus patches here and there (e.g. proposing
+ the new dot behavior of the real numerics parsers).
+ 
+
+ Nicola Musatti, Paul
+ Snively, Alisdair Meredith and
+ Hugo Duncan for testing and sending in various
+ patches.
+ 
+
+ Steve Rowe for his splendid work on the TSTs
+ that will soon be taken into Spirit.
+ 
+
+ Jonathan de Halleux for his work on actors.
+ 
+
+ Angus Leeming for last minute editing work
+ on the 1.8.0 release documentation, his work on Phoenix and his active presence
+ in the Spirit mailing list.
+ 
+
+ Joao Abecasis for his active presence in the
+ Spirit mailing list, providing user support, participating in the discussions
+ and so on.
+ 
+
+ Guillaume Melquiond for a last minute patch
+ to multi_pass for 1.8.1.
+ 
+
+ Peder Holt for his porting work on Phoenix,
+ Fusion and Spirit to VC6.
+ 
+
+ To Joels wife Mariel who did the graphics in this document.
+ 
+
+ My, there's a lot in this list! And it's a continuing list. We add people to
+ this list everytime. We hope we did not forget anyone. If we missed someone
+ you know who has helped in any way, please inform us.
+ 
+
+ Special thanks also to people who gave feedback and valuable comments, particularly
+ members of Boost and Spirit mailing lists. This includes all those who participated
+ in the review:
+ 
+
+ John Maddock, our review manager, Aleksey Gurtovoy, Andre Hentz,
+ Beman Dawes, Carl Daniel,
+ Christopher Currie, Dan
+ Gohman, Dan Nuffer, Daryle
+ Walker, David Abrahams, David B. Held, Dirk Gerrits,
+ Douglas Gregor, Hartmut
+ Kaiser, Iain K.Hanson, Juan Carlos Arevalo-Baeza, Larry
+ Evans, Martin Wille, Mattias Flodin, Noah Stein,
+ Nuno Lucas, Peter Dimov,
+ Peter Simons, Petr Kocmid,
+ Ross Smith, Scott Kirkwood,
+ Steve Cleary, Thorsten
+ Ottosen, Tom Wenisch, Vladimir Prus
+ 
+
+ Finally thanks to SourceForge for hosting the Spirit project and Boost: a C++
+ community comprised of extremely talented library authors who participate in
+ the discussion and peer review of well crafted C++ libraries.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="repository.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="references.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/faq.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/faq.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,256 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Spirit FAQ</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="support/multi_pass.html" title="The multi pass iterator">
+<link rel="next" href="notes.html" title="Notes">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="support/multi_pass.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="notes.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Spirit FAQ">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.faq"></a><a class="link" href="faq.html" title="Spirit FAQ"> Spirit FAQ</a>
+</h2></div></div></div>
+<a name="spirit.faq.i_m_getting_multiple_symbol_definition_errors_while_using_visual_c____anything_i_could_do_about_that_"></a><h4>
+<a name="id889387"></a>
+ <a class="link" href="faq.html#spirit.faq.i_m_getting_multiple_symbol_definition_errors_while_using_visual_c____anything_i_could_do_about_that_">I'm
+ getting multiple symbol definition errors while using Visual C++. Anything
+ I could do about that?</a>
+ </h4>
+
+ Do you see strange multiple symbol definition linker errors mentioning <code class="computeroutput">boost::mpl::failed</code>
+ and <code class="computeroutput">boost::spirit::qi::rule</code>?
+ Then this FAQ entry might be for you.
+ 
+
+ Boost.Mpl implements
+ a macro <code class="computeroutput">BOOST_MPL_ASSERT_MSG()</code> which essentially is a more powerfull version
+ of static_assert. Unfortunately under certain circumstances using this macro
+ may lead to the aformentioned linker errors.
+ 
+
+ Spirit allows you to define
+ a preprocessor constant disabling the usage of <code class="computeroutput">BOOST_MPL_ASSERT_MSG()</code>, while switching to <code class="computeroutput">BOOST_STATIC_ASSERT()</code> instead. For that you need define BOOST_SPIRIT_DONT_USE_MPL_ASSERT_MSG=1
+ (either by adding
+ 
+<pre class="programlisting">-DBOOST_SPIRIT_DONT_USE_MPL_ASSERT_MSG=1
+</pre>
+
+ on the compiler command line or by inserting a
+ 
+<pre class="programlisting">#define BOOST_SPIRIT_DONT_USE_MPL_ASSERT_MSG 1
+</pre>
+
+ into your code before any spirit headers get included).
+ 
+
+ Using this trick has no adverse effects on any of the functionality of Spirit. The only change you might
+ see while using this workaround are less verbose error messages generated from
+ static_assert.
+ 
+<a name="spirit.faq.i_m_very_confused_about_the_header_hell_in_my_boost_spirit_directory__what_s_all_this_about_"></a><h4>
+<a name="id890241"></a>
+ <a class="link" href="faq.html#spirit.faq.i_m_very_confused_about_the_header_hell_in_my_boost_spirit_directory__what_s_all_this_about_">I'm
+ very confused about the header hell in my boost/spirit directory. What's all
+ this about?</a>
+ </h4>
+
+ The boost/spirit directory currently holds two versions of the Spirit library:
+ Spirit.Classic
+ (former V1.8.x) and SpiritV2. Both are completely independent and usually not
+ used at the same time. Do not mix these two in the same grammar.
+ 
+
+ Spirit.Classic
+ evolved over years in a fairly complex directory structure:
+ 
+<pre class="programlisting">boost/spirit/actor
+boost/spirit/attribute
+boost/spirit/core
+boost/spirit/debug
+boost/spirit/dynamic
+boost/spirit/error_handling
+boost/spirit/iterator
+boost/spirit/meta
+boost/spirit/symbols
+boost/spirit/tree
+boost/spirit/utility
+</pre>
+
+ While introducing Spirit V2 we restructured the directory structure in order
+ to accommodate two versions at the same time. All of Spirit.Classic
+ now lives in the directory
+ 
+<pre class="programlisting">boost/spirit/home/classic
+</pre>
+
+ where the directories above contain forwarding headers to the new location
+ allowing to maintain application compatibility. The forwarding headers issue
+ a warning (starting with Boost V1.38) telling the user to change their include
+ paths. Please expect the above directories/forwarding headers to go away soon.
+ 
+
+ This explains the need for the directory
+ 
+<pre class="programlisting">boost/spirit/include
+</pre>
+
+ which contains forwarding headers as well. But this time the headers won't
+ go away. We encourage application writers to use only the includes contained
+ in this directory. This allows us to restructure the directories underneath
+ if needed without worrying application compatibility. Please use those files
+ in your application only. If it turns out that some forwarding file is missing,
+ please report this as a bug.
+ 
+
+ Spirit V2 is not about parsing only anymore (as Spirit.Classic).
+ It now consists out of 3 parts (sub-libraries): Spirit.Qi,
+ Spirit.Karma, and Spirit.Lex. The
+ header files for those live in
+ 
+<pre class="programlisting">boost/spirit/home/qi
+boost/spirit/home/karma
+boost/spirit/home/lex
+</pre>
+
+ and have forwarding headers in
+ 
+<pre class="programlisting">boost/spirit/include
+</pre>
+
+ Spirit.Qi is the direct successor to Spirit.Classic
+ as it implements a DSEL (domain specific embedded language) allowing to write
+ parsers using the syntax of C++ itself (parsers in the sense turning a sequence
+ of bytes into an internal data structure). It is not compatible with Spirit.Classic,
+ the main concepts are similar, though.
+ 
+
+ Spirit.Karma is the counterpart to Spirit.Qi.
+ It implements a similar DSEL but for writing generators (i.e. the things turning
+ internal data structures into a sequence of bytes, most of the time - strings).
+ Spirit.Karma is the Yang to Spirit.Qi's
+ Yin, it's almost like a mirrored picture.
+ 
+
+ Spirit.Lex is (as the name implies) a library allowing
+ to write lexical analyzers. These are either usable standalone or can be used
+ as a frontend for Spirit.Qi parsers. If you know flex
+ you shouldn't have problems understanding Spirit.Lex.
+ This library actually doesn't implement the lexer itself. All it does is to
+ provide an interface to pre-existing lexical analyzers. Currently it's using
+ Ben Hansons excellent Lexertl
+ library (proposed for a Boost review, BTW) as its underlying workhorse.
+ 
+
+ Again, don't use any of the header files underneath the boost/spirit/home directory
+ directly, always include files from the boost/spirit/include directory.
+ 
+
+ The last bit missing is Boost.Phoenix
+ (which currently still lives under the Spirit umbrella, but already has been
+ accepted as a Boost library, so it will move away). Boost.Phoenix
+ is a library allowing to write functional style C++, which is interesting on
+ itself, but as it initially has been developed for Spirit, it is nicely integrated
+ and very useful when it comes to writing semantic actions. I think using the
+ boost/spirit/include/phoenix_... headers will be safe in the future as well,
+ as we will probably redirect to the Boost.Phoenix headers as soon as these
+ are available.
+ 
+<a name="spirit.faq.why_doesn_t_my_symbol_table_work_in_a__code__phrase_role__identifier__no_case__phrase___code__directive_"></a><h4>
+<a name="id890765"></a>
+ <a class="link" href="faq.html#spirit.faq.why_doesn_t_my_symbol_table_work_in_a__code__phrase_role__identifier__no_case__phrase___code__directive_">Why
+ doesn't my symbol table work in a <code class="computeroutput">no_case</code>
+ directive?</a>
+ </h4>
+
+ In order to perform case-insensitive parsing (using <a class="link" href="qi/reference/directive/no_case.html" title="Inhibiting Case Sensitivity (no_case[])"><code class="computeroutput">no_case</code></a>) with a symbol table (i.e.
+ use a <a class="link" href="qi/reference/string/symbols.html" title="Symbols (symbols)"><code class="computeroutput">symbols<Ch,
+ T></code></a>
+ parser in a <code class="computeroutput">no_case</code> directive),
+ that symbol table needs to be filled with all-lowercase contents. Entries containing
+ one or more uppercase characters will not match any input.
+ 
+<a name="spirit.faq.i_m_getting_a_compilation_error_mentioning__code__phrase_role__identifier__boost__phrase__phrase_role__special______phrase__phrase_role__identifier__function__phrase___code__and_or___________code__phrase_role__identifier__boost__phrase__phrase_role__special______phrase__phrase_role__identifier__function4__phrase___code___what_does_this_mean_"></a><h4>
+<a name="id890836"></a>
+ <a class="link" href="faq.html#spirit.faq.i_m_getting_a_compilation_error_mentioning__code__phrase_role__identifier__boost__phrase__phrase_role__special______phrase__phrase_role__identifier__function__phrase___code__and_or___________code__phrase_role__identifier__boost__phrase__phrase_role__special______phrase__phrase_role__identifier__function4__phrase___code___what_does_this_mean_">I'm
+ getting a compilation error mentioning <code class="computeroutput">boost::function</code>
+ and/or <code class="computeroutput">boost::function4</code>. What does this mean?</a>
+ </h4>
+
+ If you are using Visual C++ and have an error like:
+ 
+<pre class="programlisting">error C2664: 'bool boost::function4<R,T0,T1,T2,T3>::operator ()(T0,T1,T2,T3) const' :
+ cannot convert parameter 4 from '...' to '...'
+</pre>
+
+ or you are using GCC and have an error like:
+ 
+<pre class="programlisting">error: no match for call to '(const boost::function<bool ()(...)>) (...)'
+note: candidates are: ... boost::function4<R,T1,T2,T3,T4>::operator()(T0,T1,T2,T3) const [with ...]
+</pre>
+
+ then this FAQ entry may help you.
+ 
+
+ The definition of a Rule or Grammar may contain a skip parser type. If it does,
+ it means that non-terminal can only be used with a skip parser of a compatible
+ type. The error above arises when this is not the case, i.e.:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ a non-terminal defined with a skip parser type is used without a skip parser
+ (for example, a rule with a skip parser type is used inside a <code class="computeroutput">lexeme</code> directive, or a grammar with a skip
+ parser type is used in <code class="computeroutput">parse</code>
+ instead of <code class="computeroutput">phrase_parse</code>),
+ </li>
+<li class="listitem">
+ or a non-terminal is used with a skip parser of an incompatible type (for
+ example, a rule defined with one skip parser type calls a second rule defined
+ with another, incompatible skip parser type).
+ </li>
+</ul></div>
+<div class="note" title="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">
+ The same applies to Spirit.Karma, replacing 'skip parser'
+ and <code class="computeroutput">lexeme</code> by 'delimit generator'
+ and <code class="computeroutput">verbatim</code>. Similarily,
+ corresponding error messages in Spirit.Karma reference
+ <code class="computeroutput">boost::function3</code> and the 3rd parameter (instead
+ of the 4th).
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="support/multi_pass.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="notes.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/introduction.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/introduction.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,473 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Introduction</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="what_s_new.html" title="What's New">
+<link rel="next" href="structure.html" title="Structure">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="what_s_new.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="structure.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Introduction">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.introduction"></a><a class="link" href="introduction.html" title="Introduction">Introduction</a>
+</h2></div></div></div>
+
+ Boost Spirit is an object-oriented, recursive-descent parser and output generation
+ library for C++. It allows you to write grammars and format descriptions using
+ a format similar to Extended Backus Naur Form (EBNF)
+ [<a name="id591110" href="#ftn.id591110" class="footnote">1</a>]
+ directly in C++. These inline grammar specifications can mix freely with other
+ C++ code and, thanks to the generative power of C++ templates, are immediately
+ executable. In retrospect, conventional compiler-compilers or parser-generators
+ have to perform an additional translation step from the source EBNF code to
+ C or C++ code.
+ 
+
+ The syntax and semantics of the libraries' API directly form domain-specific
+ embedded languages (DSEL). In fact, Spirit exposes 3 different DSELs to the
+ user:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ one for creating parser grammars,
+ </li>
+<li class="listitem">
+ one for the specification of the required tokens to be used for parsing,
+ </li>
+<li class="listitem">
+ and one for the description of the required output formats.
+ </li>
+</ul></div>
+
+ Since the target input grammars and output formats are written entirely in
+ C++ we do not need any separate tools to compile, preprocess or integrate those
+ into the build process. Spirit
+ allows seamless integration of the parsing and output generation process with
+ other C++ code. This often allows for simpler and more efficient code.
+ 
+
+ Both the created parsers and generators are fully attributed (more on that
+ later) which allows you to easily build and handle hierarchical data structures
+ in memory. These data structures resemble the structure of the input data and
+ can directly be used to generate arbitrarily-formatted output.
+ 
+
+ The <a class="link" href="introduction.html#spirit.spiritstructure" title="Figure 1. The overall structure of the Boost Spirit library">figure</a> below depicts the
+ overall structure of the Boost Spirit library. The library consists of 4 major
+ parts:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+Spirit.Classic:
+ This is the almost-unchanged code base taken from the former Boost Spirit
+ V1.8 distribution. It has been moved into the namespace boost::spirit::classic.
+ A special compatibility layer has been added to ensure complete compatibility
+ with existing code using Spirit V1.8.
+ </li>
+<li class="listitem">
+Spirit.Qi: This is the parser library allowing you to
+ build recursive descent parsers. The exposed domain-specific language can
+ be used to describe the grammars to implement, and the rules for storing
+ the parsed information.
+ </li>
+<li class="listitem">
+Spirit.Lex: This is the library usable to create tokenizers
+ (lexers). The domain-specific language exposed by Spirit.Lex
+ allows to define regular expressions used to match tokens (create token definitions),
+ associate these regular expressions with code to be executed whenever they
+ are matched, and to add the token definitions to the lexical analyzer.
+ </li>
+<li class="listitem">
+Spirit.Karma: This is the generator library allowing
+ you to create code for recursive descent, data type-driven output formatting.
+ The exposed domain-specific language is almost equivalent to the parser description
+ language used in Spirit.Qi, except that it is used to
+ describe the required output format to generate from a given data structure.
+ </li>
+</ul></div>
+
+ 
+<div class="figure">
+<a name="spirit.spiritstructure"></a>Figure 1. The overall structure of the Boost Spirit library
+<div class="figure-contents"><img src=".././images/spiritstructure.png" alt="The overall structure of the Boost Spirit library"></div>
+</div>
+ 
+ 
+
+ The separate sublibraries Spirit.Qi, Spirit.Karma
+ and Spirit.Lex are well integrated with any of the other
+ parts. Because of their similar structure and identical underlying technology
+ these are usable either separately or together at the same time. For instance
+ is it possible to directly feed the hierarchical data structures generated
+ by Spirit.Qi into output generators created using Spirit.Karma;
+ or to use the token sequence generated by Spirit.Lex as
+ the input for a parser generated by Spirit.Qi.
+ 
+
+ The <a class="link" href="introduction.html#spirit.spiritkarmaflow" title="Figure 2. The place of Spirit.Qi and Spirit.Karma in a data transformation flow of a typical application">figure</a> below shows the typical
+ data flow of some input being converted to some internal representation. After
+ some (optional) transformation these data are converted back into some different,
+ external representation. The picture highlights Spirit's place in this data
+ transformation flow.
+ 
+
+ 
+<div class="figure">
+<a name="spirit.spiritkarmaflow"></a>Figure 2. The place of Spirit.Qi and Spirit.Karma
+ in a data transformation flow of a typical application
+<div class="figure-contents"><img src=".././images/spiritkarmaflow.png" alt="The place of Spirit.Qi and Spirit.Karma in a data transformation flow of a typical application"></div>
+</div>
+ 
+ 
+<a name="spirit.introduction.a_quick_overview_of_parsing_with__emphasis_spirit_qi__emphasis_"></a><h4>
+<a name="id591326"></a>
+ <a class="link" href="introduction.html#spirit.introduction.a_quick_overview_of_parsing_with__emphasis_spirit_qi__emphasis_">A
+ Quick Overview of Parsing with Spirit.Qi</a>
+ </h4>
+
+ Spirit.Qi is Spirit's sublibrary dealing with generating
+ parsers based on a given target grammar (essentially a format description of
+ the input data to read).
+ 
+
+ A simple EBNF grammar snippet:
+ 
+<pre class="programlisting">group ::= '(' expression ')'
+factor ::= integer | group
+term ::= factor (('*' factor) | ('/' factor))*
+expression ::= term (('+' term) | ('-' term))*
+</pre>
+
+ is approximated using facilities of Spirit's Qi sublibrary
+ as seen in this code snippet:
+ 
+<pre class="programlisting">group = '(' >> expression >> ')';
+factor = integer | group;
+term = factor >> *(('*' >> factor) | ('/' >> factor));
+expression = term >> *(('+' >> term) | ('-' >> term));
+</pre>
+
+ Through the magic of expression templates, this is perfectly valid and executable
+ C++ code. The production rule <code class="computeroutput">expression</code>
+ is, in fact, an object that has a member function <code class="computeroutput">parse</code>
+ that does the work given a source code written in the grammar that we have
+ just declared. Yes, it's a calculator. We shall simplify for now by skipping
+ the type declarations and the definition of the rule <code class="computeroutput">integer</code>
+ invoked by <code class="computeroutput">factor</code>. Now, the
+ production rule <code class="computeroutput">expression</code>
+ in our grammar specification, traditionally called the <code class="computeroutput">start</code>
+ symbol, can recognize inputs such as:
+ 
+<pre class="programlisting">12345
+-12345
++12345
+1 + 2
+1 * 2
+1/2 + 3/4
+1 + 2 + 3 + 4
+1 * 2 * 3 * 4
+(1 + 2) * (3 + 4)
+(-1 + 2) * (3 + -4)
+1 + ((6 * 200) - 20) / 6
+(1 + (2 + (3 + (4 + 5))))
+</pre>
+
+ Certainly we have modified the original EBNF syntax. This is done to conform
+ to C++ syntax rules. Most notably we see the abundance of shift >> operators.
+ Since there are no 'empty' operators in C++, it is simply not possible to write
+ something like:
+ 
+<pre class="programlisting">a b
+</pre>
+
+ as seen in math syntax, for example, to mean multiplication or, in our case,
+ as seen in EBNF syntax to mean sequencing (b should follow a). Spirit.Qi
+ uses the shift <code class="computeroutput">>></code> operator
+ instead for this purpose. We take the <code class="computeroutput">>></code>
+ operator, with arrows pointing to the right, to mean "is followed by".
+ Thus we write:
+ 
+<pre class="programlisting">a >> b
+</pre>
+
+ The alternative operator <code class="computeroutput">|</code> and
+ the parentheses <code class="computeroutput">()</code> remain as is.
+ The assignment operator <code class="computeroutput">=</code> is used
+ in place of EBNF's <code class="computeroutput">::=</code>. Last but
+ not least, the Kleene star <code class="computeroutput">*</code> which
+ used to be a postfix operator in EBNF becomes a prefix. Instead of:
+ 
+<pre class="programlisting">a* //... in EBNF syntax,
+</pre>
+
+ we write:
+ 
+<pre class="programlisting">*a //... in Spirit.
+</pre>
+
+ since there are no postfix stars, <code class="computeroutput">*</code>,
+ in C/C++. Finally, we terminate each rule with the ubiquitous semi-colon,
+ <code class="computeroutput">;</code>.
+ 
+<a name="spirit.introduction.a_quick_overview_of_output_generation_with__emphasis_spirit_karma__emphasis_"></a><h4>
+<a name="id592283"></a>
+ <a class="link" href="introduction.html#spirit.introduction.a_quick_overview_of_output_generation_with__emphasis_spirit_karma__emphasis_">A
+ Quick Overview of Output Generation with Spirit.Karma</a>
+ </h4>
+
+ Spirit not only allows you to describe the structure of the input. Starting
+ with Version 2.0 it enables the specification of the output format for your
+ data in a similar way, and based on a single syntax and compatible semantics.
+ 
+
+ Let's assume we need to generate a textual representation from a simple data
+ structure such as a <code class="computeroutput">std::vector<int></code>. Conventional
+ code probably would look like:
+ 
+<pre class="programlisting">std::vector<int> v (initialize_and_fill());
+std::vector<int>::iterator end = v.end();
+for (std::vector<int>::iterator it = v.begin(); it != end; ++it)
+ std::cout << *it << std::endl;
+</pre>
+
+ which is not very flexible and quite difficult to maintain when it comes to
+ changing the required output format. Spirit's sublibrary Karma
+ allows you to specify output formats for arbitrary data structures in a very
+ flexible way. The following snippet is the Karma format
+ description used to create the same output as the traditional code above:
+ 
+<pre class="programlisting">*(int_ << eol)
+</pre>
+
+ Here are some more examples of format descriptions for different output representations
+ of the same <code class="computeroutput">std::vector<int></code>:
+ 
+<div class="table">
+<a name="id594262"></a>Table 2. Different output formats for `std::vector<int>`
+<div class="table-contents"><table class="table" summary="Different output formats for `std::vector<int>`">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Format
+ 
+ </th>
+<th>
+ 
+ Example
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">'[' <<
+ *(int_
+ << ',') << ']'</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">[1,8,10,]</code>
+ 
+ </td>
+<td>
+ 
+ Comma separated list of integers
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">*('('
+ << int_
+ << ')'
+ << ',')</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">(1),(8),(10),</code>
+ 
+ </td>
+<td>
+ 
+ Comma separated list of integers in parenthesis
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">*hex</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">18a</code>
+ 
+ </td>
+<td>
+ 
+ A list of hexadecimal numbers
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">*(double_
+ << ',')</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">1.0,8.0,10.0,</code>
+ 
+ </td>
+<td>
+ 
+ A list of floating point numbers
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ 
+ We will see later in this documentation how it is possible to avoid printing
+ the trailing <code class="computeroutput">','</code>.
+ 
+
+ Overall, the syntax is similar to Spirit.Qi with the exception
+ that we use the <code class="computeroutput"><<</code> operator
+ for output concatenation. This should be easy to understand as it follows the
+ conventions used in the Standard's I/O streams.
+ 
+
+ Another important feature of Spirit.Karma allows you to
+ fully decouple the data type from the output format. You can use the same output
+ format with different data types as long as these conform conceptually. The
+ next table gives some related examples.
+ 
+<div class="table">
+<a name="id594646"></a>Table 3. Different data types usable with the output format
+ `*(int_ << eol)`
+<div class="table-contents"><table class="table" summary="Different data types usable with the output format
+ `*(int_ << eol)`">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Data type
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">int i[4]</code>
+ 
+ </td>
+<td>
+ 
+ C style arrays
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::vector<int></code>
+ 
+ </td>
+<td>
+ 
+ Standard vector
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::list<int></code>
+ 
+ </td>
+<td>
+ 
+ Standard list
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">boost::array<long, 20></code>
+ 
+ </td>
+<td>
+ 
+ Boost array
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ <div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a name="ftn.id591110" href="#id591110" class="para">1</a>] 
+ ISO-EBNF
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="what_s_new.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="structure.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,88 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Karma - Writing Generators</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="qi/reference/string/symbols.html" title="Symbols (symbols)">
+<link rel="next" href="karma/tutorials.html" title="Tutorials">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="qi/reference/string/symbols.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="karma/tutorials.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Karma - Writing Generators">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.karma"></a><a class="link" href="karma.html" title="Karma - Writing Generators"> Karma - Writing Generators</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt>Tutorials</dt>
+<dd><dl>
+<dt>Quick Start</dt>
+<dt>Warming up</dt>
+<dt>Semantic Actions</dt>
+<dt><a href="karma/tutorials/karma_complex.html"> Complex - A
+ first more complex generator</a></dt>
+<dt><a href="karma/tutorials/karma_attributes.html"> Understanding
+ Generator Attributes</a></dt>
+<dt><a href="karma/tutorials/karma_easier_complex.html"> Complex
+ - Made easier</a></dt>
+</dl></dd>
+<dt>Quick Reference</dt>
+<dd><dl>
+<dt><a href="karma/quick_reference/common_notation.html">Common
+ Notation</a></dt>
+<dt><a href="karma/quick_reference/primitive_generators.html">
+ Karma Generators</a></dt>
+<dt><a href="karma/quick_reference/compound_attribute_rules.html">Compound
+ Attribute Rules</a></dt>
+<dt>Non-terminals</dt>
+<dt><a href="karma/quick_reference/semantic_actions.html">Semantic
+ Actions</a></dt>
+<dt>Phoenix</dt>
+</dl></dd>
+<dt>Reference</dt>
+<dd><dl>
+<dt><a href="karma/reference/generator_concepts.html">Generator
+ Concepts</a></dt>
+<dt> Basics</dt>
+<dt> Char</dt>
+<dt>String</dt>
+<dt> Numeric</dt>
+<dt>Stream</dt>
+<dt> Binary</dt>
+<dt>Auxiliary</dt>
+<dt> Directive</dt>
+<dt>Operator</dt>
+</dl></dd>
+<dt>Performance Measurements</dt>
+<dd><dl><dt><a href="karma/performance_measurements/numeric_performance.html">
+ Performance of Numeric Generators</a></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="qi/reference/string/symbols.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="karma/tutorials.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,46 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Performance Measurements</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../karma.html" title="Karma - Writing Generators">
+<link rel="prev" href="reference/operator/not_predicate.html" title="Not Predicate (!a)">
+<link rel="next" href="performance_measurements/numeric_performance.html" title="Performance of Numeric Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="reference/operator/not_predicate.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../karma.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="performance_measurements/numeric_performance.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Performance Measurements">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.karma.performance_measurements"></a><a class="link" href="performance_measurements.html" title="Performance Measurements">Performance Measurements</a>
+</h3></div></div></div>
+<div class="toc"><dl><dt><a href="performance_measurements/numeric_performance.html">
+ Performance of Numeric Generators</a></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="reference/operator/not_predicate.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../karma.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="performance_measurements/numeric_performance.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,53 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Performance of Numeric Generators</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../performance_measurements.html" title="Performance Measurements">
+<link rel="prev" href="../performance_measurements.html" title="Performance Measurements">
+<link rel="next" href="numeric_performance/int_performance.html" title="Comparing the performance of a single int_ generator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../performance_measurements.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../performance_measurements.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric_performance/int_performance.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Performance of Numeric Generators">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.performance_measurements.numeric_performance"></a><a class="link" href="numeric_performance.html" title="Performance of Numeric Generators">
+ Performance of Numeric Generators</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="numeric_performance/int_performance.html">
+ Comparing the performance of a single int_ generator</a></dt>
+<dt><a href="numeric_performance/double_performance.html">
+ Comparing the performance of a single double_ generator</a></dt>
+<dt><a href="numeric_performance/format_performance.html">
+ Comparing the performance of a sequence of several generators</a></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../performance_measurements.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../performance_measurements.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric_performance/int_performance.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/double_performance.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/double_performance.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,363 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Comparing the performance of a single double_ generator</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../numeric_performance.html" title="Performance of Numeric Generators">
+<link rel="prev" href="int_performance.html" title="Comparing the performance of a single int_ generator">
+<link rel="next" href="format_performance.html" title="Comparing the performance of a sequence of several generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="int_performance.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric_performance.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="format_performance.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Comparing the performance of a single double_ generator">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.performance_measurements.numeric_performance.double_performance"></a><a class="link" href="double_performance.html" title="Comparing the performance of a single double_ generator">
+ Comparing the performance of a single double_ generator</a>
+</h5></div></div></div>
+
+ This performance measurements are centered around default formatting
+ of a single <code class="computeroutput">double</code> floating
+ point number using different libraries and methods. The overall execution
+ times for those examples are compared below. We compare using <code class="computeroutput">sprintf</code>, C++ iostreams, Boost.Format,
+ and Spirit.Karma.
+ 
+
+ For the full source code of the performance test please see here: double_performance.cpp).
+ All the measurements have been done by executing 1000000 iterations for
+ each formatting type (NUMITERATIONS is set to 1000000 in the code shown
+ below).
+ 
+
+ Code used to measure the performance for <code class="computeroutput">sprintf</code>:
+ 
+
+ 
+
+
+
+<pre class="programlisting">char buffer[256];
+for (int i = 0; i < NUMITERATIONS; ++i) {
+ sprintf(buffer, "%f", 12345.12345);
+}
+</pre>
+
+ 
+
+ 
+
+ Code used to measure the performance for standard C++ iostreams:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::stringstream strm;
+for (int i = 0; i < NUMITERATIONS; ++i) {
+ strm.str("");
+ strm << 12345.12345;
+}
+</pre>
+
+ 
+
+ 
+
+ Code used to measure the performance for Boost.Format:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string generated;
+boost::format double_format("%f");
+for (int i = 0; i < NUMITERATIONS; ++i)
+ generated = boost::str(double_format % 12345.12345);
+</pre>
+
+ 
+
+ 
+
+ The following code shows the common definitions used by all Spirit.Karma
+ performance measurements as listed below:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::double_;
+</pre>
+
+ 
+
+ 
+
+ Code used to measure the performance for Spirit.Karma
+ using a plain character buffer:
+ 
+
+ 
+
+
+
+<pre class="programlisting">char buffer[256];
+for (int i = 0; i < NUMITERATIONS; ++i) {
+ char *p = buffer;
+ generate(p, double_, 12345.12345);
+ *p = '\0';
+}
+</pre>
+
+ 
+
+ 
+
+ The following table shows the overall performance results collected while
+ using different compilers. All times are in seconds measured for 1000000
+ iterations (platform: Windows7, Intel Core Duo(tm) Processor, 2.8GHz,
+ 4GByte RAM). For a more readable comparison of the results see this
+ <a class="link" href="double_performance.html#spirit.karma.double_performance" title="Figure 4. Performance comparison for a single double">figure</a>.
+ 
+<div class="table">
+<a name="id847622"></a>Table 6. Performance comparison for a single double (all
+ times in [s], 1000000 iterations)
+<div class="table-contents"><table class="table" summary="Performance comparison for a single double (all
+ times in [s], 1000000 iterations)">
+<colgroup>
+<col>
+<col>
+<col>
+<col>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Library
+ 
+ </th>
+<th>
+ 
+ gcc 4.4.0 (32 bit)
+ 
+ </th>
+<th>
+ 
+ VC++ 10 (32 bit)
+ 
+ </th>
+<th>
+ 
+ Intel 11.1 (32 bit)
+ 
+ </th>
+<th>
+ 
+ gcc 4.4.0 (64 bit)
+ 
+ </th>
+<th>
+ 
+ VC++ 10 (64 bit)
+ 
+ </th>
+<th>
+ 
+ Intel 11.1 (64 bit)
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ sprintf
+ 
+ </td>
+<td>
+ 
+ 0.755
+ 
+ </td>
+<td>
+ 
+ 0.965
+ 
+ </td>
+<td>
+ 
+ 0.880
+ 
+ </td>
+<td>
+ 
+ 0.713
+ 
+ </td>
+<td>
+ 
+ 0.807
+ 
+ </td>
+<td>
+ 
+ 0.694
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ iostreams
+ 
+ </td>
+<td>
+ 
+ 2.316
+ 
+ </td>
+<td>
+ 
+ 2.624
+ 
+ </td>
+<td>
+ 
+ 1.964
+ 
+ </td>
+<td>
+ 
+ 1.634
+ 
+ </td>
+<td>
+ 
+ 1.468
+ 
+ </td>
+<td>
+ 
+ 1.354
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Boost.Format
+ 
+ </td>
+<td>
+ 
+ 3.188
+ 
+ </td>
+<td>
+ 
+ 3.737
+ 
+ </td>
+<td>
+ 
+ 2.878
+ 
+ </td>
+<td>
+ 
+ 3.217
+ 
+ </td>
+<td>
+ 
+ 2.672
+ 
+ </td>
+<td>
+ 
+ 2.011
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Spirit.Karma double_
+ 
+ </td>
+<td>
+ 
+ 0.813
+ 
+ </td>
+<td>
+ 
+ 0.561
+ 
+ </td>
+<td>
+ 
+ 0.368
+ 
+ </td>
+<td>
+ 
+ 0.426
+ 
+ </td>
+<td>
+ 
+ 0.260
+ 
+ </td>
+<td>
+ 
+ 0.218
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ 
+ 
+<div class="figure">
+<a name="spirit.karma.double_performance"></a>Figure 4. Performance comparison for a single double
+<div class="figure-contents"><img src="../../../.././images/double_performance.png" alt="Performance comparison for a single double"></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="int_performance.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric_performance.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="format_performance.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/format_performance.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/format_performance.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,384 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Comparing the performance of a sequence of several generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../numeric_performance.html" title="Performance of Numeric Generators">
+<link rel="prev" href="double_performance.html" title="Comparing the performance of a single double_ generator">
+<link rel="next" href="../../../lex.html" title="Lex - Writing Lexical Analyzers">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="double_performance.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric_performance.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../lex.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Comparing the performance of a sequence of several generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.performance_measurements.numeric_performance.format_performance"></a><a class="link" href="format_performance.html" title="Comparing the performance of a sequence of several generators">
+ Comparing the performance of a sequence of several generators</a>
+</h5></div></div></div>
+
+ This performance measurements are centered around formatting of a sequence
+ of different items, including 2 <code class="computeroutput">double</code>
+ floating point numbers using different libraries and methods. The overall
+ execution times for those examples are compared below. We compare using
+ <code class="computeroutput">sprintf</code>, C++ iostreams,
+ Boost.Format, and
+ Spirit.Karma.
+ 
+
+ For the full source code of the performance test please see here: format_performance.cpp).
+ All the measurements have been done by doing 1000000 iterations for each
+ formatting type (NUMITERATIONS is set to 1000000).
+ 
+
+ Code used to measure the performance for sprintf:
+ 
+
+ 
+
+
+
+<pre class="programlisting">char buffer[256];
+for (int i = 0; i < NUMITERATIONS; ++i) {
+ sprintf(buffer, "[%-14.3f%-14.3f]", 12345.12345, 12345.12345);
+}
+</pre>
+
+ 
+
+ 
+
+ Code used to measure the performance for standard iostreams:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::stringstream strm;
+for (int i = 0; i < NUMITERATIONS; ++i) {
+ strm.str("");
+ strm << '['
+ << std::setiosflags(std::ios::fixed)
+ << std::left
+ << std::setprecision(3)
+ << std::setw(14)
+ << 12345.12345
+ << std::setw(14)
+ << 12345.12345
+ << ']';
+}
+</pre>
+
+ 
+
+ 
+
+ Code used to measure the performance for Boost.Format:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string generated;
+boost::format outformat("[%-14.3f%-14.3f]");
+for (int i = 0; i < NUMITERATIONS; ++i)
+ generated = boost::str(outformat % 12345.12345 % 12345.12345);
+</pre>
+
+ 
+
+ 
+
+ The following code shows the common definitions used by all Spirit.Karma
+ performance measurements as listed below:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename T>
+struct double3_policy : boost::spirit::karma::real_policies<T>
+{
+ // we want to generate up to 3 fractional digits
+ static unsigned int precision(T) { return 3; }
+};
+
+typedef boost::spirit::karma::real_generator<double, double3_policy<double> >
+ double3_type;
+double3_type const double3 = double3_type();
+</pre>
+
+ 
+
+ 
+
+ Code used to measure the performance for Spirit.Karma
+ using a plain character buffer:
+ 
+
+ 
+
+
+
+<pre class="programlisting">char buffer[256];
+for (int i = 0; i < NUMITERATIONS; ++i) {
+ char *p = buffer;
+ generate(p
+ , '[' << left_align(14)[double3] << left_align(14)[double3] << ']'
+ , 12345.12345, 12345.12345);
+ *p = '\0';
+}
+</pre>
+
+ 
+
+ 
+
+ The following table shows the overall performance results collected while
+ using different compilers. All times are in seconds measured for 1000000
+ iterations (platform: Windows7, Intel Core Duo(tm) Processor, 2.8GHz,
+ 4GByte RAM). For a more readable comparison of the results see this
+ <a class="link" href="format_performance.html#spirit.karma.format_performance" title="Figure 5. Performance comparison for a sequence of several items">figure</a>.
+ 
+<div class="table">
+<a name="id849689"></a>Table 7. Performance comparison for a sequence of several
+ items (all times in [s], 1000000 iterations)
+<div class="table-contents"><table class="table" summary="Performance comparison for a sequence of several
+ items (all times in [s], 1000000 iterations)">
+<colgroup>
+<col>
+<col>
+<col>
+<col>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Library
+ 
+ </th>
+<th>
+ 
+ gcc 4.4.0 (32 bit)
+ 
+ </th>
+<th>
+ 
+ VC++ 10 (32 bit)
+ 
+ </th>
+<th>
+ 
+ Intel 11.1 (32 bit)
+ 
+ </th>
+<th>
+ 
+ gcc 4.4.0 (64 bit)
+ 
+ </th>
+<th>
+ 
+ VC++ 10 (64 bit)
+ 
+ </th>
+<th>
+ 
+ Intel 11.1 (64 bit)
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ sprintf
+ 
+ </td>
+<td>
+ 
+ 1.725
+ 
+ </td>
+<td>
+ 
+ 1.892
+ 
+ </td>
+<td>
+ 
+ 1.903
+ 
+ </td>
+<td>
+ 
+ 1.469
+ 
+ </td>
+<td>
+ 
+ 1.608
+ 
+ </td>
+<td>
+ 
+ 1.493
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ iostreams
+ 
+ </td>
+<td>
+ 
+ 4.827
+ 
+ </td>
+<td>
+ 
+ 5.287
+ 
+ </td>
+<td>
+ 
+ 4.444
+ 
+ </td>
+<td>
+ 
+ 3.112
+ 
+ </td>
+<td>
+ 
+ 3.319
+ 
+ </td>
+<td>
+ 
+ 2.877
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Boost.Format
+ 
+ </td>
+<td>
+ 
+ 5.881
+ 
+ </td>
+<td>
+ 
+ 7.089
+ 
+ </td>
+<td>
+ 
+ 5.801
+ 
+ </td>
+<td>
+ 
+ 5.455
+ 
+ </td>
+<td>
+ 
+ 5.254
+ 
+ </td>
+<td>
+ 
+ 4.164
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Spirit.Karma
+ 
+ </td>
+<td>
+ 
+ 1.942
+ 
+ </td>
+<td>
+ 
+ 1.242
+ 
+ </td>
+<td>
+ 
+ 0.999
+ 
+ </td>
+<td>
+ 
+ 1.334
+ 
+ </td>
+<td>
+ 
+ 0.758
+ 
+ </td>
+<td>
+ 
+ 0.686
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ 
+ 
+<div class="figure">
+<a name="spirit.karma.format_performance"></a>Figure 5. Performance comparison for a sequence
+ of several items
+<div class="figure-contents"><img src="../../../.././images/format_performance.png" alt="Performance comparison for a sequence of several items"></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="double_performance.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric_performance.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../lex.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/int_performance.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/performance_measurements/numeric_performance/int_performance.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,353 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Comparing the performance of a single int_ generator</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../numeric_performance.html" title="Performance of Numeric Generators">
+<link rel="prev" href="../numeric_performance.html" title="Performance of Numeric Generators">
+<link rel="next" href="double_performance.html" title="Comparing the performance of a single double_ generator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../numeric_performance.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric_performance.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="double_performance.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Comparing the performance of a single int_ generator">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.performance_measurements.numeric_performance.int_performance"></a><a class="link" href="int_performance.html" title="Comparing the performance of a single int_ generator">
+ Comparing the performance of a single int_ generator</a>
+</h5></div></div></div>
+
+ This performance measurements are centered around default formatting
+ of a single <code class="computeroutput">int</code> integer
+ number using different libraries and methods. The overall execution times
+ for those examples are compared below. We compare using <code class="computeroutput">sprintf</code>, C++ iostreams, Boost.Format,
+ and Spirit.Karma.
+ 
+
+ For the full source code of the performance test please see here: int_generator.cpp).
+ All the measurements have been done by executing 10000000 iterations
+ for each formatting type (NUMITERATIONS is set to 10000000 in the code
+ shown below).
+ 
+
+ Code used to measure the performance for <code class="computeroutput">ltoa</code>:
+ 
+
+ 
+
+
+
+<pre class="programlisting">char buffer[65]; // we don't expect more than 64 bytes to be generated here
+for (int i = 0; i < MAX_ITERATION; ++i)
+{
+ ltoa(v[i], buffer, 10);
+}
+</pre>
+
+ 
+
+ 
+
+ Code used to measure the performance for standard C++ iostreams:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::stringstream str;
+for (int i = 0; i < MAX_ITERATION; ++i)
+{
+ str.str("");
+ str << v[i];
+}
+</pre>
+
+ 
+
+ 
+
+ Code used to measure the performance for Boost.Format:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string str;
+boost::format int_format("%d");
+for (int i = 0; i < MAX_ITERATION; ++i)
+{
+ str = boost::str(int_format % v[i]);
+}
+</pre>
+
+ 
+
+ 
+
+ Code used to measure the performance for Spirit.Karma
+ using a plain character buffer:
+ 
+
+ 
+
+
+
+<pre class="programlisting">char buffer[65]; // we don't expect more than 64 bytes to be generated here
+for (int i = 0; i < MAX_ITERATION; ++i)
+{
+ char *ptr = buffer;
+ karma::generate(ptr, int_, v[i]);
+ *ptr = '\0';
+}
+</pre>
+
+ 
+
+ 
+
+ The following table shows the overall performance results collected while
+ using different compilers. All times are in seconds measured for 10000000
+ iterations (platform: Windows7, Intel Core Duo(tm) Processor, 2.8GHz,
+ 4GByte RAM). For a more readable comparison of the results see this
+ <a class="link" href="int_performance.html#spirit.karma.int_performance" title="Figure 3. Performance comparison for a single int">figure</a>.
+ 
+<div class="table">
+<a name="id845463"></a>Table 5. Performance comparison for a single int (all
+ times in [s], 10000000 iterations)
+<div class="table-contents"><table class="table" summary="Performance comparison for a single int (all
+ times in [s], 10000000 iterations)">
+<colgroup>
+<col>
+<col>
+<col>
+<col>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Library
+ 
+ </th>
+<th>
+ 
+ gcc 4.4.0 (32 bit)
+ 
+ </th>
+<th>
+ 
+ VC++ 10 (32 bit)
+ 
+ </th>
+<th>
+ 
+ Intel 11.1 (32 bit)
+ 
+ </th>
+<th>
+ 
+ gcc 4.4.0 (64 bit)
+ 
+ </th>
+<th>
+ 
+ VC++ 10 (64 bit)
+ 
+ </th>
+<th>
+ 
+ Intel 11.1 (64 bit)
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ ltoa
+ 
+ </td>
+<td>
+ 
+ 1.542
+ 
+ </td>
+<td>
+ 
+ 0.895
+ 
+ </td>
+<td>
+ 
+ 0.884
+ 
+ </td>
+<td>
+ 
+ 1.163
+ 
+ </td>
+<td>
+ 
+ 1.099
+ 
+ </td>
+<td>
+ 
+ 0.906
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ iostreams
+ 
+ </td>
+<td>
+ 
+ 6.548
+ 
+ </td>
+<td>
+ 
+ 13.727
+ 
+ </td>
+<td>
+ 
+ 11.898
+ 
+ </td>
+<td>
+ 
+ 3.464
+ 
+ </td>
+<td>
+ 
+ 8.316
+ 
+ </td>
+<td>
+ 
+ 8.115
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Boost.Format
+ 
+ </td>
+<td>
+ 
+ 16.998
+ 
+ </td>
+<td>
+ 
+ 21.813
+ 
+ </td>
+<td>
+ 
+ 20.477
+ 
+ </td>
+<td>
+ 
+ 17.464
+ 
+ </td>
+<td>
+ 
+ 14.662
+ 
+ </td>
+<td>
+ 
+ 13.646
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Spirit.Karma int_
+ 
+ </td>
+<td>
+ 
+ 1.421
+ 
+ </td>
+<td>
+ 
+ 0.744
+ 
+ </td>
+<td>
+ 
+ 0.697
+ 
+ </td>
+<td>
+ 
+ 1.072
+ 
+ </td>
+<td>
+ 
+ 0.953
+ 
+ </td>
+<td>
+ 
+ 0.606
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ 
+ 
+<div class="figure">
+<a name="spirit.karma.int_performance"></a>Figure 3. Performance comparison for a single int
+<div class="figure-contents"><img src="../../../.././images/int_performance.png" alt="Performance comparison for a single int"></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../numeric_performance.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric_performance.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="double_performance.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,63 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Quick Reference</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../karma.html" title="Karma - Writing Generators">
+<link rel="prev" href="tutorials/karma_easier_complex.html" title="Complex - Made easier">
+<link rel="next" href="quick_reference/common_notation.html" title="Common Notation">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="tutorials/karma_easier_complex.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../karma.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="quick_reference/common_notation.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Quick Reference">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.karma.quick_reference"></a><a class="link" href="quick_reference.html" title="Quick Reference">Quick Reference</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><a href="quick_reference/common_notation.html">Common
+ Notation</a></dt>
+<dt><a href="quick_reference/primitive_generators.html">
+ Karma Generators</a></dt>
+<dt><a href="quick_reference/compound_attribute_rules.html">Compound
+ Attribute Rules</a></dt>
+<dt>Non-terminals</dt>
+<dt><a href="quick_reference/semantic_actions.html">Semantic
+ Actions</a></dt>
+<dt>Phoenix</dt>
+</dl></div>
+
+ This quick reference section is provided for convenience. You can use this
+ section as a sort of a "cheat-sheet" on the most commonly used
+ Karma components. It is not intended to be complete, but should give you
+ an easy way to recall a particular component without having to dig up on
+ pages and pages of reference doumentation.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="tutorials/karma_easier_complex.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../karma.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="quick_reference/common_notation.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/common_notation.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/common_notation.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,157 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Common Notation</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="../quick_reference.html" title="Quick Reference">
+<link rel="next" href="primitive_generators.html" title="Karma Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitive_generators.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Common Notation">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.quick_reference.common_notation"></a><a class="link" href="common_notation.html" title="Common Notation">Common
+ Notation</a>
+</h4></div></div></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">G</code></dt>
+<dd>
+ Generator type
+ </dd>
+<dt><code class="computeroutput">g, a,
+ b,
+ c,
+ d</code></dt>
+<dd>
+ Generator objects
+ </dd>
+<dt><code class="computeroutput">A, B,
+ C,
+ D</code></dt>
+<dd>
+ Attribute types of generators <code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code>, <code class="computeroutput">c</code>,
+ and <code class="computeroutput">d</code>
+ </dd>
+<dt><code class="computeroutput">I</code></dt>
+<dd>
+ The iterator type used for generation
+ </dd>
+<dt><code class="computeroutput">Unused</code></dt>
+<dd>
+ An <code class="computeroutput">unused_type</code>
+ </dd>
+<dt><code class="computeroutput">Context</code></dt>
+<dd>
+ The enclosing rule's <code class="computeroutput">Context</code>
+ type
+ </dd>
+<dt><code class="computeroutput">attrib</code></dt>
+<dd>
+ A attribute value
+ </dd>
+<dt><code class="computeroutput">Attrib</code></dt>
+<dd>
+ An attribute type
+ </dd>
+<dt><code class="computeroutput">b</code></dt>
+<dd>
+ A boolean expression
+ </dd>
+<dt><code class="computeroutput">fg</code></dt>
+<dd>
+ A (lazy generator) function with signature <code class="computeroutput">G(Unused, Context)</code>
+ </dd>
+<dt><code class="computeroutput">fa</code></dt>
+<dd>
+ A (semantic action) function with signature <code class="computeroutput">void(Attr&, Context, bool&)</code>. The third parameter is a boolean
+ flag that can be set to false to force the generator to fail. Both
+ <code class="computeroutput">Context</code> and the boolean
+ flag are optional.
+ </dd>
+<dt><code class="computeroutput">outiter</code></dt>
+<dd>
+ An output iterator to receive the generated output
+ </dd>
+<dt><code class="computeroutput">Ch</code></dt>
+<dd>
+ Character-class specific character type (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">ch, ch2</code></dt>
+<dd>
+ Character-class specific character (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">charset</code></dt>
+<dd>
+ Character-set specifier string (example: "a-z0-9")
+ </dd>
+<dt><code class="computeroutput">str</code></dt>
+<dd>
+ Character-class specific string (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">Str</code></dt>
+<dd>
+ Attribute of <code class="computeroutput">str</code>:
+ <code class="computeroutput">std::basic_string<T></code>
+ where <code class="computeroutput">T</code> is the underlying
+ character type of <code class="computeroutput">str</code>
+ </dd>
+<dt><code class="computeroutput">num</code></dt>
+<dd>
+ Numeric literal, any integer or real number type
+ </dd>
+<dt><code class="computeroutput">Num</code></dt>
+<dd>
+ Attribute of <code class="computeroutput">num</code>: any
+ integer or real number type
+ </dd>
+<dt><code class="computeroutput">tuple<></code></dt>
+<dd>
+ Used as a placeholder for a fusion sequence
+ </dd>
+<dt><code class="computeroutput">vector<></code></dt>
+<dd>
+ Used as a placeholder for an STL container
+ </dd>
+<dt><code class="computeroutput">variant<></code></dt>
+<dd>
+ Used as a placeholder for a boost::variant
+ </dd>
+<dt><code class="computeroutput">optional<></code></dt>
+<dd>
+ Used as a placeholder for a boost::optional
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitive_generators.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/compound_attribute_rules.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/compound_attribute_rules.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,276 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Compound Attribute Rules</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="primitive_generators/directives.html" title="Generator Directives">
+<link rel="next" href="non_terminals.html" title="Non-terminals">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitive_generators/directives.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="non_terminals.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Compound Attribute Rules">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.quick_reference.compound_attribute_rules"></a><a class="link" href="compound_attribute_rules.html" title="Compound Attribute Rules">Compound
+ Attribute Rules</a>
+</h4></div></div></div>
+<a name="spirit.karma.quick_reference.compound_attribute_rules.notation"></a><h6>
+<a name="id731527"></a>
+ <a class="link" href="compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Notation</a>
+ </h6>
+
+ The notation we will use will be of the form:
+ 
+<pre class="programlisting">a: A, b: B, ... --> composite-expression: composite-attribute
+</pre>
+
+ <code class="computeroutput">a</code>, <code class="computeroutput">b</code>,
+ etc. are the operands. <code class="computeroutput">A</code>,
+ <code class="computeroutput">B</code>, etc. are the operand's
+ attribute types. <code class="computeroutput">composite-expression</code>
+ is the expression involving the operands and <code class="computeroutput">composite-attribute</code>
+ is the resulting attribute type of the composite expression.
+ 
+
+ For instance:
+ 
+<pre class="programlisting">a: A, b: B --> (a << b): tuple<A, B>
+</pre>
+
+ which reads as: given, <code class="computeroutput">a</code>
+ and <code class="computeroutput">b</code> are generators, and
+ <code class="computeroutput">A</code> is the type of the attribute
+ of <code class="computeroutput">a</code>, and <code class="computeroutput">B</code> is the type of the attribute of <code class="computeroutput">b</code>, then the type of the attribute of
+ <code class="computeroutput">a <<
+ b</code> will be <code class="computeroutput">tuple<A, B></code>.
+ 
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ In the attribute tables, we will use <code class="computeroutput">vector<A></code> and <code class="computeroutput">tuple<A, B...></code> as placeholders only. The notation
+ of <code class="computeroutput">vector<A></code>
+ stands for any STL
+ container holding elements of type <code class="computeroutput">A</code>
+ and the notation <code class="computeroutput">tuple<A, B...></code> stands for any Boost.Fusion sequence
+ holding <code class="computeroutput">A</code>, <code class="computeroutput">B</code>, ... etc. elements. The notation
+ of <code class="computeroutput">variant<A, B, ...></code> stands for a Boost.Variant
+ capable of holding <code class="computeroutput">A</code>,
+ <code class="computeroutput">B</code>, ... etc. elements.
+ Finally, <code class="computeroutput">Unused</code> stands
+ for <code class="computeroutput">unused_type</code>.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.quick_reference.compound_attribute_rules.compound_generator_attribute_types"></a><h6>
+<a name="id732062"></a>
+ <a class="link" href="compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.compound_generator_attribute_types">Compound
+ Generator Attribute Types</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../reference/operator/sequence.html" title="Sequences (a << b)">sequence
+ (<code class="computeroutput"><<</code>)</a>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a << b): tuple<A, B>
+a: A, b: Unused --> (a << b): A
+a: Unused, b: B --> (a << b): B
+a: Unused, b: Unused --> (a << b): Unused
+
+a: A, b: A --> (a << b): vector<A>
+a: vector<A>, b: A --> (a << b): vector<A>
+a: A, b: vector<A> --> (a << b): vector<A>
+a: vector<A>, b: vector<A> --> (a << b): vector<A></pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../reference/operator/alternative.html" title="Alternative (a | b)">alternative
+ (<code class="computeroutput">|</code>)</a>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a | b): variant<A, B>
+a: A, b: Unused --> (a | b): A
+a: Unused, b: B --> (a | b): B
+a: Unused, b: Unused --> (a | b): Unused
+a: A, b: A --> (a | b): A</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../reference/operator/kleene.html" title="Kleene Star (*a)">kleene (unary
+ <code class="computeroutput">*</code>)</a>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> *a: vector<A>
+a: Unused --> *a: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../reference/operator/plus.html" title="Plus (+a)">plus (unary
+ <code class="computeroutput">+</code>)</a>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> +a: vector<A>
+a: Unused --> +a: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../reference/operator/list.html" title="Lists (a % b)">list (<code class="computeroutput">%</code>)</a>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a % b): vector<A>
+a: Unused, b: B --> (a % b): Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../reference/directive/repeat.html" title="Repetition Directive (repeat[])">repetition</a>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat(...,...)[a]: vector<A>
+a: Unused --> repeat(...,...)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../reference/operator/optional.html" title="Optional (-a)">optional
+ (unary <code class="computeroutput">-</code>)</a>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> -a: optional<A>
+a: Unused --> -a: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../reference/operator/and_predicate.html" title="And Predicate (&a)">and
+ predicate (unary <code class="computeroutput">&</code>)</a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">a:
+ A -->
+ &a: A</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../reference/operator/not_predicate.html" title="Not Predicate (!a)">not
+ predicate (unary <code class="computeroutput">!</code>)</a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">a:
+ A -->
+ !a: A</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitive_generators/directives.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="non_terminals.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/non_terminals.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/non_terminals.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,329 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Non-terminals</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="compound_attribute_rules.html" title="Compound Attribute Rules">
+<link rel="next" href="semantic_actions.html" title="Semantic Actions">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="compound_attribute_rules.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Non-terminals">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.quick_reference.non_terminals"></a><a class="link" href="non_terminals.html" title="Non-terminals">Non-terminals</a>
+</h4></div></div></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">RT</code></dt>
+<dd>
+ Synthesized attribute. The rule or grammar's return type.
+ </dd>
+<dt><code class="computeroutput">Arg1</code>,
+ <code class="computeroutput">Arg2</code>, <code class="computeroutput">ArgN</code></dt>
+<dd>
+ Inherited attributes. Zero or more arguments.
+ </dd>
+<dt><code class="computeroutput">L1</code>,
+ <code class="computeroutput">L2</code>, <code class="computeroutput">LN</code></dt>
+<dd>
+ Zero or more local variables.
+ </dd>
+<dt><code class="computeroutput">r, r2</code></dt>
+<dd>
+ Rules
+ </dd>
+<dt><code class="computeroutput">g</code></dt>
+<dd>
+ A grammar
+ </dd>
+<dt><code class="computeroutput">p</code></dt>
+<dd>
+ A generator expression
+ </dd>
+<dt><code class="computeroutput">my_grammar</code></dt>
+<dd>
+ A user defined grammar
+ </dd>
+</dl>
+</div>
+<div class="variablelist" title="Terminology">
+Terminology
+<dl>
+<dt>Signature</dt>
+<dd>
+ <code class="computeroutput">RT(Arg1, Arg2 ...
+ ,ArgN)</code>. The signature specifies the synthesized
+ (return value) and inherited (arguments) attributes.
+ </dd>
+<dt>Locals</dt>
+<dd>
+ <code class="computeroutput">locals<L1, L2 ...,
+ LN></code>.
+ The local variables.
+ </dd>
+<dt>Delimiter</dt>
+<dd>
+ The delimit-generator type
+ </dd>
+</dl>
+</div>
+<div class="variablelist" title="Template Arguments">
+Template Arguments
+<dl>
+<dt><code class="computeroutput">Iterator</code></dt>
+<dd>
+ The iterator type you will use for parsing.
+ </dd>
+<dt><code class="computeroutput">A1</code>,
+ <code class="computeroutput">A2</code>, <code class="computeroutput">A3</code></dt>
+<dd>
+ Can be one of 1)Signature 2)Locals 3)Skipper.
+ </dd>
+</dl>
+</div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">rule<Iterator,
+ A1,
+ A2,
+ A3>
+ r(name);</code>
+ 
+ </td>
+<td>
+ 
+ Rule declaration. <code class="computeroutput">Iterator</code>
+ is required. <code class="computeroutput">A1, A2, A3</code>
+ are optional and can be specified in any order. <code class="computeroutput">name</code>
+ is an optional string that gives the rule its name, useful for
+ debugging and error handling.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">rule<Iterator,
+ A1,
+ A2,
+ A3>
+ r(r2);</code>
+ 
+ </td>
+<td>
+ 
+ Copy construct rule <code class="computeroutput">r</code>
+ from rule <code class="computeroutput">r2</code>.
+ <code class="computeroutput">boost::shared_ptr</code> semantics.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r =
+ r2;</code>
+ 
+ </td>
+<td>
+ 
+ Assign rule <code class="computeroutput">r2</code>
+ to <code class="computeroutput">r</code>. <code class="computeroutput">boost::shared_ptr</code> semantics.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r.alias()</code>
+ 
+ </td>
+<td>
+ 
+ return an alias of <code class="computeroutput">r</code>.
+ The alias is a generator that holds a reference to <code class="computeroutput">r</code>. Reference semantics.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r.copy()</code>
+ 
+ </td>
+<td>
+ 
+ Get a copy of <code class="computeroutput">r</code>.
+ <code class="computeroutput">boost::shared_ptr</code> semantics.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r.name(name)</code>
+ 
+ </td>
+<td>
+ 
+ Naming a rule
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r.name()</code>
+ 
+ </td>
+<td>
+ 
+ Getting the name of a rule
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r =
+ g;</code>
+ 
+ </td>
+<td>
+ 
+ Rule definition
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r %=
+ g;</code>
+ 
+ </td>
+<td>
+ 
+ Auto-rule definition. The attribute of <code class="computeroutput">g</code>
+ should be compatible with the synthesized attribute of <code class="computeroutput">r</code>. When <code class="computeroutput">g</code>
+ is successful, its attribute is automatically propagated to <code class="computeroutput">r</code>'s synthesized attribute.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <typename Iterator>
+struct my_grammar : grammar<Iterator, A1, A2, A3>
+{
+ my_grammar() : my_grammar::base_type(start, name)
+ {
+ // Rule definitions
+ start = /* ... */;
+ }
+
+ rule<Iterator, A1, A2, A3> start;
+ // more rule declarations...
+};
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ Grammar definition. <code class="computeroutput">name</code>
+ is an optional string that gives the grammar its name, useful for
+ debugging and error handling.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ my_grammar<Iterator> g
+ 
+ </td>
+<td>
+ 
+ Instantiating a grammar
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">g.name(name)</code>
+ 
+ </td>
+<td>
+ 
+ Naming a grammar
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">g.name()</code>
+ 
+ </td>
+<td>
+ 
+ Getting the name of a grammar
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="compound_attribute_rules.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/phoenix.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/phoenix.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,90 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Phoenix</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="semantic_actions.html" title="Semantic Actions">
+<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"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Phoenix">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.quick_reference.phoenix"></a><a class="link" href="phoenix.html" title="Phoenix">Phoenix</a>
+</h4></div></div></div>
+
+ Boost.Phoenix makes
+ it easier to attach semantic actions. You just inline your lambda expressions:
+ 
+<pre class="programlisting">g[phoenix-lambda-expression]
+</pre>
+
+ Spirit.Karma provides some Boost.Phoenix
+ placeholders to access important information from the <code class="computeroutput">Attrib</code>
+ and <code class="computeroutput">Context</code> that are otherwise
+ fiddly to extract.
+ 
+<div class="variablelist" title="Spirit.Karma specific Phoenix placeholders">
+Spirit.Karma specific Phoenix placeholders
+<dl>
+<dt><code class="computeroutput">_1, _2... , _N</code></dt>
+<dd>
+ Nth attribute of <code class="computeroutput">g</code>
+ </dd>
+<dt><code class="computeroutput">_val</code></dt>
+<dd>
+ The enclosing rule's synthesized attribute.
+ </dd>
+<dt><code class="computeroutput">_r1, _r2... , _rN</code></dt>
+<dd>
+ The enclosing rule's Nth inherited attribute.
+ </dd>
+<dt><code class="computeroutput">_a, _b... , _j</code></dt>
+<dd>
+ The enclosing rule's local variables (<code class="computeroutput">_a</code>
+ refers to the first).
+ </dd>
+<dt><code class="computeroutput">_val</code></dt>
+<dd>
+ The enclosing rule's synthesized attribute.
+ </dd>
+<dt><code class="computeroutput">_pass</code></dt>
+<dd>
+ Assign <code class="computeroutput">false</code> to <code class="computeroutput">_pass</code> to force a generator failure.
+ </dd>
+</dl>
+</div>
+
+ For more information see <a class="link" href="../tutorials/semantic_actions.html" title="Semantic Actions">Semantic
+ Actions</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,67 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Karma Generators</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="common_notation.html" title="Common Notation">
+<link rel="next" href="primitive_generators/char.html" title="Character Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="common_notation.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitive_generators/char.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Karma Generators">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators"></a><a class="link" href="primitive_generators.html" title="Karma Generators">
+ Karma Generators</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="primitive_generators/char.html">
+ Character Generators</a></dt>
+<dt><a href="primitive_generators/string.html">
+ String Generators</a></dt>
+<dt><a href="primitive_generators/real_number.html">
+ Real Number Generators</a></dt>
+<dt><a href="primitive_generators/signed_int.html">
+ Integer Generators</a></dt>
+<dt><a href="primitive_generators/unsigned_int.html">
+ Unsigned Integer Generators</a></dt>
+<dt><a href="primitive_generators/stream.html">
+ Stream Generators</a></dt>
+<dt><a href="primitive_generators/binary.html">
+ Binary Generators</a></dt>
+<dt><a href="primitive_generators/auxiliary.html">
+ Auxiliary Generators</a></dt>
+<dt><a href="primitive_generators/operators.html">
+ Generator Operators</a></dt>
+<dt><a href="primitive_generators/directives.html">
+ Generator Directives</a></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="common_notation.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitive_generators/char.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/auxiliary.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/auxiliary.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,184 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Auxiliary Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="binary.html" title="Binary Generators">
+<link rel="next" href="operators.html" title="Generator Operators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="operators.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Auxiliary Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.auxiliary"></a><a class="link" href="auxiliary.html" title="Auxiliary Generators">
+ Auxiliary Generators</a>
+</h5></div></div></div>
+
+ See here for more information about <a class="link" href="../../reference/auxiliary.html" title="Auxiliary">Auxiliary
+ Generators</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/auxiliary/eol.html" title="End of Line (eol)"><code class="computeroutput">eol</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generates the end of line (<code class="computeroutput">\n</code>)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/auxiliary/eps.html" title="Epsilon (eps)"><code class="computeroutput">eps</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generate an empty string
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/auxiliary/eps.html" title="Epsilon (eps)"><code class="computeroutput">eps(b)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ If <code class="computeroutput">b</code> is true,
+ generate an empty string
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/auxiliary/lazy.html" title="Lazy (lazy)"><code class="computeroutput">lazy(fg)</code></a>
+ 
+ </td>
+<td>
+ 
+ Attribute of <code class="computeroutput">G</code>
+ where <code class="computeroutput">G</code> is the
+ return type of <code class="computeroutput">fg</code>
+ 
+ </td>
+<td>
+ 
+ Invoke <code class="computeroutput">fg</code> at
+ generation time, returning a generator <code class="computeroutput">g</code>
+ which is then called to generate.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/auxiliary/lazy.html" title="Lazy (lazy)"><code class="computeroutput">fg</code></a>
+ 
+ </td>
+<td>
+ 
+ see <a class="link" href="../../reference/auxiliary/lazy.html" title="Lazy (lazy)"><code class="computeroutput">lazy(fg)</code></a>
+ above
+ 
+ </td>
+<td>
+ 
+ Equivalent to <a class="link" href="../../reference/auxiliary/lazy.html" title="Lazy (lazy)"><code class="computeroutput">lazy(fg)</code></a>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">g[fa]</code>
+ 
+ </td>
+<td>
+ 
+ Attribute of <code class="computeroutput">g</code>
+ 
+ </td>
+<td>
+ 
+ Call semantic action <code class="computeroutput">fa</code>
+ (before executing <code class="computeroutput">g</code>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="operators.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/binary.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/binary.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,263 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Binary Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="stream.html" title="Stream Generators">
+<link rel="next" href="auxiliary.html" title="Auxiliary Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="stream.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Binary Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.binary"></a><a class="link" href="binary.html" title="Binary Generators">
+ Binary Generators</a>
+</h5></div></div></div>
+
+ See here for more information about <a class="link" href="../../reference/binary.html" title="Binary">Binary
+ Generators</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_native.html" title="Binary Native Endianness Generators"><code class="computeroutput">byte_</code></a>
+ 
+ </td>
+<td>
+ 
+ 8 bits native endian
+ 
+ </td>
+<td>
+ 
+ Generates an 8 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_native.html" title="Binary Native Endianness Generators"><code class="computeroutput">word</code></a>
+ 
+ </td>
+<td>
+ 
+ 16 bits native endian
+ 
+ </td>
+<td>
+ 
+ Generates a 16 bit binary in native endian representation
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_big.html" title="Binary Big Endianness Generators"><code class="computeroutput">big_word</code></a>
+ 
+ </td>
+<td>
+ 
+ 16 bits big endian
+ 
+ </td>
+<td>
+ 
+ Generates a 16 bit binary in big endian representation
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_little.html" title="Binary Little Endianness Generators"><code class="computeroutput">little_word</code></a>
+ 
+ </td>
+<td>
+ 
+ 16 bits little endian
+ 
+ </td>
+<td>
+ 
+ Generates a 16 bit binary in little endian representation
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_native.html" title="Binary Native Endianness Generators"><code class="computeroutput">dword</code></a>
+ 
+ </td>
+<td>
+ 
+ 32 bits native endian
+ 
+ </td>
+<td>
+ 
+ Generates a 32 bit binary in native endian representation
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_big.html" title="Binary Big Endianness Generators"><code class="computeroutput">big_dword</code></a>
+ 
+ </td>
+<td>
+ 
+ 32 bits big endian
+ 
+ </td>
+<td>
+ 
+ Generates a 32 bit binary in big endian representation
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_little.html" title="Binary Little Endianness Generators"><code class="computeroutput">little_dword</code></a>
+ 
+ </td>
+<td>
+ 
+ 32 bits little endian
+ 
+ </td>
+<td>
+ 
+ Generates a 32 bit binary in little endian representation
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_native.html" title="Binary Native Endianness Generators"><code class="computeroutput">qword</code></a>
+ 
+ </td>
+<td>
+ 
+ 64 bits native endian
+ 
+ </td>
+<td>
+ 
+ Generates a 64 bit binary in native endian representation
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_big.html" title="Binary Big Endianness Generators"><code class="computeroutput">big_qword</code></a>
+ 
+ </td>
+<td>
+ 
+ 64 bits big endian
+ 
+ </td>
+<td>
+ 
+ Generates a 64 bit binary in big endian representation
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/binary/binary_little.html" title="Binary Little Endianness Generators"><code class="computeroutput">little_qword</code></a>
+ 
+ </td>
+<td>
+ 
+ 64 bits little endian
+ 
+ </td>
+<td>
+ 
+ Generates a 64 bit binary in little endian representation
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">pad(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generate additional null bytes allowing to align generated output
+ with memory addresses divisible by <code class="computeroutput">num</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="stream.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/char.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/char.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,431 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Character Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="../primitive_generators.html" title="Karma Generators">
+<link rel="next" href="string.html" title="String Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Character Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.char"></a><a class="link" href="char.html" title="Character Generators">
+ Character Generators</a>
+</h5></div></div></div>
+
+ See here for more information about <a class="link" href="../../reference/char.html" title="Char">Character
+ Generators</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_generator.html" title="Character Generators (char_, lit)"><code class="computeroutput">ch</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generates <code class="computeroutput">ch</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_generator.html" title="Character Generators (char_, lit)"><code class="computeroutput">lit(ch)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generates <code class="computeroutput">ch</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_generator.html" title="Character Generators (char_, lit)"><code class="computeroutput">char_</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates character supplied as the attribute
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_generator.html" title="Character Generators (char_, lit)"><code class="computeroutput">char_(ch)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates <code class="computeroutput">ch</code>,
+ if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_generator.html" title="Character Generators (char_, lit)"><code class="computeroutput">char_("c")</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates a single char string literal, <code class="computeroutput">c</code>,
+ if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_generator.html" title="Character Generators (char_, lit)"><code class="computeroutput">char_(ch,
+ ch2)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates a single char string literal, <code class="computeroutput">c</code>,
+ if <code class="computeroutput">c</code> belongs
+ to the chracter range from <code class="computeroutput">ch</code>
+ to <code class="computeroutput">ch2</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_generator.html" title="Character Generators (char_, lit)"><code class="computeroutput">char_(charset)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates a single char string literal, <code class="computeroutput">c</code>,
+ if <code class="computeroutput">c</code> belongs
+ to the chracter set <code class="computeroutput">charset</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">alnum</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::isalnum</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">alpha</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::isalpha</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">blank</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::isblank</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">cntrl</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::iscntrl</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">digit</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::isdigit</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">graph</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::isgraph</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">print</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::isprint</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">punct</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::ispunct</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">space</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::isspace</code>,
+ or a single space character in the character set defined by
+ <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">xdigit</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::isxdigit</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">lower</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::islower</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/char/char_class.html" title="Character Classification (alnum, digit, etc.)"><code class="computeroutput">upper</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Generates the character supplied as the attribute if it satisfies
+ the concept of <code class="computeroutput">std::isupper</code>
+ in the character set defined by <code class="computeroutput">NS</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/directives.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/directives.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,478 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Generator Directives</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="operators.html" title="Generator Operators">
+<link rel="next" href="../compound_attribute_rules.html" title="Compound Attribute Rules">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="operators.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../compound_attribute_rules.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Generator Directives">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.directives"></a><a class="link" href="directives.html" title="Generator Directives">
+ Generator Directives</a>
+</h5></div></div></div>
+
+ See here for more information about <a class="link" href="../../reference/directive.html" title="Directive">Generator
+ Directives</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/upperlower.html" title="Directives Controlling Case Sensitivity (upper[], lower[])"><code class="computeroutput">lower[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> as
+ lower case
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/upperlower.html" title="Directives Controlling Case Sensitivity (upper[], lower[])"><code class="computeroutput">upper[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> as
+ upper case
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">left_align[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> left
+ aligned in column of width <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_LENGTH</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">left_align(num)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> left
+ aligned in column of width <code class="computeroutput">num</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">left_align(num,
+ g)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> left
+ aligned in column of width <code class="computeroutput">num</code>
+ while using <code class="computeroutput">g</code>
+ to generate the necesssary padding
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">center[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> centered
+ in column of width <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_LENGTH</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">center(num)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> centered
+ in column of width <code class="computeroutput">num</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">center(num,
+ g)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> centered
+ in column of width <code class="computeroutput">num</code>
+ while using <code class="computeroutput">g</code>
+ to generate the necesssary padding
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">right_align[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> right
+ aligned in column of width <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_LENGTH</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">right_align(num)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> right
+ aligned in column of width <code class="computeroutput">num</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">right_align(num,
+ g)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> right
+ aligned in column of width <code class="computeroutput">num</code>
+ while using <code class="computeroutput">g</code>
+ to generate the necesssary padding
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/maxwidth.html" title="Controlling the Maximum Field Wield (maxwidth[])"><code class="computeroutput">maxwidth[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> truncated
+ to column of width <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_MAXWIDTH</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/maxwidth.html" title="Controlling the Maximum Field Wield (maxwidth[])"><code class="computeroutput">maxwidth(num)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> truncated
+ to column of width <code class="computeroutput">num</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/repeat.html" title="Repetition Directive (repeat[])"><code class="computeroutput">repeat[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> zero
+ or more times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/repeat.html" title="Repetition Directive (repeat[])"><code class="computeroutput">repeat(num)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> <code class="computeroutput">num</code> times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/repeat.html" title="Repetition Directive (repeat[])"><code class="computeroutput">repeat(num1,
+ num2)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> <code class="computeroutput">num1</code> to <code class="computeroutput">num2</code>
+ times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/repeat.html" title="Repetition Directive (repeat[])"><code class="computeroutput">repeat(num,
+ inf)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> <code class="computeroutput">num</code> or more times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/delimit.html" title="Directives Controlling Automatic Delimiting (verbatim[], delimit[])"><code class="computeroutput">verbatim[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Disable delimited generation for <code class="computeroutput">a</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/delimit.html" title="Directives Controlling Automatic Delimiting (verbatim[], delimit[])"><code class="computeroutput">delimit[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Reestablish the delimiter that got inhibited by verbatim
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/delimit.html" title="Directives Controlling Automatic Delimiting (verbatim[], delimit[])"><code class="computeroutput">delimit(d)[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Use <code class="computeroutput">d</code> as a delimiter
+ for generating <code class="computeroutput">a</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/omit.html" title="Consume Attribute (omit[])"><code class="computeroutput">omit[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Consumes the attribute type of <code class="computeroutput">a</code>
+ without generating anything
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/buffer.html" title="Temporary Output Buffering (buffer[])"><code class="computeroutput">buffer[a]</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Temporarily intercepts the output generated by <code class="computeroutput">a</code>, flushing it only after
+ <code class="computeroutput">a</code> succeeded.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="operators.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../compound_attribute_rules.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/operators.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/operators.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,236 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Generator Operators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="auxiliary.html" title="Auxiliary Generators">
+<link rel="next" href="directives.html" title="Generator Directives">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="auxiliary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="directives.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Generator Operators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.operators"></a><a class="link" href="operators.html" title="Generator Operators">
+ Generator Operators</a>
+</h5></div></div></div>
+
+ See here for more information about <a class="link" href="../../reference/operator.html" title="Operator">Generator
+ Operators</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/operator/not_predicate.html" title="Not Predicate (!a)"><code class="computeroutput">!a</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Not predicate. Ensure that <code class="computeroutput">a</code>
+ does not succeed generating, but don't create any output
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/operator/not_predicate.html" title="Not Predicate (!a)"><code class="computeroutput">&a</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ And predicate. Ensure that <code class="computeroutput">a</code>
+ does succeed generating, but don't create any output
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/operator/optional.html" title="Optional (-a)"><code class="computeroutput">-a</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">optional<A></code>
+ 
+ </td>
+<td>
+ 
+ Optional. Generate <code class="computeroutput">a</code>
+ zero or one time
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/operator/kleene.html" title="Kleene Star (*a)"><code class="computeroutput">*a</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Kleene. Generate <code class="computeroutput">a</code>
+ zero or more times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/operator/plus.html" title="Plus (+a)"><code class="computeroutput">+a</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Plus. Generate <code class="computeroutput">a</code>
+ one or more times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/operator/alternative.html" title="Alternative (a | b)"><code class="computeroutput">a |
+ b</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">variant<A,
+ B></code>
+ 
+ </td>
+<td>
+ 
+ Alternative. Generate <code class="computeroutput">a</code>
+ or <code class="computeroutput">b</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/operator/sequence.html" title="Sequences (a << b)"><code class="computeroutput">a <<
+ b</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">tuple<A,
+ B></code>
+ 
+ </td>
+<td>
+ 
+ Sequence. Generate <code class="computeroutput">a</code>
+ followed by <code class="computeroutput">b</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/operator/list.html" title="Lists (a % b)"><code class="computeroutput">a %
+ b</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ List. Generate <code class="computeroutput">a</code>
+ delimited <code class="computeroutput">b</code> one
+ or more times
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ For more information about the attribute propagation rules implemented
+ by the compound generators please see <a class="link" href="../compound_attribute_rules.html" title="Compound Attribute Rules">Compound
+ Attribute Rules</a>.
+ 
+
+ 
+</blockquote></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="auxiliary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="directives.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/real_number.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/real_number.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,248 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Real Number Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="string.html" title="String Generators">
+<link rel="next" href="signed_int.html" title="Integer Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="signed_int.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Real Number Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.real_number"></a><a class="link" href="real_number.html" title="Real Number Generators">
+ Real Number Generators</a>
+</h5></div></div></div>
+
+ See here for more information about <a class="link" href="../../reference/numeric.html" title="Numeric">Numeric
+ Generators</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric.html" title="Numeric"><code class="computeroutput">lit(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generates <code class="computeroutput">num</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)"><code class="computeroutput">float_</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">float</code>
+ 
+ </td>
+<td>
+ 
+ Generate a real number from a <code class="computeroutput">float</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)"><code class="computeroutput">float_(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">float</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as a real number from a <code class="computeroutput">float</code>,
+ if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)"><code class="computeroutput">double_</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">double</code>
+ 
+ </td>
+<td>
+ 
+ Generate a real number from a <code class="computeroutput">double</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)"><code class="computeroutput">double_(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">double</code>
+ 
+ </td>
+<td>
+ 
+ Generate a <code class="computeroutput">num</code>
+ as a real number from a <code class="computeroutput">double</code>,
+ if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)"><code class="computeroutput">long_double</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long double</code>
+ 
+ </td>
+<td>
+ 
+ Generate a real number from a <code class="computeroutput">long
+ double</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)"><code class="computeroutput">long_double(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long double</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as a real number from a <code class="computeroutput">long
+ double</code>, if an attribute
+ is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)">
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">real_generator<
+ Num, Policies
+>()</pre>
+ </a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>
+ 
+ </td>
+<td>
+ 
+ Generate a real number <code class="computeroutput">Num</code>
+ using the supplied real number formatting policies
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)">
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">real_generator<
+ Num, Policies
+>()(num)</pre>
+ </a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>
+ 
+ </td>
+<td>
+ 
+ Generate real number <code class="computeroutput">num</code>
+ as a <code class="computeroutput">Num</code> using
+ the supplied real number formatting policies, if an attribute
+ is supplied it must match
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="signed_int.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/signed_int.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/signed_int.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,255 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Integer Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="real_number.html" title="Real Number Generators">
+<link rel="next" href="unsigned_int.html" title="Unsigned Integer Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="real_number.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="unsigned_int.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Integer Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.signed_int"></a><a class="link" href="signed_int.html" title="Integer Generators">
+ Integer Generators</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)"><code class="computeroutput">short_</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">short</code>
+ 
+ </td>
+<td>
+ 
+ Generate a short integer
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)"><code class="computeroutput">short_(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">short</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as a short integer, if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)"><code class="computeroutput">int_</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">int</code>
+ 
+ </td>
+<td>
+ 
+ Generate an int
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)"><code class="computeroutput">int_(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">int</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as an int, if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)"><code class="computeroutput">long_</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long</code>
+ 
+ </td>
+<td>
+ 
+ Generate a long integer
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)"><code class="computeroutput">long_(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as long integer, if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)"><code class="computeroutput">long_long</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long long</code>
+ 
+ </td>
+<td>
+ 
+ Generate a long long
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)"><code class="computeroutput">long_long(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long long</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as an long long, if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)">
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int_generator<
+ Num, Radix, force_sign
+>()</pre>
+ </a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>
+ 
+ </td>
+<td>
+ 
+ Generate a <code class="computeroutput">Num</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)">
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int_generator<
+ Num, Radix, force_sign
+>()(num)</pre>
+ </a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>
+ 
+ </td>
+<td>
+ 
+ Generate a <code class="computeroutput">num</code>
+ as a <code class="computeroutput">Num</code>, if
+ an attribute is supplied it must match
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="real_number.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="unsigned_int.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/stream.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/stream.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,194 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Stream Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="unsigned_int.html" title="Unsigned Integer Generators">
+<link rel="next" href="binary.html" title="Binary Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unsigned_int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Stream Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.stream"></a><a class="link" href="stream.html" title="Stream Generators">
+ Stream Generators</a>
+</h5></div></div></div>
+
+ See here for more information about <a class="link" href="../../reference/stream.html" title="Stream">Stream
+ Generators</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/stream.html" title="Stream"><code class="computeroutput">stream</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">hold_any</code>
+ 
+ </td>
+<td>
+ 
+ Generates narrow character (<code class="computeroutput">char</code>)
+ based output using the matching streaming <code class="computeroutput">operator<<()</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/stream.html" title="Stream"><code class="computeroutput">stream(s)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generates narrow character (<code class="computeroutput">char</code>)
+ based output from the immediate argument <code class="computeroutput">s</code>
+ using the matching streaming <code class="computeroutput">operator<<()</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/stream.html" title="Stream"><code class="computeroutput">wstream</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">hold_any</code>
+ 
+ </td>
+<td>
+ 
+ Generates narrow character (<code class="computeroutput">wchar_t</code>)
+ based output using the matching streaming <code class="computeroutput">operator<<()</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/stream.html" title="Stream"><code class="computeroutput">wstream(s)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generates wide character (<code class="computeroutput">wchar_t</code>)
+ based output from the immediate argument <code class="computeroutput">s</code>
+ using the matching streaming <code class="computeroutput">operator<<()</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/stream.html" title="Stream">
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">stream_generator<
+ Char
+>()</pre>
+ </a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">hold_any</code>
+ 
+ </td>
+<td>
+ 
+ Generates output based on the given character type (<code class="computeroutput">Char</code>) using the matching streaming
+ <code class="computeroutput">operator<<()</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/stream.html" title="Stream">
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">stream_generator<
+ Char
+>()(s)</pre>
+ </a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generates output based on the given character type <code class="computeroutput">Char</code> from the immediate argument
+ <code class="computeroutput">s</code> using the matching
+ streaming <code class="computeroutput">operator<<()</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unsigned_int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/string.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/string.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,143 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>String Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="char.html" title="Character Generators">
+<link rel="next" href="real_number.html" title="Real Number Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="real_number.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="String Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.string"></a><a class="link" href="string.html" title="String Generators">
+ String Generators</a>
+</h5></div></div></div>
+
+ See here for more information about String Generators .
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string.html" title="String"><code class="computeroutput">str</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generates <code class="computeroutput">str</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string.html" title="String"><code class="computeroutput">lit(str)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Generates <code class="computeroutput">str</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string.html" title="String"><code class="computeroutput">string</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Str</code>
+ 
+ </td>
+<td>
+ 
+ Generates string supplied as the attribute
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string.html" title="String"><code class="computeroutput">string(str)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Str</code>
+ 
+ </td>
+<td>
+ 
+ Generates <code class="computeroutput">str</code>,
+ if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="real_number.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/unsigned_int.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/primitive_generators/unsigned_int.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,314 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Unsigned Integer Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitive_generators.html" title="Karma Generators">
+<link rel="prev" href="signed_int.html" title="Integer Generators">
+<link rel="next" href="stream.html" title="Stream Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="signed_int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="stream.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Unsigned Integer Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.quick_reference.primitive_generators.unsigned_int"></a><a class="link" href="unsigned_int.html" title="Unsigned Integer Generators">
+ Unsigned Integer Generators</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">ushort_</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned short</code>
+ 
+ </td>
+<td>
+ 
+ Generate an unsigned short integer
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">ushort_(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned short</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as an unsigned short integer, if an attribute is supplied it
+ must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">uint_</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>
+ 
+ </td>
+<td>
+ 
+ Generate an unsigned int
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">uint_(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as an unsigned int, if an attribute is supplied it must match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">ulong_</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long</code>
+ 
+ </td>
+<td>
+ 
+ Generate an unsigned long integer
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">ulong_(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as an unsigned long integer, if an attribute is supplied it must
+ match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">ulong_long</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long
+ long</code>
+ 
+ </td>
+<td>
+ 
+ Generate an unsigned long long
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">ulong_long(num)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long
+ long</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">num</code>
+ as an unsigned long long, if an attribute is supplied it must
+ match
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">bin</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>
+ 
+ </td>
+<td>
+ 
+ Generate a binary integer from an <code class="computeroutput">unsigned
+ int</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">oct</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>
+ 
+ </td>
+<td>
+ 
+ Generate an octal integer from an <code class="computeroutput">unsigned
+ int</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"><code class="computeroutput">hex</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>
+ 
+ </td>
+<td>
+ 
+ Generate a hexadecimal integer from an <code class="computeroutput">unsigned
+ int</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)">
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">uint_generator<
+ Num, Radix
+>()</pre>
+ </a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>
+ 
+ </td>
+<td>
+ 
+ Generate an unsigned <code class="computeroutput">Num</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)">
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">uint_generator<
+ Num, Radix
+>()(num)</pre>
+ </a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>
+ 
+ </td>
+<td>
+ 
+ Generate an unsigned <code class="computeroutput">num</code>
+ as a <code class="computeroutput">Num</code>, if
+ an attribute is supplied it must match
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="signed_int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitive_generators.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="stream.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/semantic_actions.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/quick_reference/semantic_actions.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,75 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Semantic Actions</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="non_terminals.html" title="Non-terminals">
+<link rel="next" href="phoenix.html" title="Phoenix">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="non_terminals.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="phoenix.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Semantic Actions">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.quick_reference.semantic_actions"></a><a class="link" href="semantic_actions.html" title="Semantic Actions">Semantic
+ Actions</a>
+</h4></div></div></div>
+
+ Has the form:
+ 
+<pre class="programlisting">g[f]
+</pre>
+
+ where <code class="computeroutput">f</code> is a function with
+ the signatures:
+ 
+<pre class="programlisting">void f(Attr&);
+void f(Attr&, Context&);
+void f(Attr&, Context&, bool&);
+</pre>
+
+ You can use <code class="computeroutput">Boost.Bind</code>
+ to bind member functions. For function objects, the allowed signatures
+ are:
+ 
+<pre class="programlisting">void operator()(Attr&, unused_type, unused_type) const;
+void operator()(Attr&, Context&, unused_type) const;
+void operator()(Attr&, Context&, bool&) const;
+</pre>
+
+ The <code class="computeroutput">unused_type</code> is used
+ in the signatures above to signify 'don't care'.
+ 
+
+ For more information see <a class="link" href="../tutorials/semantic_actions.html" title="Semantic Actions">Semantic
+ Actions</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="non_terminals.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="phoenix.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,57 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Reference</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../karma.html" title="Karma - Writing Generators">
+<link rel="prev" href="quick_reference/phoenix.html" title="Phoenix">
+<link rel="next" href="reference/generator_concepts.html" title="Generator Concepts">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_reference/phoenix.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../karma.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/generator_concepts.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Reference">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.karma.reference"></a><a class="link" href="reference.html" title="Reference">Reference</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><a href="reference/generator_concepts.html">Generator
+ Concepts</a></dt>
+<dt> Basics</dt>
+<dt> Char</dt>
+<dt>String</dt>
+<dt> Numeric</dt>
+<dt>Stream</dt>
+<dt> Binary</dt>
+<dt>Auxiliary</dt>
+<dt> Directive</dt>
+<dt>Operator</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_reference/phoenix.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../karma.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/generator_concepts.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,65 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Auxiliary</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="binary/binary_big.html" title="Binary Big Endianness Generators">
+<link rel="next" href="auxiliary/eol.html" title="End of Line (eol)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary/binary_big.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary/eol.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Auxiliary">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.auxiliary"></a><a class="link" href="auxiliary.html" title="Auxiliary">Auxiliary</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="auxiliary/eol.html"> End of Line
+ (<code class="computeroutput">eol</code>)</a></dt>
+<dt> Epsilon (eps)</dt>
+<dt> Lazy (lazy)</dt>
+</dl></div>
+
+ This module includes different auxiliary generators not fitting into any
+ of the other categories. It includes the <code class="computeroutput">eol</code>
+ and <code class="computeroutput">eps</code>, <code class="computeroutput">lazy</code> generators.
+ 
+<a name="spirit.karma.reference.auxiliary.module_header"></a><h6>
+<a name="id797514"></a>
+ <a class="link" href="auxiliary.html#spirit.karma.reference.auxiliary.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/auxiliary.hpp>
+#include <boost/spirit/include/karma_auxiliary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary/binary_big.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary/eol.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/eol.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/eol.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,265 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>End of Line (eol)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../auxiliary.html" title="Auxiliary">
+<link rel="prev" href="../auxiliary.html" title="Auxiliary">
+<link rel="next" href="eps.html" title="Epsilon (eps)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="eps.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="End of Line (eol)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.auxiliary.eol"></a><a class="link" href="eol.html" title="End of Line (eol)"> End of Line
+ (<code class="computeroutput">eol</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.auxiliary.eol.description"></a><h6>
+<a name="id797605"></a>
+ <a class="link" href="eol.html#spirit.karma.reference.auxiliary.eol.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">eol</code> component generates
+ a single newline character. It is equivalent to <code class="computeroutput">lit('\n')</code>
+ or simply '\n' (please see the <a class="link" href="../char/char_generator.html" title="Character Generators (char_, lit)"><code class="computeroutput">char_</code></a> generator module for more
+ details).
+ 
+<a name="spirit.karma.reference.auxiliary.eol.header"></a><h6>
+<a name="id797658"></a>
+ <a class="link" href="eol.html#spirit.karma.reference.auxiliary.eol.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/auxiliary/eol.hpp>
+#include <boost/spirit/include/karma_eol.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.auxiliary.eol.namespace"></a><h6>
+<a name="id797732"></a>
+ <a class="link" href="eol.html#spirit.karma.reference.auxiliary.eol.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::eol // alias:
+ boost::spirit::karma::eol</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.auxiliary.eol.model_of"></a><h6>
+<a name="id797810"></a>
+ <a class="link" href="eol.html#spirit.karma.reference.auxiliary.eol.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.auxiliary.eol.expression_semantics"></a><h6>
+<a name="id797849"></a>
+ <a class="link" href="eol.html#spirit.karma.reference.auxiliary.eol.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">eol</code>
+ 
+ </td>
+<td>
+ 
+ Create a component generating a single end of line character
+ in the output. This generator never fails (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.auxiliary.eol.attributes"></a><h6>
+<a name="id797938"></a>
+ <a class="link" href="eol.html#spirit.karma.reference.auxiliary.eol.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">eol</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.auxiliary.eol.complexity"></a><h6>
+<a name="id798016"></a>
+ <a class="link" href="eol.html#spirit.karma.reference.auxiliary.eol.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(1)
+ 
+
+ 
+</blockquote></div>
+
+ The complexity is constant as a single character is generated in the
+ output.
+ 
+<a name="spirit.karma.reference.auxiliary.eol.example"></a><h6>
+<a name="id798043"></a>
+ <a class="link" href="eol.html#spirit.karma.reference.auxiliary.eol.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::eol;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the <code class="computeroutput">eol</code>
+ generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator("\n", eol);
+test_generator("abc\n", "abc" << eol);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="eps.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/eps.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/eps.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,384 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Epsilon (eps)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../auxiliary.html" title="Auxiliary">
+<link rel="prev" href="eol.html" title="End of Line (eol)">
+<link rel="next" href="lazy.html" title="Lazy (lazy)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eol.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lazy.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Epsilon (eps)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.auxiliary.eps"></a><a class="link" href="eps.html" title="Epsilon (eps)"> Epsilon (<code class="computeroutput">eps</code>)</a>
+</h5></div></div></div>
+
+ The family of <code class="computeroutput">eps</code> components
+ allows to create pseudo generators generating an empty string. This feature
+ is sometimes useful either to force a generator to fail or to succeed
+ or to insert semantic actions into the generation process.
+ 
+<a name="spirit.karma.reference.auxiliary.eps.description"></a><h6>
+<a name="id798816"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.description">Description</a>
+ </h6>
+
+ The Epsilon (<code class="computeroutput">eps</code>) is
+ a multi-purpose generator that emits a yero length string.
+ 
+<a name="spirit.karma.reference.auxiliary.eps.simple_form"></a><h6>
+<a name="id798840"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.simple_form">Simple
+ Form</a>
+ </h6>
+
+ In its simplest form, <code class="computeroutput">eps</code>
+ creates a component generating an empty string while always succeeding:
+ 
+<pre class="programlisting">eps // always emits a zero-length string
+</pre>
+
+ This form is usually used to trigger a semantic action unconditionally.
+ For example, it is useful in triggering error messages when a set of
+ alternatives fail:
+ 
+<pre class="programlisting">r = a | b | c | eps[error()]; // Call error if a, b, and c fail to generate
+</pre>
+<a name="spirit.karma.reference.auxiliary.eps.semantic_predicate"></a><h6>
+<a name="id798941"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.semantic_predicate">Semantic
+ Predicate</a>
+ </h6>
+
+ The <code class="computeroutput">eps(b)</code>
+ component generates an empty string as well, but succeeds only if <code class="computeroutput">b</code> is <code class="computeroutput">true</code>
+ and fails otherwise. It's lazy variant <code class="computeroutput">eps(fb)</code> is equivalent to <code class="computeroutput">eps(b)</code> except it evaluates the supplied function
+ <code class="computeroutput">fb</code> at generate time,
+ while using the return value as the criteria to succeed.
+ 
+
+ Semantic predicates allow you to attach a conditional function anywhere
+ in the grammar. In this role, the epsilon takes a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that returns <code class="computeroutput">true</code>
+ or <code class="computeroutput">false</code>. The <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> is typically a test that is called to resolve ambiguity
+ in the grammar. A generator failure will be reported when the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> result evaluates to <code class="computeroutput">false</code>.
+ Otherwise an empty string will be emitted. The general form is:
+ 
+<pre class="programlisting">eps_p(fb) << rest;
+</pre>
+
+ The <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> <code class="computeroutput">fb</code> is
+ called to do a semantic test. If the test returns true, <code class="computeroutput">rest</code> will be evaluated. Otherwise,
+ the production will return early without ever touching rest.
+ 
+<a name="spirit.karma.reference.auxiliary.eps.header"></a><h6>
+<a name="id799128"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/auxiliary/eps.hpp>
+#include <boost/spirit/include/karma_eps.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.auxiliary.eps.namespace"></a><h6>
+<a name="id799202"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::eps // alias:
+ boost::spirit::karma::eps</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.auxiliary.eps.model_of"></a><h6>
+<a name="id799280"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">b</code></dt>
+<dd>
+ A boolean value.
+ </dd>
+<dt><code class="computeroutput">fb</code></dt>
+<dd>
+ A <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a boolean value.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.auxiliary.eps.expression_semantics"></a><h6>
+<a name="id799367"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps</code>
+ 
+ </td>
+<td>
+ 
+ Creates a component generating an empty string. Succeeds always.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps(b)</code>
+ 
+ </td>
+<td>
+ 
+ Creates a component generating an empty string. Succeeds if
+ <code class="computeroutput">b</code> is <code class="computeroutput">true</code> (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps(fb)</code>
+ 
+ </td>
+<td>
+ 
+ Creates a component generating an empty string. Succeeds if
+ <code class="computeroutput">fb</code> returns <code class="computeroutput">true</code> at generate time (except
+ if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.auxiliary.eps.attributes"></a><h6>
+<a name="id799554"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps(b)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps(fb)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.auxiliary.eps.complexity"></a><h6>
+<a name="id799716"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(1)
+ 
+
+ 
+</blockquote></div>
+
+ The complexity is constant as no output is generated.
+ 
+<a name="spirit.karma.reference.auxiliary.eps.example"></a><h6>
+<a name="id799744"></a>
+ <a class="link" href="eps.html#spirit.karma.reference.auxiliary.eps.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::eps;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the <code class="computeroutput">eps</code>
+ generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator("abc", eps[cout << "starting eps example"] << "abc");
+test_generator("abc", eps(true) << "abc");
+test_generator("", eps(false) << "abc"); // fails as eps expression is 'false'
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eol.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lazy.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/lazy.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/auxiliary/lazy.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,347 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lazy (lazy)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../auxiliary.html" title="Auxiliary">
+<link rel="prev" href="eps.html" title="Epsilon (eps)">
+<link rel="next" href="../directive.html" title="Directive">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eps.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../directive.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lazy (lazy)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.auxiliary.lazy"></a><a class="link" href="lazy.html" title="Lazy (lazy)"> Lazy (<code class="computeroutput">lazy</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.auxiliary.lazy.description"></a><h6>
+<a name="id800590"></a>
+ <a class="link" href="lazy.html#spirit.karma.reference.auxiliary.lazy.description">Description</a>
+ </h6>
+
+ The familiy of <code class="computeroutput">lazy</code> components
+ allows to use a dynamically returned generator component for output generation.
+ It calls the provided function or function object at generate time using
+ its return value as the actual generator to produce the output.
+ 
+<a name="spirit.karma.reference.auxiliary.lazy.header"></a><h6>
+<a name="id800614"></a>
+ <a class="link" href="lazy.html#spirit.karma.reference.auxiliary.lazy.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/auxiliary/lazy.hpp>
+#include <boost/spirit/include/karma_lazy.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.auxiliary.lazy.namespace"></a><h6>
+<a name="id800688"></a>
+ <a class="link" href="lazy.html#spirit.karma.reference.auxiliary.lazy.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lazy // alias:
+ boost::spirit::karma::lazy</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.auxiliary.lazy.model_of"></a><h6>
+<a name="id800767"></a>
+ <a class="link" href="lazy.html#spirit.karma.reference.auxiliary.lazy.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/generator.html" title="Generator"><code class="computeroutput">Generator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">fg</code></dt>
+<dd>
+ A function or function object that evaluates to a generator object
+ (an object exposing the <a class="link" href="../generator_concepts/generator.html" title="Generator"><code class="computeroutput">Generator</code></a>). This function
+ will be invoked at generate time.
+ </dd>
+</dl>
+</div>
+
+ The signature of <code class="computeroutput">fg</code> is
+ expected to be
+ 
+<pre class="programlisting">G f(Unused, Context)
+</pre>
+
+ where <code class="computeroutput">G</code>, the function's
+ return value, is the type of the generator to be invoked, and <code class="computeroutput">Context</code> is the generators's Context
+ type (The first argument is <code class="computeroutput">unused</code>
+ to make the <code class="computeroutput">Context</code> the
+ second argument. This is done for uniformity with <a class="link" href="../../tutorials/semantic_actions.html" title="Semantic Actions">Semantic
+ Actions</a>).
+ 
+<a name="spirit.karma.reference.auxiliary.lazy.expression_semantics"></a><h6>
+<a name="id800918"></a>
+ <a class="link" href="lazy.html#spirit.karma.reference.auxiliary.lazy.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/generator.html" title="Generator"><code class="computeroutput">Generator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">fg</code>
+ 
+ </td>
+<td>
+ 
+ The Boost.Phoenix
+ function object <code class="computeroutput">fg</code>
+ will be invoked at generate time. It is expected to return a
+ generator instance. This generator is then invoked in order to
+ generate the output. This generator will succeed as long as the
+ invoked generated succeeds as well (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lazy(fg)</code>
+ 
+ </td>
+<td>
+ 
+ The function or function object will be invoked at generate time.
+ It is expected to return a generator instance (note this version
+ of <code class="computeroutput">lazy</code> does
+ not require <code class="computeroutput">fg</code>
+ to be a Boost.Phoenix
+ function object). This generator is then invoked in order to
+ generate the output. This generator will succeed as long as the
+ invoked generated succeeds as well (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.auxiliary.lazy.attributes"></a><h6>
+<a name="id802446"></a>
+ <a class="link" href="lazy.html#spirit.karma.reference.auxiliary.lazy.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">fg</code>
+ 
+ </td>
+<td>
+ 
+ The attribute type <code class="computeroutput">G</code>
+ as exposed by the generator <code class="computeroutput">g</code>
+ returned from <code class="computeroutput">fg</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lazy(fg)</code>
+ 
+ </td>
+<td>
+ 
+ The attribute type <code class="computeroutput">G</code>
+ as exposed by the generator <code class="computeroutput">g</code>
+ returned from <code class="computeroutput">fg</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.auxiliary.lazy.complexity"></a><h6>
+<a name="id802595"></a>
+ <a class="link" href="lazy.html#spirit.karma.reference.auxiliary.lazy.complexity">Complexity</a>
+ </h6>
+
+ The complexity of the <code class="computeroutput">lazy</code>
+ component is determined by the complexity of the generator returned from
+ <code class="computeroutput">fg</code>.
+ 
+<a name="spirit.karma.reference.auxiliary.lazy.example"></a><h6>
+<a name="id802626"></a>
+ <a class="link" href="lazy.html#spirit.karma.reference.auxiliary.lazy.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::lazy;
+using boost::spirit::karma::_1;
+using boost::spirit::ascii::string;
+using boost::phoenix::val;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the <code class="computeroutput">lazy</code>
+ generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator_attr("abc", lazy(val(string)), "abc");
+test_generator("abc", lazy(val(string))[_1 = "abc"]);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eps.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../directive.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/binary.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/binary.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,68 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Binary</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="stream/stream.html" title="Stream (stream, wstream, etc.)">
+<link rel="next" href="binary/binary_native.html" title="Binary Native Endianness Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="stream/stream.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary/binary_native.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Binary">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.binary"></a><a class="link" href="binary.html" title="Binary"> Binary</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="binary/binary_native.html"> Binary
+ Native Endianness Generators</a></dt>
+<dt><a href="binary/binary_little.html"> Binary
+ Little Endianness Generators</a></dt>
+<dt><a href="binary/binary_big.html"> Binary
+ Big Endianness Generators</a></dt>
+</dl></div>
+
+ This module includes different generators allowing to output binary data.
+ It includes generators for default, little, and big endian binary output
+ and a <code class="computeroutput">pad</code> generator allowing
+ to control padding of the generated output stream.
+ 
+<a name="spirit.karma.reference.binary.module_header"></a><h6>
+<a name="id785226"></a>
+ <a class="link" href="binary.html#spirit.karma.reference.binary.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/binary.hpp>
+#include <boost/spirit/include/karma_binary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="stream/stream.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary/binary_native.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/binary_big.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/binary_big.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,476 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Binary Big Endianness Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../binary.html" title="Binary">
+<link rel="prev" href="binary_little.html" title="Binary Little Endianness Generators">
+<link rel="next" href="../auxiliary.html" title="Auxiliary">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary_little.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Binary Big Endianness Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.binary.binary_big"></a><a class="link" href="binary_big.html" title="Binary Big Endianness Generators"> Binary
+ Big Endianness Generators</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.binary.binary_big.description"></a><h6>
+<a name="id792396"></a>
+ <a class="link" href="binary_big.html#spirit.karma.reference.binary.binary_big.description">Description</a>
+ </h6>
+
+ The big native endianness generators described in this section are used
+ to emit binary byte streams layed out conforming to the big endianess
+ byte order.
+ 
+<a name="spirit.karma.reference.binary.binary_big.header"></a><h6>
+<a name="id792412"></a>
+ <a class="link" href="binary_big.html#spirit.karma.reference.binary.binary_big.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/binary.hpp>
+#include <boost/spirit/include/karma_binary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.binary.binary_big.namespace"></a><h6>
+<a name="id792487"></a>
+ <a class="link" href="binary_big.html#spirit.karma.reference.binary.binary_big.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::big_word //
+ alias: boost::spirit::karma::big_word</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::big_dword //
+ alias: boost::spirit::karma::big_dword</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::big_qword //
+ alias: boost::spirit::karma::big_qword</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ The generators <code class="computeroutput">big_qword</code>
+ and <code class="computeroutput">big_qword(qw)</code>
+ are only available on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code> is defined (i.e.
+ on platforms having native support for <code class="computeroutput">unsigned
+ long long</code>
+ (64 bit) integer types).
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.binary.binary_big.model_of"></a><h6>
+<a name="id792699"></a>
+ <a class="link" href="binary_big.html#spirit.karma.reference.binary.binary_big.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">w</code></dt>
+<dd>
+ A 16 bit binary value or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always interpreted using native endianness.
+ </dd>
+<dt><code class="computeroutput">dw</code></dt>
+<dd>
+ A 32 bit binary value or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always interpreted using native endianness.
+ </dd>
+<dt><code class="computeroutput">qw</code></dt>
+<dd>
+ A 64 bit binary value or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always interpreted using native endianness.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.binary.binary_big.expression_semantics"></a><h6>
+<a name="id792813"></a>
+ <a class="link" href="binary_big.html#spirit.karma.reference.binary.binary_big.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_word</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 16
+ bits of the mandatory attribute in big endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_dword</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 32
+ bits of the mandatory attribute in big endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_qword</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 64
+ bits of the mandatory attribute in big endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_word(w)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 16
+ bits of the immediate parameter in big endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 32
+ bits of the immediate parameter in big endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 64
+ bits of the immediate parameter in big endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.binary.binary_big.attributes"></a><h6>
+<a name="id793054"></a>
+ <a class="link" href="binary_big.html#spirit.karma.reference.binary.binary_big.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_word</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least16_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_dword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least32_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_qword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least64_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_word(w)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.binary.binary_big.complexity"></a><h6>
+<a name="id793342"></a>
+ <a class="link" href="binary_big.html#spirit.karma.reference.binary.binary_big.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of bytes emitted by the binary generator
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.binary.binary_big.example"></a><h6>
+<a name="id793366"></a>
+ <a class="link" href="binary_big.html#spirit.karma.reference.binary.binary_big.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_binary_generator(char const* expected, std::size_t size, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && !std::memcmp(s.c_str(), expected, size))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_binary_generator_attr(char const* expected, std::size_t size, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && !std::memcmp(s.c_str(), expected, size))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the big binary generators:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_binary_generator("\x02\x01", 2, big_word(0x0201));
+test_binary_generator("\x04\x03\x02\x01", 4, big_dword(0x04030201));
+test_binary_generator("\x08\x07\x06\x05\x04\x03\x02\x01", 8, big_qword(0x0807060504030201LL));
+
+test_binary_generator_attr("\x02\x01", 2, big_word, 0x0201);
+test_binary_generator_attr("\x04\x03\x02\x01", 4, big_dword, 0x04030201);
+test_binary_generator_attr("\x08\x07\x06\x05\x04\x03\x02\x01", 8, big_qword, 0x0807060504030201LL);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary_little.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/binary_little.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/binary_little.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,476 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Binary Little Endianness Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../binary.html" title="Binary">
+<link rel="prev" href="binary_native.html" title="Binary Native Endianness Generators">
+<link rel="next" href="binary_big.html" title="Binary Big Endianness Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary_native.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary_big.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Binary Little Endianness Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.binary.binary_little"></a><a class="link" href="binary_little.html" title="Binary Little Endianness Generators"> Binary
+ Little Endianness Generators</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.binary.binary_little.description"></a><h6>
+<a name="id789922"></a>
+ <a class="link" href="binary_little.html#spirit.karma.reference.binary.binary_little.description">Description</a>
+ </h6>
+
+ The little native endianness generators described in this section are
+ used to emit binary byte streams layed out conforming to the little endianess
+ byte order.
+ 
+<a name="spirit.karma.reference.binary.binary_little.header"></a><h6>
+<a name="id789939"></a>
+ <a class="link" href="binary_little.html#spirit.karma.reference.binary.binary_little.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/binary.hpp>
+#include <boost/spirit/include/karma_binary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.binary.binary_little.namespace"></a><h6>
+<a name="id790013"></a>
+ <a class="link" href="binary_little.html#spirit.karma.reference.binary.binary_little.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::little_word //
+ alias: boost::spirit::karma::little_word</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::little_dword //
+ alias: boost::spirit::karma::little_dword</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::little_qword //
+ alias: boost::spirit::karma::little_qword</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ The generators <code class="computeroutput">little_qword</code>
+ and <code class="computeroutput">little_qword(qw)</code>
+ are only available on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code> is defined (i.e.
+ on platforms having native support for <code class="computeroutput">unsigned
+ long long</code>
+ (64 bit) integer types).
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.binary.binary_little.model_of"></a><h6>
+<a name="id790223"></a>
+ <a class="link" href="binary_little.html#spirit.karma.reference.binary.binary_little.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">w</code></dt>
+<dd>
+ A 16 bit binary value or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always interpreted using native endianness.
+ </dd>
+<dt><code class="computeroutput">dw</code></dt>
+<dd>
+ A 32 bit binary value or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always interpreted using native endianness.
+ </dd>
+<dt><code class="computeroutput">qw</code></dt>
+<dd>
+ A 64 bit binary value or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always interpreted using native endianness.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.binary.binary_little.expression_semantics"></a><h6>
+<a name="id790335"></a>
+ <a class="link" href="binary_little.html#spirit.karma.reference.binary.binary_little.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_word</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 16
+ bits of the mandatory attribute in little endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_dword</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 32
+ bits of the mandatory attribute in little endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_qword</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 64
+ bits of the mandatory attribute in little endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_word(w)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 16
+ bits of the immediate parameter in little endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 32
+ bits of the immediate parameter in little endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 64
+ bits of the immediate parameter in little endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.binary.binary_little.attributes"></a><h6>
+<a name="id790574"></a>
+ <a class="link" href="binary_little.html#spirit.karma.reference.binary.binary_little.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_word</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least16_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_dword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least32_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_qword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least64_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_word(w)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.binary.binary_little.complexity"></a><h6>
+<a name="id790862"></a>
+ <a class="link" href="binary_little.html#spirit.karma.reference.binary.binary_little.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of bytes emitted by the binary generator
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.binary.binary_little.example"></a><h6>
+<a name="id790886"></a>
+ <a class="link" href="binary_little.html#spirit.karma.reference.binary.binary_little.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_binary_generator(char const* expected, std::size_t size, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && !std::memcmp(s.c_str(), expected, size))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_binary_generator_attr(char const* expected, std::size_t size, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && !std::memcmp(s.c_str(), expected, size))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the little binary generators:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_binary_generator("\x01\x02", 2, little_word(0x0201));
+test_binary_generator("\x01\x02\x03\x04", 4, little_dword(0x04030201));
+test_binary_generator("\x01\x02\x03\x04\x05\x06\x07\x08", 8, little_qword(0x0807060504030201LL));
+
+test_binary_generator_attr("\x01\x02", 2, little_word, 0x0201);
+test_binary_generator_attr("\x01\x02\x03\x04", 4, little_dword, 0x04030201);
+test_binary_generator_attr("\x01\x02\x03\x04\x05\x06\x07\x08", 8, little_qword, 0x0807060504030201LL);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary_native.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary_big.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/binary_native.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/binary/binary_native.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,566 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Binary Native Endianness Generators</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../binary.html" title="Binary">
+<link rel="prev" href="../binary.html" title="Binary">
+<link rel="next" href="binary_little.html" title="Binary Little Endianness Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../binary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary_little.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Binary Native Endianness Generators">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.binary.binary_native"></a><a class="link" href="binary_native.html" title="Binary Native Endianness Generators"> Binary
+ Native Endianness Generators</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.binary.binary_native.description"></a><h6>
+<a name="id785310"></a>
+ <a class="link" href="binary_native.html#spirit.karma.reference.binary.binary_native.description">Description</a>
+ </h6>
+
+ The binary native endianness generators described in this section are
+ used to emit binary byte streams layed out conforming to the native endianess
+ (byte order) of the target architecture.
+ 
+<a name="spirit.karma.reference.binary.binary_native.header"></a><h6>
+<a name="id785326"></a>
+ <a class="link" href="binary_native.html#spirit.karma.reference.binary.binary_native.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/binary.hpp>
+#include <boost/spirit/include/karma_binary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.binary.binary_native.namespace"></a><h6>
+<a name="id785401"></a>
+ <a class="link" href="binary_native.html#spirit.karma.reference.binary.binary_native.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::byte_ // alias:
+ boost::spirit::karma::byte_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::word // alias:
+ boost::spirit::karma::word</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::dword // alias:
+ boost::spirit::karma::dword</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::qword // alias:
+ boost::spirit::karma::qword</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ The generators <code class="computeroutput">qword</code>
+ and <code class="computeroutput">qword(qw)</code>
+ are only available on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code> is defined (i.e.
+ on platforms having native support for <code class="computeroutput">unsigned
+ long long</code>
+ (64 bit) integer types).
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.binary.binary_native.model_of"></a><h6>
+<a name="id786744"></a>
+ <a class="link" href="binary_native.html#spirit.karma.reference.binary.binary_native.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">b</code></dt>
+<dd>
+ A single byte (8 bit binary value) or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a single byte
+ </dd>
+<dt><code class="computeroutput">w</code></dt>
+<dd>
+ A 16 bit binary value or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always interpreted using native endianness.
+ </dd>
+<dt><code class="computeroutput">dw</code></dt>
+<dd>
+ A 32 bit binary value or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always interpreted using native endianness.
+ </dd>
+<dt><code class="computeroutput">qw</code></dt>
+<dd>
+ A 64 bit binary value or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always interpreted using native endianness.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.binary.binary_native.expression_semantics"></a><h6>
+<a name="id786880"></a>
+ <a class="link" href="binary_native.html#spirit.karma.reference.binary.binary_native.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">byte_</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant byte
+ of the mandatory attribute. This generator never fails (except
+ if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">word</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 16
+ bits of the mandatory attribute in native endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">dword</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 32
+ bits of the mandatory attribute in native endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">qword</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 64
+ bits of the mandatory attribute in native endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">byte_(b)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant byte
+ of the immediate parameter. This generator never fails (except
+ if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">word(w)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 16
+ bits of the immediate parameter in native endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 32
+ bits of the immediate parameter in native endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ Output the binary representation of the least significant 64
+ bits of the immediate parameter in native endian representation.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.binary.binary_native.attributes"></a><h6>
+<a name="id787178"></a>
+ <a class="link" href="binary_native.html#spirit.karma.reference.binary.binary_native.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">byte_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least8_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">word</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least16_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">dword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least32_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">qword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least64_t</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">byte_(b)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">word(w)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.binary.binary_native.complexity"></a><h6>
+<a name="id787546"></a>
+ <a class="link" href="binary_native.html#spirit.karma.reference.binary.binary_native.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of bytes emitted by the binary generator
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.binary.binary_native.example"></a><h6>
+<a name="id787570"></a>
+ <a class="link" href="binary_native.html#spirit.karma.reference.binary.binary_native.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_binary_generator(char const* expected, std::size_t size, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && !std::memcmp(s.c_str(), expected, size))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_binary_generator_attr(char const* expected, std::size_t size, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && !std::memcmp(s.c_str(), expected, size))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the native binary generators with some results for little
+ endian platforms:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_binary_generator("\x01", 1, byte_(0x01));
+test_binary_generator("\x01\x02", 2, word(0x0201));
+test_binary_generator("\x01\x02\x03\x04", 4, dword(0x04030201));
+test_binary_generator("\x01\x02\x03\x04\x05\x06\x07\x08", 8, qword(0x0807060504030201LL));
+
+test_binary_generator_attr("\x01", 1, byte_, 0x01);
+test_binary_generator_attr("\x01\x02", 2, word, 0x0201);
+test_binary_generator_attr("\x01\x02\x03\x04", 4, dword, 0x04030201);
+test_binary_generator_attr("\x01\x02\x03\x04\x05\x06\x07\x08", 8, qword, 0x0807060504030201LL);
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the native binary generators with some results for big
+ endian platforms:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_binary_generator("\x01", 1, byte_(0x01));
+test_binary_generator("\x02\x01", 2, word(0x0201));
+test_binary_generator("\x04\x03\x02\x01", 4, dword(0x04030201));
+test_binary_generator("\x08\x07\x06\x05\x04\x03\x02\x01", 8, qword(0x0807060504030201LL));
+
+test_binary_generator_attr("\x01", 1, byte_, 0x01);
+test_binary_generator_attr("\x02\x01", 2, word, 0x0201);
+test_binary_generator_attr("\x04\x03\x02\x01", 4, dword, 0x04030201);
+test_binary_generator_attr("\x08\x07\x06\x05\x04\x03\x02\x01", 8, qword, 0x0807060504030201LL);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../binary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary_little.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/char.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/char.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,69 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Char</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="karma_basics.html" title="Basics">
+<link rel="next" href="char/char_generator.html" title="Character Generators (char_, lit)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="karma_basics.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char/char_generator.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Char">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.char"></a><a class="link" href="char.html" title="Char"> Char</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="char/char_generator.html"> Character
+ Generators (<code class="computeroutput">char_</code>, <code class="computeroutput">lit</code>)</a></dt>
+<dt><a href="char/char_class.html"> Character
+ Classification (<code class="computeroutput">alnum</code>,
+ <code class="computeroutput">digit</code>, etc.)</a></dt>
+</dl></div>
+
+ This module includes different character oriented generators allowing to
+ output single characters. Currently, it includes literal chars (e.g. <code class="computeroutput">'x'</code>, <code class="computeroutput">L'x'</code>), <code class="computeroutput">char_</code>
+ (single characters, ranges and character sets) and the encoding specific
+ character classifiers (<code class="computeroutput">alnum</code>,
+ <code class="computeroutput">alpha</code>, <code class="computeroutput">digit</code>,
+ <code class="computeroutput">xdigit</code>, etc.).
+ 
+<a name="spirit.karma.reference.char.module_header"></a><h6>
+<a name="id748436"></a>
+ <a class="link" href="char.html#spirit.karma.reference.char.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/char.hpp>
+#include <boost/spirit/include/karma_char.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="karma_basics.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char/char_generator.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/char/char_class.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/char/char_class.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,536 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Character Classification (alnum, digit, etc.)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../char.html" title="Char">
+<link rel="prev" href="char_generator.html" title="Character Generators (char_, lit)">
+<link rel="next" href="../string.html" title="String">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char_generator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../char.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../string.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Character Classification (alnum, digit, etc.)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.char.char_class"></a><a class="link" href="char_class.html" title="Character Classification (alnum, digit, etc.)"> Character
+ Classification (<code class="computeroutput">alnum</code>,
+ <code class="computeroutput">digit</code>, etc.)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.char.char_class.description"></a><h6>
+<a name="id754305"></a>
+ <a class="link" href="char_class.html#spirit.karma.reference.char.char_class.description">Description</a>
+ </h6>
+
+ The library has the full repertoire of single character generators for
+ character classification. This includes the usual <code class="computeroutput">alnum</code>,
+ <code class="computeroutput">alpha</code>, <code class="computeroutput">digit</code>, <code class="computeroutput">xdigit</code>,
+ etc. generators. These generators have an associated <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>. This is needed when doing basic operations
+ such as forcing lower or upper case.
+ 
+<a name="spirit.karma.reference.char.char_class.header"></a><h6>
+<a name="id754356"></a>
+ <a class="link" href="char_class.html#spirit.karma.reference.char.char_class.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/char/char_class.hpp>
+#include <boost/spirit/include/karma_char_class.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.char.char_class.namespace"></a><h6>
+<a name="id754430"></a>
+ <a class="link" href="char_class.html#spirit.karma.reference.char.char_class.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">ns::alnum</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::alpha</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::blank</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::cntrl</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::digit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::graph</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::lower</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::print</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::punct</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::space</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::upper</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::xdigit</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+
+ In the table above, <code class="computeroutput">ns</code>
+ is a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> used by the corresponding character class generator.
+ All listed generators have a mandatory attribute <code class="computeroutput">Ch</code>
+ and will not compile if no attribute is associated.
+ 
+<a name="spirit.karma.reference.char.char_class.model_of"></a><h6>
+<a name="id754796"></a>
+ <a class="link" href="char_class.html#spirit.karma.reference.char.char_class.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">ns</code></dt>
+<dd>
+ A <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.char.char_class.expression_semantics"></a><h6>
+<a name="id754864"></a>
+ <a class="link" href="char_class.html#spirit.karma.reference.char.char_class.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::alnum</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::isalnum</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::alpha</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::isalpha</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::blank</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::isblank</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::cntrl</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::iscntrl</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::digit</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::isdigit</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::graph</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::isgraph</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::print</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::isprint</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::punct</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::ispunct</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::xdigit</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::isxdigit</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::lower</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::islower</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::upper</code>
+ 
+ </td>
+<td>
+ 
+ If the mandatory attribute satisfies the concept of <code class="computeroutput">std::isupper</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::space</code>
+ 
+ </td>
+<td>
+ 
+ If the optional attribute satisfies the concept of <code class="computeroutput">std::isspace</code> in the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> the generator succeeds after emitting
+ its attribute (except if the underlying output stream reports
+ an error). This generator fails otherwise while not generating
+ anything.If no attribute is supplied this generator emits a single
+ space character in the character set defined by <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ Possible values for <code class="computeroutput">ns</code>
+ are described in the section <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<div class="note" title="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">
+
+ The generators <code class="computeroutput">alpha</code>
+ and <code class="computeroutput">alnum</code> might seem
+ to behave unexpected if used inside a <code class="computeroutput">lower[]</code> or <code class="computeroutput">upper[]</code> directive. Both directives additionally
+ apply the semanitics of <code class="computeroutput">std::islower</code>
+ or <code class="computeroutput">std::isupper</code> to the respective character
+ class. Some examples:
+
+<pre class="programlisting">std::string s;
+std::back_insert_iterator<std::string> out(s);
+generate(out, lower[alpha], 'a'); // succeeds emitting 'a'
+generate(out, lower[alpha], 'A'); // fails
+</pre>
+
+ The generator directive <code class="computeroutput">upper[]</code> behaves correspondingly.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.char.char_class.attributes"></a><h6>
+<a name="id757055"></a>
+ <a class="link" href="char_class.html#spirit.karma.reference.char.char_class.attributes">Attributes</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ All listed character class generators can take any attribute <code class="computeroutput">Ch</code>. All character class generators
+ (except <code class="computeroutput">space</code>) require
+ an attribute and will fail compiling otherwise.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.char.char_class.complexity"></a><h6>
+<a name="id757095"></a>
+ <a class="link" href="char_class.html#spirit.karma.reference.char.char_class.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(1)
+ 
+
+ 
+</blockquote></div>
+
+ The complexity is constant as the generators emit not more than one character
+ per invocation.
+ 
+<a name="spirit.karma.reference.char.char_class.example"></a><h6>
+<a name="id757122"></a>
+ <a class="link" href="char_class.html#spirit.karma.reference.char.char_class.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::alpha;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of an <code class="computeroutput">alpha</code>
+ generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator_attr("a", alpha, 'a');
+test_generator_attr("A", alpha, 'A');
+test_generator_attr("", alpha, '1'); // fails (as isalpha('1') is false)
+test_generator_attr("A", upper[alpha], 'a');
+test_generator_attr("", upper[alpha], 'a'); // fails (as isupper('a') is false)
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char_generator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../char.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../string.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/char/char_generator.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/char/char_generator.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,815 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Character Generators (char_, lit)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../char.html" title="Char">
+<link rel="prev" href="../char.html" title="Char">
+<link rel="next" href="char_class.html" title="Character Classification (alnum, digit, etc.)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../char.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char_class.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Character Generators (char_, lit)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.char.char_generator"></a><a class="link" href="char_generator.html" title="Character Generators (char_, lit)"> Character
+ Generators (<code class="computeroutput">char_</code>, <code class="computeroutput">lit</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.char.char_generator.description"></a><h6>
+<a name="id748534"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.description">Description</a>
+ </h6>
+
+ The character generators described in this section are:
+ 
+
+ The <code class="computeroutput">char_</code> generator emits
+ single characters. The <code class="computeroutput">char_</code>
+ generator has an associated <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>. This is needed when doing basic operations
+ such as forcing lower or upper case and dealing with character ranges.
+ 
+
+ There are various forms of <code class="computeroutput">char_</code>.
+ 
+<a name="spirit.karma.reference.char.char_generator.char_"></a><h6>
+<a name="id748584"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.char_">char_</a>
+ </h6>
+
+ The no argument form of <code class="computeroutput">char_</code>
+ emits any character in the associated <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<pre class="programlisting">char_ // emits any character as supplied by the attribute
+</pre>
+<a name="spirit.karma.reference.char.char_generator.char__ch_"></a><h6>
+<a name="id748625"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.char__ch_">char_(ch)</a>
+ </h6>
+
+ The single argument form of <code class="computeroutput">char_</code>
+ (with a character argument) emits the supplied character.
+ 
+<pre class="programlisting">char_('x') // emits 'x'
+char_(L'x') // emits L'x'
+char_(x) // emits x (a char)
+</pre>
+<a name="spirit.karma.reference.char.char_generator.char__first__last_"></a><h6>
+<a name="id748716"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.char__first__last_">char_(first,
+ last)</a>
+ </h6>
+
+ <code class="computeroutput">char_</code> with two arguments,
+ emits any character from a range of characters as supplied by the attribute.
+ 
+<pre class="programlisting">char_('a','z') // alphabetic characters
+char_(L'0',L'9') // digits
+</pre>
+
+ A range of characters is created from a low-high character pair. Such
+ a generator emits a single character that is in the range, including
+ both endpoints. Note, the first character must be before
+ the second, according to the underlying <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+
+ Character mapping is inherently platform dependent. It is not guaranteed
+ in the standard for example that <code class="computeroutput">'A'
+ < 'Z'</code>,
+ that is why in Spirit2, we purposely attach a specific <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> (such as ASCII, ISO-8859-1) to the <code class="computeroutput">char_</code> generator to eliminate such ambiguities.
+ 
+<div class="note" title="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">
+
+ Sparse bit vectors
+ 
+
+ To accomodate 16/32 and 64 bit characters, the char-set statically
+ switches from a <code class="computeroutput">std::bitset</code>
+ implementation when the character type is not greater than 8 bits,
+ to a sparse bit/boolean set which uses a sorted vector of disjoint
+ ranges (<code class="computeroutput">range_run</code>).
+ The set is constructed from ranges such that adjacent or overlapping
+ ranges are coalesced.
+ 
+
+ <code class="computeroutput">range_runs</code> are very
+ space-economical in situations where there are lots of ranges and a
+ few individual disjoint values. Searching is O(log n) where n is the
+ number of ranges.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.char.char_generator.char__def_"></a><h6>
+<a name="id748899"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.char__def_">char_(def)</a>
+ </h6>
+
+ Lastly, when given a string (a plain C string, a <code class="computeroutput">std::basic_string</code>,
+ etc.), the string is regarded as a char-set definition string following
+ a syntax that resembles posix style regular expression character sets
+ (except that double quotes delimit the set elements instead of square
+ brackets and there is no special negation ^ character). Examples:
+ 
+<pre class="programlisting">char_("a-zA-Z") // alphabetic characters
+char_("0-9a-fA-F") // hexadecimal characters
+char_("actgACTG") // DNA identifiers
+char_("\x7f\x7e") // Hexadecimal 0x7F and 0x7E
+</pre>
+
+ These generators emit any character from a range of characters as supplied
+ by the attribute.
+ 
+<a name="spirit.karma.reference.char.char_generator.lit_ch_"></a><h6>
+<a name="id750664"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.lit_ch_">lit(ch)</a>
+ </h6>
+
+ <code class="computeroutput">lit</code>, when passed a single
+ character, behaves like the single argument <code class="computeroutput">char_</code>
+ except that <code class="computeroutput">lit</code> does
+ not consume an attribute. A plain <code class="computeroutput">char</code>
+ or <code class="computeroutput">wchar_t</code> is equivalent
+ to a <code class="computeroutput">lit</code>.
+ 
+<div class="note" title="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">
+ <code class="computeroutput">lit</code> is reused by the
+ <a class="link" href="../string.html" title="String">String Generators</a>,
+ the char generators, and the Numeric Generators (see <a class="link" href="../numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)">signed
+ integer</a>, <a class="link" href="../numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)">unsigned
+ integer</a>, and <a class="link" href="../numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)">real
+ number</a> generators). In general, a char generator is created
+ when you pass in a character, a string generator is created when you
+ pass in a string, and a numeric generator is created when you use a
+ numeric literal. The exception is when you pass a single element literal
+ string, e.g. <code class="computeroutput">lit("x")</code>.
+ In this case, we optimize this to create a char generator instead of
+ a string generator.
+ </td></tr>
+</table></div>
+
+ Examples:
+ 
+<pre class="programlisting">'x'
+lit('x')
+lit(L'x')
+lit(c) // c is a char
+</pre>
+<a name="spirit.karma.reference.char.char_generator.header"></a><h6>
+<a name="id750842"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/char/char.hpp>
+#include <boost/spirit/include/karma_char_.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.char.char_generator.namespace"></a><h6>
+<a name="id750916"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lit // alias:
+ boost::spirit::karma::lit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::char_</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+
+ In the table above, <code class="computeroutput">ns</code>
+ is a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<a name="spirit.karma.reference.char.char_generator.model_of"></a><h6>
+<a name="id751035"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">ch</code>,
+ <code class="computeroutput">ch1</code>, <code class="computeroutput">ch2</code></dt>
+<dd>
+ Character-class specific character (See Character Class Types), or
+ a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a character-class specific character
+ value
+ </dd>
+<dt><code class="computeroutput">cs</code></dt>
+<dd>
+ Character-set specifier string (See Character Class Types), or a
+ <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a character-set specifier string,
+ or a pointer/reference to a null-terminated array of characters.
+ This string specifies a char-set definition string following a syntax
+ that resembles posix style regular expression character sets (except
+ the square brackets and the negation <code class="computeroutput">^</code>
+ character).
+ </dd>
+<dt><code class="computeroutput">ns</code></dt>
+<dd>
+ A <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ </dd>
+<dt><code class="computeroutput">cg</code></dt>
+<dd>
+ A char generator, a char range generator, or a char set generator.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.char.char_generator.expression_semantics"></a><h6>
+<a name="id751189"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ch</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character literal <code class="computeroutput">ch</code>.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(ch)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character literal <code class="computeroutput">ch</code>.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character provided by a mandatory attribute interpreted
+ in the character set defined by <code class="computeroutput">ns</code>.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(ch)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character <code class="computeroutput">ch</code>
+ as provided by the immediate literal value the generator is initialized
+ from. If this generator has an associated attribute it succeeds
+ only as long as the attribute is equal to the immediate literal
+ (except if the underlying output stream reports an error). Otherwise
+ this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_("c")</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character <code class="computeroutput">c</code>
+ as provided by the immediate literal value the generator is initialized
+ from. If this generator has an associated attribute it succeeds
+ only as long as the attribute is equal to the immediate literal
+ (except if the underlying output stream reports an error). Otherwise
+ this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(ch1,
+ ch2)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character provided by a mandatory attribute interpreted
+ in the character set defined by <code class="computeroutput">ns</code>.
+ The generator succeeds as long as the attribute belongs to the
+ character range <code class="computeroutput">[ch1,
+ ch2]</code>
+ (except if the underlying output stream reports an error). Otherwise
+ this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(cs)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character provided by a mandatory attribute interpreted
+ in the character set defined by <code class="computeroutput">ns</code>.
+ The generator succeeds as long as the attribute belongs to the
+ character set <code class="computeroutput">cs</code>
+ (except if the underlying output stream reports an error). Otherwise
+ this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">~cg</code>
+ 
+ </td>
+<td>
+ 
+ Negate <code class="computeroutput">cg</code>. The
+ result is a negated char generator that inverts the test condition
+ of the character generator it is attached to.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ A character <code class="computeroutput">ch</code> is assumed
+ to belong to the character range defined by <code class="computeroutput">ns::char_(ch1, ch2)</code> if its character value (binary representation)
+ interpreted in the character set defined by <code class="computeroutput">ns</code>
+ is not smaller than the character value of <code class="computeroutput">ch1</code>
+ and not larger then the character value of <code class="computeroutput">ch2</code>
+ (i.e. <code class="computeroutput">ch1 <=
+ ch <=
+ ch2</code>).
+ 
+
+ The <code class="computeroutput">charset</code> parameter
+ passed to <code class="computeroutput">ns::char_(charset)</code>
+ must be a string containing more than one character. Every single character
+ in this string is assumed to belong to the character set defined by this
+ expression. An exception to this is the <code class="computeroutput">'-'</code>
+ character which has a special meaning if it is not specified as the first
+ and not the last character in <code class="computeroutput">charset</code>.
+ If the <code class="computeroutput">'-'</code> is used in between
+ to characters it is interpreted as spanning a character range. A character
+ <code class="computeroutput">ch</code> is considered to belong
+ to the defined character set <code class="computeroutput">charset</code>
+ if it matches one of the characters as specified by the string parameter
+ described above. For example
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Example
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_("abc")</code>
+ 
+ </td>
+<td>
+ 
+ 'a', 'b', and 'c'
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_("a-z")</code>
+ 
+ </td>
+<td>
+ 
+ all characters (and including) from 'a' to 'z'
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_("a-zA-Z")</code>
+ 
+ </td>
+<td>
+ 
+ all characters (and including) from 'a' to 'z' and 'A' and 'Z'
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_("-1-9")</code>
+ 
+ </td>
+<td>
+ 
+ '-' and all characters (and including) from '1' to '9'
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.char.char_generator.attributes"></a><h6>
+<a name="id751976"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ch</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(ch)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>, attribute
+ is mandatory (otherwise compilation will fail). <code class="computeroutput">Ch</code> is the character type of
+ the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(ch)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">ch</code> and succeeds
+ only if both are equal, failing otherwise. <code class="computeroutput">Ch</code>
+ is the character type of the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_("c")</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">c</code> and succeeds
+ only if both are equal, failing otherwise. <code class="computeroutput">Ch</code>
+ is the character type of the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(ch1,
+ ch2)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>, attribute
+ is mandatory (otherwise compilation will fail), the generator
+ succeeds if the attribute belongs to the character range <code class="computeroutput">[ch1, ch2]</code> interpreted in the character
+ set defined by <code class="computeroutput">ns</code>.
+ <code class="computeroutput">Ch</code> is the character
+ type of the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(cs)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>, attribute
+ is mandatory (otherwise compilation will fail), the generator
+ succeeds if the attribute belongs to the character set <code class="computeroutput">cs</code>, interpreted in the character
+ set defined by <code class="computeroutput">ns</code>.
+ <code class="computeroutput">Ch</code> is the character
+ type of the <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">~cg</code>
+ 
+ </td>
+<td>
+ 
+ Attribute of <code class="computeroutput">cg</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.char.char_generator.complexity"></a><h6>
+<a name="id752529"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(1)
+ 
+
+ 
+</blockquote></div>
+
+ The complexity of <code class="computeroutput">ch</code>,
+ <code class="computeroutput">lit(ch)</code>,
+ <code class="computeroutput">ns::char_</code>, <code class="computeroutput">ns::char_(ch)</code>, and <code class="computeroutput">ns::char_("c")</code> is constant as all generators emit exactly
+ one character per invocation.
+ 
+
+ The character range generator (<code class="computeroutput">ns::char_(ch1, ch2)</code>) additionally requires constant lookup
+ time for the verification whether the attribute belongs to the character
+ range.
+ 
+
+ The character set generator (<code class="computeroutput">ns::char_(cs)</code>) additionally requires O(log N) lookup
+ time for the verification whether the attribute belongs to the character
+ set, where N is the number of characters in the character set.
+ 
+<a name="spirit.karma.reference.char.char_generator.example"></a><h6>
+<a name="id752713"></a>
+ <a class="link" href="char_generator.html#spirit.karma.reference.char.char_generator.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::lit;
+using boost::spirit::ascii::char_;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of <code class="computeroutput">char_</code>
+ generators:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator("A", 'A');
+test_generator("A", lit('A'));
+
+test_generator_attr("a", char_, 'a');
+test_generator("A", char_('A'));
+test_generator_attr("A", char_('A'), 'A');
+test_generator_attr("", char_('A'), 'B'); // fails (as 'A' != 'B')
+
+test_generator_attr("A", char_('A', 'Z'), 'A');
+test_generator_attr("", char_('A', 'Z'), 'a'); // fails (as 'a' does not belong to 'A'...'Z')
+
+test_generator_attr("k", char_("a-z0-9"), 'k');
+test_generator_attr("", char_("a-z0-9"), 'A'); // fails (as 'A' does not belong to "a-z0-9")
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../char.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char_class.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/directive.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/directive.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,77 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Directive</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="auxiliary/lazy.html" title="Lazy (lazy)">
+<link rel="next" href="directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="auxiliary/lazy.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="directive/alignment.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Directive">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.directive"></a><a class="link" href="directive.html" title="Directive"> Directive</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="directive/alignment.html"> Alignment
+ Directives (<code class="computeroutput">left_align[]</code>, <code class="computeroutput">center[]</code>, <code class="computeroutput">right_align[]</code>)</a></dt>
+<dt><a href="directive/repeat.html"> Repetition
+ Directive (<code class="computeroutput">repeat[]</code>)</a></dt>
+<dt><a href="directive/delimit.html"> Directives
+ Controlling Automatic Delimiting (<code class="computeroutput">verbatim[]</code>, <code class="computeroutput">delimit[]</code>)</a></dt>
+<dt><a href="directive/upperlower.html"> Directives
+ Controlling Case Sensitivity (<code class="computeroutput">upper[]</code>, <code class="computeroutput">lower[]</code>)</a></dt>
+<dt><a href="directive/maxwidth.html"> Controlling
+ the Maximum Field Wield (<code class="computeroutput">maxwidth[]</code>)</a></dt>
+<dt><a href="directive/buffer.html"> Temporary
+ Output Buffering (<code class="computeroutput">buffer[]</code>)</a></dt>
+<dt><a href="directive/omit.html"> Consume Attribute
+ (<code class="computeroutput">omit[]</code>)</a></dt>
+</dl></div>
+
+ This module includes different generator directives. It includes alignement
+ directives (<code class="computeroutput">left_align[]</code>, <code class="computeroutput">center[]</code>, and <code class="computeroutput">right_align[]</code>), repetition (<code class="computeroutput">repeat[]</code>), directives controlling automatic delimiting
+ (<code class="computeroutput">verbatim[]</code>
+ and <code class="computeroutput">delimit[]</code>),
+ controlling case sensitivity (<code class="computeroutput">upper[]</code> and <code class="computeroutput">lower[]</code>), field width (<code class="computeroutput">maxwidth[]</code>), buffering (<code class="computeroutput">buffer[]</code>), and attribute handling (<code class="computeroutput">omit[]</code>).
+ 
+<a name="spirit.karma.reference.directive.module_header"></a><h6>
+<a name="id804011"></a>
+ <a class="link" href="directive.html#spirit.karma.reference.directive.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive.hpp>
+#include <boost/spirit/include/karma_directive.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="auxiliary/lazy.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="directive/alignment.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/alignment.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/alignment.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,756 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Alignment Directives (left_align[], center[], right_align[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="../directive.html" title="Directive">
+<link rel="next" href="repeat.html" title="Repetition Directive (repeat[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../directive.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="repeat.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Alignment Directives (left_align[], center[], right_align[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.directive.alignment"></a><a class="link" href="alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"> Alignment
+ Directives (<code class="computeroutput">left_align[]</code>, <code class="computeroutput">center[]</code>, <code class="computeroutput">right_align[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.directive.alignment.description"></a><h6>
+<a name="id804127"></a>
+ <a class="link" href="alignment.html#spirit.karma.reference.directive.alignment.description">Description</a>
+ </h6>
+
+ The alignment directives allow to left align, right align or center output
+ emitted by other generators into columns of a specified width while using
+ an arbitrary generator to create the padding.
+ 
+<a name="spirit.karma.reference.directive.alignment.header"></a><h6>
+<a name="id804144"></a>
+ <a class="link" href="alignment.html#spirit.karma.reference.directive.alignment.header">Header</a>
+ </h6>
+
+ For the <code class="computeroutput">left_align[]</code>
+ directive:
+ 
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/left_alignment.hpp>
+#include <boost/spirit/include/karma_left_alignment.hpp>
+</pre>
+
+ For the <code class="computeroutput">center[]</code>
+ directive:
+ 
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/center_alignment.hpp>
+#include <boost/spirit/include/karma_center_alignment.hpp>
+</pre>
+
+ For the <code class="computeroutput">right_align[]</code>
+ directive:
+ 
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/right_alignment.hpp>
+#include <boost/spirit/include/karma_right_alignment.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.directive.alignment.namespace"></a><h6>
+<a name="id804367"></a>
+ <a class="link" href="alignment.html#spirit.karma.reference.directive.alignment.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::left_align //
+ alias: boost::spirit::karma::left_align</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::center // alias:
+ boost::spirit::karma::center</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::right_align //
+ alias: boost::spirit::karma::right_align</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.alignment.model_of"></a><h6>
+<a name="id805350"></a>
+ <a class="link" href="alignment.html#spirit.karma.reference.directive.alignment.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A generator object
+ </dd>
+<dt><code class="computeroutput">pad</code></dt>
+<dd>
+ A generator object, or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a generator object
+ </dd>
+<dt><code class="computeroutput">A</code>,
+ <code class="computeroutput">Pad</code></dt>
+<dd>
+ Attribute types of the generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">pad</code>
+ </dd>
+<dt><code class="computeroutput">width</code></dt>
+<dd>
+ Numeric literal, any unsigned integer value, or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to an unsigned integer value
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.directive.alignment.expression_semantics"></a><h6>
+<a name="id805500"></a>
+ <a class="link" href="alignment.html#spirit.karma.reference.directive.alignment.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">left_align[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> left
+ aligned in a column of width as defined by the preprocessor constant
+ <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_LENGTH</code>
+ (default: 10), while using <code class="computeroutput">space</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded generator <code class="computeroutput">a</code>
+ does not fail (except if the underlying output stream reports
+ an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">left_align(width)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> left
+ aligned in a column of the given <code class="computeroutput">width</code>,
+ while using <code class="computeroutput">space</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded generator <code class="computeroutput">a</code>
+ does not fail (except if the underlying output stream reports
+ an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">left_align(pad)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> left
+ aligned in a column of width as defined by the preprocessor constant
+ <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_LENGTH</code>
+ (default: 10), while using the generator <code class="computeroutput">pad</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded and padding generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">pad</code> do not
+ fail (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">left_align(pad,
+ width)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> left
+ aligned in a column of the given <code class="computeroutput">width</code>,
+ while using the generator <code class="computeroutput">pad</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded and padding generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">pad</code> do not
+ fail (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">center[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> centered
+ in a column of width as defined by the preprocessor constant
+ <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_LENGTH</code>
+ (default: 10), while using <code class="computeroutput">space</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded generator <code class="computeroutput">a</code>
+ does not fail (except if the underlying output stream reports
+ an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">center(width)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> centered
+ in a column of the given <code class="computeroutput">width</code>,
+ while using <code class="computeroutput">space</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded generator <code class="computeroutput">a</code>
+ does not fail (except if the underlying output stream reports
+ an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">center(pad)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> centered
+ in a column of width as defined by the preprocessor constant
+ <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_LENGTH</code>
+ (default: 10), while using the generator <code class="computeroutput">pad</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded and padding generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">pad</code> do not
+ fail (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">center(pad,
+ width)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> centered
+ in a column of the given <code class="computeroutput">width</code>,
+ while using the generator <code class="computeroutput">pad</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded and padding generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">pad</code> do not
+ fail (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">right_align[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> right
+ aligned in a column of width as defined by the preprocessor constant
+ <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_LENGTH</code>
+ (default: 10), while using <code class="computeroutput">space</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded generator <code class="computeroutput">a</code>
+ does not fail (except if the underlying output stream reports
+ an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">right_align(width)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> right
+ aligned in a column of the given <code class="computeroutput">width</code>,
+ while using <code class="computeroutput">space</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded generator <code class="computeroutput">a</code>
+ does not fail (except if the underlying output stream reports
+ an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">right_align(pad)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> right
+ aligned in a column of width as defined by the preprocessor constant
+ <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_LENGTH</code>
+ (default: 10), while using the generator <code class="computeroutput">pad</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded and padding generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">pad</code> do not
+ fail (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">right_align(pad,
+ width)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> right
+ aligned in a column of the given <code class="computeroutput">width</code>,
+ while using the generator <code class="computeroutput">pad</code>
+ to emit the necessary padding. This generator succeeds as long
+ as its embedded and padding generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">pad</code> do not
+ fail (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+
+ None of the generator directives listed above limits the emitted output
+ to the respective column width. If the emitted output is longer than
+ the specified (or implied) column width, the generated output overruns
+ the column to the right.
+ 
+
+ If the output needs to be limitted to a specified column width, use
+ the <code class="computeroutput">maxwidth[]</code>
+ directive, for instance:
+
+<pre class="programlisting">maxwidth(8)[right_align(12)["1234567890"]]
+</pre>
+
+ which will output (without the quotes):
+
+<pre class="programlisting">" 123456"</pre>
+
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.directive.alignment.attributes"></a><h6>
+<a name="id806540"></a>
+ <a class="link" href="alignment.html#spirit.karma.reference.directive.alignment.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">left_align[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> left_align[a]: A
+a: Unused --> left_align[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">left_align(width)[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> left_align(width)[a]: A
+a: Unused --> left_align(width)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">left_align(pad)[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, pad: Pad --> left_align(pad)[a]: A
+a: Unused, pad: Pad --> left_align(pad)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">left_align(pad,
+ width)[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, pad: Pad --> left_align(pad, width)[a]: A
+a: Unused, pad: Pad --> left_align(pad, width)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">center[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> center[a]: A
+a: Unused --> center[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">center(width)[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> center(width)[a]: A
+a: Unused --> center(width)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">center(pad)[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, pad: Pad --> center(pad)[a]: A
+a: Unused, pad: Pad --> center(pad)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">center(pad,
+ width)[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, pad: Pad --> center(pad, width)[a]: A
+a: Unused, pad: Pad --> center(pad, width)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">right_align[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> right_align[a]: A
+a: Unused --> right_align[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">right_align(width)[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> right_align(width)[a]: A
+a: Unused --> right_align(width)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">right_align(pad)[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, pad: Pad --> right_align(pad)[a]: A
+a: Unused, pad: Pad --> right_align(pad)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">right_align(pad,
+ width)[]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, pad: Pad --> right_align(pad, width)[a]: A
+a: Unused, pad: Pad --> right_align(pad, width)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.alignment.complexity"></a><h6>
+<a name="id808556"></a>
+ <a class="link" href="alignment.html#spirit.karma.reference.directive.alignment.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the alignment generator directives is defined
+ by the complexity of its embedded and padding generator. The complexity
+ of the left alignment directive generator itself is O(1). The complexity
+ of the center and right alignment directive generators itself is
+ O(N). where <code class="computeroutput">N</code> is
+ the number of characters emitted by the embedded and padding generators.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.directive.alignment.example"></a><h6>
+<a name="id808588"></a>
+ <a class="link" href="alignment.html#spirit.karma.reference.directive.alignment.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::left_align;
+using boost::spirit::karma::center;
+using boost::spirit::karma::right_align;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the alignment generators:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::pair<double, double> p (1.0, 2.0);
+test_generator_attr("1.0 |2.0", left_align(8)[double_] << '|' << double_, p);
+test_generator_attr(" 1.0 |2.0", center(8)[double_] << '|' << double_, p);
+test_generator_attr(" 1.0|2.0", right_align(8)[double_] << '|' << double_, p);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../directive.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="repeat.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/buffer.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/buffer.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,308 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Temporary Output Buffering (buffer[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="maxwidth.html" title="Controlling the Maximum Field Wield (maxwidth[])">
+<link rel="next" href="omit.html" title="Consume Attribute (omit[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="maxwidth.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="omit.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Temporary Output Buffering (buffer[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.directive.buffer"></a><a class="link" href="buffer.html" title="Temporary Output Buffering (buffer[])"> Temporary
+ Output Buffering (<code class="computeroutput">buffer[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.directive.buffer.description"></a><h6>
+<a name="id821843"></a>
+ <a class="link" href="buffer.html#spirit.karma.reference.directive.buffer.description">Description</a>
+ </h6>
+
+ All generator components (except the <a class="link" href="../operator/alternative.html" title="Alternative (a | b)">alternative
+ (<code class="computeroutput">|</code>)</a> generator) pass
+ their generated output directly to the underlying output stream. If a
+ generator fails halfway through, the output generated so far is not 'rolled
+ back'. The buffering generator directive allows to avoid this unwanted
+ output to be generated. It temporarily redirects the output produced
+ by the embedded generator into a buffer. This buffer is flushed to the
+ underlying stream only after the embedded generator succeeded, but is
+ discarded otherwise.
+ 
+<a name="spirit.karma.reference.directive.buffer.header"></a><h6>
+<a name="id821872"></a>
+ <a class="link" href="buffer.html#spirit.karma.reference.directive.buffer.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/buffer.hpp>
+#include <boost/spirit/include/karma_buffer.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::buffer // alias:
+ boost::spirit::karma::buffer</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.buffer.model_of"></a><h6>
+<a name="id822012"></a>
+ <a class="link" href="buffer.html#spirit.karma.reference.directive.buffer.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A generator object
+ </dd>
+<dt><code class="computeroutput">A</code></dt>
+<dd>
+ Attribute type of generator <code class="computeroutput">a</code>
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.directive.buffer.expression_semantics"></a><h6>
+<a name="id822101"></a>
+ <a class="link" href="buffer.html#spirit.karma.reference.directive.buffer.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">buffer[a]</code>
+ 
+ </td>
+<td>
+ 
+ The embedded generator <code class="computeroutput">a</code>
+ is invoked but its output is temporarily intercepted and stored
+ in an internal buffer. If <code class="computeroutput">a</code>
+ succeeds the buffer content is flushed to the underlying output
+ stream, otherwise the buffer content is discarded. The buffer
+ directive succeeds as long as the embedded generator succeeded
+ (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+ If you want to make the buffered generator succeed regardless of the
+ outcome of the embedded generator, simply wrap the <code class="computeroutput">buffer[a]</code> into an additional optional: <code class="computeroutput">-buffer[a]</code> (see <a class="link" href="../operator/optional.html" title="Optional (-a)">optional
+ (unary <code class="computeroutput">-</code>)</a>).
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.directive.buffer.attributes"></a><h6>
+<a name="id823381"></a>
+ <a class="link" href="buffer.html#spirit.karma.reference.directive.buffer.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">buffer[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> buffer[a]: A
+a: Unused --> buffer[a]: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.buffer.complexity"></a><h6>
+<a name="id823553"></a>
+ <a class="link" href="buffer.html#spirit.karma.reference.directive.buffer.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the buffering generator directive is defined
+ by the complexity of its embedded generator. The complexity of the
+ buffering directive generator itself is O(1).
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.directive.buffer.example"></a><h6>
+<a name="id823577"></a>
+ <a class="link" href="buffer.html#spirit.karma.reference.directive.buffer.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::buffer;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of a buffering generator directive. It shows how the partial
+ output generated in the first example does not show up in the generated
+ output as the plus generator fails (no data is available, see <a class="link" href="../operator/plus.html" title="Plus (+a)">plus
+ (unary <code class="computeroutput">+</code>)</a>).
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<double> v; // empty container
+test_generator_attr("", -buffer['[' << +double_ << ']'], v);
+
+v.push_back(1.0); // now, fill the container
+v.push_back(2.0);
+test_generator_attr("[1.02.0]", buffer['[' << +double_ << ']'], v);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="maxwidth.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="omit.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/delimit.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/delimit.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,384 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Directives Controlling Automatic Delimiting (verbatim[], delimit[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="repeat.html" title="Repetition Directive (repeat[])">
+<link rel="next" href="upperlower.html" title="Directives Controlling Case Sensitivity (upper[], lower[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="repeat.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="upperlower.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Directives Controlling Automatic Delimiting (verbatim[], delimit[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.directive.delimit"></a><a class="link" href="delimit.html" title="Directives Controlling Automatic Delimiting (verbatim[], delimit[])"> Directives
+ Controlling Automatic Delimiting (<code class="computeroutput">verbatim[]</code>, <code class="computeroutput">delimit[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.directive.delimit.description"></a><h6>
+<a name="id814008"></a>
+ <a class="link" href="delimit.html#spirit.karma.reference.directive.delimit.description">Description</a>
+ </h6>
+
+ The directives <code class="computeroutput">delimit[]</code> and <code class="computeroutput">verbatim[]</code> can be used to control automatic delimiting.
+ The directive <code class="computeroutput">verbatim[]</code> disables any automatic delimiting,
+ while the directive <code class="computeroutput">delimit[]</code> (re-)enables automatic delimiting.
+ 
+<a name="spirit.karma.reference.directive.delimit.header"></a><h6>
+<a name="id814068"></a>
+ <a class="link" href="delimit.html#spirit.karma.reference.directive.delimit.header">Header</a>
+ </h6>
+
+ For the <code class="computeroutput">verbatim[]</code>
+ directive:
+ 
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/verbatim.hpp>
+#include <boost/spirit/include/karma_verbatim.hpp>
+</pre>
+
+ For the <code class="computeroutput">delimit[]</code>
+ directive:
+ 
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/delimit.hpp>
+#include <boost/spirit/include/karma_delimit.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.directive.delimit.namespace"></a><h6>
+<a name="id814224"></a>
+ <a class="link" href="delimit.html#spirit.karma.reference.directive.delimit.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::verbatim //
+ alias: boost::spirit::karma::verbatim</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::delimit //
+ alias: boost::spirit::karma::delimit</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.delimit.model_of"></a><h6>
+<a name="id814342"></a>
+ <a class="link" href="delimit.html#spirit.karma.reference.directive.delimit.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A generator object
+ </dd>
+<dt><code class="computeroutput">d</code></dt>
+<dd>
+ A generator object, or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a generator object
+ </dd>
+<dt><code class="computeroutput">A</code>,
+ <code class="computeroutput">D</code></dt>
+<dd>
+ Attribute types of the generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">d</code>
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.directive.delimit.expression_semantics"></a><h6>
+<a name="id814468"></a>
+ <a class="link" href="delimit.html#spirit.karma.reference.directive.delimit.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">delimit[a]</code>
+ 
+ </td>
+<td>
+ 
+ Enable automatic delimiting for the embedded generator <code class="computeroutput">a</code> while using the <code class="computeroutput">space</code> generator as the delimiting
+ generator. If used inside a <code class="computeroutput">verbatim[]</code> directive it re-enables the
+ delimiter generator as used outside of this <code class="computeroutput">verbatim[]</code> instead. The directive succeeds
+ as long as the embedded generator succeeded (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">delimit(d)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Enable automatic delimiting for the embedded generator <code class="computeroutput">a</code> while using the generator
+ <code class="computeroutput">d</code> as the delimiting
+ generator. The directive succeeds as long as the embedded generator
+ succeeded (except if the underlying output stream reports an
+ error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">verbatim[a]</code>
+ 
+ </td>
+<td>
+ 
+ Disable automatic delimiting for the embedded generator <code class="computeroutput">a</code>. The directive succeeds as
+ long as the embedded generator succeeded (except if the underlying
+ output stream reports an error). This directive it has no effect
+ if it is used when no delimiting is active.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.delimit.attributes"></a><h6>
+<a name="id814702"></a>
+ <a class="link" href="delimit.html#spirit.karma.reference.directive.delimit.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">delimit[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> delimit[a]: A
+a: Unused --> delimit[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">delimit(d)[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, d: D --> delimit(d)[a]: A
+a: Unused, d: D --> delimit(d)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">verbatim[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> verbatim[a]: A
+a: Unused --> verbatim[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.delimit.complexity"></a><h6>
+<a name="id815157"></a>
+ <a class="link" href="delimit.html#spirit.karma.reference.directive.delimit.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the generator directives <code class="computeroutput">delimit[]</code>
+ and <code class="computeroutput">verbatim[]</code>
+ is defined by the complexity of its embedded generators. The complexity
+ of the directives themselves is O(1).
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.directive.delimit.example"></a><h6>
+<a name="id815202"></a>
+ <a class="link" href="delimit.html#spirit.karma.reference.directive.delimit.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T1, typename T2>
+void test_generator_attr(char const* expected, G const& g, T1 const& attr1,
+ T2 const& attr2)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr1, attr2) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::delimit;
+using boost::spirit::karma::verbatim;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of <code class="computeroutput">delimit</code>
+ generator directive:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator_attr("[ 2.0 , 4.3 ] ",
+ delimit['[' << double_ << ',' << double_ << ']'], 2.0, 4.3);
+test_generator_attr("[*2.0*,*4.3*]*",
+ delimit('*')['[' << double_ << ',' << double_ << ']'], 2.0, 4.3);
+test_generator_attr("[2.0, 4.3 ] ",
+ delimit[verbatim['[' << double_ << ','] << double_ << ']'], 2.0, 4.3);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="repeat.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="upperlower.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/maxwidth.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/maxwidth.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,353 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Controlling the Maximum Field Wield (maxwidth[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="upperlower.html" title="Directives Controlling Case Sensitivity (upper[], lower[])">
+<link rel="next" href="buffer.html" title="Temporary Output Buffering (buffer[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="upperlower.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="buffer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Controlling the Maximum Field Wield (maxwidth[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.directive.maxwidth"></a><a class="link" href="maxwidth.html" title="Controlling the Maximum Field Wield (maxwidth[])"> Controlling
+ the Maximum Field Wield (<code class="computeroutput">maxwidth[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.directive.maxwidth.description"></a><h6>
+<a name="id820133"></a>
+ <a class="link" href="maxwidth.html#spirit.karma.reference.directive.maxwidth.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">maxwidth[]</code>
+ directive allows to limit (truncate) the overall length of the output
+ generated by the embedded generator.
+ 
+<a name="spirit.karma.reference.directive.maxwidth.header"></a><h6>
+<a name="id820161"></a>
+ <a class="link" href="maxwidth.html#spirit.karma.reference.directive.maxwidth.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/maxwidth.hpp>
+#include <boost/spirit/include/karma_maxwidth.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::maxwidth //
+ alias: boost::spirit::karma::maxwidth</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.maxwidth.model_of"></a><h6>
+<a name="id820301"></a>
+ <a class="link" href="maxwidth.html#spirit.karma.reference.directive.maxwidth.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A generator object
+ </dd>
+<dt><code class="computeroutput">A</code></dt>
+<dd>
+ Attribute type of the generator <code class="computeroutput">a</code>
+ </dd>
+<dt><code class="computeroutput">num</code></dt>
+<dd>
+ Numeric literal, any unsigned integer value, or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to an unsigned integer value
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.directive.maxwidth.expression_semantics"></a><h6>
+<a name="id820414"></a>
+ <a class="link" href="maxwidth.html#spirit.karma.reference.directive.maxwidth.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">maxwidth[a]</code>
+ 
+ </td>
+<td>
+ 
+ Limit the overall length of the emitted output of the embedded
+ generator (including characters generated by automatic delimiting)
+ to the number of characters as defined by the preprocessor constant
+ <code class="computeroutput">BOOST_KARMA_DEFAULT_FIELD_MAXWIDTH</code>.
+ Any additional output is truncated. The directive succeeds as
+ long as the embedded generator succeeded (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">maxwidth(num)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Limit the overall length of the emitted output of the embedded
+ generator (including characters generated by automatic delimiting)
+ to the number of characters as defined by <code class="computeroutput">num</code>.
+ Any additional output is truncated. The directive succeeds as
+ long as the embedded generator succeeded (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+
+ The <code class="computeroutput">maxwidth[]</code>
+ generator directive does not pads the generated output to fill the
+ specified column width. If the emitted output is shorter than the specified
+ (or implied) column width, the generated output will be more narrow
+ than the column width.
+ 
+
+ If the output needs to always be equal to a specified column width,
+ use one of the alignment directives <code class="computeroutput">left-align[]</code>, <code class="computeroutput">center[]</code>, or <code class="computeroutput">right_align[]</code>, for instance:
+
+<pre class="programlisting">maxwidth(8)[left_align(8)["1234"]]
+</pre>
+
+ which will output: <code class="computeroutput">"1234 "</code>
+ (without the quotes).
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.directive.maxwidth.attributes"></a><h6>
+<a name="id820679"></a>
+ <a class="link" href="maxwidth.html#spirit.karma.reference.directive.maxwidth.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">maxwidth[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> maxwidth[a]: A
+a: Unused --> maxwidth[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">maxwidth(num)[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> maxwidth(num)[a]: A
+a: Unused --> maxwidth(num)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.maxwidth.complexity"></a><h6>
+<a name="id820986"></a>
+ <a class="link" href="maxwidth.html#spirit.karma.reference.directive.maxwidth.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the generator directive <code class="computeroutput">maxwidth[]</code> is defined by the complexity of
+ its embedded generator. The complexity of the directive itself is
+ O(N), where <code class="computeroutput">N</code> is
+ the number of characters generated by the maxwidth directive.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.directive.maxwidth.example"></a><h6>
+<a name="id821028"></a>
+ <a class="link" href="maxwidth.html#spirit.karma.reference.directive.maxwidth.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::maxwidth;
+using boost::spirit::karma::left_align;
+using boost::spirit::karma::right_align;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of <code class="computeroutput">maxwidth</code>
+ generator directive:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator("01234", maxwidth(5)["0123456789"]);
+test_generator(" 012", maxwidth(5)[right_align(12)["0123456789"]]);
+test_generator("0123 ", maxwidth(8)[left_align(8)["0123"]]);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="upperlower.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="buffer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/omit.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/omit.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,317 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Consume Attribute (omit[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="buffer.html" title="Temporary Output Buffering (buffer[])">
+<link rel="next" href="../operator.html" title="Operator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="buffer.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../operator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Consume Attribute (omit[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.directive.omit"></a><a class="link" href="omit.html" title="Consume Attribute (omit[])"> Consume Attribute
+ (<code class="computeroutput">omit[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.directive.omit.description"></a><h6>
+<a name="id824575"></a>
+ <a class="link" href="omit.html#spirit.karma.reference.directive.omit.description">Description</a>
+ </h6>
+
+ Consumes the attribute type of the embedded generator without generating
+ any output.
+ 
+<a name="spirit.karma.reference.directive.omit.header"></a><h6>
+<a name="id824592"></a>
+ <a class="link" href="omit.html#spirit.karma.reference.directive.omit.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/omit.hpp>
+#include <boost/spirit/include/karma_omit.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::omit // alias:
+ boost::spirit::karma::omit</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.omit.model_of"></a><h6>
+<a name="id824732"></a>
+ <a class="link" href="omit.html#spirit.karma.reference.directive.omit.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A generator object
+ </dd>
+<dt><code class="computeroutput">A</code></dt>
+<dd>
+ Attribute type of generator <code class="computeroutput">a</code>
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.directive.omit.expression_semantics"></a><h6>
+<a name="id824821"></a>
+ <a class="link" href="omit.html#spirit.karma.reference.directive.omit.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">omit[a]</code>
+ 
+ </td>
+<td>
+ 
+ The <code class="computeroutput">omit</code> directive
+ consumes the attribute type of the embedded generator <code class="computeroutput">A</code> without generating any output.
+ It succeeds always.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.omit.attributes"></a><h6>
+<a name="id824935"></a>
+ <a class="link" href="omit.html#spirit.karma.reference.directive.omit.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">omit[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> omit[a]: A
+a: Unused --> omit[a]: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.omit.complexity"></a><h6>
+<a name="id825107"></a>
+ <a class="link" href="omit.html#spirit.karma.reference.directive.omit.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the <code class="computeroutput">omit</code>
+ generator directive is O(1) as it does not generate any output.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.directive.omit.example"></a><h6>
+<a name="id825138"></a>
+ <a class="link" href="omit.html#spirit.karma.reference.directive.omit.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::buffer;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of a <code class="computeroutput">omit</code>
+ generator directive. It shows how it consumes the first element of the
+ provided attribute without generating anything, leaving the second element
+ of the attribute to the non-wrapped <code class="computeroutput">double_</code>
+ generator.
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::pair<double, double> p (1.0, 2.0);
+test_generator_attr("2.0", omit[double_] << double_, p);
+</pre>
+
+ 
+
+ 
+
+ Generally, this directive is helpful in situations, where the attribute
+ type contains more information (elements) than need to be used to generate
+ the required output. Normally in such situations we would resolve to
+ use semantic actions to explicitly pass the correct parts of the overall
+ attribute to the generators. The <code class="computeroutput">omit</code>
+ directive helps achieving the same without having to use semantic actions.
+ 
+
+ Consider the attribute type:
+ 
+<pre class="programlisting">typedef fusion::vector<int, double, std::string> attribute_type;
+</pre>
+
+ where we need to generate output only from the first and last element:
+ 
+<pre class="programlisting">typedef std::back_insert:iterator<std::string> iterator_type;
+
+karma::rule<iterator_type, attribute_type()> r;
+r = int_[_1 = phoenix::at_c<0>(_val)] << string[_1 = phoenix::at_c<2>(_val)];
+
+std::string str;
+iterator_type sink(str);
+generate(sink, r, attribute_type(1, 2.0, "example")); // will generate: '1example'
+</pre>
+
+ This is error prone and not really readable. The same can be achieved
+ by using the <code class="computeroutput">omit</code> directive:
+ 
+<pre class="programlisting">r = int_ << omit[double_] << string;
+</pre>
+
+ which is at the same time more readable and more efficient as we don't
+ have to use semantic actions.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="buffer.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../operator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/repeat.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/repeat.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,452 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Repetition Directive (repeat[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="alignment.html" title="Alignment Directives (left_align[], center[], right_align[])">
+<link rel="next" href="delimit.html" title="Directives Controlling Automatic Delimiting (verbatim[], delimit[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="alignment.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="delimit.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Repetition Directive (repeat[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.directive.repeat"></a><a class="link" href="repeat.html" title="Repetition Directive (repeat[])"> Repetition
+ Directive (<code class="computeroutput">repeat[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.directive.repeat.description"></a><h6>
+<a name="id809696"></a>
+ <a class="link" href="repeat.html#spirit.karma.reference.directive.repeat.description">Description</a>
+ </h6>
+
+ The repetition directive allows to repeat an arbitrary generator expression
+ while optionally specifying the lower and upper repetition counts. It
+ provides a more powerful and flexible mechanism for repeating a generator.
+ There are grammars that are impractical and cumbersome, if not impossible,
+ for the basic EBNF iteration syntax ( <a class="link" href="../operator/kleene.html" title="Kleene Star (*a)">unary
+ <code class="computeroutput">'*'</code></a> and the [karma_plus
+ unary <code class="computeroutput">'+'</code>]) to specify. Examples:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ A file name may have a maximum of 255 characters only.
+ </li>
+<li class="listitem">
+ A specific bitmap file format has exactly 4096 RGB color information.
+ </li>
+<li class="listitem">
+ A 256 bit binary string (1..256 1s or 0s).
+ </li>
+</ul></div>
+<a name="spirit.karma.reference.directive.repeat.header"></a><h6>
+<a name="id809746"></a>
+ <a class="link" href="repeat.html#spirit.karma.reference.directive.repeat.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/repeat.hpp>
+#include <boost/spirit/include/karma_repeat.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.directive.repeat.namespace"></a><h6>
+<a name="id809820"></a>
+ <a class="link" href="repeat.html#spirit.karma.reference.directive.repeat.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::repeat // alias:
+ boost::spirit::karma::repeat</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::inf // alias:
+ boost::spirit::karma::inf</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.repeat.model_of"></a><h6>
+<a name="id811582"></a>
+ <a class="link" href="repeat.html#spirit.karma.reference.directive.repeat.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A generator object
+ </dd>
+<dt><code class="computeroutput">num, num1, num2</code></dt>
+<dd>
+ Numeric literals, any unsigned integer value, or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to an unsigned integer value
+ </dd>
+<dt><code class="computeroutput">inf</code></dt>
+<dd>
+ Placeholder expression standing for 'no upper repeat limit'
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.directive.repeat.expression_semantics"></a><h6>
+<a name="id811704"></a>
+ <a class="link" href="repeat.html#spirit.karma.reference.directive.repeat.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat[a]</code>
+ 
+ </td>
+<td>
+ 
+ Repeat the generator <code class="computeroutput">a</code>
+ zero or more times. This generator succeeds as long as its embedded
+ generator <code class="computeroutput">a</code> does
+ not fail (except if the underlying output stream reports an error).
+ This variant of <code class="computeroutput">repeat[]</code> is semantically equivalent
+ to the <a class="link" href="../operator/kleene.html" title="Kleene Star (*a)">Kleene
+ Star operator <code class="computeroutput">*a</code></a>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(num)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Repeat the generator <code class="computeroutput">a</code>
+ exactly <code class="computeroutput">num</code> times.
+ This generator succeeds as long as its embedded generator <code class="computeroutput">a</code> does not fail and as long
+ as the associated attribute (container) contains at least <code class="computeroutput">num</code> elements (except if the
+ underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(num1,
+ num2)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Repeat the generator <code class="computeroutput">a</code>
+ at least <code class="computeroutput">num1</code>
+ times but not more than <code class="computeroutput">num2</code>
+ times. This generator succeeds as long as its embedded generator
+ <code class="computeroutput">a</code> does not fail
+ and as long as the associated attribute (container) contains
+ at least <code class="computeroutput">num1</code>
+ elements (except if the underlying output stream reports an error).
+ If the associated attribute (container) does contain more than
+ <code class="computeroutput">num2</code> elements,
+ this directive limits the repeat count to <code class="computeroutput">num2</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(num,
+ inf)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Repeat the generator <code class="computeroutput">a</code>
+ at least <code class="computeroutput">num1</code>
+ times. No upper limit for the repeat count is set. This generator
+ succeeds as long as its embedded generator <code class="computeroutput">a</code>
+ does not fail and as long as the associated attribute (container)
+ contains at least <code class="computeroutput">num</code>
+ elements (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.repeat.attributes"></a><h6>
+<a name="id812094"></a>
+ <a class="link" href="repeat.html#spirit.karma.reference.directive.repeat.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat[a]: vector<A>
+a: Unused --> repeat[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(num)[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat(num)[a]: vector<A>
+a: Unused --> repeat(num)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(num1,
+ num2)[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat(num1, num2)[a]: vector<A>
+a: Unused --> repeat(num1, num2)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(num,
+ inf)[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat(num, inf)[a]: vector<A>
+a: Unused --> repeat(num, inf)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ The table above uses <code class="computeroutput">vector<A></code> as placeholders only.
+ 
+
+ The notation of <code class="computeroutput">vector<A></code> stands for any STL container
+ holding elements of type <code class="computeroutput">A</code>.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.directive.repeat.complexity"></a><h6>
+<a name="id812824"></a>
+ <a class="link" href="repeat.html#spirit.karma.reference.directive.repeat.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the repetition generator is defined by
+ the complexity of its embedded generator. The complexity of the repeat
+ itself is O(N), where N is the number of repetitions to execute.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.directive.repeat.example"></a><h6>
+<a name="id812848"></a>
+ <a class="link" href="repeat.html#spirit.karma.reference.directive.repeat.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::repeat;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of <code class="computeroutput">repeat</code>
+ generator directive:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<double> v;
+v.push_back(1.0);
+v.push_back(2.0);
+v.push_back(3.0);
+
+test_generator_attr("[1.0][2.0][3.0]", repeat['[' << double_ << ']'], v);
+test_generator_attr("[1.0][2.0]", repeat(2)['[' << double_ << ']'], v);
+
+// fails because of insufficient number of items
+test_generator_attr("", repeat(4)['[' << double_ << ']'], v);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="alignment.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="delimit.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/upperlower.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/directive/upperlower.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,389 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Directives Controlling Case Sensitivity (upper[], lower[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="delimit.html" title="Directives Controlling Automatic Delimiting (verbatim[], delimit[])">
+<link rel="next" href="maxwidth.html" title="Controlling the Maximum Field Wield (maxwidth[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="delimit.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="maxwidth.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Directives Controlling Case Sensitivity (upper[], lower[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.directive.upperlower"></a><a class="link" href="upperlower.html" title="Directives Controlling Case Sensitivity (upper[], lower[])"> Directives
+ Controlling Case Sensitivity (<code class="computeroutput">upper[]</code>, <code class="computeroutput">lower[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.directive.upperlower.description"></a><h6>
+<a name="id817310"></a>
+ <a class="link" href="upperlower.html#spirit.karma.reference.directive.upperlower.description">Description</a>
+ </h6>
+
+ The generator directives <code class="computeroutput">ns::lower[]</code> and <code class="computeroutput">ns::upper[]</code> force their embedded generators to
+ emit lower case or upper case only characters based on the interpretation
+ of the generated characters in the character set defined by <code class="computeroutput">ns</code> (see <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>).
+ 
+<a name="spirit.karma.reference.directive.upperlower.header"></a><h6>
+<a name="id817375"></a>
+ <a class="link" href="upperlower.html#spirit.karma.reference.directive.upperlower.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/directive/upper_lower_case.hpp>
+#include <boost/spirit/include/karma_upper_lower_case.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.directive.upperlower.namespace"></a><h6>
+<a name="id817450"></a>
+ <a class="link" href="upperlower.html#spirit.karma.reference.directive.upperlower.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">ns::lower</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::upper</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+
+ In the table above, <code class="computeroutput">ns</code>
+ is a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<a name="spirit.karma.reference.directive.upperlower.model_of"></a><h6>
+<a name="id817556"></a>
+ <a class="link" href="upperlower.html#spirit.karma.reference.directive.upperlower.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The model of <code class="computeroutput">lower[]</code> and <code class="computeroutput">upper[]</code> is the model of its subject generator.
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A generator object
+ </dd>
+<dt><code class="computeroutput">A</code></dt>
+<dd>
+ Attribute type of the generator <code class="computeroutput">a</code>
+ </dd>
+<dt><code class="computeroutput">ns</code></dt>
+<dd>
+ A <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.directive.upperlower.expression_semantics"></a><h6>
+<a name="id817675"></a>
+ <a class="link" href="upperlower.html#spirit.karma.reference.directive.upperlower.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ The <code class="computeroutput">lower[]</code>
+ and <code class="computeroutput">upper[]</code>
+ directives have no special generator semantics. They are pure modifier
+ directives. They indirectly influence the way all subject generators
+ work. They add information (the <code class="computeroutput">tag::upper</code>
+ or <code class="computeroutput">tag::lower</code>) to the <code class="computeroutput">Modifier</code>
+ template parameter used while tranforming the <code class="computeroutput">proto::expr</code>
+ into the corresponding generator expression. This is achieved by the
+ following specializations:
+ 
+<pre class="programlisting">namespace boost { namespace spirit
+{
+ template <typename CharEncoding>
+ struct is_modifier_directive<
+ karma::domain
+ , tag::char_code<tag::lower, CharEncoding> >
+ : mpl::true_
+ {};
+
+ template <typename CharEncoding>
+ struct is_modifier_directive<
+ karma::domain
+ , tag::char_code<tag::upper, CharEncoding> >
+ : mpl::true_
+}}
+</pre>
+
+ (for more details see the section describing the compilation process
+ of the Boost.Proto
+ expression into the corresponding parser expressions).
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::lower[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> as
+ lower case, interpreted in the character set defined by <code class="computeroutput">ns</code>. The directive succeeds
+ as long as the embedded generator succeeded (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::upper[a]</code>
+ 
+ </td>
+<td>
+ 
+ Generate <code class="computeroutput">a</code> as
+ upper case, interpreted in the character set defined by <code class="computeroutput">ns</code>. The directive succeeds
+ as long as the embedded generator succeeded (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+
+ If both directives are 'active' with regard to a generator, the innermost
+ of those directives takes precendence. For instance:
+
+<pre class="programlisting">generate(sink, ascii::lower['A' << ascii::upper['b']])
+</pre>
+
+ will generate <code class="computeroutput">"aB"</code>
+ (without the quotes).
+ 
+
+ Further, the directives will have no effect on generators emitting
+ characters not having an upper case or lower case equivalent in the
+ character set defined by <code class="computeroutput">ns</code>.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.directive.upperlower.attributes"></a><h6>
+<a name="id818276"></a>
+ <a class="link" href="upperlower.html#spirit.karma.reference.directive.upperlower.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns:lower[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> ns:lower[a]: A
+a: Unused --> ns:lower[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns:upper[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> ns:upper[a]: A
+a: Unused --> ns:upper[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.directive.upperlower.complexity"></a><h6>
+<a name="id818605"></a>
+ <a class="link" href="upperlower.html#spirit.karma.reference.directive.upperlower.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the generator directives <code class="computeroutput">ns::lower[]</code>
+ and <code class="computeroutput">ns::upper[]</code>
+ is defined by the complexity of its embedded generators. The directives
+ themselves are compile time only directives, having no impact on
+ runtime performance.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.directive.upperlower.example"></a><h6>
+<a name="id818665"></a>
+ <a class="link" href="upperlower.html#spirit.karma.reference.directive.upperlower.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::ascii::upper;
+using boost::spirit::ascii::lower;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the <code class="computeroutput">upper</code>
+ and <code class="computeroutput">lower</code> generator directives:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator_attr("abc:2.0e-06", lower["ABC:" << double_], 2e-6);
+test_generator_attr("ABC:2.0E-06", upper["abc:" << double_], 2e-6);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="delimit.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="maxwidth.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,64 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Generator Concepts</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="../reference.html" title="Reference">
+<link rel="next" href="generator_concepts/generator.html" title="Generator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="generator_concepts/generator.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Generator Concepts">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.generator_concepts"></a><a class="link" href="generator_concepts.html" title="Generator Concepts">Generator
+ Concepts</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt>Generator</dt>
+<dt>PrimitiveGenerator</dt>
+<dt>UnaryGenerator</dt>
+<dt>BinaryGenerator</dt>
+<dt>NaryGenerator</dt>
+</dl></div>
+
+ Spirit.Karma generators fall into a couple of generalized
+ concepts.
+ The Generator is the most fundamental concept. All
+ Spirit.Karma generators are models of the Generator
+ concept. PrimitiveGenerator, UnaryGenerator,
+ BinaryGenerator and NaryGenerator
+ are all refinements of the Generator concept.
+ 
+
+ The following sections provide details on these concepts.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="generator_concepts/generator.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/binarygenerator.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/binarygenerator.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,247 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>BinaryGenerator</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../generator_concepts.html" title="Generator Concepts">
+<link rel="prev" href="unarygenerator.html" title="UnaryGenerator">
+<link rel="next" href="narygenerator.html" title="NaryGenerator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unarygenerator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="narygenerator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="BinaryGenerator">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.generator_concepts.binarygenerator"></a><a class="link" href="binarygenerator.html" title="BinaryGenerator">BinaryGenerator</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.generator_concepts.binarygenerator.description"></a><h6>
+<a name="id743789"></a>
+ <a class="link" href="binarygenerator.html#spirit.karma.reference.generator_concepts.binarygenerator.description">Description</a>
+ </h6>
+
+ BinaryGenerator is a composite parser that has a
+ two subjects, <code class="computeroutput">left</code> and
+ <code class="computeroutput">right</code>. The BinaryGenerator
+ allows its subjects to be treated in the same way as a single instance
+ of a <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a> following the Composite
+ Design Pattern.
+ 
+<a name="spirit.karma.reference.generator_concepts.binarygenerator.refinement_of"></a><h6>
+<a name="id743836"></a>
+ <a class="link" href="binarygenerator.html#spirit.karma.reference.generator_concepts.binarygenerator.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">g</code></dt>
+<dd>
+ A BinaryGenerator.
+ </dd>
+<dt><code class="computeroutput">G</code></dt>
+<dd>
+ A BinaryGenerator type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.generator_concepts.binarygenerator.valid_expressions"></a><h6>
+<a name="id743913"></a>
+ <a class="link" href="binarygenerator.html#spirit.karma.reference.generator_concepts.binarygenerator.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In addition to the requirements defined in <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>, for any BinaryGenerator
+ the following must be met:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">g.left</code>
+ 
+ </td>
+<td>
+ 
+ Left generator.
+ 
+ </td>
+<td>
+ 
+ <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">g.right</code>
+ 
+ </td>
+<td>
+ 
+ Right generator.
+ 
+ </td>
+<td>
+ 
+ <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.generator_concepts.binarygenerator.type_expressions"></a><h6>
+<a name="id744075"></a>
+ <a class="link" href="binarygenerator.html#spirit.karma.reference.generator_concepts.binarygenerator.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">G::left_type</code>
+ 
+ </td>
+<td>
+ 
+ The left parser type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">G::right_type</code>
+ 
+ </td>
+<td>
+ 
+ The right parser type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_binary_generator<G>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">G</code>
+ is a BinaryGenerator, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.generator_concepts.binarygenerator.invariants"></a><h6>
+<a name="id744274"></a>
+ <a class="link" href="binarygenerator.html#spirit.karma.reference.generator_concepts.binarygenerator.invariants">Invariants</a>
+ </h6>
+
+ For any BinaryGenerator, <code class="computeroutput">G</code>,
+ the following invariants always hold:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+<code class="computeroutput">traits::is_generator<G::left_type>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li>
+<li class="listitem">
+<code class="computeroutput">traits::is_generator<G::right_type>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li>
+</ul></div>
+<a name="spirit.karma.reference.generator_concepts.binarygenerator.models"></a><h6>
+<a name="id744411"></a>
+ <a class="link" href="binarygenerator.html#spirit.karma.reference.generator_concepts.binarygenerator.models">Models</a>
+ </h6>
+
+ The following generators conform to this model:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+<a class="link" href="../operator/list.html" title="Lists (a % b)">list (<code class="computeroutput">%</code>)</a>.
+ </li></ul></div>
+
+ FIXME Add more links to models of BinaryGenerator
+ concept
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unarygenerator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="narygenerator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/generator.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/generator.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,278 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Generator</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../generator_concepts.html" title="Generator Concepts">
+<link rel="prev" href="../generator_concepts.html" title="Generator Concepts">
+<link rel="next" href="primitivegenerator.html" title="PrimitiveGenerator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitivegenerator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Generator">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.generator_concepts.generator"></a><a class="link" href="generator.html" title="Generator">Generator</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.generator_concepts.generator.description"></a><h6>
+<a name="id736912"></a>
+ <a class="link" href="generator.html#spirit.karma.reference.generator_concepts.generator.description">Description</a>
+ </h6>
+
+ The Generator is the most fundamental concept. A
+ Generator has a member function, <code class="computeroutput">generate</code>,
+ that accepts an <code class="computeroutput">OutputIterator</code>
+ and returns bool as its result. The iterator receives the data being
+ generated. The Generator's <code class="computeroutput">generate</code>
+ member function returns <code class="computeroutput">true</code>
+ if the generator succeeds. Each Generator can represent a specific pattern
+ or algorithm, or it can be a more complex generator formed as a composition
+ of other Generator's.
+ 
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">g</code></dt>
+<dd>
+ A <code class="computeroutput">Generator</code>.
+ </dd>
+<dt><code class="computeroutput">G</code></dt>
+<dd>
+ A <code class="computeroutput">Generator</code> type.
+ </dd>
+<dt><code class="computeroutput">OutIter</code></dt>
+<dd>
+ An <code class="computeroutput">OutputIterator</code>
+ type.
+ </dd>
+<dt><code class="computeroutput">sink</code></dt>
+<dd>
+ An <code class="computeroutput">OutputIterator</code>
+ instance.
+ </dd>
+<dt><code class="computeroutput">Context</code></dt>
+<dd>
+ The generator's Context type.
+ </dd>
+<dt><code class="computeroutput">context</code></dt>
+<dd>
+ The generator's Context, or <code class="computeroutput">unused</code>.
+ </dd>
+<dt><code class="computeroutput">delimit</code></dt>
+<dd>
+ A delimiter Generator, or <code class="computeroutput">unused</code>.
+ </dd>
+<dt><code class="computeroutput">attrib</code></dt>
+<dd>
+ A Compatible Attributes, or <code class="computeroutput">unused</code>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.generator_concepts.generator.valid_expressions"></a><h6>
+<a name="id737166"></a>
+ <a class="link" href="generator.html#spirit.karma.reference.generator_concepts.generator.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In the expressions below, the behavior of the generator, <code class="computeroutput">g</code>, as well as how <code class="computeroutput">delimit</code>
+ and <code class="computeroutput">attrib</code> are handled
+ by <code class="computeroutput">g</code>, are left unspecified
+ in the base <code class="computeroutput">Generator</code>
+ concept. These are specified in subsequent, more refined concepts and
+ by the actual models therof.
+ 
+
+ For any Generator the following expressions must be valid:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">g.generate(sink, context, delimit, attr)</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the output sequence by inserting the generated characters/tokens
+ into <code class="computeroutput">sink</code>. Use
+ the <code class="computeroutput">delimit</code> generator
+ for delimiting. Return <code class="computeroutput">true</code>
+ if successful, otherwise return <code class="computeroutput">false</code>.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">bool</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">g.what(context)</code>
+ 
+ </td>
+<td>
+ 
+ Get information about a Generator.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">info</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.generator_concepts.generator.type_expressions"></a><h6>
+<a name="id737426"></a>
+ <a class="link" href="generator.html#spirit.karma.reference.generator_concepts.generator.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">G::template attribute<Context>::type</code>
+ 
+ </td>
+<td>
+ 
+ The Generator's attribute.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_generator<G>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">G</code>
+ is a Generator, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">G::properties</code>
+ 
+ </td>
+<td>
+ 
+ A <code class="computeroutput">mpl::int_</code> (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Integral Constant</a>) holding a value from the <code class="computeroutput">karma::generator_properties</code> enumeration.
+ The default value is <code class="computeroutput">generator_properties::no_properties</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.generator_concepts.generator.postcondition"></a><h6>
+<a name="id737692"></a>
+ <a class="link" href="generator.html#spirit.karma.reference.generator_concepts.generator.postcondition">Postcondition</a>
+ </h6>
+
+ Upon return from <code class="computeroutput">g.generate</code> the following post conditions
+ should hold:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ On successful generation, <code class="computeroutput">sink</code>
+ receives the generated characters/tokens sequence.
+ </li>
+<li class="listitem">
+ No pre-delimits: <code class="computeroutput">delimit</code>
+ characters/tokens will not be emitted in front of any other output.
+ </li>
+<li class="listitem">
+ The attribute <code class="computeroutput">attrib</code>
+ has not been modified.
+ </li>
+</ul></div>
+<a name="spirit.karma.reference.generator_concepts.generator.models"></a><h6>
+<a name="id737761"></a>
+ <a class="link" href="generator.html#spirit.karma.reference.generator_concepts.generator.models">Models</a>
+ </h6>
+
+ All generators in Spirit.Karma are models of the
+ Generator concept.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitivegenerator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/narygenerator.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/narygenerator.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,217 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>NaryGenerator</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../generator_concepts.html" title="Generator Concepts">
+<link rel="prev" href="binarygenerator.html" title="BinaryGenerator">
+<link rel="next" href="../karma_basics.html" title="Basics">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binarygenerator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../karma_basics.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="NaryGenerator">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.generator_concepts.narygenerator"></a><a class="link" href="narygenerator.html" title="NaryGenerator">NaryGenerator</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.generator_concepts.narygenerator.description"></a><h6>
+<a name="id744466"></a>
+ <a class="link" href="narygenerator.html#spirit.karma.reference.generator_concepts.narygenerator.description">Description</a>
+ </h6>
+
+ NaryGenerator is a composite generator that has
+ one or more subjects. The NaryGenerator allows its subjects to be treated
+ in the same way as a single instance of a <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a> following the Composite
+ Design Pattern.
+ 
+<a name="spirit.karma.reference.generator_concepts.narygenerator.refinement_of"></a><h6>
+<a name="id744497"></a>
+ <a class="link" href="narygenerator.html#spirit.karma.reference.generator_concepts.narygenerator.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">g</code></dt>
+<dd>
+ A NaryGenerator.
+ </dd>
+<dt><code class="computeroutput">G</code></dt>
+<dd>
+ A NaryGenerator type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.generator_concepts.narygenerator.valid_expressions"></a><h6>
+<a name="id744574"></a>
+ <a class="link" href="narygenerator.html#spirit.karma.reference.generator_concepts.narygenerator.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In addition to the requirements defined in <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>, for any NaryGenerator
+ the following must be met:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">g.elements</code>
+ 
+ </td>
+<td>
+ 
+ The tuple of elements.
+ 
+ </td>
+<td>
+ 
+ A Boost.Fusion
+ Sequence of <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a> types.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.generator_concepts.narygenerator.type_expressions"></a><h6>
+<a name="id744694"></a>
+ <a class="link" href="narygenerator.html#spirit.karma.reference.generator_concepts.narygenerator.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">g.elements_type</code>
+ 
+ </td>
+<td>
+ 
+ Elements tuple type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_nary_generator<G>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">G</code>
+ is a NaryGenerator, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.generator_concepts.narygenerator.invariants"></a><h6>
+<a name="id744861"></a>
+ <a class="link" href="narygenerator.html#spirit.karma.reference.generator_concepts.narygenerator.invariants">Invariants</a>
+ </h6>
+
+ For each element, <code class="computeroutput">E</code>,
+ in any NaryGenerator, <code class="computeroutput">G</code>,
+ the following invariant always holds:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+<code class="computeroutput">traits::is_generator<E>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li></ul></div>
+<a name="spirit.karma.reference.generator_concepts.narygenerator.models"></a><h6>
+<a name="id744946"></a>
+ <a class="link" href="narygenerator.html#spirit.karma.reference.generator_concepts.narygenerator.models">Models</a>
+ </h6>
+
+ The following generators conform to this model:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+<a class="link" href="../operator/sequence.html" title="Sequences (a << b)">sequence (<code class="computeroutput"><<</code>)</a>,
+ </li>
+<li class="listitem">
+<a class="link" href="../operator/alternative.html" title="Alternative (a | b)">alternative
+ (<code class="computeroutput">|</code>)</a>.
+ </li>
+</ul></div>
+
+ FIXME Add more links to models of NaryGenerator
+ concept
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binarygenerator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../karma_basics.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/primitivegenerator.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/primitivegenerator.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,144 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>PrimitiveGenerator</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../generator_concepts.html" title="Generator Concepts">
+<link rel="prev" href="generator.html" title="Generator">
+<link rel="next" href="unarygenerator.html" title="UnaryGenerator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="generator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="unarygenerator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="PrimitiveGenerator">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.generator_concepts.primitivegenerator"></a><a class="link" href="primitivegenerator.html" title="PrimitiveGenerator">PrimitiveGenerator</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.generator_concepts.primitivegenerator.description"></a><h6>
+<a name="id737803"></a>
+ <a class="link" href="primitivegenerator.html#spirit.karma.reference.generator_concepts.primitivegenerator.description">Description</a>
+ </h6>
+
+ PrimitiveGenerator is the most basic building block
+ that the client uses to build more complex generators.
+ 
+<a name="spirit.karma.reference.generator_concepts.primitivegenerator.refinement_of"></a><h6>
+<a name="id737824"></a>
+ <a class="link" href="primitivegenerator.html#spirit.karma.reference.generator_concepts.primitivegenerator.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.generator_concepts.primitivegenerator.post_delimit"></a><h6>
+<a name="id737857"></a>
+ <a class="link" href="primitivegenerator.html#spirit.karma.reference.generator_concepts.primitivegenerator.post_delimit">Post-delimit</a>
+ </h6>
+
+ Before exiting the <code class="computeroutput">generate</code>
+ member function, a PrimitiveGenerator is required to do a post-delimit.
+ This will generate a single delimiting character/token sequence. Only
+ PrimitiveGenerator's are required to perform this post-delimit. This
+ is typically carried out through a call to <code class="computeroutput">karma::delimit_out</code>:
+ 
+<pre class="programlisting">karma::delimit_out(sink, delimit);
+</pre>
+<a name="spirit.karma.reference.generator_concepts.primitivegenerator.type_expressions"></a><h6>
+<a name="id737930"></a>
+ <a class="link" href="primitivegenerator.html#spirit.karma.reference.generator_concepts.primitivegenerator.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_primitive_generator<G>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">G</code>,
+ is a PrimitiveGenerator, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.generator_concepts.primitivegenerator.models"></a><h6>
+<a name="id738065"></a>
+ <a class="link" href="primitivegenerator.html#spirit.karma.reference.generator_concepts.primitivegenerator.models">Models</a>
+ </h6>
+
+ The following generators conform to this model:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+<a class="link" href="../auxiliary/eol.html" title="End of Line (eol)"><code class="computeroutput">eol</code></a> ,
+ </li>
+<li class="listitem">
+<a class="link" href="../auxiliary/eps.html" title="Epsilon (eps)"><code class="computeroutput">eps</code></a>,
+ </li>
+<li class="listitem">
+<a class="link" href="../numeric.html" title="Numeric">Numeric generators</a>,
+ </li>
+<li class="listitem">
+<a class="link" href="../char/char_generator.html" title="Character Generators (char_, lit)">Character
+ generators</a>.
+ </li>
+</ul></div>
+
+ FIXME Add more links to PrimitiveGenerator
+ models here.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="generator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="unarygenerator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/unarygenerator.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/generator_concepts/unarygenerator.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,251 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>UnaryGenerator</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../generator_concepts.html" title="Generator Concepts">
+<link rel="prev" href="primitivegenerator.html" title="PrimitiveGenerator">
+<link rel="next" href="binarygenerator.html" title="BinaryGenerator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitivegenerator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binarygenerator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="UnaryGenerator">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.generator_concepts.unarygenerator"></a><a class="link" href="unarygenerator.html" title="UnaryGenerator">UnaryGenerator</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.generator_concepts.unarygenerator.description"></a><h6>
+<a name="id743038"></a>
+ <a class="link" href="unarygenerator.html#spirit.karma.reference.generator_concepts.unarygenerator.description">Description</a>
+ </h6>
+
+ UnaryGenerator is a composite generator that has
+ a single subject. The UnaryGenerator may change the behavior of its subject
+ following the Delegate Design Pattern.
+ 
+<a name="spirit.karma.reference.generator_concepts.unarygenerator.refinement_of"></a><h6>
+<a name="id743059"></a>
+ <a class="link" href="unarygenerator.html#spirit.karma.reference.generator_concepts.unarygenerator.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">g</code></dt>
+<dd>
+ A UnaryGenerator.
+ </dd>
+<dt><code class="computeroutput">G</code></dt>
+<dd>
+ A UnaryGenerator type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.generator_concepts.unarygenerator.valid_expressions"></a><h6>
+<a name="id743135"></a>
+ <a class="link" href="unarygenerator.html#spirit.karma.reference.generator_concepts.unarygenerator.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In addition to the requirements defined in <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>, for any UnaryGenerator
+ the following must be met:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">g.subject</code>
+ 
+ </td>
+<td>
+ 
+ Subject generator.
+ 
+ </td>
+<td>
+ 
+ <a class="link" href="generator.html" title="Generator"><code class="computeroutput">Generator</code></a>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.generator_concepts.unarygenerator.type_expressions"></a><h6>
+<a name="id743251"></a>
+ <a class="link" href="unarygenerator.html#spirit.karma.reference.generator_concepts.unarygenerator.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">G::subject_type</code>
+ 
+ </td>
+<td>
+ 
+ The subject generator type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_unary_generator<G>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">G</code>
+ is a UnaryGenerator, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.generator_concepts.unarygenerator.invariants"></a><h6>
+<a name="id743416"></a>
+ <a class="link" href="unarygenerator.html#spirit.karma.reference.generator_concepts.unarygenerator.invariants">Invariants</a>
+ </h6>
+
+ For any UnaryGenerator, <code class="computeroutput">G</code>,
+ the following invariant always holds:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+<code class="computeroutput">traits::is_generator<G::subject_type>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li></ul></div>
+<a name="spirit.karma.reference.generator_concepts.unarygenerator.models"></a><h6>
+<a name="id743501"></a>
+ <a class="link" href="unarygenerator.html#spirit.karma.reference.generator_concepts.unarygenerator.models">Models</a>
+ </h6>
+
+ The following generators conform to this model:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+<a class="link" href="../operator/kleene.html" title="Kleene Star (*a)">Kleene Star
+ (unary <code class="computeroutput">*</code>)</a>,
+ </li>
+<li class="listitem">
+<a class="link" href="../operator/plus.html" title="Plus (+a)">plus (unary <code class="computeroutput">+</code>)</a> operator,
+ </li>
+<li class="listitem">
+<a class="link" href="../operator/optional.html" title="Optional (-a)">optional (unary
+ <code class="computeroutput">-</code>)</a> operator,
+ </li>
+<li class="listitem">
+<a class="link" href="../operator/and_predicate.html" title="And Predicate (&a)">and predicate
+ (unary <code class="computeroutput">&</code>)</a> and
+ <a class="link" href="../operator/not_predicate.html" title="Not Predicate (!a)">not predicate
+ (unary <code class="computeroutput">!</code>)</a> operators,
+ </li>
+<li class="listitem">
+<a class="link" href="../directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">left_align</code></a>, <a class="link" href="../directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">center</code></a>, and <a class="link" href="../directive/alignment.html" title="Alignment Directives (left_align[], center[], right_align[])"><code class="computeroutput">right_align</code></a> directives,
+ </li>
+<li class="listitem">
+<a class="link" href="../directive/repeat.html" title="Repetition Directive (repeat[])"><code class="computeroutput">repeat</code></a> directive,
+ </li>
+<li class="listitem">
+<a class="link" href="../directive/delimit.html" title="Directives Controlling Automatic Delimiting (verbatim[], delimit[])"><code class="computeroutput">verbatim[a]</code></a>
+ directive,
+ </li>
+<li class="listitem">
+<a class="link" href="../directive/delimit.html" title="Directives Controlling Automatic Delimiting (verbatim[], delimit[])"><code class="computeroutput">delimit</code></a> directive,
+ </li>
+<li class="listitem">
+<a class="link" href="../directive/upperlower.html" title="Directives Controlling Case Sensitivity (upper[], lower[])"><code class="computeroutput">lower</code></a> and <a class="link" href="../directive/upperlower.html" title="Directives Controlling Case Sensitivity (upper[], lower[])"><code class="computeroutput">upper</code></a> directives,
+ </li>
+<li class="listitem">
+<a class="link" href="../directive/maxwidth.html" title="Controlling the Maximum Field Wield (maxwidth[])"><code class="computeroutput">maxwidth</code></a> directive,
+ </li>
+<li class="listitem">
+<a class="link" href="../directive/buffer.html" title="Temporary Output Buffering (buffer[])"><code class="computeroutput">buffer[a]</code></a>
+ directive,
+ </li>
+<li class="listitem">
+<a class="link" href="../directive/omit.html" title="Consume Attribute (omit[])"><code class="computeroutput">omit[a]</code></a>
+ directive.
+ </li>
+</ul></div>
+
+ FIXME Add more links to models of UnaryGenerator
+ concept
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitivegenerator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../generator_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binarygenerator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/karma_basics.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/karma_basics.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,249 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Basics</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="generator_concepts/narygenerator.html" title="NaryGenerator">
+<link rel="next" href="char.html" title="Char">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="generator_concepts/narygenerator.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Basics">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.karma_basics"></a><a class="link" href="karma_basics.html" title="Basics"> Basics</a>
+</h4></div></div></div>
+<a name="spirit.karma.reference.karma_basics.lazy_argument"></a><h6>
+<a name="id745021"></a>
+ <a class="link" href="karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a>
+ </h6>
+
+ Some generators (e.g. primitives and non-terminals) may take in additional
+ attributes. Such generators take the form:
+ 
+<pre class="programlisting">g(a1, a2,... aN)
+</pre>
+
+ where <code class="computeroutput">g</code> is a parser. Each
+ of the arguments (a1...aN) can either be an immediate value, or a function,
+ <code class="computeroutput">f</code>, with signature:
+ 
+<pre class="programlisting">T f(Unused, Context)
+</pre>
+
+ where <code class="computeroutput">T</code>, the function's
+ return value, is compatible with the argument type expected and <code class="computeroutput">Context</code> is the generators's Context type
+ (The first argument is <code class="computeroutput">unused</code>
+ to make the <code class="computeroutput">Context</code> the
+ second argument. This is done for uniformity with <a class="link" href="../tutorials/semantic_actions.html" title="Semantic Actions">Semantic
+ Actions</a>).
+ 
+<a name="spirit.karma.reference.karma_basics.character_encoding_namespace"></a><h6>
+<a name="id745161"></a>
+ <a class="link" href="karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>
+ </h6>
+
+ Some generators need to know which character set a <code class="computeroutput">char</code>
+ or <code class="computeroutput">wchar_t</code> is operating on.
+ For example, the <code class="computeroutput">alnum</code>
+ generator works differently with ISO8859.1 and ASCII encodings. Where necessary,
+ Spirit encodes (tags) the generator with the character set.
+ 
+
+ We have a namespace for each character set Spirit will be supporting. That
+ includes <code class="computeroutput">ascii</code>, <code class="computeroutput">iso8859_1</code>, <code class="computeroutput">standard</code>
+ and <code class="computeroutput">standard_wide</code> (and
+ in the future, <code class="computeroutput">unicode</code>).
+ In each of the character encoding namespaces, we place tagged versions
+ of generators such as <code class="computeroutput">alnum</code>,
+ <code class="computeroutput">space</code> etc.
+ 
+
+ Example:
+ 
+<pre class="programlisting">using boost::spirit::ascii::space; // use the ASCII space generator
+</pre>
+
+ Namespaces:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ boost::spirit::ascii
+ </li>
+<li class="listitem">
+ boost::spirit::iso8859_1
+ </li>
+<li class="listitem">
+ boost::spirit::standard
+ </li>
+<li class="listitem">
+ boost::spirit::standard_wide
+ </li>
+</ul></div>
+
+ For ease of use, the components in this namespaces are also brought into
+ the karma sub-namespaces with the same names:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ boost::spirit::karma::ascii
+ </li>
+<li class="listitem">
+ boost::spirit::karma::iso8859_1
+ </li>
+<li class="listitem">
+ boost::spirit::karma::standard
+ </li>
+<li class="listitem">
+ boost::spirit::karma::standard_wide
+ </li>
+</ul></div>
+<a name="spirit.karma.reference.karma_basics.examples"></a><h6>
+<a name="id746915"></a>
+ <a class="link" href="karma_basics.html#spirit.karma.reference.karma_basics.examples">Examples</a>
+ </h6>
+
+ All sections in the reference present some real world examples. The examples
+ use a common test harness to keep the example code as minimal and direct
+ to the point as possible. The test harness is presented below.
+ 
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ Our test functions:
+ 
+
+ This one tests the generators without attributes.
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ These test the generators with one or more user supplied attributes.
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T1, typename T2>
+void test_generator_attr(char const* expected, G const& g, T1 const& attr1,
+ T2 const& attr2)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr1, attr2) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+<a name="spirit.karma.reference.karma_basics.models"></a><h6>
+<a name="id748286"></a>
+ <a class="link" href="karma_basics.html#spirit.karma.reference.karma_basics.models">Models</a>
+ </h6>
+
+ Predefined models include:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ any literal string, e.g. "Hello, World",
+ </li>
+<li class="listitem">
+ a pointer/reference to a null-terminated array of characters
+ </li>
+<li class="listitem">
+ a <code class="computeroutput">std::basic_string<Char></code>
+</li>
+</ul></div>
+
+ The namespace <code class="computeroutput">boost::spirit::traits</code> is open for users to provide their
+ own specializations.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="generator_concepts/narygenerator.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,83 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Numeric</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="string/string.html" title="String (string, lit)">
+<link rel="next" href="numeric/unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="string/string.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric/unsigned_int.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Numeric">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.numeric"></a><a class="link" href="numeric.html" title="Numeric"> Numeric</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="numeric/unsigned_int.html"> Unsigned
+ Integer Number Generators (<code class="computeroutput">uint_</code>,
+ etc.)</a></dt>
+<dt><a href="numeric/signed_int.html"> Signed
+ Integer Number Generators (<code class="computeroutput">int_</code>,
+ etc.)</a></dt>
+<dt><a href="numeric/real_number.html"> Real
+ Number Generators (<code class="computeroutput">float_</code>,
+ <code class="computeroutput">double_</code>, etc.)</a></dt>
+</dl></div>
+
+ The library includes a couple of predefined objects for generating signed
+ and unsigned integers and real numbers. These generators are fully parametric.
+ Most of the important aspects of numeric generation can be finely adjusted
+ to suit. This includes the radix base, the exponent, the fraction etc.
+ Policies control the real number generators' behavior. There are some predefined
+ policies covering the most common real number formats but the user can
+ supply her own when needed.
+ 
+
+ The numeric parsers are fine tuned (employing loop unrolling and extensive
+ template metaprogramming) with exceptional performance that rivals the
+ low level C functions such as <code class="computeroutput">ltoa</code>,
+ <code class="computeroutput">ssprintf</code>, and <code class="computeroutput">_gcvt</code>. Benchmarks reveal up to 2X speed
+ over the C counterparts (see here: <a class="link" href="../performance_measurements/numeric_performance.html" title="Performance of Numeric Generators">Performance
+ of Numeric Generators</a>). This goes to show that you can write extremely
+ tight generic C++ code that rivals, if not surpasses C.
+ 
+<a name="spirit.karma.reference.numeric.module_header"></a><h6>
+<a name="id761427"></a>
+ <a class="link" href="numeric.html#spirit.karma.reference.numeric.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/numeric.hpp>
+#include <boost/spirit/include/karma_numeric.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="string/string.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric/unsigned_int.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/real_number.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/real_number.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,1240 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Real Number Generators (float_, double_, etc.)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../numeric.html" title="Numeric">
+<link rel="prev" href="signed_int.html" title="Signed Integer Number Generators (int_, etc.)">
+<link rel="next" href="../stream.html" title="Stream">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="signed_int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../stream.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Real Number Generators (float_, double_, etc.)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.numeric.real_number"></a><a class="link" href="real_number.html" title="Real Number Generators (float_, double_, etc.)"> Real
+ Number Generators (<code class="computeroutput">float_</code>,
+ <code class="computeroutput">double_</code>, etc.)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.numeric.real_number.description"></a><h6>
+<a name="id772438"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">real_generator</code> can
+ generate real numbers of arbitrary length and size limited by its template
+ parameter, <code class="computeroutput">Num</code>. The numeric
+ base type <code class="computeroutput">Num</code> can be
+ a user defined numeric type such as fixed_point (fixed point reals) and
+ bignum (unlimited precision numbers) as long as the type follows certain
+ expression requirements (for more information about the requirements,
+ see <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.additional_requirements">below</a>).
+ 
+<div class="note" title="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">
+ <code class="computeroutput">lit</code> is reused by the
+ <a class="link" href="../string.html" title="String">String Generators</a>,
+ the <a class="link" href="../char.html" title="Char">Character Generators</a>,
+ and the Numeric Generators. In general, a char generator is created
+ when you pass in a character, a string generator is created when you
+ pass in a string, and a numeric generator is created when you use a
+ numeric literal.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.numeric.real_number.header"></a><h6>
+<a name="id772505"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/numeric/real.hpp>
+#include <boost/spirit/include/karma_real.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.numeric.real_number.namespace"></a><h6>
+<a name="id772579"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lit // alias:
+ boost::spirit::karma::lit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::float_ // alias:
+ boost::spirit::karma::float_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::double_ //
+ alias: boost::spirit::karma::double_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::long_double //
+ alias: boost::spirit::karma::long_double</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.numeric.real_number.synopsis"></a><h6>
+<a name="id772772"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting">template <typename Num, typename RealPolicies>
+struct real_generator;
+</pre>
+<a name="spirit.karma.reference.numeric.real_number.template_parameters"></a><h6>
+<a name="id772840"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.template_parameters">Template
+ parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Parameter
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+<th>
+ 
+ Default
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Num</code>
+ 
+ </td>
+<td>
+ 
+ The type of the real number to generate
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">double</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RealPolicies</code>
+ 
+ </td>
+<td>
+ 
+ The policies to use while converting the real number
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">real_policies<Num></code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ For more information about the type <code class="computeroutput">RealPolicies</code>
+ see <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.real_number_formatting_policies">below</a>).
+ 
+<a name="spirit.karma.reference.numeric.real_number.model_of"></a><h6>
+<a name="id772996"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">num</code></dt>
+<dd>
+ Numeric literal, any real number value, or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a real number value of type <code class="computeroutput">Num</code>
+ </dd>
+<dt><code class="computeroutput">Num</code></dt>
+<dd>
+ Type of <code class="computeroutput">num</code>: any
+ real number type
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.numeric.real_number.expression_semantics"></a><h6>
+<a name="id773098"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(num)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the real number literal <code class="computeroutput">num</code>
+ using the default formatting (no trailing zeros, <code class="computeroutput">fixed</code> representation for numbers
+ <code class="computeroutput">fabs(n)
+ <= 1e5
+ && fabs(n) >
+ 1e-3</code>, scientific representation
+ otherwise, 3 fractional digits, sign is only printed for negative
+ literals). This generator never fails (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">float_
+double_
+long_double</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the real number provided by a mandatory attribute using
+ the default formatting (no trailing zeros, <code class="computeroutput">fixed</code>
+ representation for numbers <code class="computeroutput">fabs(n) <=
+ 1e5 &&
+ fabs(n)
+ > 1e-3</code>,
+ scientific representation otherwise, 3 fractional digits, sign
+ is only printed for negative literals). This generator never
+ fails (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">float_(num)
+double_(num)
+long_double(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the real point number provided by the immediate literal
+ value the generator is initialized from using the default formatting
+ (no trailing zeros, <code class="computeroutput">fixed</code>
+ representation for numbers <code class="computeroutput">fabs(n) <=
+ 1e5 &&
+ fabs(n)
+ > 1e-3</code>,
+ scientific representation otherwise, 3 fractional digits, sign
+ is only printed for negative literals). If this generator has
+ an associated attribute it succeeds only as long as the attribute
+ is equal to the immediate literal (except if the underlying output
+ stream reports an error). Otherwise this generator fails and
+ does not generate any output.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ All generators listed in the table above (except <code class="computeroutput">lit(num)</code>) are predefined specializations of the
+ <code class="computeroutput">real_generator<Num, RealPolicies></code>
+ basic real number generator type described below. It is possible to directly
+ use this type to create real number generators using a wide range of
+ formatting options.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">real_generator<
+ Num, RealPolicies
+>()</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the real number of type <code class="computeroutput">Num</code>
+ provided by a mandatory attribute using the specified <code class="computeroutput">RealPolicies</code>. This generator
+ never fails (except if the underlying output stream reports an
+ error).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.numeric.real_number.additional_requirements"></a><h6>
+<a name="id773725"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.additional_requirements">Additional
+ Requirements</a>
+ </h6>
+
+ The following list enumerate the requirements which must be met in order
+ to use a certain type <code class="computeroutput">Num</code>
+ to instantiate a <code class="computeroutput">real_generator<Num, Policies></code>.
+ 
+
+ In order to be usable as the first template parameter for <code class="computeroutput">real_generator<></code>
+ the type <code class="computeroutput">Num</code> must have
+ defined:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ comparison operators for: <code class="computeroutput"><</code>,
+ <code class="computeroutput"><=</code>, <code class="computeroutput">==</code>,
+ <code class="computeroutput">!=</code>, <code class="computeroutput">></code>,
+ and <code class="computeroutput">>=</code>
+</li>
+<li class="listitem">
+ numeric operators for: <code class="computeroutput">+</code>,
+ <code class="computeroutput">-</code>, <code class="computeroutput">/</code>,
+ <code class="computeroutput">*</code>, and <code class="computeroutput">%</code>
+</li>
+<li class="listitem">
+ functions implementing the interface and the semantics of: <code class="computeroutput">std::fmod</code>, <code class="computeroutput">std::pow</code>,
+ <code class="computeroutput">std::log10</code>, <code class="computeroutput">std::lround</code>,
+ <code class="computeroutput">std::ltrunc</code>, <code class="computeroutput">std::modf</code>,
+ <code class="computeroutput">std::floor</code>, and <code class="computeroutput">std::ceil</code>.
+ These need to be defined in a way so that they will be found using
+ argument dependent lookup (ADL).
+ </li>
+<li class="listitem">
+ a valid specialization of the type <code class="computeroutput">std::numeric_limits<Num></code> allowing for numeric property inspection.
+ </li>
+</ul></div>
+<a name="spirit.karma.reference.numeric.real_number.attributes"></a><h6>
+<a name="id774034"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">float_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">float</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">float_(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">float_</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">num</code> and
+ succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">double_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">double</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">double_(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">double</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">num</code> and
+ succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_double</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long double</code>,
+ attribute is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_double(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long double</code>,
+ attribute is optional, if it is supplied, the generator compares
+ the attribute with <code class="computeroutput">num</code>
+ and succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">real_generator<
+ Num, Policies
+>()</pre>
+
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">real_generator<
+ Num, Policies
+>()(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">num</code> and
+ succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.numeric.real_number.real_number_formatting_policies"></a><h6>
+<a name="id774494"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.real_number_formatting_policies">Real
+ Number Formatting Policies</a>
+ </h6>
+
+ If special formatting of a real number is needed, overload the policy
+ class <code class="computeroutput">real_policies<Num></code>
+ and use it as a template parameter to the <code class="computeroutput">real_generator<></code> real number generator. For instance:
+ 
+<pre class="programlisting">// define a new real number formatting policy
+template <typename Num>
+struct scientific_policy : real_policies<Num>
+{
+ // we want the numbers always to be in scientific format
+ static int floatfield(Num n) { return fmtflags::scientific; }
+};
+
+// define a new generator type based on the new policy
+typedef real_generator<double, scientific_policy<double> > science_type;
+science_type const scientific = science_type();
+
+// use the new generator
+generate(sink, science_type(), 1.0); // will output: 1.0e00
+generate(sink, scientific, 0.1); // will output: 1.0e-01
+</pre>
+
+ The template parameter <code class="computeroutput">Num</code>
+ should be the type to be formatted using the overloaded policy type.
+ At the same time <code class="computeroutput">Num</code>
+ will be used as the attribute type of the created real number generator.
+ 
+<a name="spirit.karma.reference.numeric.real_number.real_number_formatting_policy_expression_semantics"></a><h6>
+<a name="id774848"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.real_number_formatting_policy_expression_semantics">Real
+ Number Formatting Policy Expression Semantics</a>
+ </h6>
+
+ A real number formatting policy should expose the following variables
+ and functions:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <typename Inserter
+ , typename OutputIterator
+ , typename Policies>
+bool call (OutputIterator& sink, Num n
+ , Policies const& p);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ This is the main function used to generate the output for a real
+ number. It is called by the real generator in order to perform
+ the conversion. In theory all of the work can be implemented
+ here, but it is the easiest to use existing functionality provided
+ by the type specified by the template parameter <code class="computeroutput">Inserter</code>. The default implementation
+ of this functions is:
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <typename Inserter, typename OutputIterator
+ , typename Policies>
+static bool
+call (OutputIterator& sink, Num n, Policies const& p)
+{
+ return Inserter::call_n(sink, n, p);
+}
+</pre>
+
+ <code class="computeroutput">sink</code>: is the
+ output iterator to use for generation
+ 
+ 
+ <code class="computeroutput">n</code>: is the real
+ number to convert
+ 
+ 
+ <code class="computeroutput">p</code>: the instance
+ of the policy type used to instantiate this real number generator.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">bool force_sign(Num n);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ The default behavior is to not to require generating a sign.
+ If the function <code class="computeroutput">force_sign()</code> returns true, then all generated
+ numbers will have a sign (<code class="computeroutput">'+'</code>
+ or <code class="computeroutput">'-'</code>, zeros will
+ have a space instead of a sign).
+ 
+ 
+ <code class="computeroutput">n</code> is the real
+ number to output. This can be used to adjust the required behavior
+ depending on the value of this number.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">bool trailing_zeros(Num n);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ Return whether trailing zero digits have to be emitted in the
+ fractional part of the output. If set, this flag instructs the
+ real number generator to emit trailing zeros up to the required
+ precision digits (as returned by the <code class="computeroutput">precision()</code> function).
+ 
+ 
+ <code class="computeroutput">n</code> is the real
+ number to output. This can be used to adjust the required behavior
+ depending on the value of this number.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int floatfield(Num n);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ Decide, which representation type to use in the generated output.
+ 
+ 
+ By default all numbers having an absolute value of zero or in
+ between <code class="computeroutput">0.001</code> and
+ <code class="computeroutput">100000</code> will be generated
+ using the fixed format, all others will be generated using the
+ scientific representation.
+ 
+ 
+ The <code class="computeroutput">trailing_zeros()</code> can be used to force the output
+ of trailing zeros in the fractional part up to the number of
+ digits returned by the <code class="computeroutput">precision()</code> member function. The default
+ is not to generate the trailing zeros.
+ 
+ 
+ <code class="computeroutput">n</code>: is the real
+ number to output. This can be used to adjust the formatting flags
+ depending on the value of this number.
+ 
+ 
+ The return value has to be either <code class="computeroutput">fmtflags::scientific</code>
+ (generate real number values in scientific notation) or <code class="computeroutput">fmtflags::fixed</code> (generate real number
+ values in fixed-point notation).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">unsigned precision(Num n);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ Return the maximum number of decimal digits to generate in the
+ fractional part of the output.
+ 
+ 
+ <code class="computeroutput">n</code>: is the real
+ number to output. This can be used to adjust the required precision
+ depending on the value of this number. If the trailing zeros
+ flag is specified the fractional part of the output will be 'filled'
+ with zeros, if appropriate.
+ 
+ 
+ Note: If the trailing_zeros
+ flag is not in effect additional semantics apply. See the description
+ for the <code class="computeroutput">fraction_part()</code> function below. Moreover, this
+ precision will be limited to the value of <code class="computeroutput">std::numeric_limits<T>::digits10
+ + 1</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <bool ForceSign,
+ typename OutputIterator>
+bool integer_part(OutputIterator& sink
+ , Num n, bool sign, bool force_sign);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ This function is called to generate the integer part of the real
+ number.
+ 
+ 
+ <code class="computeroutput">sink</code>: is the
+ output iterator to use for generation
+ 
+ 
+ <code class="computeroutput">n</code>: is the absolute
+ value of the integer part of the real number to convert (always
+ non-negative)
+ 
+ 
+ <code class="computeroutput">sign</code>: is the
+ sign of the overall real number to convert.
+ 
+ 
+ <code class="computeroutput">force_sign</code>: is
+ a flag whether a sign has to be generated even for non- negative
+ numbers (this is the same as has been returned from the function
+ <code class="computeroutput">force_sign()</code>
+ described above)
+ 
+ 
+ The return value defines the outcome of the whole generator.
+ If it is <code class="computeroutput">false</code>,
+ no further output is generated, immediatly returning <code class="computeroutput">false</code> from the calling <code class="computeroutput">real_generator</code> as well. If
+ it is <code class="computeroutput">true</code>, normal
+ output generation continues.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <typename OutputIterator>
+bool dot(OutputIterator& sink, Num n,
+ unsigned precision);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ This function is called to generate the decimal point.
+ 
+ 
+ <code class="computeroutput">sink</code>: is the
+ output iterator to use for generation
+ 
+ 
+ <code class="computeroutput">n</code>: The fractional
+ part of the real number to convert. Note that this number is
+ scaled such, that it represents the number of units which correspond
+ to the value returned from the <code class="computeroutput">precision()</code> function earlier. I.e. a fractional
+ part of <code class="computeroutput">0.01234</code> is
+ represented as <code class="computeroutput">1234</code>
+ when the function <code class="computeroutput">precision()</code> returned <code class="computeroutput">5</code>.
+ 
+ 
+ <code class="computeroutput">precision</code>: The
+ number of digits to emit as returned by the function <code class="computeroutput">precision()</code>
+ described above
+ 
+ 
+ This is given to allow to decide, whether a decimal point has
+ to be generated at all.
+ 
+ 
+ Note: If the <code class="computeroutput">trailing_zeros</code>
+ flag is not in effect additional comments apply. See the description
+ for the <code class="computeroutput">fraction_part()</code> function below.
+ 
+ 
+ The return value defines the outcome of the whole generator.
+ If it is <code class="computeroutput">false</code>,
+ no further output is generated, immediatly returning <code class="computeroutput">false</code> from the calling <code class="computeroutput">real_generator</code> as well. If
+ it is <code class="computeroutput">true</code>, normal
+ output generation continues.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <typename OutputIterator>
+bool fraction_part(OutputIterator& sink, Num n
+ , unsigned adjprec, unsigned precision);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ This function is called to generate the fractional part of the
+ number.
+ 
+ 
+ <code class="computeroutput">sink</code>: is the
+ output iterator to use for generation
+ 
+ 
+ <code class="computeroutput">n</code>: The fractional
+ part of the real number to convert. Note that this number is
+ scaled such, that it represents the number of units which correspond
+ to the value returned from the <code class="computeroutput">precision()</code> function earlier. I.e. a fractional
+ part of <code class="computeroutput">0.01234</code> is
+ represented as <code class="computeroutput">1234</code>
+ when the function <code class="computeroutput">precision()</code> returned <code class="computeroutput">5</code>.
+ 
+ 
+ <code class="computeroutput">adjprec</code>: The
+ corrected number of digits to emit (see note below)
+ 
+ 
+ <code class="computeroutput">precision</code>: The
+ number of digits to emit as returned by the function <code class="computeroutput">precision()</code>
+ described above
+ 
+ 
+ Note: If <code class="computeroutput">trailing_zeros()</code> returns <code class="computeroutput">false</code>
+ the <code class="computeroutput">adjprec</code> parameter
+ will have been corrected from the value the <code class="computeroutput">precision()</code> function returned earlier (defining
+ the maximal number of fractional digits) in the sense, that it
+ takes into account trailing zeros. I.e. a real number <code class="computeroutput">0.0123</code> and a value of <code class="computeroutput">5</code> returned from <code class="computeroutput">precision()</code> will result in:
+ 
+ 
+ <code class="computeroutput">trailing_zeros()</code> returned <code class="computeroutput">false</code>:
+ <code class="computeroutput">n</code> will be <code class="computeroutput">123</code>, and <code class="computeroutput">adjprec</code>
+ will be <code class="computeroutput">4</code> (as we
+ need to print <code class="computeroutput">0123</code>)
+ 
+ 
+ <code class="computeroutput">trailing_zeros()</code> returned <code class="computeroutput">true</code>:
+ <code class="computeroutput">n</code> will be <code class="computeroutput">1230</code>, and <code class="computeroutput">adjprec</code>
+ will be <code class="computeroutput">5</code> (as we
+ need to print <code class="computeroutput">01230</code>)
+ 
+ 
+ The missing preceding zeros in the fractional part have to be
+ supplied by the implementation of this policy function.
+ 
+ 
+ The return value defines the outcome of the whole generator.
+ If it is <code class="computeroutput">false</code>,
+ no further output is generated, immediatly returning <code class="computeroutput">false</code> from the calling <code class="computeroutput">real_generator</code> as well. If
+ it is <code class="computeroutput">true</code>, normal
+ output generation continues.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <typename CharEncoding,
+ typename Tag, typename OutputIterator>
+bool exponent(
+ OutputIterator& sink, long n);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ This function is called to generate the exponential part of the
+ number (this is called only if the <code class="computeroutput">floatfield()</code> function returned the <code class="computeroutput">fmtflags::scientific</code> flag).
+ 
+ 
+ <code class="computeroutput">sink</code>: is the
+ output iterator to use for generation
+ 
+ 
+ <code class="computeroutput">n</code>: The (signed)
+ exponential part of the real number to convert.
+ 
+ 
+ The template parameters <code class="computeroutput">CharEncoding</code>
+ and <code class="computeroutput">Tag</code> are either
+ of the type <code class="computeroutput">unused_type</code>
+ or describe the character class and conversion to be applied
+ to any output possibly influenced by either the <code class="computeroutput">lower[]</code>
+ or <code class="computeroutput">upper[]</code>
+ directives.
+ 
+ 
+ The return value defines the outcome of the whole generator.
+ If it is <code class="computeroutput">false</code>,
+ no further output is generated, immediatly returning <code class="computeroutput">false</code> from the calling <code class="computeroutput">real_generator</code> as well. If
+ it is <code class="computeroutput">true</code>, normal
+ output generation continues.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <typename CharEncoding
+ , typename Tag, typename OutputIterator>
+bool nan (OutputIterator& sink, Num n
+ , bool force_sign);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ This function is called whenever the number to print is a non-normal
+ real number of type <code class="computeroutput">NaN</code>.
+ 
+ 
+ <code class="computeroutput">sink</code>: is the
+ output iterator to use for generation
+ 
+ 
+ <code class="computeroutput">n</code>: is the (signed)
+ real number to convert
+ 
+ 
+ <code class="computeroutput">force_sign</code>: is
+ a flag whether a sign has to be generated even for non- negative
+ numbers (this is the same as has been returned from the function
+ <code class="computeroutput">force_sign()</code>
+ described above)
+ 
+ 
+ The template parameters <code class="computeroutput">CharEncoding</code>
+ and <code class="computeroutput">Tag</code> are either
+ of the type <code class="computeroutput">unused_type</code>
+ or describe the character class and conversion to be applied
+ to any output possibly influenced by either the <code class="computeroutput">lower[]</code>
+ or <code class="computeroutput">upper[]</code>
+ directives.
+ 
+ 
+ The return value defines the outcome of the whole generator.
+ If it is <code class="computeroutput">false</code>,
+ no further output is generated, immediatly returning <code class="computeroutput">false</code> from the calling <code class="computeroutput">real_generator</code> as well. If
+ it is <code class="computeroutput">true</code>, normal
+ output generation continues.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <typename CharEncoding
+ , typename Tag, typename OutputIterator>
+bool inf (OutputIterator& sink, Num n
+ , bool force_sign);
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ This function is called whenever the number to print is a non-normal
+ real number of type <code class="computeroutput">Inf</code>.
+ 
+ 
+ <code class="computeroutput">sink</code>: is the
+ output iterator to use for generation
+ 
+ 
+ <code class="computeroutput">n</code>: is the (signed)
+ real number to convert
+ 
+ 
+ <code class="computeroutput">force_sign</code>: is
+ a flag whether a sign has to be generated even for non- negative
+ numbers (this is the same as has been returned from the function
+ <code class="computeroutput">force_sign()</code>
+ described above)
+ 
+ 
+ The template parameters <code class="computeroutput">CharEncoding</code>
+ and <code class="computeroutput">Tag</code> are either
+ of the type <code class="computeroutput">unused_type</code>
+ or describe the character class and conversion to be applied
+ to any output possibly influenced by either the <code class="computeroutput">lower[]</code>
+ or <code class="computeroutput">upper[]</code>
+ directives.
+ 
+ 
+ The return value defines the outcome of the whole generator.
+ If it is <code class="computeroutput">false</code>,
+ no further output is generated, immediatly returning <code class="computeroutput">false</code> from the calling <code class="computeroutput">real_generator</code> as well. If
+ it is <code class="computeroutput">true</code>, normal
+ output generation continues.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+ The easiest way to implement a proper real number formatting policy
+ is to derive a new type from the the type <code class="computeroutput">real_policies<></code> while overriding the aspects
+ of the formatting which need to be changed.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.numeric.real_number.complexity"></a><h6>
+<a name="id778427"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where <code class="computeroutput">N</code> is
+ the number of digits needed to represent the generated real number.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.numeric.real_number.example"></a><h6>
+<a name="id778458"></a>
+ <a class="link" href="real_number.html#spirit.karma.reference.numeric.real_number.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of an <code class="computeroutput">double_</code>
+ generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator("2.0", lit(2.0));
+test_generator("2.0", double_(2));
+test_generator_attr("2.0", double_(2.0), 2.0);
+test_generator_attr("", double_(2.0), 3.0); // fails (as 2.0 != 3.0)!
+test_generator_attr("-2.0", double_, -2.0);
+
+test_generator_attr("1.234e05", double_, 1234.0e2);
+test_generator_attr("1.234e-06", double_, 0.000001234);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="signed_int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../stream.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/signed_int.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/signed_int.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,816 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Signed Integer Number Generators (int_, etc.)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../numeric.html" title="Numeric">
+<link rel="prev" href="unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)">
+<link rel="next" href="real_number.html" title="Real Number Generators (float_, double_, etc.)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unsigned_int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="real_number.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Signed Integer Number Generators (int_, etc.)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.numeric.signed_int"></a><a class="link" href="signed_int.html" title="Signed Integer Number Generators (int_, etc.)"> Signed
+ Integer Number Generators (<code class="computeroutput">int_</code>,
+ etc.)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.numeric.signed_int.description"></a><h6>
+<a name="id767155"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">int_generator</code> can
+ generate signed integers of arbitrary length and size. This is almost
+ the same as the <code class="computeroutput">int_generator</code>.
+ The only difference is the additional task of generating the <code class="computeroutput">'+'</code> or <code class="computeroutput">'-'</code>
+ sign preceding the number. The class interface is the same as that of
+ the <code class="computeroutput">int_generator</code>.
+ 
+
+ The <code class="computeroutput">int_generator</code> generator
+ can be used to emit ordinary primitive C/C++ integers or even user defined
+ scalars such as bigints (unlimited precision integers) as long as the
+ type follows certain expression requirements (for more information about
+ the requirements, see <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.additional_requirements">below</a>).
+ 
+<div class="note" title="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">
+ <code class="computeroutput">lit</code> is reused by the
+ <a class="link" href="../string.html" title="String">String Generators</a>,
+ the <a class="link" href="../char.html" title="Char">Character Generators</a>,
+ and the Numeric Generators. In general, a char generator is created
+ when you pass in a character, a string generator is created when you
+ pass in a string, and a numeric generator is created when you use a
+ numeric literal.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.numeric.signed_int.header"></a><h6>
+<a name="id767248"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/numeric/int.hpp>
+#include <boost/spirit/include/karma_int.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.numeric.signed_int.namespace"></a><h6>
+<a name="id767322"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lit // alias:
+ boost::spirit::karma::lit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::short_ // alias:
+ boost::spirit::karma::short_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::int_ // alias:
+ boost::spirit::karma::int_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::long_ // alias:
+ boost::spirit::karma::long_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::long_long //
+ alias: boost::spirit::karma::long_long</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ The generators <code class="computeroutput">long_long</code>
+ and <code class="computeroutput">long_long(num)</code>
+ are only available on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code> is defined (i.e.
+ on platforms having native support for <code class="computeroutput">long
+ long</code> (64 bit) integer types).
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.numeric.signed_int.synopsis"></a><h6>
+<a name="id767611"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting">template <
+ typename T
+ , unsigned Radix
+ , bool force_sign>
+struct int_generator;
+</pre>
+<a name="spirit.karma.reference.numeric.signed_int.template_parameters"></a><h6>
+<a name="id767695"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.template_parameters">Template
+ parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Parameter
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+<th>
+ 
+ Default
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T</code>
+ 
+ </td>
+<td>
+ 
+ The numeric base type of the numeric parser.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">int</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Radix</code>
+ 
+ </td>
+<td>
+ 
+ The radix base. This can be either 2: binary, 8: octal, 10: decimal
+ and 16: hexadecimal.
+ 
+ </td>
+<td>
+ 
+ 10
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">force_sign</code>
+ 
+ </td>
+<td>
+ 
+ If <code class="computeroutput">true</code>, all numbers
+ will have a sign (space for zero)
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">false</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.numeric.signed_int.model_of"></a><h6>
+<a name="id767862"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">num</code></dt>
+<dd>
+ Numeric literal, any signed integer value, or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a signed integer value of type
+ <code class="computeroutput">Num</code>
+ </dd>
+<dt><code class="computeroutput">Num</code></dt>
+<dd>
+ Type of <code class="computeroutput">num</code>: any
+ signed integer type
+ </dd>
+<dt><code class="computeroutput">Radix</code></dt>
+<dd>
+ A constant integer literal specifying the required radix for the
+ output conversion. Valid values are <code class="computeroutput">2</code>,
+ <code class="computeroutput">8</code>, <code class="computeroutput">10</code>,
+ and <code class="computeroutput">16</code>.
+ </dd>
+<dt><code class="computeroutput">force_sign</code></dt>
+<dd>
+ A constant boolean literal specifying whether the generated number
+ should always have a sign (<code class="computeroutput">'+'</code>
+ for positive numbers, <code class="computeroutput">'-'</code>
+ for negative numbers and a '<code class="computeroutput"> </code>' for zero).
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.numeric.signed_int.expression_semantics"></a><h6>
+<a name="id768048"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(num)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the integer literal <code class="computeroutput">num</code>
+ using the default formatting (radix is 10, sign is only printed
+ for negative literals). This generator never fails (except if
+ the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">short_
+int_
+long_
+long_long</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the integer provided by a mandatory attribute using
+ the default formatting (radix is 10, sign is only printed for
+ negative literals). This generator never fails (except if the
+ underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">short_(num)
+int_(num)
+long_(num)
+long_long(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the integer provided by the immediate literal value
+ the generator is initialized from using the default formatting
+ (radix is 10, sign is only printed for negative literals). If
+ this generator has an associated attribute it succeeds only as
+ long as the attribute is equal to the immediate literal (except
+ if the underlying output stream reports an error). Otherwise
+ this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ All generators listed in the table above (except <code class="computeroutput">lit(num)</code>) are predefined specializations of the
+ <code class="computeroutput">int_generator<Num, Radix, force_sign></code>
+ basic integer number generator type described below. It is possible to
+ directly use this type to create integer generators using a wide range
+ of formatting options.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int_generator<
+ Num, Radix, force_sign
+>()</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the integer of type <code class="computeroutput">Num</code>
+ provided by a mandatory attribute using the specified <code class="computeroutput">Radix</code> (possible values are
+ <code class="computeroutput">2</code>, <code class="computeroutput">8</code>, <code class="computeroutput">10</code>,
+ and <code class="computeroutput">16</code>, the default
+ value is <code class="computeroutput">10</code>). If
+ <code class="computeroutput">force_sign</code> is
+ <code class="computeroutput">false</code> (the default),
+ a sign is only printed for negative literals. If <code class="computeroutput">force_sign</code> is <code class="computeroutput">true</code>, all numbers will be printed
+ using a sign, i.e. <code class="computeroutput">'-'</code>
+ for negative numbers, <code class="computeroutput">'+'</code>
+ for positive numbers, and <code class="computeroutput">' '</code>
+ for zeros. This generator never fails (except if the underlying
+ output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int_generator<
+ Num, Radix, force_sign
+>()(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the integer of type <code class="computeroutput">Num</code>
+ provided by the immediate literal value the generator is initialized
+ from, using the specified <code class="computeroutput">Radix</code>
+ (possible values are <code class="computeroutput">2</code>,
+ <code class="computeroutput">8</code>, <code class="computeroutput">10</code>, and <code class="computeroutput">16</code>,
+ the default value is <code class="computeroutput">10</code>).
+ If <code class="computeroutput">force_sign</code>
+ is <code class="computeroutput">false</code> (the default),
+ a sign is only printed for negative literals. If <code class="computeroutput">force_sign</code> is <code class="computeroutput">true</code>, all numbers will be printed
+ using a sign, i.e. <code class="computeroutput">'-'</code>
+ for negative numbers, <code class="computeroutput">'+'</code>
+ for positive numbers, and <code class="computeroutput">' '</code>
+ for zeros. If this generator has an associated attribute it succeeds
+ only as long as the attribute is equal to the immediate literal
+ (except if the underlying output stream reports an error). Otherwise
+ this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.numeric.signed_int.additional_requirements"></a><h6>
+<a name="id768682"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.additional_requirements">Additional
+ Requirements</a>
+ </h6>
+
+ The following lists enumerate the requirements which must be met in order
+ to use a certain type <code class="computeroutput">Num</code>
+ to instantiate and use a <code class="computeroutput">int_generator<Num, Radix, force_sign></code>.
+ 
+
+ If <code class="computeroutput">boost::is_integral<Num>::value</code> is <code class="computeroutput">true</code>
+ the type <code class="computeroutput">Num</code> must have
+ defined:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ comparison operators for: <code class="computeroutput"><</code>,
+ <code class="computeroutput"><=</code>, <code class="computeroutput">==</code>,
+ <code class="computeroutput">!=</code>, <code class="computeroutput">></code>,
+ and <code class="computeroutput">>=</code>
+</li>
+<li class="listitem">
+ numeric operators for: <code class="computeroutput">+</code>,
+ <code class="computeroutput">-</code>, <code class="computeroutput">/</code>,
+ <code class="computeroutput">*</code>, <code class="computeroutput">%</code>,
+ and unary <code class="computeroutput">-</code>
+</li>
+</ul></div>
+
+ If <code class="computeroutput">boost::is_integral<Num>::value</code> is <code class="computeroutput">false</code>
+ the type <code class="computeroutput">Num</code> must have
+ defined:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ comparison operators for: <code class="computeroutput"><</code>,
+ <code class="computeroutput"><=</code>, <code class="computeroutput">==</code>,
+ <code class="computeroutput">!=</code>, <code class="computeroutput">></code>,
+ and <code class="computeroutput">>=</code>
+</li>
+<li class="listitem">
+ numeric operators for: <code class="computeroutput">+</code>,
+ <code class="computeroutput">-</code>, <code class="computeroutput">/</code>,
+ <code class="computeroutput">*</code>, <code class="computeroutput">%</code>,
+ and unary <code class="computeroutput">-</code>
+</li>
+<li class="listitem">
+ helper functions implementing the interface and the semantics of:
+ <code class="computeroutput">std::fmod</code>, <code class="computeroutput">std::fabs</code>,
+ <code class="computeroutput">std::pow</code>, <code class="computeroutput">std::lround</code>,
+ <code class="computeroutput">std::ltrunc</code>, <code class="computeroutput">std::floor</code>,
+ and <code class="computeroutput">std::ceil</code>. These need to be defined in
+ a way so that they will be found using argument dependent lookup (ADL).
+ </li>
+</ul></div>
+<a name="spirit.karma.reference.numeric.signed_int.attributes"></a><h6>
+<a name="id769134"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">short_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">short</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">short_(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">short</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">num</code> and
+ succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">int_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">int</code>, attribute is
+ mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">int_(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">int</code>, attribute is
+ optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">num</code> and
+ succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">num</code> and
+ succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_long</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long long</code>,
+ attribute is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_long(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long long</code>,
+ attribute is optional, if it is supplied, the generator compares
+ the attribute with <code class="computeroutput">num</code>
+ and succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int_generator<
+ Num, Radix, force_sign
+>()</pre>
+
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">int_generator<
+ Num, Radix, force_sign
+>()(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">num</code> and
+ succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.numeric.signed_int.complexity"></a><h6>
+<a name="id769690"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where <code class="computeroutput">N</code> is
+ the number of digits needed to represent the generated integer number
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.numeric.signed_int.example"></a><h6>
+<a name="id771178"></a>
+ <a class="link" href="signed_int.html#spirit.karma.reference.numeric.signed_int.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::int_;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of an <code class="computeroutput">int_</code>
+ generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator("-2", lit(-2));
+test_generator("-2", int_(-2));
+test_generator_attr("-2", int_(-2), -2);
+test_generator_attr("", int_(-2), 3); // fails (as -2 != 3)!
+test_generator_attr("-2", int_, -2);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unsigned_int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="real_number.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/unsigned_int.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/numeric/unsigned_int.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,875 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Unsigned Integer Number Generators (uint_, etc.)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../numeric.html" title="Numeric">
+<link rel="prev" href="../numeric.html" title="Numeric">
+<link rel="next" href="signed_int.html" title="Signed Integer Number Generators (int_, etc.)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../numeric.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="signed_int.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Unsigned Integer Number Generators (uint_, etc.)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.numeric.unsigned_int"></a><a class="link" href="unsigned_int.html" title="Unsigned Integer Number Generators (uint_, etc.)"> Unsigned
+ Integer Number Generators (<code class="computeroutput">uint_</code>,
+ etc.)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.numeric.unsigned_int.description"></a><h6>
+<a name="id761536"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">uint_generator</code> class
+ is the simplest among the members of the numerics package. The <code class="computeroutput">uint_generator</code> can generate unsigned
+ integers of arbitrary length and size. The <code class="computeroutput">uint_generator</code>
+ generator can be used to generate ordinary primitive C/C++ integers or
+ even user defined scalars such as bigints (unlimited precision integers)
+ as long as the type follows certain expression requirements (for more
+ information about the requirements, see <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.additional_requirements">below</a>)).
+ The <code class="computeroutput">uint_generator</code> is
+ a template class. Template parameters fine tune its behavior.
+ 
+<div class="note" title="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">
+ <code class="computeroutput">lit</code> is reused by the
+ <a class="link" href="../string.html" title="String">String Generators</a>,
+ the <a class="link" href="../char.html" title="Char">Character Generators</a>,
+ and the Numeric Generators. In general, a char generator is created
+ when you pass in a character, a string generator is created when you
+ pass in a string, and a numeric generator is created when you use a
+ numeric literal.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.numeric.unsigned_int.header"></a><h6>
+<a name="id761610"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/numeric/uint.hpp>
+#include <boost/spirit/include/karma_uint.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.numeric.unsigned_int.namespace"></a><h6>
+<a name="id761685"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lit // alias:
+ boost::spirit::karma::lit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::bin // alias:
+ boost::spirit::karma::bin</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::oct // alias:
+ boost::spirit::karma::oct</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::hex // alias:
+ boost::spirit::karma::hex</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::ushort_ //
+ alias: boost::spirit::karma::ushort_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::ulong_ // alias:
+ boost::spirit::karma::ulong_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::uint_ // alias:
+ boost::spirit::karma::uint_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::ulong_long //
+ alias: boost::spirit::karma::ulong_long</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ The generators <code class="computeroutput">ulong_long</code>
+ and <code class="computeroutput">ulong_long(num)</code>
+ are only available on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code> is defined (i.e.
+ on platforms having native support for <code class="computeroutput">unsigned
+ long long</code>
+ (64 bit) unsigned integer types).
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.numeric.unsigned_int.synopsis"></a><h6>
+<a name="id762086"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting">template <
+ typename Num
+ , unsigned Radix>
+struct uint_generator;
+</pre>
+<a name="spirit.karma.reference.numeric.unsigned_int.template_parameters"></a><h6>
+<a name="id762155"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.template_parameters">Template
+ parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Parameter
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+<th>
+ 
+ Default
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Num</code>
+ 
+ </td>
+<td>
+ 
+ The numeric base type of the numeric generator.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Radix</code>
+ 
+ </td>
+<td>
+ 
+ The radix base. This can be either 2: binary, 8: octal, 10: decimal
+ and 16: hexadecimal.
+ 
+ </td>
+<td>
+ 
+ 10
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.numeric.unsigned_int.model_of"></a><h6>
+<a name="id762282"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">num</code></dt>
+<dd>
+ Numeric literal, any unsigned integer value, or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to an unsigned integer value of type
+ <code class="computeroutput">Num</code>
+ </dd>
+<dt><code class="computeroutput">Num</code></dt>
+<dd>
+ Type of <code class="computeroutput">num</code>: any
+ unsigned integer type, or in case of a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a>, its return value
+ </dd>
+<dt><code class="computeroutput">Radix</code></dt>
+<dd>
+ A integer literal specifying the required radix for the output conversion.
+ Valid values are <code class="computeroutput">2</code>,
+ <code class="computeroutput">8</code>, <code class="computeroutput">10</code>,
+ and <code class="computeroutput">16</code>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.numeric.unsigned_int.expression_semantics"></a><h6>
+<a name="id762434"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(num)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the integer literal <code class="computeroutput">num</code>
+ using the default formatting (radix is 10, sign is only printed
+ for negative literals). This generator never fails (except if
+ the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">ushort
+uint
+ulong
+ulong_long</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the unsigned integer provided by a mandatory attribute
+ using the default formatting (radix is 10). This generator never
+ fails (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">ushort(num)
+uint(num)
+ulong(num)
+ulong_long(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the unsigned integer provided by the immediate literal
+ value the generator is initialized from using the default formatting
+ (radix is 10). If this generator has an associated attribute
+ it succeeds only as long as the attribute is equal to the immediate
+ literal (except if the underlying output stream reports an error).
+ Otherwise this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">bin
+oct
+hex</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the unsigned integer provided by a mandatory attribute
+ using the default formatting and the corresponding radix (<code class="computeroutput">bin</code>: radix is 2, <code class="computeroutput">oct</code>: radix is 8, <code class="computeroutput">hex</code>: radix is 16). This generator
+ never fails (except if the underlying output stream reports an
+ error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">bin(num)
+oct(num)
+hex(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the unsigned integer provided by the immediate literal
+ value the generator is initialized from using the default formatting
+ and the corresponding radix (<code class="computeroutput">bin</code>:
+ radix is 2, <code class="computeroutput">oct</code>:
+ radix is 8, <code class="computeroutput">hex</code>:
+ radix is 16). If this generator has an associated attribute it
+ succeeds only as long as the attribute is equal to the immediate
+ literal (except if the underlying output stream reports an error).
+ Otherwise this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ All generators listed in the table above (except <code class="computeroutput">lit(num)</code>) are predefined specializations of the
+ <code class="computeroutput">uint_generator<Num, Radix></code>
+ basic unsigned integer number generator type described below. It is possible
+ to directly use this type to create unsigned integer generators using
+ a wide range of formatting options.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">uint_generator<
+ Num, Radix
+>()</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the unsigned integer of type <code class="computeroutput">Num</code>
+ provided by a mandatory attribute using the specified <code class="computeroutput">Radix</code> (possible values are
+ <code class="computeroutput">2</code>, <code class="computeroutput">8</code>, <code class="computeroutput">10</code>,
+ and <code class="computeroutput">16</code>, the default
+ value is <code class="computeroutput">10</code>).This
+ generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">uint_generator<
+ Num, Radix
+>()(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ Generate the unsigned integer of type <code class="computeroutput">Num</code>
+ provided by the immediate literal value the generator is initialized
+ from, using the specified <code class="computeroutput">Radix</code>
+ (possible values are <code class="computeroutput">2</code>,
+ <code class="computeroutput">8</code>, <code class="computeroutput">10</code>, and <code class="computeroutput">16</code>,
+ the default value is <code class="computeroutput">10</code>).
+ If this generator has an associated attribute it succeeds only
+ as long as the attribute is equal to the immediate literal (except
+ if the underlying output stream reports an error). Otherwise
+ this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.numeric.unsigned_int.additional_requirements"></a><h6>
+<a name="id763085"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.additional_requirements">Additional
+ Requirements</a>
+ </h6>
+
+ The following lists enumerate the requirements which must be met in order
+ to use a certain type <code class="computeroutput">Num</code>
+ to instantiate and use a <code class="computeroutput">uint_generator<Num, Radix></code>.
+ 
+
+ If <code class="computeroutput">boost::is_integral<Num>::value</code> is <code class="computeroutput">true</code>
+ the type <code class="computeroutput">Num</code> must have
+ defined:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ comparison operators for: <code class="computeroutput"><</code>,
+ <code class="computeroutput"><=</code>, <code class="computeroutput">==</code>,
+ <code class="computeroutput">!=</code>, <code class="computeroutput">></code>,
+ and <code class="computeroutput">>=</code>
+</li>
+<li class="listitem">
+ numeric operators for: <code class="computeroutput">+</code>,
+ <code class="computeroutput">-</code>, <code class="computeroutput">/</code>,
+ <code class="computeroutput">*</code>, and <code class="computeroutput">%</code>
+</li>
+</ul></div>
+
+ If <code class="computeroutput">boost::is_integral<Num>::value</code> is <code class="computeroutput">false</code>
+ the type <code class="computeroutput">Num</code> must have
+ defined:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ comparison operators for: <code class="computeroutput"><</code>,
+ <code class="computeroutput"><=</code>, <code class="computeroutput">==</code>,
+ <code class="computeroutput">!=</code>, <code class="computeroutput">></code>,
+ and <code class="computeroutput">>=</code>
+</li>
+<li class="listitem">
+ numeric operators for: <code class="computeroutput">+</code>,
+ <code class="computeroutput">-</code>, <code class="computeroutput">/</code>,
+ <code class="computeroutput">*</code>, and <code class="computeroutput">%</code>
+</li>
+<li class="listitem">
+ helper functions implementing the interface and the semantics of:
+ <code class="computeroutput">std::fmod</code>, <code class="computeroutput">std::pow</code>,
+ <code class="computeroutput">std::lround</code>, <code class="computeroutput">std::ltrunc</code>,
+ <code class="computeroutput">std::floor</code>, and <code class="computeroutput">std::ceil</code>.
+ These need to be defined in a way so that they will be found using
+ argument dependent lookup (ADL).
+ </li>
+</ul></div>
+<a name="spirit.karma.reference.numeric.unsigned_int.attributes"></a><h6>
+<a name="id763499"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ushort</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned short</code>,
+ attribute is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ushort(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned short</code>,
+ attribute is optional, if it is supplied, the generator compares
+ the attribute with <code class="computeroutput">num</code>
+ and succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">uint</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>,
+ attribute is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">uint(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>,
+ attribute is optional, if it is supplied, the generator compares
+ the attribute with <code class="computeroutput">num</code>
+ and succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ulong</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long</code>,
+ attribute is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ulong(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long</code>,
+ attribute is optional, if it is supplied, the generator compares
+ the attribute with <code class="computeroutput">num</code>
+ and succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ulong_long</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long
+ long</code>, attribute is mandatory
+ (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ulong_long(num)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long
+ long</code>, attribute is optional,
+ if it is supplied, the generator compares the attribute with
+ <code class="computeroutput">num</code> and succeeds
+ only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">bin
+oct
+hex</pre>
+
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>,
+ attribute is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">bin(num)
+oct(num)
+hex(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>,
+ attribute is optional, if it is supplied, the generator compares
+ the attribute with <code class="computeroutput">num</code>
+ and succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">uint_generator<
+ Num, Radix
+>()</pre>
+
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">uint_generator<
+ Num, Radix
+>()(num)</pre>
+
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Num</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">num</code> and
+ succeeds only if both are equal, failing otherwise.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.numeric.unsigned_int.complexity"></a><h6>
+<a name="id765878"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where <code class="computeroutput">N</code> is
+ the number of digits needed to represent the generated integer number
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.numeric.unsigned_int.example"></a><h6>
+<a name="id765910"></a>
+ <a class="link" href="unsigned_int.html#spirit.karma.reference.numeric.unsigned_int.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::uint;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of an <code class="computeroutput">uint</code>
+ generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator("2", lit(2U));
+test_generator("2", uint(2));
+test_generator_attr("2", uint(2), 2);
+test_generator_attr("", uint(2), 3); // fails (as 2 != 3)!
+test_generator_attr("2", uint, 2);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../numeric.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="signed_int.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/operator.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/operator.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,84 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Operator</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="directive/omit.html" title="Consume Attribute (omit[])">
+<link rel="next" href="operator/sequence.html" title="Sequences (a << b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="directive/omit.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="operator/sequence.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Operator">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.operator"></a><a class="link" href="operator.html" title="Operator">Operator</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="operator/sequence.html"> Sequences
+ (<code class="computeroutput">a <<
+ b</code>)</a></dt>
+<dt><a href="operator/alternative.html"> Alternative
+ (<code class="computeroutput">a |
+ b</code>)</a></dt>
+<dt><a href="operator/kleene.html"> Kleene Star
+ (<code class="computeroutput">*a</code>)</a></dt>
+<dt> Plus (+a)</dt>
+<dt> Lists (a % b)</dt>
+<dt><a href="operator/optional.html"> Optional
+ (<code class="computeroutput">-a</code>)</a></dt>
+<dt><a href="operator/and_predicate.html"> And
+ Predicate (<code class="computeroutput">&a</code>)</a></dt>
+<dt><a href="operator/not_predicate.html"> Not
+ Predicate (<code class="computeroutput">!a</code>)</a></dt>
+</dl></div>
+
+ This module includes different generators which get instantiated if one
+ of the overloaded operators is used with more primitive generator constructs.
+ It includes sequences (<code class="computeroutput">a << b</code>),
+ alternatives (<code class="computeroutput">a |
+ b</code>), Kleene star (unary <code class="computeroutput">*</code>), plus (unary <code class="computeroutput">+</code>),
+ optional (unary <code class="computeroutput">-</code>), lists
+ (<code class="computeroutput">a %
+ b</code>), and the two predicates, the
+ and predicate (unary <code class="computeroutput">&</code>)
+ and the not predicate (unary <code class="computeroutput">!</code>).
+ 
+<a name="spirit.karma.reference.operator.module_header"></a><h6>
+<a name="id827399"></a>
+ <a class="link" href="operator.html#spirit.karma.reference.operator.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator.hpp>
+#include <boost/spirit/include/karma_operator.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="directive/omit.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="operator/sequence.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/alternative.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/alternative.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,313 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Alternative (a | b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="sequence.html" title="Sequences (a << b)">
+<link rel="next" href="kleene.html" title="Kleene Star (*a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="sequence.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="kleene.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Alternative (a | b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.operator.alternative"></a><a class="link" href="alternative.html" title="Alternative (a | b)"> Alternative
+ (<code class="computeroutput">a |
+ b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.operator.alternative.description"></a><h6>
+<a name="id829762"></a>
+ <a class="link" href="alternative.html#spirit.karma.reference.operator.alternative.description">Description</a>
+ </h6>
+
+ Generator alternatives are used to combine different, more primitive
+ generators into alternatives. All generators in an alternative are invoked
+ from left to right until one of them succeeds.
+ 
+<a name="spirit.karma.reference.operator.alternative.header"></a><h6>
+<a name="id829779"></a>
+ <a class="link" href="alternative.html#spirit.karma.reference.operator.alternative.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator/alternative.hpp>
+#include <boost/spirit/include/karma_alternative.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.operator.alternative.model_of"></a><h6>
+<a name="id829853"></a>
+ <a class="link" href="alternative.html#spirit.karma.reference.operator.alternative.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/narygenerator.html" title="NaryGenerator"><code class="computeroutput">NaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.alternative.expression_semantics"></a><h6>
+<a name="id829887"></a>
+ <a class="link" href="alternative.html#spirit.karma.reference.operator.alternative.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/narygenerator.html" title="NaryGenerator"><code class="computeroutput">NaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a |
+ b</code>
+ 
+ </td>
+<td>
+ 
+ The generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">b</code> are executed
+ sequentially from left to right and until one of them succeeds.
+ A failed generator forces the alternative generator to try the
+ next one. The alternative fails as a whole only if all elements
+ of the alternative fail. Each element of the alternative gets
+ passed the whole attribute of the alternative.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ Alternatives intercept and buffer the output of the currently executed
+ element. This allows to avoid partial outputs from failing elements as
+ the buffered content will be forwarded to the actual output only after
+ an element succeeded.
+ 
+<a name="spirit.karma.reference.operator.alternative.attributes"></a><h6>
+<a name="id829999"></a>
+ <a class="link" href="alternative.html#spirit.karma.reference.operator.alternative.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a |
+ b</code> (alternative)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a | b): variant<A, B>
+a: A, b: Unused --> (a | b): A
+a: Unused, b: B --> (a | b): B
+a: Unused, b: Unused --> (a | b): Unused
+a: A, b: A --> (a | b): A</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The table above uses <code class="computeroutput">variant<A, B></code> as a placeholder only. The notation
+ <code class="computeroutput">variant<A, B></code>
+ stands for the type <code class="computeroutput">boost::variant<A, B></code>.
+ </td></tr>
+</table></div>
+
+ Alternatives are special in terms of attribute handling as their behavior
+ is not completely compile time defined. First of all the selected alternative
+ element depends on the actual type of the attribute supplied to the alternative
+ generator (i.e. what is stored in the variant). The attribute type supplied
+ at runtime narrows the set of considered alternatives
+ to those being compatible attribute wise. The remaining alternatives
+ are tried sequentially until the first of them succeeds. See below for
+ an example of this behavior.
+ 
+<a name="spirit.karma.reference.operator.alternative.complexity"></a><h6>
+<a name="id830518"></a>
+ <a class="link" href="alternative.html#spirit.karma.reference.operator.alternative.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the alternative generator is defined by
+ the sum of the complexities of its elements. The complexity of the
+ alternative itself is O(N), where N is the number of elements in
+ the alternative.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.alternative.example"></a><h6>
+<a name="id830542"></a>
+ <a class="link" href="alternative.html#spirit.karma.reference.operator.alternative.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::ascii::string;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of an alternative. While being only the second alternative,
+ the <code class="computeroutput">double_</code> generator
+ is chosen for output formatting because the supplied attribute type is
+ not compatible (i.e. not convertible) to the attribute type of the <code class="computeroutput">string</code> alternative.
+ 
+
+ 
+
+
+
+<pre class="programlisting">boost::variant<std::string, double> v1(1.0);
+test_generator_attr("1.0", string | double_, v1);
+test_generator_attr("2.0", string | double_, 2.0);
+</pre>
+
+ 
+
+ 
+
+ The same formatting rules may be used to output a string. This time we
+ supply the string <code class="computeroutput">"example"</code>,
+ resulting in the first alternative to be chosen for the generated output.
+ 
+
+ 
+
+
+
+<pre class="programlisting">boost::variant<std::string, double> v2("example");
+test_generator_attr("example", string | double_, v2);
+test_generator_attr("example", string | double_, "example");
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="sequence.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="kleene.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/and_predicate.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/and_predicate.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,275 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>And Predicate (&a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="optional.html" title="Optional (-a)">
+<link rel="next" href="not_predicate.html" title="Not Predicate (!a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="optional.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="not_predicate.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="And Predicate (&a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.operator.and_predicate"></a><a class="link" href="and_predicate.html" title="And Predicate (&a)"> And
+ Predicate (<code class="computeroutput">&a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.operator.and_predicate.description"></a><h6>
+<a name="id841695"></a>
+ <a class="link" href="and_predicate.html#spirit.karma.reference.operator.and_predicate.description">Description</a>
+ </h6>
+
+ The and predicate generator is used to test, whether the embedded generator
+ succeeds without generating any output. It succeeds if the embedded generator
+ succeeds.
+ 
+<a name="spirit.karma.reference.operator.and_predicate.header"></a><h6>
+<a name="id841714"></a>
+ <a class="link" href="and_predicate.html#spirit.karma.reference.operator.and_predicate.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator/and_predicate.hpp>
+#include <boost/spirit/include/karma_and_predicate.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.operator.and_predicate.model_of"></a><h6>
+<a name="id841788"></a>
+ <a class="link" href="and_predicate.html#spirit.karma.reference.operator.and_predicate.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.and_predicate.expression_semantics"></a><h6>
+<a name="id841824"></a>
+ <a class="link" href="and_predicate.html#spirit.karma.reference.operator.and_predicate.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">&a</code>
+ 
+ </td>
+<td>
+ 
+ The generator <code class="computeroutput">a</code>
+ is executed for the sole purpose of testing whether it succeeds.
+ The and predicate generator succeeds as long as its embedded
+ generator succeeds (except if the underlying output stream reports
+ an error). The and predicate never produces any output.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ The and generator is implemented by redirecting all output produced by
+ its embedded generator into a discarding device.
+ 
+<a name="spirit.karma.reference.operator.and_predicate.attributes"></a><h6>
+<a name="id841928"></a>
+ <a class="link" href="and_predicate.html#spirit.karma.reference.operator.and_predicate.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">&a</code>
+ (and predicate, unary <code class="computeroutput">&</code>)
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">a:
+ A -->
+ &a: A</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="note" title="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">
+ The attribute of the and predicate is not always <code class="computeroutput">Unused</code>,
+ which is different from Qi's and predicate. This is necessary as the
+ generator the and predicate is attached to most of the time needs an
+ attribute.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.operator.and_predicate.complexity"></a><h6>
+<a name="id842076"></a>
+ <a class="link" href="and_predicate.html#spirit.karma.reference.operator.and_predicate.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the and predicate generator is defined
+ by the complexity of its embedded generator. The complexity of the
+ and predicate generator itself is O(1).
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.and_predicate.example"></a><h6>
+<a name="id842103"></a>
+ <a class="link" href="and_predicate.html#spirit.karma.reference.operator.and_predicate.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::ascii::char_;
+using boost::spirit::karma::ascii::string;
+using boost::phoenix::ref;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of an and predicate generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator_attr("b", &char_('a') << 'b' | 'c', 'a');
+test_generator_attr("c", &char_('a') << 'b' | 'c', 'x');
+
+test_generator_attr("abc", &string("123") << "abc" | "def", "123");
+test_generator_attr("def", &string("123") << "abc" | "def", "456");
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="optional.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="not_predicate.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/kleene.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/kleene.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,323 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Kleene Star (*a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="alternative.html" title="Alternative (a | b)">
+<link rel="next" href="plus.html" title="Plus (+a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="alternative.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="plus.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Kleene Star (*a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.operator.kleene"></a><a class="link" href="kleene.html" title="Kleene Star (*a)"> Kleene Star
+ (<code class="computeroutput">*a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.operator.kleene.description"></a><h6>
+<a name="id832978"></a>
+ <a class="link" href="kleene.html#spirit.karma.reference.operator.kleene.description">Description</a>
+ </h6>
+
+ Kleene star generators are used to repeat the execution of an embedded
+ generator zero or more times. Regardless of the success of the embedded
+ generator, the Kleene star generator always succeeds.
+ 
+<a name="spirit.karma.reference.operator.kleene.header"></a><h6>
+<a name="id832994"></a>
+ <a class="link" href="kleene.html#spirit.karma.reference.operator.kleene.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator/kleene.hpp>
+#include <boost/spirit/include/karma_kleene.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.operator.kleene.model_of"></a><h6>
+<a name="id833069"></a>
+ <a class="link" href="kleene.html#spirit.karma.reference.operator.kleene.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.kleene.expression_semantics"></a><h6>
+<a name="id833107"></a>
+ <a class="link" href="kleene.html#spirit.karma.reference.operator.kleene.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">*a</code>
+ 
+ </td>
+<td>
+ 
+ The generator <code class="computeroutput">a</code>
+ is executed zero or more times depending on the availability
+ of an attribute. The execution of <code class="computeroutput">a</code>
+ stops after the attribute values passed to the Kleene star generator
+ are exhausted. The Kleene star always succeeds (except if the
+ underlying output stream reports an error).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.operator.kleene.attributes"></a><h6>
+<a name="id833214"></a>
+ <a class="link" href="kleene.html#spirit.karma.reference.operator.kleene.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">*a</code>
+ (Kleene star, unary <code class="computeroutput">*</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> *a: vector<A>
+a: Unused --> *a: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The table above uses <code class="computeroutput">vector<A></code> as a placeholder only. The notation
+ of <code class="computeroutput">vector<A></code>
+ stands for any STL container holding elements
+ of type <code class="computeroutput">A</code>.
+ </td></tr>
+</table></div>
+
+ The Kleene star generator will execute its embedded generator once for
+ each element in the provided container attribute and as long as the embedded
+ generator succeeds. On each iteration it will pass the next consecutive
+ element from the container attribute to the embedded generator. Therefor
+ the number of iterations will not be larger than the number of elements
+ in the container passed as its attribute. An empty container will make
+ the Kleene star to not generate any output at all.
+ 
+
+ It is important to note, that the Kleene star does not perform any buffering
+ of the output generated by its embedded elements. That means that any
+ failing element generator might have already generated some output, which
+ is not rolled back.
+ 
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ The simplest way to force a Kleene star to behave as if it did buffering
+ is to wrap it into a buffering directive (see <a class="link" href="../directive/buffer.html" title="Temporary Output Buffering (buffer[])"><code class="computeroutput">buffer[a]</code></a>):
+ 
+
+
+
+<pre class="programlisting">buffer[*a]</pre>
+
+ 
+
+ which will not generate any output in case of
+ a failing generator <code class="computeroutput">a</code>.
+ The expression:
+ 
+
+
+
+<pre class="programlisting">*(buffer[a])</pre>
+
+ 
+
+ will not generate any partial output from a generator <code class="computeroutput">a</code> if it fails generating in the middle
+ of its output. The overall expression will still generate the output
+ as produced by all succeeded invocations of the generator <code class="computeroutput">a</code>.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.operator.kleene.complexity"></a><h6>
+<a name="id833561"></a>
+ <a class="link" href="kleene.html#spirit.karma.reference.operator.kleene.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the Kleene star generator is defined by
+ the complexity of its embedded generator multiplied by the number
+ of executed iterations. The complexity of the Kleene star itself
+ is O(N), where N is the number of elements in the container passed
+ as its attribute.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.kleene.example"></a><h6>
+<a name="id833585"></a>
+ <a class="link" href="kleene.html#spirit.karma.reference.operator.kleene.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::space;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of a Kleene star generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<double> v;
+v.push_back(1.0);
+v.push_back(2.0);
+v.push_back(3.0);
+test_generator_attr("1.0 2.0 3.0 ", *double_, space, v);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="alternative.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="plus.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/list.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/list.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,344 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lists (a % b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="plus.html" title="Plus (+a)">
+<link rel="next" href="optional.html" title="Optional (-a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="plus.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="optional.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lists (a % b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.operator.list"></a><a class="link" href="list.html" title="Lists (a % b)"> Lists (<code class="computeroutput">a % b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.operator.list.description"></a><h6>
+<a name="id836699"></a>
+ <a class="link" href="list.html#spirit.karma.reference.operator.list.description">Description</a>
+ </h6>
+
+ The list generator is used to repeat the execution of an embedded generator
+ and interspace it with the output of anyother generator one or more times.
+ It succeeds if the embedded generator has been successfully executed
+ at least once.
+ 
+<a name="spirit.karma.reference.operator.list.header"></a><h6>
+<a name="id836716"></a>
+ <a class="link" href="list.html#spirit.karma.reference.operator.list.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator/list.hpp>
+#include <boost/spirit/include/karma_list.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.operator.list.model_of"></a><h6>
+<a name="id836790"></a>
+ <a class="link" href="list.html#spirit.karma.reference.operator.list.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/binarygenerator.html" title="BinaryGenerator"><code class="computeroutput">BinaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.list.expression_semantics"></a><h6>
+<a name="id836829"></a>
+ <a class="link" href="list.html#spirit.karma.reference.operator.list.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/binarygenerator.html" title="BinaryGenerator"><code class="computeroutput">BinaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a %
+ b</code>
+ 
+ </td>
+<td>
+ 
+ The generator <code class="computeroutput">a</code>
+ is executed one or more times depending on the availability of
+ an attribute. The output generated by <code class="computeroutput">a</code>
+ is interspaced with the output generated by <code class="computeroutput">b</code>.
+ The list generator succeeds as long as both its first embedded
+ generator has been successfully executed at least once (except
+ if the underlying output stream reports an error).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ The list expression <code class="computeroutput">a % b</code>
+ is a shortcut for <code class="computeroutput">a << *(b <<
+ a)</code>.
+ It is almost semantically equivalent, except for the attribute of <code class="computeroutput">b</code>, which gets ignored in the case of
+ the list generator.
+ 
+<a name="spirit.karma.reference.operator.list.attributes"></a><h6>
+<a name="id837010"></a>
+ <a class="link" href="list.html#spirit.karma.reference.operator.list.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a %
+ b</code> (list)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a % b): vector<A>
+a: Unused, b: B --> (a % b): Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The table above uses <code class="computeroutput">vector<A></code> as a placeholder only. The notation
+ of <code class="computeroutput">vector<A></code>
+ stands for any STL container holding elements
+ of type <code class="computeroutput">A</code>.
+ </td></tr>
+</table></div>
+
+ The list generator will execute its embedded generator once for each
+ element in the provided container attribute and as long as the embedded
+ generator succeeds. The output generated by its first generator will
+ be interspaced by the output generated by the second generator. On each
+ iteration it will pass the next consecutive element from the container
+ attribute to the first embedded generator. The second embedded generator
+ does not get passed any attributes (it gets invoked using an <code class="computeroutput">unused_type</code> as its attribute). Therefor
+ the number of iterations will not be larger than the number of elements
+ in the container passed as its attribute. An empty container will make
+ the list generator fail.
+ 
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ If you want to use the list generator and still allow for an empty
+ attribute, you can use the optional operator (see <a class="link" href="optional.html" title="Optional (-a)">optional
+ (unary <code class="computeroutput">-</code>)</a>):
+ 
+
+
+
+<pre class="programlisting">-(a % b)</pre>
+
+ 
+
+ which will succeed even if the provided container attribute does not
+ contain any elements.
+ 
+</td></tr>
+</table></div>
+
+ It is important to note, that the list generator does not perform any
+ buffering of the output generated by its embedded elements. That means
+ that any failing element generator might have already generated some
+ output, which is not rolled back.
+ 
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ The simplest way to force a list generator to behave as if it did buffering
+ is to wrap it into a buffering directive (see <a class="link" href="../directive/buffer.html" title="Temporary Output Buffering (buffer[])"><code class="computeroutput">buffer[a]</code></a>):
+ 
+
+
+
+<pre class="programlisting">buffer[a % b]</pre>
+
+ 
+
+ which will not generate any output in case of
+ a failing generator <code class="computeroutput">a</code>.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.operator.list.complexity"></a><h6>
+<a name="id838561"></a>
+ <a class="link" href="list.html#spirit.karma.reference.operator.list.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the list generator is defined by the complexity
+ of its embedded generators multiplied by the number of executed iterations.
+ The complexity of the list generator itself is O(N), where N is the
+ number of elements in the container passed as its attribute.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.list.example"></a><h6>
+<a name="id838585"></a>
+ <a class="link" href="list.html#spirit.karma.reference.operator.list.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of a list generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<double> v1;
+v1.push_back(1.0);
+test_generator_attr("1.0", double_ % ',', v1);
+
+v1.push_back(2.0);
+test_generator_attr("1.0,2.0", double_ % ',', v1);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="plus.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="optional.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/not_predicate.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/not_predicate.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,275 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Not Predicate (!a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="and_predicate.html" title="And Predicate (&a)">
+<link rel="next" href="../../performance_measurements.html" title="Performance Measurements">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="and_predicate.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../performance_measurements.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Not Predicate (!a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.operator.not_predicate"></a><a class="link" href="not_predicate.html" title="Not Predicate (!a)"> Not
+ Predicate (<code class="computeroutput">!a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.operator.not_predicate.description"></a><h6>
+<a name="id843177"></a>
+ <a class="link" href="not_predicate.html#spirit.karma.reference.operator.not_predicate.description">Description</a>
+ </h6>
+
+ The not predicate generator is used to test, whether the embedded generator
+ fails, without generating any output. It succeeds if the embedded generator
+ fails.
+ 
+<a name="spirit.karma.reference.operator.not_predicate.header"></a><h6>
+<a name="id843196"></a>
+ <a class="link" href="not_predicate.html#spirit.karma.reference.operator.not_predicate.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator/not_predicate.hpp>
+#include <boost/spirit/include/karma_not_predicate.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.operator.not_predicate.model_of"></a><h6>
+<a name="id843270"></a>
+ <a class="link" href="not_predicate.html#spirit.karma.reference.operator.not_predicate.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.not_predicate.expression_semantics"></a><h6>
+<a name="id843306"></a>
+ <a class="link" href="not_predicate.html#spirit.karma.reference.operator.not_predicate.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">!a</code>
+ 
+ </td>
+<td>
+ 
+ The generator <code class="computeroutput">a</code>
+ is executed for the sole purpose of testing whether it succeeds.
+ The not predicate generator succeeds as long as its embedded
+ generator fails (except if the underlying output stream reports
+ an error). The not predicate never produces any output.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ The not generator is implemented by redirecting all output produced by
+ its embedded generator into a discarding device.
+ 
+<a name="spirit.karma.reference.operator.not_predicate.attributes"></a><h6>
+<a name="id843410"></a>
+ <a class="link" href="not_predicate.html#spirit.karma.reference.operator.not_predicate.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">!a</code>
+ (not predicate, unary <code class="computeroutput">!</code>)
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">a:
+ A -->
+ !a: A</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="note" title="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">
+ The attribute of the and predicate is not always <code class="computeroutput">Unused</code>,
+ which is different from Qi's and predicate. This is necessary as the
+ generator the and predicate is attached to most of the time needs an
+ attribute.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.operator.not_predicate.complexity"></a><h6>
+<a name="id843559"></a>
+ <a class="link" href="not_predicate.html#spirit.karma.reference.operator.not_predicate.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the not predicate generator is defined
+ by the complexity of its embedded generator. The complexity of the
+ not predicate generator itself is O(1).
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.not_predicate.example"></a><h6>
+<a name="id843585"></a>
+ <a class="link" href="not_predicate.html#spirit.karma.reference.operator.not_predicate.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::ascii::char_;
+using boost::spirit::karma::ascii::string;
+using boost::phoenix::ref;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of a not predicate generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator_attr("c", !char_('a') << 'b' | 'c', 'a');
+test_generator_attr("b", !char_('a') << 'b' | 'c', 'x');
+
+test_generator_attr("def", !string("123") << "abc" | "def", "123");
+test_generator_attr("abc", !string("123") << "abc" | "def", "456");
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="and_predicate.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../performance_measurements.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/optional.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/optional.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,313 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Optional (-a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="list.html" title="Lists (a % b)">
+<link rel="next" href="and_predicate.html" title="And Predicate (&a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="list.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="and_predicate.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Optional (-a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.operator.optional"></a><a class="link" href="optional.html" title="Optional (-a)"> Optional
+ (<code class="computeroutput">-a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.operator.optional.description"></a><h6>
+<a name="id839486"></a>
+ <a class="link" href="optional.html#spirit.karma.reference.operator.optional.description">Description</a>
+ </h6>
+
+ The optional generator is used to conditionally execute an embedded generator.
+ It succeeds always.
+ 
+<a name="spirit.karma.reference.operator.optional.header"></a><h6>
+<a name="id839503"></a>
+ <a class="link" href="optional.html#spirit.karma.reference.operator.optional.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator/optional.hpp>
+#include <boost/spirit/include/karma_optional.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.operator.optional.model_of"></a><h6>
+<a name="id839577"></a>
+ <a class="link" href="optional.html#spirit.karma.reference.operator.optional.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.optional.expression_semantics"></a><h6>
+<a name="id839616"></a>
+ <a class="link" href="optional.html#spirit.karma.reference.operator.optional.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">-a</code>
+ 
+ </td>
+<td>
+ 
+ The generator <code class="computeroutput">a</code>
+ is executed depending on the availability of an attribute. The
+ optional generator succeeds as long as its embedded generator
+ succeeds (except if the underlying output stream reports an error).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.operator.optional.attributes"></a><h6>
+<a name="id839715"></a>
+ <a class="link" href="optional.html#spirit.karma.reference.operator.optional.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">-a</code>
+ (optional, unary <code class="computeroutput">-</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> -a: optional<A>
+a: Unused --> -a: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The table above uses <code class="computeroutput">optional<A></code> as a placeholder only. The notation
+ of <code class="computeroutput">optional<A></code>
+ stands for the data type <code class="computeroutput">boost::optional<A></code>.
+ </td></tr>
+</table></div>
+
+ The optional generator will execute its embedded generator once if the
+ provided attribute holds a valid value. It forwards the value held in
+ its attribute to the embedded generator.
+ 
+
+ It is important to note, that the optional generator does not perform
+ any buffering of the output generated by its embedded elements. That
+ means that any failing element might have already generated some output,
+ which is not rolled back.
+ 
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ The simplest way to force a optional generator to behave as if it did
+ buffering is to wrap it into a buffering directive (see <a class="link" href="../directive/buffer.html" title="Temporary Output Buffering (buffer[])"><code class="computeroutput">buffer[a]</code></a>):
+ 
+
+
+
+<pre class="programlisting">buffer[-a]</pre>
+
+ 
+
+ which will not generate any output in case of
+ a failing generator <code class="computeroutput">a</code>.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.operator.optional.complexity"></a><h6>
+<a name="id840033"></a>
+ <a class="link" href="optional.html#spirit.karma.reference.operator.optional.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the optional generator is defined by the
+ complexity of its embedded generator. The complexity of the optional
+ generator itself is O(1).
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.optional.example"></a><h6>
+<a name="id840057"></a>
+ <a class="link" href="optional.html#spirit.karma.reference.operator.optional.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of an optional generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">boost::optional<double> val(1.0);
+test_generator_attr("1.0", -double_, val);
+test_generator_attr("2.0", -double_, 2.0);
+</pre>
+
+ 
+
+ 
+
+ Usage and result of an empty optional generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">boost::optional<double> val; // empty optional
+test_generator_attr("", -double_, val);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="list.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="and_predicate.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/plus.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/plus.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,337 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Plus (+a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="kleene.html" title="Kleene Star (*a)">
+<link rel="next" href="list.html" title="Lists (a % b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="kleene.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="list.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Plus (+a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.operator.plus"></a><a class="link" href="plus.html" title="Plus (+a)"> Plus (<code class="computeroutput">+a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.operator.plus.description"></a><h6>
+<a name="id835072"></a>
+ <a class="link" href="plus.html#spirit.karma.reference.operator.plus.description">Description</a>
+ </h6>
+
+ The plus generator is used to repeat the execution of an embedded generator
+ one or more times. It succeeds if the embedded generator has been successfully
+ executed at least once.
+ 
+<a name="spirit.karma.reference.operator.plus.header"></a><h6>
+<a name="id835089"></a>
+ <a class="link" href="plus.html#spirit.karma.reference.operator.plus.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator/plus.hpp>
+#include <boost/spirit/include/karma_plus.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.operator.plus.model_of"></a><h6>
+<a name="id835163"></a>
+ <a class="link" href="plus.html#spirit.karma.reference.operator.plus.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.plus.expression_semantics"></a><h6>
+<a name="id835202"></a>
+ <a class="link" href="plus.html#spirit.karma.reference.operator.plus.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/unarygenerator.html" title="UnaryGenerator"><code class="computeroutput">UnaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">+a</code>
+ 
+ </td>
+<td>
+ 
+ The generator <code class="computeroutput">a</code>
+ is executed one or more times depending on the availability of
+ an attribute. The execution of <code class="computeroutput">a</code>
+ stops after the attribute values passed to the plus generator
+ are exhausted. The plus generator succeeds as long as its embedded
+ generator has been successfully executed at least once (except
+ if the underlying output stream reports an error).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.operator.plus.attributes"></a><h6>
+<a name="id835308"></a>
+ <a class="link" href="plus.html#spirit.karma.reference.operator.plus.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">+a</code>
+ (unary <code class="computeroutput">+</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> +a: vector<A>
+a: Unused --> +a: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The table above uses <code class="computeroutput">vector<A></code> as a placeholder only. The notation
+ of <code class="computeroutput">vector<A></code>
+ stands for any STL container holding elements
+ of type <code class="computeroutput">A</code>.
+ </td></tr>
+</table></div>
+
+ The plus generator will execute its embedded generator once for each
+ element in the provided container attribute and as long as the embedded
+ generator succeeds. On each iteration it will pass the next consecutive
+ element from the container attribute to the embedded generator. Therefor
+ the number of iterations will not be larger than the number of elements
+ in the container passed as its attribute. An empty container will make
+ the plus generator fail.
+ 
+
+ It is important to note, that the plus generator does not perform any
+ buffering of the output generated by its embedded elements. That means
+ that any failing element generator might have already generated some
+ output, which is not rolled back.
+ 
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ The simplest way to force a plus generator to behave as if it did buffering
+ is to wrap it into a buffering directive (see <a class="link" href="../directive/buffer.html" title="Temporary Output Buffering (buffer[])"><code class="computeroutput">buffer[a]</code></a>):
+ 
+
+
+
+<pre class="programlisting">buffer[+a]</pre>
+
+ 
+
+ which will not generate any output in case of
+ a failing generator <code class="computeroutput">a</code>.
+ The expression:
+ 
+
+
+
+<pre class="programlisting">+(buffer[a])</pre>
+
+ 
+
+ will not generate any partial output from a generator <code class="computeroutput">a</code> if it fails generating in the middle
+ of its output. The overall expression will still generate the output
+ as produced by all succeeded invocations of the generator <code class="computeroutput">a</code>.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.operator.plus.complexity"></a><h6>
+<a name="id835655"></a>
+ <a class="link" href="plus.html#spirit.karma.reference.operator.plus.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the plus generator is defined by the complexity
+ of its embedded generator multiplied by the number of executed iterations.
+ The complexity of the plus generator itself is O(N), where N is the
+ number of elements in the container passed as its attribute.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.plus.example"></a><h6>
+<a name="id835679"></a>
+ <a class="link" href="plus.html#spirit.karma.reference.operator.plus.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+using boost::spirit::karma::space;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of a plus generator:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<double> v1;
+v1.push_back(1.0);
+v1.push_back(2.0);
+v1.push_back(3.0);
+test_generator_attr("1.0 2.0 3.0 ", +double_, space, v1);
+</pre>
+
+ 
+
+ 
+
+ A more sophisticated use case showing how to leverage the fact that plus
+ is failing for empty containers passed as its attribute:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<double> v2; // empty container
+test_generator_attr("empty", +double_ | "empty", v2);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="kleene.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="list.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/sequence.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/operator/sequence.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,319 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Sequences (a << b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="../operator.html" title="Operator">
+<link rel="next" href="alternative.html" title="Alternative (a | b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../operator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="alternative.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Sequences (a << b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.operator.sequence"></a><a class="link" href="sequence.html" title="Sequences (a << b)"> Sequences
+ (<code class="computeroutput">a <<
+ b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.operator.sequence.description"></a><h6>
+<a name="id827500"></a>
+ <a class="link" href="sequence.html#spirit.karma.reference.operator.sequence.description">Description</a>
+ </h6>
+
+ Generator sequences are used to consecutively combine different, more
+ primitive generators. All generators in a sequence are invoked from left
+ to right as long as they succeed.
+ 
+<a name="spirit.karma.reference.operator.sequence.header"></a><h6>
+<a name="id827516"></a>
+ <a class="link" href="sequence.html#spirit.karma.reference.operator.sequence.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator/sequence.hpp>
+#include <boost/spirit/include/karma_sequence.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.operator.sequence.model_of"></a><h6>
+<a name="id827591"></a>
+ <a class="link" href="sequence.html#spirit.karma.reference.operator.sequence.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/narygenerator.html" title="NaryGenerator"><code class="computeroutput">NaryGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.sequence.expression_semantics"></a><h6>
+<a name="id827627"></a>
+ <a class="link" href="sequence.html#spirit.karma.reference.operator.sequence.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/narygenerator.html" title="NaryGenerator"><code class="computeroutput">NaryGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a <<
+ b</code>
+ 
+ </td>
+<td>
+ 
+ The generators <code class="computeroutput">a</code>
+ and <code class="computeroutput">b</code> are executed
+ sequentially from left to right and as long as they succeed.
+ A failed generator stops the execution of the entire sequence
+ and makes the sequence fail as well.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ It is important to note, that sequences don't perform any buffering of
+ the output generated by its elements. That means that any failing sequence
+ might have already generated some output, which is not
+ rolled back.
+ 
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ The simplest way to force a sequence to behave as if it did buffering
+ is to wrap it into a buffering directive (see <a class="link" href="../directive/buffer.html" title="Temporary Output Buffering (buffer[])"><code class="computeroutput">buffer[a]</code></a>):
+ 
+
+
+
+<pre class="programlisting">buffer[a << b << c]</pre>
+
+ 
+
+ which will not generate any output in case of
+ a failing sequence.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.reference.operator.sequence.attributes"></a><h6>
+<a name="id827820"></a>
+ <a class="link" href="sequence.html#spirit.karma.reference.operator.sequence.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.karma.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a <<
+ b</code> (sequence)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a << b): tuple<A, B>
+a: A, b: Unused --> (a << b): A
+a: Unused, b: B --> (a << b): B
+a: Unused, b: Unused --> (a << b): Unused
+
+a: A, b: A --> (a << b): vector<A>
+a: vector<A>, b: A --> (a << b): vector<A>
+a: A, b: vector<A> --> (a << b): vector<A>
+a: vector<A>, b: vector<A> --> (a << b): vector<A></pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ The table above uses <code class="computeroutput">tuple<A, B></code> and <code class="computeroutput">vector<A></code> as placeholders only.
+ 
+
+ The notation <code class="computeroutput">tuple<A, B></code> stands for any fusion
+ sequence of two elements, where <code class="computeroutput">A</code>
+ is the type of its first element and <code class="computeroutput">B</code>
+ is the type of its second element.
+ 
+
+ The notation of <code class="computeroutput">vector<A></code> stands for any STL container
+ holding elements of type <code class="computeroutput">A</code>.
+ 
+</td></tr>
+</table></div>
+
+ The attribute composition and propagation rules as shown in the table
+ above make sequences somewhat special as - if all elements have the same
+ attribute type - they can operate in two modes: consuming fusion sequences
+ and consuming STL containers. The selected mode depends on the type of
+ the attribute supplied
+ 
+<a name="spirit.karma.reference.operator.sequence.complexity"></a><h6>
+<a name="id828919"></a>
+ <a class="link" href="sequence.html#spirit.karma.reference.operator.sequence.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the sequence generator is defined by the
+ sum of the complexities of its elements. The complexity of the sequence
+ itself is O(N), where N is the number of elements in the sequence.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.operator.sequence.example"></a><h6>
+<a name="id828943"></a>
+ <a class="link" href="sequence.html#spirit.karma.reference.operator.sequence.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use this common test function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::double_;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of a sequence:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator_attr("1.0,2.0", double_ << ',' << double_, std::make_pair(1.0, 2.0));
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../operator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="alternative.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/stream.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/stream.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,62 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Stream</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="numeric/real_number.html" title="Real Number Generators (float_, double_, etc.)">
+<link rel="next" href="stream/stream.html" title="Stream (stream, wstream, etc.)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="numeric/real_number.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="stream/stream.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Stream">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.stream"></a><a class="link" href="stream.html" title="Stream">Stream</a>
+</h4></div></div></div>
+<div class="toc"><dl><dt><a href="stream/stream.html"> Stream (<code class="computeroutput">stream</code>, <code class="computeroutput">wstream</code>,
+ etc.)</a></dt></dl></div>
+
+ This module includes the description of the different variants of the
+ <code class="computeroutput">stream</code> generator. It can
+ be used to utilize existing streaming operators (<code class="computeroutput">operator<<(std::ostream&, ...)</code>)
+ for output generation.
+ 
+<a name="spirit.karma.reference.stream.header"></a><h6>
+<a name="id781992"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/stream.hpp>
+#include <boost/spirit/include/karma_stream.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="numeric/real_number.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="stream/stream.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/stream/stream.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/stream/stream.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,644 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Stream (stream, wstream, etc.)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../stream.html" title="Stream">
+<link rel="prev" href="../stream.html" title="Stream">
+<link rel="next" href="../binary.html" title="Binary">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../stream.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../stream.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../binary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Stream (stream, wstream, etc.)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.stream.stream"></a><a class="link" href="stream.html" title="Stream (stream, wstream, etc.)"> Stream (<code class="computeroutput">stream</code>, <code class="computeroutput">wstream</code>,
+ etc.)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.stream.stream.description"></a><h6>
+<a name="id782090"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">stream_generator</code>
+ is a primitive which allows to use pre-existing standard streaming operators
+ for output generation integrated with Spirit.Karma.
+ It provides a wrapper generator dispatching the value to output to the
+ stream operator of the corresponding type. Any value <code class="computeroutput">a</code>
+ to be formatted using the <code class="computeroutput">stream_generator</code>
+ will result in invoking the standard streaming operator for its type
+ <code class="computeroutput">A</code>, for instance:
+ 
+<pre class="programlisting">std::ostream& operator<< (std::ostream&, A const&);
+</pre>
+<a name="spirit.karma.reference.stream.stream.header"></a><h6>
+<a name="id782200"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/stream.hpp>
+#include <boost/spirit/include/karma_stream.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.stream.stream.namespace"></a><h6>
+<a name="id782274"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::stream // alias:
+ boost::spirit::karma::stream</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::wstream //
+ alias: boost::spirit::karma::wstream</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.stream.stream.synopsis"></a><h6>
+<a name="id782392"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting">template <typename Char>
+struct stream_generator;
+</pre>
+<a name="spirit.karma.reference.stream.stream.template_parameters"></a><h6>
+<a name="id782446"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.template_parameters">Template
+ parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Parameter
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+<th>
+ 
+ Default
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">Char</code>
+ 
+ </td>
+<td>
+ 
+ The character type to use to generate the output. This type will
+ be used while assigning the generated characters to the underlying
+ output iterator.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">char</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.karma.reference.stream.stream.model_of"></a><h6>
+<a name="id782538"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">s</code></dt>
+<dd>
+ A variable instance of any type with a defined matching streaming
+ <code class="computeroutput">operator<<()</code>
+ or a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to any type with a defined matching
+ streaming <code class="computeroutput">operator<<()</code>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.stream.stream.expression_semantics"></a><h6>
+<a name="id782628"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">stream</code>
+ 
+ </td>
+<td>
+ 
+ Call the streaming <code class="computeroutput">operator<<()</code> for the type of the
+ mandory attribute. The output emitted by this operator will be
+ the result of the <code class="computeroutput">stream</code>
+ generator. This generator never fails (except if the underlying
+ output stream reports an error). The character type of the I/O
+ ostream is assumed to be <code class="computeroutput">char</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">stream(s)</code>
+ 
+ </td>
+<td>
+ 
+ Call the streaming <code class="computeroutput">operator<<()</code> for the type of the
+ immediate value <code class="computeroutput">s</code>.
+ The output emitted by this operator will be the result of the
+ <code class="computeroutput">stream</code> generator.
+ This generator never fails (except if the underlying output stream
+ reports an error). The character type of the I/O ostream is assumed
+ to be <code class="computeroutput">char</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">wstream</code>
+ 
+ </td>
+<td>
+ 
+ Call the streaming <code class="computeroutput">operator<<()</code> for the type of the
+ mandory attribute. The output emitted by this operator will be
+ the result of the <code class="computeroutput">stream</code>
+ generator. This generator never fails (except if the underlying
+ output stream reports an error). The character type of the I/O
+ ostream is assumed to be <code class="computeroutput">wchar_t</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">wstream(s)</code>
+ 
+ </td>
+<td>
+ 
+ Call the streaming <code class="computeroutput">operator<<()</code> for the type of the
+ immediate value <code class="computeroutput">s</code>.
+ The output emitted by this operator will be the result of the
+ <code class="computeroutput">stream</code> generator.
+ This generator never fails (except if the underlying output stream
+ reports an error). The character type of the I/O ostream is assumed
+ to be <code class="computeroutput">wchar_t</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ All generators listed in the table above are predefined specializations
+ of the <code class="computeroutput">stream_generator<Char></code> basic stream generator type described
+ below. It is possible to directly use this type to create stream generators
+ using an arbitrary underlying character type.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">stream_generator<
+ Char
+>()</pre>
+
+ 
+ </td>
+<td>
+ 
+ Call the streaming <code class="computeroutput">operator<<()</code> for the type of the
+ mandory attribute. The output emitted by this operator will be
+ the result of the <code class="computeroutput">stream</code>
+ generator. This generator never fails (except if the underlying
+ output stream reports an error). The character type of the I/O
+ ostream is assumed to be <code class="computeroutput">Char</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">stream_generator<
+ Char
+>()(s)</pre>
+
+ 
+ </td>
+<td>
+ 
+ Call the streaming <code class="computeroutput">operator<<()</code> for the type of the
+ immediate value <code class="computeroutput">s</code>.
+ The output emitted by this operator will be the result of the
+ <code class="computeroutput">stream</code> generator.
+ This generator never fails (except if the underlying output stream
+ reports an error). The character type of the I/O ostream is assumed
+ to be <code class="computeroutput">Char</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.stream.stream.additional_requirements"></a><h6>
+<a name="id783126"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.additional_requirements">Additional
+ Requirements</a>
+ </h6>
+
+ All of the stream generators listed above require the type of the value
+ to generate output for (either the immediate value or the associated
+ attribute) to implement a streaming operator conforming to the usual
+ I/O streams conventions (where <code class="computeroutput">attribute_type</code>
+ is the type of the value to generate output for):
+ 
+<pre class="programlisting">template <typename Ostream>
+Ostream& operator<< (Ostream& os, attribute_type const& attr)
+{
+ // type specific output generation
+ return os;
+}
+</pre>
+
+ This operator will be called by the stream generators to gather the output
+ for the attribute of type <code class="computeroutput">attribute_type</code>.
+ All data streamed into the given <code class="computeroutput">Ostream</code>
+ will end up being generated by the corresponding stream generator instance.
+ 
+<div class="note" title="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">
+ If the <code class="computeroutput">stream</code> generator
+ is invoked inside a <code class="computeroutput">format</code>
+ (or <code class="computeroutput">format_delimited</code>
+ ) stream manipulator the <code class="computeroutput">Ostream</code>
+ passed to the <code class="computeroutput">operator<<()</code> will have registered (imbued)
+ the same standard locale instance as the stream the <code class="computeroutput">format</code>
+ (or <code class="computeroutput">format_delimited</code>
+ ) manipulator has been used with. This ensures all facets registered
+ (imbued) with the original I/O stream object are used during output
+ generation.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.stream.stream.attributes"></a><h6>
+<a name="id783349"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">stream</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">hold_any</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">stream(s)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">wstream</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">hold_any</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">wstream(s)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">stream_generator<Char>()</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">hold_any</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">stream_generator<Char>()(s)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The attribute type <code class="computeroutput">hold_any</code>
+ exposed by some of the stream generators is semantically and syntactically
+ equivalent to the type implemented by Boost.Any.
+ It has been added to Spirit as it has better a
+ performance and a smaller footprint if compared to Boost.Any.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.stream.stream.complexity"></a><h6>
+<a name="id783661"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of characters emitted by the stream generator
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.stream.stream.example"></a><h6>
+<a name="id783685"></a>
+ <a class="link" href="stream.html#spirit.karma.reference.stream.stream.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::stream;
+</pre>
+
+ 
+
+ 
+
+ And a class definition used in the examples:
+ 
+
+ 
+
+
+
+<pre class="programlisting">// a simple complex number representation z = a + bi
+struct complex
+{
+ complex (double a, double b)
+ : a(a), b(b)
+ {}
+
+ double a;
+ double b;
+};
+
+// define streaming operator for the type complex
+std::ostream&
+operator<< (std::ostream& os, complex const& z)
+{
+ os << "{" << z.a << "," << z.b << "}";
+ return os;
+}
+</pre>
+
+ 
+
+ 
+
+ Basic usage of <code class="computeroutput">stream</code>
+ generators:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator_attr("abc", stream, "abc");
+test_generator("abc", stream("abc"));
+test_generator_attr("{1.2,2.4}", stream, complex(1.2, 2.4));
+test_generator("{1.2,2.4}", stream(complex(1.2, 2.4)));
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../stream.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../stream.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../binary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/string.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/string.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,60 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>String</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="char/char_class.html" title="Character Classification (alnum, digit, etc.)">
+<link rel="next" href="string/string.html" title="String (string, lit)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char/char_class.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string/string.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="String">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.reference.string"></a><a class="link" href="string.html" title="String">String</a>
+</h4></div></div></div>
+<div class="toc"><dl><dt> String (string, lit)</dt></dl></div>
+
+ This module includes different string oriented generators allowing to output
+ character sequences. It includes variants of the <code class="computeroutput">string</code>
+ generator.
+ 
+<a name="spirit.karma.reference.string.module_header"></a><h6>
+<a name="id758054"></a>
+ <a class="link" href="string.html#spirit.karma.reference.string.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/string.hpp>
+#include <boost/spirit/include/karma_string.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char/char_class.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string/string.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/reference/string/string.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/reference/string/string.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,444 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>String (string, lit)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../string.html" title="String">
+<link rel="prev" href="../string.html" title="String">
+<link rel="next" href="../numeric.html" title="Numeric">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../numeric.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="String (string, lit)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.karma.reference.string.string"></a><a class="link" href="string.html" title="String (string, lit)"> String (<code class="computeroutput">string</code>, <code class="computeroutput">lit</code>)</a>
+</h5></div></div></div>
+<a name="spirit.karma.reference.string.string.description"></a><h6>
+<a name="id758152"></a>
+ <a class="link" href="string.html#spirit.karma.reference.string.string.description">Description</a>
+ </h6>
+
+ The string generators described in this section are:
+ 
+
+ The <code class="computeroutput">string</code> generator
+ emits a string of characters. The <code class="computeroutput">string</code>
+ generator is implicitly verbatim: the <code class="computeroutput">delimit</code>
+ parser is not applied in between characters of the string. The <code class="computeroutput">string</code> generator has an assocaiated
+ <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>. This is needed when doing basic operations
+ such as forcing lower or upper case. Examples:
+ 
+<pre class="programlisting">string("Hello")
+string(L"Hello")
+string(s) // s is a std::string
+</pre>
+
+ <code class="computeroutput">lit</code>, like <code class="computeroutput">string</code>, also emits a string of characters.
+ The main difference is that <code class="computeroutput">lit</code>
+ does not consumes an attribute. A plain string like <code class="computeroutput">"hello"</code>
+ or a <code class="computeroutput">std::basic_string</code> is equivalent to a <code class="computeroutput">lit</code>. Examples:
+ 
+<pre class="programlisting">"Hello"
+lit("Hello")
+lit(L"Hello")
+lit(s) // s is a std::string
+</pre>
+<a name="spirit.karma.reference.string.string.header"></a><h6>
+<a name="id758381"></a>
+ <a class="link" href="string.html#spirit.karma.reference.string.string.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/string/lit.hpp>
+#include <boost/spirit/include/karma_string.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.karma.reference.string.string.namespace"></a><h6>
+<a name="id758456"></a>
+ <a class="link" href="string.html#spirit.karma.reference.string.string.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lit // alias:
+ boost::spirit::karma::lit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::string</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+
+ In the table above, <code class="computeroutput">ns</code>
+ is a <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a> used by the corresponding string generator.
+ 
+<a name="spirit.karma.reference.string.string.model_of"></a><h6>
+<a name="id759332"></a>
+ <a class="link" href="string.html#spirit.karma.reference.string.string.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">s</code></dt>
+<dd>
+ Character-class specific string (See Character Class Types), or a
+ <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a character-class specific string
+ value
+ </dd>
+<dt><code class="computeroutput">S</code></dt>
+<dd>
+ The type of a character-clas specific string <code class="computeroutput">s</code>.
+ </dd>
+<dt><code class="computeroutput">ns</code></dt>
+<dd>
+ A <a class="link" href="../karma_basics.html#spirit.karma.reference.karma_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.karma.reference.string.string.expression_semantics"></a><h6>
+<a name="id759450"></a>
+ <a class="link" href="string.html#spirit.karma.reference.string.string.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../generator_concepts/primitivegenerator.html" title="PrimitiveGenerator"><code class="computeroutput">PrimitiveGenerator</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">s</code>
+ 
+ </td>
+<td>
+ 
+ Generate the string literal <code class="computeroutput">s</code>.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(s)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the string literal <code class="computeroutput">s</code>.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::string</code>
+ 
+ </td>
+<td>
+ 
+ Generate the string provided by a mandatory attribute interpreted
+ in the character set defined by <code class="computeroutput">ns</code>.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::string(s)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the string <code class="computeroutput">s</code>
+ as provided by the immediate literal value the generator is initialized
+ from. If this generator has an associated attribute it succeeds
+ only as long as the attribute is equal to the immediate literal
+ (except if the underlying output stream reports an error). Otherwise
+ this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ The generators <code class="computeroutput">lit(s)</code> and <code class="computeroutput">string(s)</code> can be initialized either using a
+ string literal value (i.e. <code class="computeroutput">"abc"</code>),
+ or using a <code class="computeroutput">std::basic_string<char_type,
+ ...></code>, where <code class="computeroutput">char_type</code> is the required value type
+ of the underlying character sequence.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.reference.string.string.attributes"></a><h6>
+<a name="id759763"></a>
+ <a class="link" href="string.html#spirit.karma.reference.string.string.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">s</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(s)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::string</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">S</code>, attribute
+ is mandatory (otherwise compilation will fail)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::string(s)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">S</code>, attribute
+ is optional, if it is supplied, the generator compares the attribute
+ with <code class="computeroutput">s</code> and succeeds
+ only if both are equal, failing otherwise
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.karma.reference.string.string.complexity"></a><h6>
+<a name="id759978"></a>
+ <a class="link" href="string.html#spirit.karma.reference.string.string.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of characters emitted by the string generator
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.karma.reference.string.string.example"></a><h6>
+<a name="id760002"></a>
+ <a class="link" href="string.html#spirit.karma.reference.string.string.example">Example</a>
+ </h6>
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/karma.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/fusion/include/std_pair.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ All code snippets below use these common test functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G>
+void test_generator(char const* expected, G const& g)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename G, typename T>
+void test_generator_attr(char const* expected, G const& g, T const& attr)
+{
+ std::string s;
+ std::back_insert_iterator<std::string> out(s);
+ if (boost::spirit::karma::generate(out, g, attr) && str == expected)
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::karma::generate;
+using boost::spirit::karma::lit;
+using boost::spirit::ascii::string;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of <code class="computeroutput">string</code>
+ generators:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_generator("abc", "abc");
+test_generator("abc", lit("abc"));
+test_generator("abc", lit(std::string("abc")));
+
+test_generator_attr("abc", string, "abc");
+test_generator("abc", string("abc"));
+test_generator("abc", string(std::string("abc")));
+
+test_generator_attr("abc", string("abc"), "abc");
+test_generator_attr("", string("abc"), "cba"); // fails (as "abc" != "cba")
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../numeric.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/tutorials.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/tutorials.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,55 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Tutorials</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../karma.html" title="Karma - Writing Generators">
+<link rel="prev" href="../karma.html" title="Karma - Writing Generators">
+<link rel="next" href="tutorials/quick_start.html" title="Quick Start">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../karma.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../karma.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/quick_start.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Tutorials">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.karma.tutorials"></a><a class="link" href="tutorials.html" title="Tutorials">Tutorials</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt>Quick Start</dt>
+<dt>Warming up</dt>
+<dt>Semantic Actions</dt>
+<dt><a href="tutorials/karma_complex.html"> Complex - A
+ first more complex generator</a></dt>
+<dt><a href="tutorials/karma_attributes.html"> Understanding
+ Generator Attributes</a></dt>
+<dt><a href="tutorials/karma_easier_complex.html"> Complex
+ - Made easier</a></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../karma.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../karma.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/quick_start.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/tutorials/karma_attributes.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/tutorials/karma_attributes.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,354 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Understanding Generator Attributes</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="karma_complex.html" title="Complex - A first more complex generator">
+<link rel="next" href="karma_easier_complex.html" title="Complex - Made easier">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="karma_complex.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="karma_easier_complex.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Understanding Generator Attributes">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.tutorials.karma_attributes"></a><a class="link" href="karma_attributes.html" title="Understanding Generator Attributes"> Understanding
+ Generator Attributes</a>
+</h4></div></div></div>
+<a name="spirit.karma.tutorials.karma_attributes.attributes_of_primitive_generators"></a><h6>
+<a name="id715408"></a>
+ <a class="link" href="karma_attributes.html#spirit.karma.tutorials.karma_attributes.attributes_of_primitive_generators">Attributes
+ of Primitive Generators</a>
+ </h6>
+
+ Before we can start simplifying the complex number example from the previous
+ section we need to introduce the notion of generator attributes. Every
+ generator component in Spirit.Karma exposes a specific
+ attribute type. We have already seen that the attribute type of the <code class="computeroutput">double_</code> generator is <code class="computeroutput">double</code>.
+ Other primitive generator components have other intuitive attribute types,
+ such as for instance <code class="computeroutput">int_</code>
+ which has <code class="computeroutput">int</code>, or <code class="computeroutput">ascii::char_</code> which has <code class="computeroutput">char</code>.
+ For a full list of available generator primitives and their attribute types
+ please see the section <a class="link" href="../quick_reference/primitive_generators.html" title="Karma Generators">Karma
+ Generators</a>.
+ 
+
+ The attribute type of a generator defines what data types this generator
+ is able to consume in order to produce its output. For primitive generators
+ the normal C++ convertibility rules apply. Any data type convertible to
+ the attribute type of a primitive generator can be used to provide the
+ data to generate. As an example, it is possible to use an integer value
+ in conjunction with a <code class="computeroutput">double_</code>
+ generator:
+ 
+<pre class="programlisting">// the following generates: 1.0
+std::string str;
+std::back_insert_iterator<std::string> out(str);
+generate(out, double_, 1);
+</pre>
+<a name="spirit.karma.tutorials.karma_attributes.attributes_of_compound_generators"></a><h6>
+<a name="id715600"></a>
+ <a class="link" href="karma_attributes.html#spirit.karma.tutorials.karma_attributes.attributes_of_compound_generators">Attributes
+ of Compound Generators</a>
+ </h6>
+
+ Spirit.Karma implements well defined attribute type
+ propagation rules for all compound generators, such as sequences, alternatives,
+ Kleene star, etc. The main attribute propagation rule for a sequences is
+ for instance:
+ 
+<pre class="programlisting">a: A, b: B --> (a << b): tuple<A, B>
+</pre>
+
+ which reads as:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ Given <code class="computeroutput">a</code> and <code class="computeroutput">b</code> are generators, and <code class="computeroutput">A</code> is the attribute type of <code class="computeroutput">a</code>, and <code class="computeroutput">B</code>
+ is the attribute type of <code class="computeroutput">b</code>,
+ then the attribute type of <code class="computeroutput">a
+ << b</code>
+ will be <code class="computeroutput">tuple<A, B></code>.
+ 
+
+ 
+</blockquote></div>
+<div class="note" title="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">
+ The notation <code class="computeroutput">tuple<A, B></code>
+ is used as a placeholder expression for any fusion sequence holding the
+ types A and B, such as <code class="computeroutput">boost::fusion::tuple<A, B></code> or <code class="computeroutput">std::pair<A, B></code> (for more information see Boost.Fusion).
+ </td></tr>
+</table></div>
+
+ As you can see, in order for a type to be compatible with the attribute
+ type of a Spirit.Karma compound generator it has to
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ either be convertible to the attribute type,
+ </li>
+<li class="listitem">
+ or it has to expose certain functionalities, i.e. it needs to conform
+ to a concept compatible with the generator.
+ </li>
+</ul></div>
+
+ Each compound generator implements its own set of attribute propagation
+ rules. For a full list of how the different compound generators consume
+ attributes see the section <a class="link" href="../quick_reference/compound_attribute_rules.html" title="Compound Attribute Rules">Compound
+ Attribute Rules</a>.
+ 
+<a name="spirit.karma.tutorials.karma_attributes.the_attribute_of_sequence_generators"></a><h6>
+<a name="id715945"></a>
+ <a class="link" href="karma_attributes.html#spirit.karma.tutorials.karma_attributes.the_attribute_of_sequence_generators">The
+ Attribute of Sequence Generators</a>
+ </h6>
+
+ Sequences require an attribute type to expose the concept of a fusion sequence,
+ where all elements of that fusion sequence have to be compatible with the
+ corresponding element of the Spirit.Karma generator
+ sequence. For example, the expression:
+ 
+<pre class="programlisting">double_ << double_
+</pre>
+
+ is able to consume any fusion sequence holding two types, where both types
+ have to be convertible to <code class="computeroutput">double</code>.
+ The first element of the fusion sequence has to be compatible with the
+ attribute of the first <code class="computeroutput">double_</code>
+ (i.e. it needs to be convertible to a <code class="computeroutput">double</code>),
+ and the second element of the fusion sequence has to be compatible with
+ the attribute of the second <code class="computeroutput">double_</code>
+ (i.e. convertible to a <code class="computeroutput">double</code>
+ as well). If we assume to have an instance of a <code class="computeroutput">std::pair<double, double></code>, we can directly use the expression
+ above to generate output for it:
+ 
+<pre class="programlisting">// the following generates: 1.0 2.0
+std::string str;
+std::back_insert_iterator<std::string> out(str);
+generate(out,
+ double_ << double_, // generator grammar (format description)
+ ascii::space, // delimiter grammar
+ std::make_pair(1.0, 2.0)); // data to use as the attribute
+</pre>
+
+ (where the <code class="computeroutput">ascii::space</code> generator is used as the delimiter,
+ allowing to automatically insert delimiting spaces in between all primitives).
+ 
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ For sequences only: Spirit.Karma
+ exposes a set of API functions usable mainly with sequences. Very much
+ like the functions of the <code class="computeroutput">printf</code>
+ family these functions allow to pass the attributes for each of the elements
+ of the sequence separately. Using the corresponding overload of Karma's
+ <code class="computeroutput">generate()</code>
+ the expression above could be rewritten as:
+ 
+
+
+
+<pre class="programlisting">generate(out, double_ << double_, space, 1.0, 2.0);</pre>
+
+ 
+
+ where the first attribute (<code class="computeroutput">1.0</code>)
+ is used for the first <code class="computeroutput">double_</code>,
+ and the second attribute (<code class="computeroutput">2.0</code>)
+ is used for the second <code class="computeroutput">double_</code>.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.karma.tutorials.karma_attributes.the_attribute_of_alternative_generators"></a><h6>
+<a name="id716377"></a>
+ <a class="link" href="karma_attributes.html#spirit.karma.tutorials.karma_attributes.the_attribute_of_alternative_generators">The
+ Attribute of Alternative Generators</a>
+ </h6>
+
+ Alternative generators are all about - well - alternatives. In order to
+ store possibly different result (attribute) types from the different alternatives
+ we use the data type Boost.Variant.
+ The main attribute propagation rule of these generators is
+ 
+<pre class="programlisting">a: A, b: B --> (a | b): variant<A, B>
+</pre>
+
+ where the <code class="computeroutput">variant<></code>
+ is again a placeholder for the concept of a Boost.Variant.
+ Any other data type exposing the required concepts can be used instead
+ (for more information about attribute compatibility and attribute concepts
+ see the section Compatible Attributes). Alternatives have a second very
+ important attribute propagation rule:
+ 
+<pre class="programlisting">a: A, b: A --> (a | b): A
+</pre>
+
+ often allowing to simplify things significantly. If all sub expressions
+ of a Spirit.Karma alternative expose the same attribute
+ type, the overall alternative will expose exactly the same attribute type
+ as well. We will apply this rule later for our complex number generators.
+ 
+<a name="spirit.karma.tutorials.karma_attributes.more_about_attributes_of_compound_generators"></a><h6>
+<a name="id716736"></a>
+ <a class="link" href="karma_attributes.html#spirit.karma.tutorials.karma_attributes.more_about_attributes_of_compound_generators">More
+ About Attributes of Compound Generators</a>
+ </h6>
+
+ While generating output it is often desirable to combine some constant
+ elements with variable parts. For instance, if we go back to our example
+ of formatting a complex number, we need to write it as <code class="computeroutput">(real, imag)</code>,
+ where <code class="computeroutput">real</code> and <code class="computeroutput">imag </code> are the variables representing
+ the real and imaginary parts of our complex number. As we have already
+ seen, this can be achieved by writing
+ 
+<pre class="programlisting">'(' << double_ << ", " << double_ << ')'
+</pre>
+
+ Fortunately, literals (such as <code class="computeroutput">'('</code>
+ and <code class="computeroutput">", "</code>) do not
+ expose any attribute (well actually, they do expose the special type <code class="computeroutput">unused_type</code>, but in this context <code class="computeroutput">unused_type</code> is interpreted as if the
+ generator does not expose any attribute at all). It is very important to
+ understand that the literals don't consume any of the elements of a fusion
+ sequence passed to this generator sequence. As said, they just don't expose
+ any attribute and don't consume any data. The following example shows this:
+ 
+<pre class="programlisting">// the following generates: (1.0, 2.0)
+std::string str;
+std::back_insert_iterator<std::string> out(str);
+generate(out,
+ '(' << double_ << ", " << double_ << ')', // generator grammar (format description)
+ std::make_pair(1.0, 2.0)); // data to use as the attribute
+</pre>
+
+ where the first element of the pair passed in as the data to generate is
+ still associated with the first <code class="computeroutput">double_</code>,
+ and the second element is associated with the second <code class="computeroutput">double_</code>
+ generator.
+ 
+
+ This behavior should be familiar as it conforms to the way other output
+ formatting libraries such as <code class="computeroutput">printf</code>
+ or <code class="computeroutput">boost::format</code> are handling their variable parts.
+ In this context you can think about Spirit.Karma's
+ primitive generators (such as the <code class="computeroutput">double_</code>
+ above) as of being typesafe placeholders for the attribute values to print.
+ 
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ Similarly to the tip provided above, this example could be rewritten
+ using Karma's multi-attribute API function:
+ 
+
+
+
+<pre class="programlisting">generate(out, '(' << double_ << ", " << double_ << ')', 1.0, 2.0);</pre>
+
+ 
+
+ which provides a clear and comfortable syntax, more similar to the placeholder
+ based syntax as exposed by <code class="computeroutput">printf</code>
+ or <code class="computeroutput">boost::format</code>.
+ 
+</td></tr>
+</table></div>
+
+ Let's take a look at this from a more formal perspective. The sequence
+ attribute propagation rules define a special behavior if generators exposing
+ <code class="computeroutput">unused_type</code> as their attribute
+ are involved (see <a class="link" href="../quick_reference/compound_attribute_rules.html" title="Compound Attribute Rules">Compound
+ Attribute Rules</a>):
+ 
+<pre class="programlisting">a: A, b: Unused --> (a << b): A
+</pre>
+
+ which reads as:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ Given <code class="computeroutput">a</code> and <code class="computeroutput">b</code> are generators, and <code class="computeroutput">A</code> is the attribute type of <code class="computeroutput">a</code>, and <code class="computeroutput">unused_type</code>
+ is the attribute type of <code class="computeroutput">b</code>,
+ then the attribute type of <code class="computeroutput">a
+ << b</code>
+ will be <code class="computeroutput">A</code> as well.
+ This rule applies regardless of the position the element exposing the
+ <code class="computeroutput">unused_type</code> is at.
+ 
+
+ 
+</blockquote></div>
+
+ This rule is the key to the understanding of the attribute handling in
+ sequences as soon as literals are involved. It is as if elements with
+ <code class="computeroutput">unused_type</code> attributes
+ 'disappeared' during attribute propagation. Notably, this is not only true
+ for sequences but for any compound generator in Spirit.Karma.
+ For instance, for alternative generators the corresponding rule is:
+ 
+<pre class="programlisting">a: A, b: Unused --> (a | b): A
+</pre>
+
+ again, allowing to simplify the overall attribute type of an expression.
+ 
+<a name="spirit.karma.tutorials.karma_attributes.attributes_of_rules_and_grammars"></a><h6>
+<a name="id717476"></a>
+ <a class="link" href="karma_attributes.html#spirit.karma.tutorials.karma_attributes.attributes_of_rules_and_grammars">Attributes
+ of Rules and Grammars</a>
+ </h6>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ explicit attribute type
+ </li>
+<li class="listitem">
+ attribute propagation
+ <div class="itemizedlist"><ul class="itemizedlist" type="circle"><li class="listitem">
+ explicit and operator%=
+ </li></ul></div>
+</li>
+</ul></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="karma_complex.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="karma_easier_complex.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/tutorials/karma_complex.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/tutorials/karma_complex.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,160 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Complex - A first more complex generator</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="semantic_actions.html" title="Semantic Actions">
+<link rel="next" href="karma_attributes.html" title="Understanding Generator Attributes">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="karma_attributes.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Complex - A first more complex generator">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.tutorials.karma_complex"></a><a class="link" href="karma_complex.html" title="Complex - A first more complex generator"> Complex - A
+ first more complex generator</a>
+</h4></div></div></div>
+
+ In this section we will develop a generator for complex numbers, allowing
+ to represent a <code class="computeroutput">std::complex</code> either as <code class="computeroutput">(real, imag)</code>
+ (where <code class="computeroutput">real</code> and <code class="computeroutput">imag</code> are the real and imaginary parts
+ of the complex number) or as a simple <code class="computeroutput">real</code>
+ if the imaginary part happens to be equal to zero. This example will highlight
+ the power of Spirit.Karma allowing to combine compile
+ time definition of formatting rules with runtime based decisions which
+ of the rules to apply. Also this time, we're using Boost.Phoenix
+ to do the semantic actions.
+ 
+
+ Our goal is to allow for two different output formats to be applied depending
+ on whether the imaginary part of the complex number is zero or not. Let's
+ write both as a set of alternatives:
+ 
+<pre class="programlisting"> '(' << double_ << ", " << double_ << ')'
+| double_
+</pre>
+
+ where the first alternative should be used for numbers having a non-zero
+ imaginary part, while the second is for real numbers. Generally, alternatives
+ are tried in the sequence of their definition as long until one of the
+ expressions (as delimited by <code class="computeroutput">'|'</code>)
+ succeeds. If no generator expression succeeds the whole alternative fails.
+ 
+
+ If we left this formatting grammar as is our generator would always choose
+ the first alternative. We need to add some additional rules allowing to
+ make the first alternative failing. So, if the first fails the second alternative
+ will be chosen instead. The decision about whether to choose the first
+ alternative has to be made at runtime as only then we actually know the
+ value of the imaginary part of the complex number. Spirit.Karma
+ provides us with with a primitive generator <code class="computeroutput">eps()</code>, which is usable as a semantic predicate.
+ It has the property to 'succeed' generating only if its argument is true
+ (while it never generates any output on its own).
+ 
+<pre class="programlisting">double imag = ...; // imaginary part
+
+ eps(imag != 0) << '(' << double_ << ", " << double_ << ')'
+| double_
+</pre>
+
+ If one of the generator elements of a sequence fails the whole sequence
+ will fail. This is exactly what we need, forcing the second alternative
+ to be chosen for complex numbers with imaginary parts equal to zero.
+ 
+
+ Here goes the full example, this time with the proper semantic actions
+ (The full cpp file for this example can be found here: complex_number.cpp).
+ 
+
+ We will use the <code class="computeroutput">std::complex</code> type for this and all subsequent
+ related examples. And here you can see the full code of the generator allowing
+ to output a complex number either as a pair of numbers (if the imaginary
+ part is non-zero) or as a single number (if the complex is a real number):
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename OutputIterator>
+bool generate_complex(OutputIterator sink, std::complex<double> const& c)
+{
+ using boost::spirit::karma::eps;
+ using boost::spirit::karma::double_;
+ using boost::spirit::karma::_1;
+ using boost::spirit::karma::generate;
+
+ return generate(sink,
+ // Begin grammar
+ (
+ eps(c.imag() != 0) <<
+ '(' << double_[_1 = c.real()] << ", " << double_[_1 = c.imag()] << ')'
+ | double_[_1 = c.real()]
+ )
+ // End grammar
+ );
+}
+</pre>
+
+ 
+
+ 
+
+ The <code class="computeroutput">double_</code> generators
+ have this semantic action attached:
+ 
+<pre class="programlisting">_1 = n
+</pre>
+
+ which passes <code class="computeroutput">n</code> to the first
+ element of the generator the semantic action is attached to. Remember,
+ semantic actions in Spirit.Karma are called before
+ the corresponding generator is invoked and they are expected to provide
+ the generator with the data to be used. The semantic action above assigns
+ the value to be generated (<code class="computeroutput">n</code>)
+ to the generator (actually, the attribute of <code class="computeroutput">double_</code>).
+ <code class="computeroutput">_1</code> is a Phoenix placeholder
+ referring to the attribute of the generator the semantic action is attached
+ to. If you need more information about semantic actions, you may want to
+ read about those in this section: <a class="link" href="semantic_actions.html" title="Semantic Actions">Semantic
+ Actions</a>.
+ 
+
+ These semantic actions are easy to understand but have the unexpected side
+ effect of being slightly less efficient than it could be. In addition they
+ tend to make the formatting grammar less readable. We will see in one of
+ the next sections how it is possible to use other, builtin features of
+ Spirit.Karma to get rid of the semantic actions alltogether.
+ When writing your grammars in Spirit you should always try to avoid semantic
+ actions which is often possible. Semantic actions are really powerful tools
+ but grammars tend to be more efficient and readable without them.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="karma_attributes.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/tutorials/karma_easier_complex.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/tutorials/karma_easier_complex.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,229 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Complex - Made easier</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="karma_attributes.html" title="Understanding Generator Attributes">
+<link rel="next" href="../quick_reference.html" title="Quick Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="karma_attributes.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Complex - Made easier">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.tutorials.karma_easier_complex"></a><a class="link" href="karma_easier_complex.html" title="Complex - Made easier"> Complex
+ - Made easier</a>
+</h4></div></div></div>
+
+ In one of the previous sections we showed how to format a complex number
+ (i.e. a pair of doubles). In this section we will build on this example
+ with the goal to avoid to use semantic actions in the format specification.
+ Let's have a look at the resulting code first, trying to understand it
+ afterwards (the full source file for this example can be found here: complex_number_easier.cpp):
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename OutputIterator>
+bool generate_complex(OutputIterator sink, std::complex<double> const& c)
+{
+ using boost::spirit::karma::double_;
+ using boost::spirit::karma::omit;
+ using boost::spirit::karma::generate;
+
+ return generate(sink,
+
+ // Begin grammar
+ (
+ !double_(0.0) << '(' << double_ << ", " << double_ << ')'
+ | omit[double_] << double_ << omit[double_]
+ ),
+ // End grammar
+
+ c.imag(), c.real(), c.imag() // Data to output
+ );
+}
+</pre>
+
+ 
+
+ 
+
+ Let's try to cover some basic library features first.
+ 
+<a name="spirit.karma.tutorials.karma_easier_complex.making_numeric_generators_fail"></a><h6>
+<a name="id717955"></a>
+ <a class="link" href="karma_easier_complex.html#spirit.karma.tutorials.karma_easier_complex.making_numeric_generators_fail">Making
+ Numeric Generators Fail</a>
+ </h6>
+
+ All <a class="link" href="../reference/numeric.html" title="Numeric">numeric generators</a>
+ (such as <code class="computeroutput">double_</code>, et.al.)
+ take the value to emit from an attached attribute. In addition, they may
+ be initialized from a literal value. For instance, to emit a constant
+ <code class="computeroutput">0.0</code> you may write: <code class="computeroutput">double_(0.0)</code>. The
+ difference to a simple <code class="computeroutput">0.0</code>
+ or <code class="computeroutput">lit(0.0)</code> is that
+ the <code class="computeroutput">double_(0.0)</code> consumes
+ an attribute, if one is available. Additionally, it compares its immediate
+ value to the value of the supplied attribute, and fails if those are not
+ equal. This feature, namely to succeed generating only if the attribute
+ matches the immediate value, enables numeric generators to be used to dynamically
+ control the way output is generated.
+ 
+<div class="note" title="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">
+ There are more generators exposing the feature to fail if their immediate
+ value is not equal to the supplied attribute. Here are some: all <a class="link" href="../reference/char.html" title="Char">Character Generators</a>, all
+ <a class="link" href="../reference/string.html" title="String">String Generators</a>.
+ Generally, all generators having a sibling created by a variant of <code class="computeroutput">lit()</code>
+ belong into this category.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.tutorials.karma_easier_complex.predicates___the_conditionals_for_output_generators"></a><h6>
+<a name="id718080"></a>
+ <a class="link" href="karma_easier_complex.html#spirit.karma.tutorials.karma_easier_complex.predicates___the_conditionals_for_output_generators">Predicates
+ - The Conditionals for Output Generators</a>
+ </h6>
+
+ In addition to the <a class="link" href="../reference/auxiliary/eps.html" title="Epsilon (eps)"><code class="computeroutput">eps</code></a> generator mentioned earlier
+ Spirit.Karma provides two special operators enabling
+ dynamic flow control: the <a class="link" href="../reference/operator/and_predicate.html" title="And Predicate (&a)">and
+ predicate (unary <code class="computeroutput">&</code>)</a>
+ and the <a class="link" href="../reference/operator/not_predicate.html" title="Not Predicate (!a)">not
+ predicate (unary <code class="computeroutput">!</code>)</a>.
+ The main property of both predicates is to discard all output emitted by
+ the generator they are attached to. This is equivalent to the behaviour
+ of predicates used for parsing. There the predicates do not consume any
+ input allowing to look ahead in the input stream. The and predicate succeeds
+ as long as its associated generator suceeds, while the not predicate succeeds
+ only if its associated generator fails.
+ 
+<div class="note" title="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">
+ The generator predicates in Spirit.Karma consume
+ an attribute, if available. This makes them behave differently from predicates
+ in Spirit.Qi, where they do not expose any attribute.
+ This is because predicates allow to make decisions based on data available
+ only at runtime. While in Spirit.Qi during parsing
+ the decision is made based on the look ahead input, in Spirit.Karma
+ the criteria has to be supplied by the user. The simplest way to do this
+ is by providing an attribute.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.tutorials.karma_easier_complex.ignoring_supplied_attributes"></a><h6>
+<a name="id718157"></a>
+ <a class="link" href="karma_easier_complex.html#spirit.karma.tutorials.karma_easier_complex.ignoring_supplied_attributes">Ignoring
+ Supplied Attributes</a>
+ </h6>
+
+ Sometimes it is desirable to 'skip' (i.e. ignore) a provided attribute.
+ This happens for instance in alternative generators, where some of the
+ alternatives need to extract only part of the overall attribute passed
+ to the alternative generator. Spirit.Karma has a special
+ pseudo generator for that: the directive <a class="link" href="../reference/directive/omit.html" title="Consume Attribute (omit[])"><code class="computeroutput">omit[a]</code></a>.
+ This directive consumes an attribute of the type defined by its embedded
+ generator but it does not emit any output.
+ 
+<a name="spirit.karma.tutorials.karma_easier_complex.putting_everything_together"></a><h6>
+<a name="id718198"></a>
+ <a class="link" href="karma_easier_complex.html#spirit.karma.tutorials.karma_easier_complex.putting_everything_together">Putting
+ everything together</a>
+ </h6>
+
+ Very similar to our first example ealier we use two alternatives to allow
+ for two different output formats depending on whether the imaginery part
+ of the complex number is equal to zero or not. The first alternative is
+ executed if the imaginary part is not zero, the second alternative otherwise.
+ This time we make the decision during runtime using the <a class="link" href="../reference/operator/not_predicate.html" title="Not Predicate (!a)">not
+ predicate (unary <code class="computeroutput">!</code>)</a>
+ (the <code class="computeroutput">operator!</code>)
+ combined with the feature of many Karma primitive generators allowing them
+ to fail under certain conditions. Here is the first
+ alternative again for your reference:
+ 
+<pre class="programlisting">!double_(0.0) << '(' << double_ << ", " << double_ << ')'
+</pre>
+
+ The generator <code class="computeroutput">!double_(0.0)</code>
+ does several things. First, because of the <a class="link" href="../reference/operator/not_predicate.html" title="Not Predicate (!a)">not
+ predicate (unary <code class="computeroutput">!</code>)</a>,
+ it succeeds only if the <code class="computeroutput">double_(0.0)</code>
+ generator fails, making the whole first alternative
+ fail otherwise. Second, the <code class="computeroutput">double_(0.0)</code>
+ generator succeeds only if the value of its attribute is equal to its immediate
+ parameter (i.e. in this case <code class="computeroutput">0.0</code>).
+ Third, the not predicate does not emit any output (regardless whether it
+ succeeds or fails), discarding any possibble output emitted by the <code class="computeroutput">double_(0.0)</code>.
+ 
+
+ As we pass the imaginery part of the complex number as the attribute value
+ for the <code class="computeroutput">!double_(0.0)</code>,
+ the overall first alternative will be chosen only if it is not equal to
+ zero (the <code class="computeroutput">!double_(0.0)</code>
+ does not fail). Exactly what we need!
+ 
+
+ Now, the second alternative simply needs to emit the real part of the complex
+ number only. In order to simplify the overall grammar we strive to unify
+ the attribute types of all alternatives. As the attribute type exposed
+ by the first alternative is <code class="computeroutput">tuple<double, double, double></code>, we need to skip the first and last
+ element of the attribute (remember, we pass the real part as the second
+ attribute element). We achieve this by using the <code class="computeroutput">omit[]</code> directive:
+ 
+<pre class="programlisting">omit[double_] << double_ << omit[double_]
+</pre>
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ Generally, it is preferrable to use generator constructs not requiring
+ semantic actions. The reason is that semantic actions often use constructs
+ like: <code class="computeroutput">double_[_1 = c.real()]</code>.
+ But this assignment is a real one! The data is really copied
+ to the attribute value of the generator the action is attached to. On
+ the other hand, grammars without anz semantic actions usually don't have
+ to copy the attributes, making them more efficient.
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="karma_attributes.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/tutorials/quick_start.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/tutorials/quick_start.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,105 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Quick Start</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="../tutorials.html" title="Tutorials">
+<link rel="next" href="warming_up.html" title="Warming up">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../tutorials.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="warming_up.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Quick Start">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.tutorials.quick_start"></a><a class="link" href="quick_start.html" title="Quick Start">Quick Start</a>
+</h4></div></div></div>
+<a name="spirit.karma.tutorials.quick_start.spirit_karma___what_s_that_"></a><h6>
+<a name="id710017"></a>
+ <a class="link" href="quick_start.html#spirit.karma.tutorials.quick_start.spirit_karma___what_s_that_">Spirit.Karma
+ - what's that?</a>
+ </h6>
+
+ Throughout the description of Spirit.Karma we will
+ try to align ourselves very much with the documentation for Spirit.Qi.
+ The reasons are manyfold:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+Spirit.Karma is the counterpart to Spirit.Qi.
+ Some people say it's the Yin to Spirit.Qi's Yang.
+ Spirit.Karma is to generating byte sequences from
+ internal data structures as Spirit.Qi is parsing
+ byte sequences into those (very same) internal data structures.
+ </li>
+<li class="listitem">
+ Both libraries have an almost identical structure, very similar semantics,
+ and are both built using identical tools. Both libraries implement a
+ language casting the specifics of their domain (parsing and generating)
+ into a simple interface.
+ </li>
+</ul></div>
+
+ Why should you use a generator library for such a simple thing as output
+ generation? Programmers have been using printf, std::stream formatting,
+ or boost::format for quite some time. The answer is - yes, for simple output
+ formatting tasks those familiar tools might be a quick solution. But experience
+ shows: as soon as the formatting requirements are becomming more complex
+ output generation is getting more and more challanging in terms of readability,
+ maintainabilty, and flexibility of the code. Last, but not least, it turns
+ out that code using Spirit.Karma runs much faster
+ than equivalent code using either of the 'straight' methods mentioned above
+ (see here for some numbers: <a class="link" href="../performance_measurements/numeric_performance.html" title="Performance of Numeric Generators">Performance
+ of Numeric Generators</a>)
+ 
+
+ You might argue that more complex tasks require more complex tools. But
+ this turns out to be not the case! The whole Spirit library is designed
+ to be simple to use, while being scalable from trivial to very complicated
+ applications.
+ 
+
+ In terms of development simplicity and ease in deployment, the same is
+ true for Spirit.Karma as has been described elsewhere
+ in this docs for Spirit.Qi: the entire library consists
+ of only header files, with no libraries to link against or build. Just
+ put the spirit distribution in your include path, compile and run. Code
+ size? -very tight -essentially comparable to hand written code.
+ 
+
+ The Spirit.Karma tutorials are build in a walk through
+ style, starting with elementary things growing step by step in complexity.
+ And again: keep in mind output generation is the exact opposite to parsing.
+ Everything you already learnt about parsing using Spirit.Qi
+ is applicable to generating formatted output using Spirit.Karma.
+ All you have to do is to look at Spirit.Karma as being
+ a mirrored imaged of Spirit.Qi.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../tutorials.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="warming_up.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/tutorials/semantic_actions.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/tutorials/semantic_actions.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,306 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Semantic Actions</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="warming_up.html" title="Warming up">
+<link rel="next" href="karma_complex.html" title="Complex - A first more complex generator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="warming_up.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="karma_complex.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Semantic Actions">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.tutorials.semantic_actions"></a><a class="link" href="semantic_actions.html" title="Semantic Actions">Semantic Actions</a>
+</h4></div></div></div>
+
+ In the previous section we mentioned a very important difference between
+ parsers and generators. While parsers may be used without 'producing' any
+ data, generators alsways need data to generate the output from. We mentioned
+ one way of passing data to the generator by supplying it as a parameter
+ to one of the main API functions (for instance <code class="computeroutput">generate()</code> or <code class="computeroutput">generate_delimited()</code>). But sometimes this is not possible
+ or not desireable.
+ 
+
+ Very much like for Spirit.Qi we have semantic actions
+ in Spirit.Karma as well. Semantic actions may be attached
+ to any point in the grammar specification. These actions are C++ functions
+ or function objects that are called whenever a part of the generator is
+ about to be invoked. Say you have a generator <code class="computeroutput">G</code>,
+ and a C++ function <code class="computeroutput">F</code>, you
+ can make the generator call <code class="computeroutput">F</code>
+ just before it gets invoked by attaching <code class="computeroutput">F</code>:
+ 
+<pre class="programlisting">G[F]
+</pre>
+
+ The expression above links <code class="computeroutput">F</code>
+ to the generator, <code class="computeroutput">G</code>.
+ 
+
+ Semantic actions in Spirit.Qi are invoked after a
+ parser successfully matches its input and the matched value is passed into
+ the semantic action. In Spirit.Karma the opposite
+ happens. Semantic actions are called before its associated generator is
+ invoked. They may provide the data to be generated to the generator.
+ 
+
+ The function/function object signature depends on the type of the generator
+ to which it is attached. The generator <code class="computeroutput">double_</code>
+ expects the number to generate. Thus, if we were to attach a function
+ <code class="computeroutput">F</code> to <code class="computeroutput">double_</code>,
+ we need <code class="computeroutput">F</code> to be declared
+ as:
+ 
+<pre class="programlisting">void F(double& n);
+</pre>
+
+ where the function is expected to initialize the parameter <code class="computeroutput">n</code> with the value to generate.
+ 
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ Generally, and more formally, the semantic action <code class="computeroutput">F</code>
+ attached to a generator <code class="computeroutput">G</code>
+ needs to take a reference to the generators attribute type as its first
+ parameter. For more information about generator attributes please see
+ the section Generator Attributes.
+ 
+
+ In the example above the function F takes a <code class="computeroutput">double&</code> as its first parameter as the attribute
+ of the <code class="computeroutput">double_</code> generator
+ happens to be a <code class="computeroutput">double</code>.
+ 
+</td></tr>
+</table></div>
+
+ There are actually 2 more arguments being passed (the generator context
+ and a reference to a boolean 'pass' parameter). We don't need these, for
+ now, but we'll see more on these other arguments later. Spirit.Karma
+ allows us to bind a single argument function, like above. The other arguments
+ are simply ignored.
+ 
+
+ Overall, the possible signatures for semantic actions are:
+ 
+<pre class="programlisting">void f(Attr&);
+void f(Attr&, Context&);
+void f(Attr&, Context&, bool&);
+</pre>
+
+ In the following example we present various ways to attach semantic actions:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Using plain function pointer
+ </li>
+<li class="listitem">
+ Using simple function object
+ </li>
+<li class="listitem">
+ Using Boost.Bind with
+ a plain function
+ </li>
+<li class="listitem">
+ Using Boost.Bind with
+ a member function
+ </li>
+<li class="listitem">
+ Using Boost.Lambda
+</li>
+</ul></div>
+
+ Let's assume we have:
+ 
+
+ 
+
+
+
+<pre class="programlisting">namespace client
+{
+ namespace karma = boost::spirit::karma;
+
+ // A plain function
+ void read_function(int& i)
+ {
+ i = 42;
+ }
+
+ // A member function
+ struct reader
+ {
+ void print(int& i) const
+ {
+ i = 42;
+ }
+ };
+
+ // A function object
+ struct read_action
+ {
+ void operator()(int& i, unused_type, unused_type) const
+ {
+ i = 42;
+ }
+ };
+}
+</pre>
+
+ 
+
+ 
+
+ Take note that with function objects, we need to have an <code class="computeroutput">operator()</code>
+ with 3 arguments. Since we don't care about the other two, we can use
+ <code class="computeroutput">unused_type</code> for these.
+ We'll see more of <code class="computeroutput">unused_type</code>
+ elsewhere. Get used to it. <code class="computeroutput">unused_type</code>
+ is a Spirit supplied support class. Most of the time it stands for 'I don't
+ care, just use the appropriate default'.
+ 
+
+ All following examples generate outputs of the form:
+ 
+<pre class="programlisting">"{integer}"
+</pre>
+
+ An integer inside the curly braces.
+ 
+
+ The first example shows how to attach a plain function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">generate(outiter, '{' << int_[&read_function] << '}');
+</pre>
+
+ 
+
+ 
+
+ What's new? Well <code class="computeroutput">int_</code> is
+ the sibbling of <code class="computeroutput">double_</code>.
+ I'm sure you can guess what this generator does and what type of attribute
+ it expects.
+ 
+
+ The next example shows how to attach a simple function object:
+ 
+
+ 
+
+
+
+<pre class="programlisting">generate(outiter, '{' << int_[read_action()] << '}');
+</pre>
+
+ 
+
+ 
+
+ We can use Boost.Bind
+ to 'bind' member functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">reader r;
+generate(outiter, '{' << int_[boost::bind(&reader::print, &r, _1)] << '}');
+</pre>
+
+ 
+
+ 
+
+ Likewise, we can also use Boost.Bind
+ to 'bind' plain functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">generate(outiter, '{' << int_[boost::bind(&read_function, _1)] << '}');
+</pre>
+
+ 
+
+ 
+
+ And last but not least, we can also use Boost.Lambda:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::stringstream strm("42");
+generate(outiter, '{' << int_[strm >> lambda::_1] << '}');
+</pre>
+
+ 
+
+ 
+
+ There are more ways to bind semantic action functions, but the examples
+ above are the most common. Attaching semantic actions is the first hurdle
+ one has to tackle when getting started with generating with Spirit. If
+ you didn't do so yet, it is probably a good idea to familiarize yourself
+ with the tools behind it such as Boost.Bind
+ and Boost.Lambda.
+ 
+
+ The examples above can be found here: actions.cpp
+ 
+<a name="spirit.karma.tutorials.semantic_actions.phoenix"></a><h6>
+<a name="id714514"></a>
+ <a class="link" href="semantic_actions.html#spirit.karma.tutorials.semantic_actions.phoenix">Phoenix</a>
+ </h6>
+
+ Phoenix, a companion
+ library bundled with Spirit, is specifically suited for binding semantic
+ actions. It is like Boost.Lambda
+ on steroids, with special custom features that make it easy to integrate
+ semantic actions with Spirit. If your requirements go beyond simple to
+ moderate generation, I suggest you use this library. Examples presented
+ henceforth shall be using the Phoenix library exclusively.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="warming_up.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="karma_complex.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/karma/tutorials/warming_up.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/karma/tutorials/warming_up.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,316 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Warming up</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="quick_start.html" title="Quick Start">
+<link rel="next" href="semantic_actions.html" title="Semantic Actions">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_start.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Warming up">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.karma.tutorials.warming_up"></a><a class="link" href="warming_up.html" title="Warming up">Warming up</a>
+</h4></div></div></div>
+
+ Learning how to use Spirit.Karma is really simple.
+ We will start from trivial examples, ramping up as we go.
+ 
+<a name="spirit.karma.tutorials.warming_up.trivial_example__1_generating_a_number"></a><h6>
+<a name="id711074"></a>
+ <a class="link" href="warming_up.html#spirit.karma.tutorials.warming_up.trivial_example__1_generating_a_number">Trivial
+ Example #1 Generating a number</a>
+ </h6>
+
+ Let's create a generator that will output a floating-point number:
+ 
+<pre class="programlisting">double_
+</pre>
+
+ Easy huh? The above code actually instantiates a Spirit floating point
+ generator (a built-in generator). Spirit has many pre-defined generators
+ and consistent naming conventions will help you finding your way through
+ the maze. Especially important to note is that things related to identical
+ entities (as in this case, floating point numbers) are named identically
+ in Spirit.Karma and in Spirit.Qi.
+ Actually, both libraries are using the very same variable instance to refer
+ to a floating point generator or parser: <code class="computeroutput">double_</code>.
+ 
+<a name="spirit.karma.tutorials.warming_up.trivial_example__2_generating_two_numbers"></a><h6>
+<a name="id711117"></a>
+ <a class="link" href="warming_up.html#spirit.karma.tutorials.warming_up.trivial_example__2_generating_two_numbers">Trivial
+ Example #2 Generating two numbers</a>
+ </h6>
+
+ Now, let's create a generator that will output a line consisting of two
+ floating-point numbers.
+ 
+<pre class="programlisting">double_ << double_
+</pre>
+
+ Here you see the familiar floating-point numeric generator <code class="computeroutput">double_</code> used twice, once for each number.
+ If you are used to see the <code class="computeroutput">'>>'</code>
+ operator for concatenating two parsers in Spirit.Qi
+ you might wonder, what's that <code class="computeroutput">'<<'</code>
+ operator doing in there? We decided to distinguish generating and parsing
+ of sequences the same way as the std::stream libraries do: we use operator
+ <code class="computeroutput">'>>'</code> for input (parsing),
+ and operator <code class="computeroutput">'<<'</code> for output
+ (generating). Other than that there is no significant difference. The above
+ program creates a generator from two simpler generators, glueing them together
+ with the sequence operator. The result is a generator that is a composition
+ of smaller generators. Whitespace between numbers can implicitly be inserted
+ depending on how the generator is invoked (see below).
+ 
+<div class="note" title="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">
+ When we combine generators, we end up with a "bigger" generator,
+ but it's still a generator. Generators can get bigger and bigger, nesting
+ more and more, but whenever you glue two generators together, you end
+ up with one bigger generator. This is an important concept.
+ </td></tr>
+</table></div>
+<a name="spirit.karma.tutorials.warming_up.trivial_example__3_generating_one_or_more_numbers"></a><h6>
+<a name="id711202"></a>
+ <a class="link" href="warming_up.html#spirit.karma.tutorials.warming_up.trivial_example__3_generating_one_or_more_numbers">Trivial
+ Example #3 Generating one or more numbers</a>
+ </h6>
+
+ Now, creating output for two numbers is not too interesting. Let's create
+ a generator that will output zero or more floating-point numbers in a row.
+ 
+<pre class="programlisting">*double_
+</pre>
+
+ This is like a regular-expression Kleene Star. We moved the <code class="computeroutput">*</code> to the front for the same reasons we did
+ in Spirit.Qi: we must work with the syntax rules of
+ C++. But if you know regular expressions (and for sure you remember those
+ C++ syntax rules) it will start to look very familiar in a matter of a
+ very short time.
+ 
+
+ Any expression that evaluates to a generator may be used with the Kleene
+ Star. Keep in mind, though, that due to C++ operator precedence rules you
+ may need to put the expression in parentheses for complex expressions.
+ As above, whitespace can be inserted implicitely in between the generated
+ numbers, if needed.
+ 
+<a name="spirit.karma.tutorials.warming_up.trivial_example__4_generating_a_comma_delimited_list_of_numbers"></a><h6>
+<a name="id711250"></a>
+ <a class="link" href="warming_up.html#spirit.karma.tutorials.warming_up.trivial_example__4_generating_a_comma_delimited_list_of_numbers">Trivial
+ Example #4 Generating a comma-delimited list of numbers</a>
+ </h6>
+
+ We follow the lead of Spirit.Qi's warming up section
+ and will create a generator that produces a comma-delimited list of numbers.
+ 
+<pre class="programlisting">double_ << *(lit(',') << double_)
+</pre>
+
+ Notice <code class="computeroutput">lit(',')</code>. It is
+ a literal character generator that simply generates the comma <code class="computeroutput">','</code>. In this case, the Kleene Star is modifying
+ a more complex generator, namely, the one generated by the expression:
+ 
+<pre class="programlisting">(lit(',') << double_)
+</pre>
+
+ Note that this is a case where the parentheses are necessary. The Kleene
+ Star encloses the complete expression above, repeating the whole pattern
+ in the generated output zero or more times.
+ 
+<a name="spirit.karma.tutorials.warming_up.let_s_generate_"></a><h6>
+<a name="id711385"></a>
+ <a class="link" href="warming_up.html#spirit.karma.tutorials.warming_up.let_s_generate_">Let's
+ Generate!</a>
+ </h6>
+
+ We're done with defining the generator. All what's left is to invoke the
+ generator to do its work. For now, we will use the <code class="computeroutput">generate_delimited</code>
+ function. One overload of this function accepts four arguments:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ An output iterator accepting the generated characters
+ </li>
+<li class="listitem">
+ The generator expression
+ </li>
+<li class="listitem">
+ Another generator called the delimiting generator
+ </li>
+<li class="listitem">
+ The data to format and output
+ </li>
+</ol></div>
+
+ While comparing this minimal example with an equivalent parser example
+ we notice a significant difference. It is possible (and actually, it makes
+ a lot of sense) to use a parser without creating any internal representation
+ of the parsed input (i.e. without 'producing' any data from the parsed
+ input). Using a parser in this mode checks the provided input against the
+ given parser expression allowing to verify whether the input is parsable.
+ For generators this mode doesn't make any sense. What is output generation
+ without generating any output? So we always will have to supply the data
+ the output should be generated from. In our example we supply a vector
+ of <code class="computeroutput">double</code> numbers as the last
+ parameter to the function <code class="computeroutput">generate_delimited</code>
+ (see code below).
+ 
+
+ In this example, we wish to delimit the generated numbers by spaces. Another
+ generator named <code class="computeroutput">space</code> is
+ included in Spirit's repertoire of predefined generators. It is a very
+ trivial generator that simply produces spaces. It is the equivalent to
+ writing <code class="computeroutput">lit(' ')</code>, or simply
+ <code class="computeroutput">' '</code>. It has been implemented
+ for similarity with the corresponding predefined <code class="computeroutput">space</code>
+ parser. We will use <code class="computeroutput">space</code>
+ as our delimiter. The delimiter is the one responsible for inserting characters
+ in between generator elements such as the <code class="computeroutput">double_</code>
+ and <code class="computeroutput">lit</code>.
+ 
+
+ Ok, so now let's generate (for the complete source code of this example
+ please refer to num_list1.cpp).
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename OutputIterator>
+bool generate_numbers(OutputIterator sink, std::list<double> const& v)
+{
+ using karma::double_;
+ using karma::generate_delimited;
+ using ascii::space;
+
+ bool r = generate_delimited(
+ sink, <a class="co" name="spirit4co" href="warming_up.html#spirit4"><img src="../../../../../../../doc/src/images/callouts/1.png" alt="1" border="0"></a>
+ double_ << *(',' << double_), <a class="co" name="spirit5co" href="warming_up.html#spirit5"><img src="../../../../../../../doc/src/images/callouts/2.png" alt="2" border="0"></a>
+ space, <a class="co" name="spirit6co" href="warming_up.html#spirit6"><img src="../../../../../../../doc/src/images/callouts/3.png" alt="3" border="0"></a>
+ v <a class="co" name="spirit7co" href="warming_up.html#spirit7"><img src="../../../../../../../doc/src/images/callouts/4.png" alt="4" border="0"></a>
+ );
+ return r;
+}
+</pre>
+
+ 
+
+ 
+
+ 
+<div class="calloutlist"><table border="0" summary="Callout list">
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit4"></a> </td>
+<td valign="top" align="left"> destination: output iterator </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit5"></a> </td>
+<td valign="top" align="left"> the generator </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit6"></a> </td>
+<td valign="top" align="left"> the delimiter-generator </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit7"></a> </td>
+<td valign="top" align="left"> the
+ data to output </td>
+</tr>
+</table></div>
+
+ 
+
+ 
+
+ The generate function returns <code class="computeroutput">true</code>
+ or <code class="computeroutput">false</code> depending on the
+ result of the output generation. As outlined in different places of this
+ documentation, a generator may fail for different reasons. One of the possible
+ reasons is an error in the underlying output iterator (memory exhausted
+ or disk full, etc.). Another reason might be that the data doesn't match
+ the requirements of a particular generator.
+ 
+<div class="note" title="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">
+
+ <code class="computeroutput">char</code> and <code class="computeroutput">wchar_t</code>
+ operands
+ 
+
+ The careful reader may notice that the parser expression has <code class="computeroutput">','</code> instead of <code class="computeroutput">lit(',')</code>
+ as the previous examples did. This is ok due to C++ syntax rules of conversion.
+ Spirit provides <code class="computeroutput"><<</code>
+ operators that are overloaded to accept a <code class="computeroutput">char</code>
+ or <code class="computeroutput">wchar_t</code> argument on its
+ left or right (but not both). An operator may be overloaded if at least
+ one of its parameters is a user-defined type. In this case, the <code class="computeroutput">double_</code> is the 2nd argument to <code class="computeroutput">operator<<</code>,
+ and so the proper overload of <code class="computeroutput"><<</code>
+ is used, converting <code class="computeroutput">','</code> into
+ a character literal parser.
+ 
+
+ The problem with omiting the <code class="computeroutput">lit</code>
+ should be obvious: <code class="computeroutput">'a' <<
+ 'b'</code> is not a spirit generator, it
+ is a numeric expression, left-shifting the ASCII (or another encoding)
+ value of <code class="computeroutput">'a'</code> by the ASCII value
+ of <code class="computeroutput">'b'</code>. However, both <code class="computeroutput">lit('a') <<
+ 'b'</code> and <code class="computeroutput">'a'
+ << lit('b')</code>
+ are Spirit sequence generators for the letter <code class="computeroutput">'a'</code>
+ followed by <code class="computeroutput">'b'</code>. You'll get
+ used to it, sooner or later.
+ 
+</td></tr>
+</table></div>
+
+ Note that we inlined the generator directly in the call to <code class="computeroutput">generate_delimited</code>. Upon calling this
+ function, the expression evaluates into a temporary, unnamed generator
+ which is passed into the <code class="computeroutput">generate_delimited</code>
+ function, used, and then destroyed.
+ 
+
+ Here, we chose to make the generate function generic by making it a template,
+ parameterized by the output iterator type. By doing so, it can put the
+ generated data into any STL conforming output iterator.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_start.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,93 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lex - Writing Lexical Analyzers</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="karma/performance_measurements/numeric_performance/format_performance.html" title="Comparing the performance of a sequence of several generators">
+<link rel="next" href="lex/lexer_introduction.html" title="Introduction to Spirit.Lex">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="karma/performance_measurements/numeric_performance/format_performance.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lex/lexer_introduction.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lex - Writing Lexical Analyzers">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.lex"></a><a class="link" href="lex.html" title="Lex - Writing Lexical Analyzers"> Lex - Writing Lexical Analyzers</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt> Introduction to Spirit.Lex</dt>
+<dt><a href="lex/tutorials.html"> Spirit.Lex
+ Tutorials</a></dt>
+<dd><dl>
+<dt><a href="lex/tutorials/lexer_tutorials.html"> Spirit.Lex
+ Tutorials Overview</a></dt>
+<dt><a href="lex/tutorials/lexer_quickstart1.html"> Quickstart
+ 1 - A word counter using Spirit.Lex</a></dt>
+<dt><a href="lex/tutorials/lexer_quickstart2.html"> Quickstart
+ 2 - A better word counter using Spirit.Lex</a></dt>
+<dt><a href="lex/tutorials/lexer_quickstart3.html"> Quickstart
+ 3 - Counting Words Using a Parser</a></dt>
+</dl></dd>
+<dt> Abstracts</dt>
+<dd><dl>
+<dt>Lexer Primitives</dt>
+<dt><a href="lex/abstracts/lexer_tokenizing.html"> Tokenizing
+ Input Data</a></dt>
+<dt><a href="lex/abstracts/lexer_semantic_actions.html"> Lexer
+ Semantic Actions</a></dt>
+<dt><a href="lex/abstracts/lexer_static_model.html"> The Static
+ Lexer Model</a></dt>
+<dt><a href="lex/abstracts/lexer_parsing.html"> Parsing using
+ a Lexer</a></dt>
+<dt> Lexer Attributes</dt>
+<dt> Lexer States</dt>
+</dl></dd>
+<dt> Quick Reference</dt>
+<dd><dl>
+<dt><a href="lex/quick_reference/common_notation.html">Common
+ Notation</a></dt>
+<dt><a href="lex/quick_reference/lexers.html"> Primitive Lexer
+ Components</a></dt>
+<dt><a href="lex/quick_reference/semantic_actions.html">Semantic
+ Actions</a></dt>
+<dt>Phoenix</dt>
+</dl></dd>
+<dt> Reference</dt>
+<dd><dl>
+<dt> Lexer Concepts</dt>
+<dt> Basics</dt>
+<dt><a href="lex/reference/primitives.html"> Token definition
+ Primitives</a></dt>
+<dt> Lexer Class</dt>
+<dt> Token Class</dt>
+<dt> TokenDef Class</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="karma/performance_measurements/numeric_performance/format_performance.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lex/lexer_introduction.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,57 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Abstracts</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lex.html" title="Lex - Writing Lexical Analyzers">
+<link rel="prev" href="tutorials/lexer_quickstart3.html" title="Quickstart 3 - Counting Words Using a Parser">
+<link rel="next" href="abstracts/lexer_primitives.html" title="Lexer Primitives">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="tutorials/lexer_quickstart3.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="abstracts/lexer_primitives.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Abstracts">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.lex.abstracts"></a><a class="link" href="abstracts.html" title="Abstracts"> Abstracts</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt>Lexer Primitives</dt>
+<dt><a href="abstracts/lexer_tokenizing.html"> Tokenizing
+ Input Data</a></dt>
+<dt><a href="abstracts/lexer_semantic_actions.html"> Lexer
+ Semantic Actions</a></dt>
+<dt><a href="abstracts/lexer_static_model.html"> The Static
+ Lexer Model</a></dt>
+<dt><a href="abstracts/lexer_parsing.html"> Parsing using
+ a Lexer</a></dt>
+<dt> Lexer Attributes</dt>
+<dt> Lexer States</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="tutorials/lexer_quickstart3.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="abstracts/lexer_primitives.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_attributes.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_attributes.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,42 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lexer Attributes</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="lexer_parsing.html" title="Parsing using a Lexer">
+<link rel="next" href="lexer_states.html" title="Lexer States">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_parsing.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_states.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lexer Attributes"><div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.abstracts.lexer_attributes"></a><a class="link" href="lexer_attributes.html" title="Lexer Attributes"> Lexer Attributes</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_parsing.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_states.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_parsing.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_parsing.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,43 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Parsing using a Lexer</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="lexer_static_model.html" title="The Static Lexer Model">
+<link rel="next" href="lexer_attributes.html" title="Lexer Attributes">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_static_model.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_attributes.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Parsing using a Lexer"><div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.abstracts.lexer_parsing"></a><a class="link" href="lexer_parsing.html" title="Parsing using a Lexer"> Parsing using
+ a Lexer</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_static_model.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_attributes.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,52 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lexer Primitives</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="../abstracts.html" title="Abstracts">
+<link rel="next" href="lexer_primitives/lexer_primitives.html" title="Lexer Primitives">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../abstracts.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_primitives/lexer_primitives.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lexer Primitives">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.abstracts.lexer_primitives"></a><a class="link" href="lexer_primitives.html" title="Lexer Primitives">Lexer Primitives</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="lexer_primitives/lexer_primitives.html">
+ Lexer Primitives</a></dt>
+<dt><a href="lexer_primitives/lexer_token_values.html">
+ About Tokens and Token Values</a></dt>
+<dt><a href="lexer_primitives/lexer_token_definition.html">
+ Ways to define Tokens</a></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../abstracts.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_primitives/lexer_primitives.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_primitives.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_primitives.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,43 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lexer Primitives</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lexer_primitives.html" title="Lexer Primitives">
+<link rel="prev" href="../lexer_primitives.html" title="Lexer Primitives">
+<link rel="next" href="lexer_token_values.html" title="About Tokens and Token Values">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../lexer_primitives.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_primitives.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_token_values.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lexer Primitives"><div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.lex.abstracts.lexer_primitives.lexer_primitives"></a><a class="link" href="lexer_primitives.html" title="Lexer Primitives">
+ Lexer Primitives</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../lexer_primitives.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_primitives.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_token_values.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_token_definition.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_token_definition.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,43 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Ways to define Tokens</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lexer_primitives.html" title="Lexer Primitives">
+<link rel="prev" href="lexer_token_values.html" title="About Tokens and Token Values">
+<link rel="next" href="../lexer_tokenizing.html" title="Tokenizing Input Data">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_token_values.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_primitives.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../lexer_tokenizing.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Ways to define Tokens"><div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.lex.abstracts.lexer_primitives.lexer_token_definition"></a><a class="link" href="lexer_token_definition.html" title="Ways to define Tokens">
+ Ways to define Tokens</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_token_values.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_primitives.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../lexer_tokenizing.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_token_values.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_primitives/lexer_token_values.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,367 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>About Tokens and Token Values</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lexer_primitives.html" title="Lexer Primitives">
+<link rel="prev" href="lexer_primitives.html" title="Lexer Primitives">
+<link rel="next" href="lexer_token_definition.html" title="Ways to define Tokens">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_primitives.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_primitives.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_token_definition.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="About Tokens and Token Values">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.lex.abstracts.lexer_primitives.lexer_token_values"></a><a class="link" href="lexer_token_values.html" title="About Tokens and Token Values">
+ About Tokens and Token Values</a>
+</h5></div></div></div>
+
+ As already discussed, lexical scanning is the process of analyzing the
+ stream of input characters and separating it into strings called tokens,
+ most of the time separated by whitespace. The different token types recognized
+ by a lexical analyzer often get assigned unique integer token identifiers
+ (token ids). These token ids arenormally used by the parser to identifiy
+ the current token without having to look at the matched string again.
+ The Spirit.Lex library is not different with respect
+ to this, as it uses the token ids as the main means of identification
+ of the different token types defined for a particular lexical analyzer.
+ However, it is different from commonly used lexical analyzers in the
+ sense that it returns (references to) instances of a (user defined) token
+ class to the user. The only real limitation posed on this token class
+ is consequently, that it has to carry at least the token id of the token
+ it represents. For more information about the interface a user defined
+ token type has to expose please look at the <a class="link" href="../../reference/token.html" title="Token Class">Token
+ Class</a> reference. The library provides a default token type based
+ on the Lexertl
+ library which should be sufficient in most use cases: the <a class="link" href="../../reference/token.html" title="Token Class"><code class="computeroutput">lexertl_token<></code></a>
+ type. This section focusses on the description of general features a
+ token class may implement and how this integrates with the other parts
+ of the Spirit.Lex library.
+ 
+<a name="spirit.lex.abstracts.lexer_primitives.lexer_token_values.the_anatomy_of_a_token"></a><h6>
+<a name="id862574"></a>
+ <a class="link" href="lexer_token_values.html#spirit.lex.abstracts.lexer_primitives.lexer_token_values.the_anatomy_of_a_token">The
+ Anatomy of a Token</a>
+ </h6>
+
+ It is very important to understand the difference between a token definition
+ (represented by the <a class="link" href="../../reference/tokendef.html" title="TokenDef Class"><code class="computeroutput">token_def<></code></a>
+ template) and a token itself (for instance represented by the <a class="link" href="../../reference/token.html" title="Token Class"><code class="computeroutput">lexertl_token<></code></a>
+ template).
+ 
+
+ The token definition is used to describe the main features of a particular
+ token type, especially:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ to simplify the definition of a token type using a regular expression
+ pattern applied while matching this token type,
+ </li>
+<li class="listitem">
+ to associate a token type with a particular lexer state,
+ </li>
+<li class="listitem">
+ to optionally assign a token id to a token type,
+ </li>
+<li class="listitem">
+ to optionally associate some code to execute whenever an instance of
+ this token type has been matched,
+ </li>
+<li class="listitem">
+ and to optionally specify the attribute type of the token value.
+ </li>
+</ul></div>
+
+ The token itself is a data structure returned by the lexer iterators.
+ Dereferencing a lexer iterator returns a reference to the last matched
+ token instance. It encapsulates the part of the underlying input sequence
+ matched by the regular expression used during the definiton of this token
+ type. Incrementing the lexer iterator invokes the lexical analyzer to
+ match the next token by advancing the underlying input stream. The token
+ data structure contains at least the token id of the matched token type,
+ allowing to identify the matched character sequence. Optionally, the
+ token instance may contain a token value and/or the lexer state this
+ token instance was matched in. The following <a class="link" href="lexer_token_values.html#spirit.lex.tokenstructure" title="Figure 8. The structure of a token">figure</a>
+ shows the schematic structure of a token.
+ 
+
+ 
+<div class="figure">
+<a name="spirit.lex.tokenstructure"></a>Figure 8. The structure of a token
+<div class="figure-contents"><img src="../../../.././images/tokenstructure.png" alt="The structure of a token"></div>
+</div>
+ 
+ 
+
+ The token value and the lexer state the token has been recogniyed in
+ may be omitted for optimization reasons, avoiding the token to carry
+ more data than actually required. This configuration can be achieved
+ by supplying appropriate template parameters for the <a class="link" href="../../reference/token.html" title="Token Class"><code class="computeroutput">lexertl_token<></code></a>
+ template while defining the token type.
+ 
+
+ The lexer iterator returns the same token type for each of the different
+ matched token definitions. To accomodate for the possibly different token
+ value types exposed by the various token types (token
+ definitions), the general type of the token value is a Boost.Variant.
+ As a minimum (for the default configuration) this token value variant
+ will be configured to always hold a boost::iterator_range containing the
+ pair of iterators pointing to the matched input sequence for this token
+ instance.
+ 
+<div class="note" title="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">
+ If the lexical analyzer is used in conjunction with a Spirit.Qi
+ parser, the stored boost::iterator_range token value
+ will be converted to the requested token type (parser attribute) exactly
+ once. This happens at the time of the first access to the token value
+ requiring the corresponding type conversion. The converted token value
+ will be stored in the Boost.Variant
+ replacing the initially stored iterator range. This avoids to convert
+ the input sequence to the token value more than once, thus optimizing
+ the integration of the lexer with Spirit.Qi, even
+ during parser backtracking.
+ </td></tr>
+</table></div>
+
+ Here is the template prototype of the <a class="link" href="../../reference/token.html" title="Token Class"><code class="computeroutput">lexertl_token<></code></a>
+ template:
+ 
+<pre class="programlisting">template <
+ typename Iterator = char const*,
+ typename AttributeTypes = mpl::vector0<>,
+ typename HasState = mpl::true_
+>
+struct lexertl_token;
+</pre>
+<div class="variablelist" title="where:">
+where:
+<dl>
+<dt>Iterator</dt>
+<dd>
+ This is the type of the iterator used to access the underlying input
+ stream. It defaults to a plain <code class="computeroutput">char
+ const*</code>.
+ </dd>
+<dt>AttributeTypes</dt>
+<dd>
+ This is either a mpl sequence containing all attribute types used
+ for the token definitions or the type <code class="computeroutput">omit</code>.
+ If the mpl sequence is empty (which is the default), all token instances
+ will store a boost::iterator_range<code class="computeroutput"><Iterator></code> pointing to the start and the
+ end of the matched section in the input stream. If the type is <code class="computeroutput">omit</code>, the generated tokens will
+ contain no token value (attribute) at all.
+ </dd>
+<dt>HasState</dt>
+<dd>
+ This is either <code class="computeroutput">mpl::true_</code>
+ or <code class="computeroutput">mpl::false_</code>, allowing to control whether
+ the generated token instances will contain the lexer state they were
+ generated in. The default is mpl::true_, so all token instances will
+ contain the lexer state.
+ </dd>
+</dl>
+</div>
+
+ Normally, during its construction, a token instance always holds the
+ boost::iterator_range as its token
+ value (except, if it has been defined using the <code class="computeroutput">omit</code>
+ token value type). This iterator range then is converted in place to
+ the requested token value type (attribute) when it is requested for the
+ first time.
+ 
+<a name="spirit.lex.abstracts.lexer_primitives.lexer_token_values.the_physiognomy_of_a_token_definition"></a><h6>
+<a name="id863067"></a>
+ <a class="link" href="lexer_token_values.html#spirit.lex.abstracts.lexer_primitives.lexer_token_values.the_physiognomy_of_a_token_definition">The
+ Physiognomy of a Token Definition</a>
+ </h6>
+
+ The token definitions (represented by the <a class="link" href="../../reference/tokendef.html" title="TokenDef Class"><code class="computeroutput">token_def<></code></a>
+ template) are normally used as part of the definition of the lexical
+ analyzer. At the same time a token definition instance may be used as
+ a parser component in Spirit.Qi.
+ 
+
+ The template prototype of this class is shown here:
+ 
+<pre class="programlisting">template<
+ typename Attribute = unused_type,
+ typename Char = char
+>
+class token_def;
+</pre>
+<div class="variablelist" title="where:">
+where:
+<dl>
+<dt>Attribute</dt>
+<dd>
+ This is the type of the token value (attribute) supported by token
+ instances representing this token type. This attribute type is exposed
+ to the Spirit.Qi library, whenever this token
+ definition is used as a parser component. The default attribute type
+ is <code class="computeroutput">unused_type</code>, which
+ means the token instance holds a boost::iterator_range pointing
+ to the start and the end of the matched section in the input stream.
+ If the attribute is <code class="computeroutput">omit</code>
+ the token instance will expose no token type at all. Any other type
+ will be used directly as the token value type.
+ </dd>
+<dt>Char</dt>
+<dd>
+ This is the value type of the iterator for the underlying input sequence.
+ It defaults to <code class="computeroutput">char</code>.
+ </dd>
+</dl>
+</div>
+
+ The semantics of the template parameters for the token type and the token
+ definition type are very similar and interdependent. As a rule of thumb
+ you can think of the token definition type as the means of specifying
+ everything related to a single specific token type (such as <code class="computeroutput">identifier</code> or <code class="computeroutput">integer</code>).
+ On the other hand the token type is used to define the general proerties
+ of all token instances generated by the Spirit.Lex
+ library.
+ 
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ If you don't list any token value types in the token type definition
+ declaration (resulting in the usage of the default boost::iterator_range token type)
+ everything will compile and work just fine, just a bit less efficient.
+ This is because the token value will be converted from the matched
+ input sequence every time it is requested.
+ 
+
+ But as soon as you specify at least one token value type while defining
+ the token type you'll have to list all value types used for <a class="link" href="../../reference/tokendef.html" title="TokenDef Class"><code class="computeroutput">token_def<></code></a>
+ declarations in the token definition class, otherwise compilation errors
+ will occur.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.lex.abstracts.lexer_primitives.lexer_token_values.examples_of_using__link_linkend__spirit_lex_reference_token___code__phrase_role__identifier__lexertl_token__phrase__phrase_role__special___lt__gt___phrase___code___link_"></a><h6>
+<a name="id863318"></a>
+ <a class="link" href="lexer_token_values.html#spirit.lex.abstracts.lexer_primitives.lexer_token_values.examples_of_using__link_linkend__spirit_lex_reference_token___code__phrase_role__identifier__lexertl_token__phrase__phrase_role__special___lt__gt___phrase___code___link_">Examples
+ of using <a class="link" href="../../reference/token.html" title="Token Class"><code class="computeroutput">lexertl_token<></code></a></a>
+ </h6>
+
+ Let's start with some examples. We refer to one of the Spirit.Lex
+ examples (for the full source code of this example please see example4.cpp).
+ 
+
+ The first code snippet shows an excerpt of the token definition class,
+ the definition of a couple of token types. Some of the token types do
+ not expose a special token value (<code class="computeroutput">if_</code>,
+ <code class="computeroutput">else_</code>, and <code class="computeroutput">while_</code>). Their token value will always
+ hold the iterator range of the matched input sequence only. The token
+ definitions for the <code class="computeroutput">identifier</code>
+ and the integer <code class="computeroutput">constant</code>
+ are specialized to expose an explicit token type each: <code class="computeroutput">std::string</code> and <code class="computeroutput">unsigned
+ int</code>.
+ 
+
+ 
+
+
+
+<pre class="programlisting">// these tokens expose the iterator_range of the matched input sequence
+token_def<> if_, else_, while_;
+
+// The following two tokens have an associated attribute type, 'identifier'
+// carries a string (the identifier name) and 'constant' carries the
+// matched integer value.
+//
+// Note: any token attribute type explicitly specified in a token_def<>
+// declaration needs to be listed during token type definition as
+// well (see the typedef for the token_type below).
+//
+// The conversion of the matched input to an instance of this type occurs
+// once (on first access), which makes token attributes as efficient as
+// possible. Moreover, token instances are constructed once by the lexer
+// library. From this point on tokens are passed by reference only,
+// avoiding them being copied around.
+token_def<std::string> identifier;
+token_def<unsigned int> constant;
+</pre>
+
+ 
+
+ 
+
+ As the parsers generated by Spirit.Qi are fully
+ attributed, any Spirit.Qi parser component needs
+ to expose a certain type as its parser attribute. Naturally, the <a class="link" href="../../reference/tokendef.html" title="TokenDef Class"><code class="computeroutput">token_def<></code></a> exposes the token value
+ type as its parser attribute, enabling a smooth integration with Spirit.Qi.
+ 
+
+ The next code snippet demonstrates how the required token value types
+ are specified while defining the token type to use. All of the token
+ value types used for at least one of the token definitions have to be
+ re-iterated for the token definition as well.
+ 
+
+ 
+
+
+
+<pre class="programlisting">// This is the lexer token type to use. The second template parameter lists
+// all attribute types used for token_def's during token definition (see
+// calculator_tokens<> above). Here we use the predefined lexertl token
+// type, but any compatible token type may be used instead.
+//
+// If you don't list any token attribute types in the following declaration
+// (or just use the default token type: lexertl_token<base_iterator_type>)
+// it will compile and work just fine, just a bit less efficient. This is
+// because the token attribute will be generated from the matched input
+// sequence every time it is requested. But as soon as you specify at
+// least one token attribute type you'll have to list all attribute types
+// used for token_def<> declarations in the token definition class above,
+// otherwise compilation errors will occur.
+typedef lexertl::token<
+ base_iterator_type, boost::mpl::vector<unsigned int, std::string>
+> token_type;
+</pre>
+
+ 
+
+ 
+
+ To avoid the token to have a token value at all, the special tag <code class="computeroutput">omit</code> can be used: <code class="computeroutput">token_def<omit></code> and <code class="computeroutput">lexertl_token<base_iterator_type, omit></code>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_primitives.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_primitives.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_token_definition.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_semantic_actions.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_semantic_actions.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,500 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lexer Semantic Actions</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="lexer_tokenizing.html" title="Tokenizing Input Data">
+<link rel="next" href="lexer_static_model.html" title="The Static Lexer Model">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_tokenizing.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_static_model.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lexer Semantic Actions">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.abstracts.lexer_semantic_actions"></a><a class="link" href="lexer_semantic_actions.html" title="Lexer Semantic Actions"> Lexer
+ Semantic Actions</a>
+</h4></div></div></div>
+
+ The main task of a lexer normally is to recognize tokens in the input.
+ Traditionally this has been complemented with the possibility to execute
+ arbitrary code whenever a certain token has been detected. Spirit.Lex
+ has been designed to support this mode of operation as well. We borrow
+ from the concept of semantic actions for parsers (Spirit.Qi)
+ and generators (Spirit.Karma). Lexer semantic actions
+ may be attached to any token definition. These are C++ functions or function
+ objects that are called whenever a token definition successfully recognizes
+ a portion of the input. Say you have a token definition <code class="computeroutput">D</code>,
+ and a C++ function <code class="computeroutput">f</code>, you
+ can make the lexer call <code class="computeroutput">f</code>
+ whenever it matches an input by attaching <code class="computeroutput">f</code>:
+ 
+<pre class="programlisting">D[f]
+</pre>
+
+ The expression above links <code class="computeroutput">f</code>
+ to the token definition, <code class="computeroutput">D</code>.
+ The required prototype of <code class="computeroutput">f</code>
+ is:
+ 
+<pre class="programlisting">void f (Iterator& start, Iterator& end, pass_flag& matched, Idtype& id, Context& ctx);
+</pre>
+<div class="variablelist" title="where:">
+where:
+<dl>
+<dt><code class="computeroutput">Iterator& start</code></dt>
+<dd>
+ This is a the iterator pointing to the begin of the matched range in
+ the underlying input sequence. The type of the iterator is the same
+ as specified while defining the type of the <code class="computeroutput">lexertl_lexer<...></code> (its first template parameter).
+ The semantic action is allowed to change the value of this iterator
+ influencing, the matched input sequence.
+ </dd>
+<dt><code class="computeroutput">Iterator& end</code></dt>
+<dd>
+ This is a the iterator pointing to the end of the matched range in
+ the underlying input sequence. The type of the iterator is the same
+ as specified while defining the type of the <code class="computeroutput">lexertl_lexer<...></code> (its first template parameter).
+ The semantic action is allowed to change the value of this iterator
+ influencing, the matched input sequence.
+ </dd>
+<dt><code class="computeroutput">pass_flag& matched</code></dt>
+<dd>
+ This value is pre/initialized to <code class="computeroutput">pass_normal</code>.
+ If the semantic action sets it to <code class="computeroutput">pass_fail</code>
+ the behaves as if the token has not been matched in the first place.
+ If the semantic action sets this to <code class="computeroutput">pass_ignore</code>
+ the lexer ignores the current token and tries to match a next token
+ from the input.
+ </dd>
+<dt><code class="computeroutput">Idtype& id</code></dt>
+<dd>
+ This is the token id of the type Idtype (most of the time this will
+ be a <code class="computeroutput">std::size_t</code>) for the matched token. The
+ semantic action is allowed to change the value of this token id, influencing
+ the if of the created token.
+ </dd>
+<dt><code class="computeroutput">Context& ctx</code></dt>
+<dd>
+ This is a reference to a lexer specific, unspecified type, providing
+ the context for the current lexer state. It can be used to access different
+ internal data items and is needed for lexer state control from inside
+ a semantic action.
+ </dd>
+</dl>
+</div>
+
+ When using a C++ function as the semantic action the following prototypes
+ are allowed as well:
+ 
+<pre class="programlisting">void f (Iterator& start, Iterator& end, pass_flag& matched, Idtype& id);
+void f (Iterator& start, Iterator& end, pass_flag& matched);
+void f (Iterator& start, Iterator& end);
+void f ();
+</pre>
+<a name="spirit.lex.abstracts.lexer_semantic_actions.the_context_of_a_lexer_semantic_action"></a><h6>
+<a name="id869192"></a>
+ <a class="link" href="lexer_semantic_actions.html#spirit.lex.abstracts.lexer_semantic_actions.the_context_of_a_lexer_semantic_action">The
+ context of a lexer semantic action</a>
+ </h6>
+
+ The last parameter passed to any lexer semantic action is a reference to
+ an unspecified type (see the <code class="computeroutput">Context</code>
+ type in the table above). This type is unspecified because it depends on
+ the token type returned by the lexer. It is implemented in the internals
+ of the iterator type exposed by the lexer. Nevertheless, any context type
+ is expected to expose a couple of functions allowing to influence the behavior
+ of the lexer. The following table gives an overview and a short description
+ of the available functionality.
+ 
+<div class="table">
+<a name="id869212"></a>Table 8. Functions exposed by any context passed to a lexer
+ semantic action
+<div class="table-contents"><table class="table" summary="Functions exposed by any context passed to a lexer
+ semantic action">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Name
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Iterator const& get_eoi() const</code>
+ 
+ </td>
+<td>
+ 
+ The function <code class="computeroutput">get_eoi()</code> may be used by to access the end
+ iterator of the input stream the lexer has been initialized with
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">void more()</code>
+ 
+ </td>
+<td>
+ 
+ The function <code class="computeroutput">more()</code> tells the lexer that the next time
+ it matches a rule, the corresponding token should be appended onto
+ the current token value rather than replacing it.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Iterator const& less(Iterator
+ const&
+ it,
+ int n)</code>
+ 
+ </td>
+<td>
+ 
+ The function <code class="computeroutput">less()</code> returns an iterator positioned
+ to the nth input character beyond the current token start iterator
+ (i.e. by passing the return value to the parameter <code class="computeroutput">end</code> it is possible to return all
+ but the first n characters of the current token back to the input
+ stream.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">bool lookahead(std::size_t
+ id)</code>
+ 
+ </td>
+<td>
+ 
+ The function <code class="computeroutput">lookahead()</code> can be for instance used to implement
+ lookahead for lexer engines not supporting constructs like flex'
+ <code class="computeroutput">a/b</code> (match <code class="computeroutput">a</code>,
+ but only when followed by <code class="computeroutput">b</code>).
+ It invokes the lexer on the input following the current token without
+ actually moving forward in the input stream. The function returns
+ whether the lexer was able to match a token with the given token-id
+ <code class="computeroutput">id</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::size_t get_state() const</code>
+ and <code class="computeroutput">void set_state(std::size_t
+ state)</code>
+ 
+ </td>
+<td>
+ 
+ The functions <code class="computeroutput">get_state()</code> and <code class="computeroutput">set_state()</code> may be used to introspect and change
+ the current lexer state.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">token_value_type get_value()
+ const</code> and <code class="computeroutput">void
+ set_value(Value const&)</code>
+ 
+ </td>
+<td>
+ 
+ The functions <code class="computeroutput">get_value()</code> and <code class="computeroutput">set_value()</code> may be used to introspect and change
+ the current token value.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ <a name="spirit.lex.abstracts.lexer_semantic_actions.lexer_semantic_actions_using_phoenix"></a><h6>
+<a name="id869730"></a>
+ <a class="link" href="lexer_semantic_actions.html#spirit.lex.abstracts.lexer_semantic_actions.lexer_semantic_actions_using_phoenix">Lexer
+ Semantic Actions Using Phoenix</a>
+ </h6>
+
+ Even if it is possible to write your own function object implementations
+ (i.e. using Boost.Lambda or Boost.Bind), the preferred way of defining
+ lexer semantic actions is to use Boost.Phoenix.
+ In this case you can access the parameters described above by using the
+ predefined Spirit placeholders:
+ 
+<div class="table">
+<a name="id869753"></a>Table 9. Predefined Phoenix placeholders for lexer semantic
+ actions
+<div class="table-contents"><table class="table" summary="Predefined Phoenix placeholders for lexer semantic
+ actions">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Placeholder
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">_start</code>
+ 
+ </td>
+<td>
+ 
+ Refers to the iterator pointing to the begin of the matched input
+ sequence. Any modifications to this iterator value will be reflected
+ in the generated token.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">_end</code>
+ 
+ </td>
+<td>
+ 
+ Refers to the iterator pointing past the end of the matched input
+ sequence. Any modifications to this iterator value will be reflected
+ in the generated token.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">_pass</code>
+ 
+ </td>
+<td>
+ 
+ References the value signaling the outcome of the semantic action.
+ This is pre-initialized to <code class="computeroutput">lex::pass_flags::pass_normal</code>.
+ If this is set to <code class="computeroutput">lex::pass_flags::pass_fail</code>,
+ the lexer will behave as if no token has been matched, if is set
+ to <code class="computeroutput">lex::pass_flags::pass_ignore</code>, the lexer will ignore
+ the current match and proceed trying to match tokens from the input.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">_tokenid</code>
+ 
+ </td>
+<td>
+ 
+ Refers to the token id of the token to be generated. Any modifications
+ to this value will be reflected in the generated token.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">_val</code>
+ 
+ </td>
+<td>
+ 
+ Refers to the value the next token will be initialized from. Any
+ modifications to this value will be reflected in the generated token.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">_state</code>
+ 
+ </td>
+<td>
+ 
+ Refers to the lexer state the input has been match in. Any modifications
+ to this value will be reflected in the lexer itself (the next match
+ will start in the new state). The currently generated token is not
+ affected by changes to this variable.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">_eoi</code>
+ 
+ </td>
+<td>
+ 
+ References the end iterator of the overall lexer input. This value
+ cannot be changed.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ 
+ The context object passed as the last parameter to any lexer semantic action
+ is not directly accessible while using Boost.Phoenix
+ expressions. We rather provide predefine Phoenix functions allowing to
+ invoke the different support functions as mentioned above. The following
+ table lists the available support functions and describes their functionality:
+ 
+<div class="table">
+<a name="id870032"></a>Table 10. Support functions usable from Phoenix expressions
+ inside lexer semantic actions
+<div class="table-contents"><table class="table" summary="Support functions usable from Phoenix expressions
+ inside lexer semantic actions">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Plain function
+ 
+ </th>
+<th>
+ 
+ Phoenix function
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ctx.more()</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">more()</code>
+ 
+ </td>
+<td>
+ 
+ The function <code class="computeroutput">more()</code> tells the lexer that the next time
+ it matches a rule, the corresponding token should be appended onto
+ the current token value rather than replacing it.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ctx.less()</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">less(n)</code>
+ 
+ </td>
+<td>
+ 
+ The function <code class="computeroutput">less()</code> takes a single integer parameter
+ <code class="computeroutput">n</code> and returns an
+ iterator positioned to the nth input character beyond the current
+ token start iterator (i.e. by assigning the return value to the placeholder
+ <code class="computeroutput">_end</code> it is possible
+ to return all but the first <code class="computeroutput">n</code>
+ characters of the current token back to the input stream.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ctx.lookahead()</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">lookahead(std::size_t)</code>
+ or <code class="computeroutput">lookahead(token_def)</code>
+ 
+ </td>
+<td>
+ 
+ The function <code class="computeroutput">lookahead()</code> takes a single parameter specifying
+ the token to match in the input. The function can be used for instance
+ to implement lookahead for lexer engines not supporting constructs
+ like flex' <code class="computeroutput">a/b</code> (match <code class="computeroutput">a</code>,
+ but only when followed by <code class="computeroutput">b</code>).
+ It invokes the lexer on the input following the current token without
+ actually moving forward in the input stream. The function returns
+ whether the lexer was able to match the specified token.
+ 
+ </td>
+</tr>
+</tbody>
+</table></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_tokenizing.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_static_model.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_states.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_states.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,59 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lexer States</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="lexer_attributes.html" title="Lexer Attributes">
+<link rel="next" href="../quick_reference.html" title="Quick Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_attributes.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lexer States">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.abstracts.lexer_states"></a><a class="link" href="lexer_states.html" title="Lexer States"> Lexer States</a>
+</h4></div></div></div>
+<a name="spirit.lex.abstracts.lexer_states.controlling_the_lexer_state_from_lexer_semantic_actions"></a><h6>
+<a name="id872882"></a>
+ <a class="link" href="lexer_states.html#spirit.lex.abstracts.lexer_states.controlling_the_lexer_state_from_lexer_semantic_actions">Controlling
+ the Lexer State from Lexer Semantic Actions</a>
+ </h6>
+<a name="spirit.lex.abstracts.lexer_states.controlling_the_lexer_state_from_parser_semantic_actions"></a><h6>
+<a name="id872895"></a>
+ <a class="link" href="lexer_states.html#spirit.lex.abstracts.lexer_states.controlling_the_lexer_state_from_parser_semantic_actions">Controlling
+ the Lexer State from Parser Semantic Actions</a>
+ </h6>
+<a name="spirit.lex.abstracts.lexer_states.using_a_lexer_state_for_the_skip_parser"></a><h6>
+<a name="id872909"></a>
+ <a class="link" href="lexer_states.html#spirit.lex.abstracts.lexer_states.using_a_lexer_state_for_the_skip_parser">Using
+ a Lexer State for the Skip Parser</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_attributes.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_static_model.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_static_model.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,367 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>The Static Lexer Model</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="lexer_semantic_actions.html" title="Lexer Semantic Actions">
+<link rel="next" href="lexer_parsing.html" title="Parsing using a Lexer">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_parsing.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="The Static Lexer Model">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.abstracts.lexer_static_model"></a><a class="link" href="lexer_static_model.html" title="The Static Lexer Model"> The Static
+ Lexer Model</a>
+</h4></div></div></div>
+
+ The documentation of Spirit.Lex so far mostly was
+ about describing the features of the dynamic model,
+ where the tables needed for lexical analysis are generated from the regular
+ expressions at runtime. The big advantage of the dynamic model is its flexibility,
+ and its integration with the Spirit
+ library and the C++ host language. Its big disadvantage is the need to
+ spend additional runtime to generate the tables, which especially might
+ be a limitation for larger lexical analyers. The static
+ model strives to build upon the smooth integration with Spirit
+ and C++, and reuses large parts of the Spirit.Lex
+ library as described so far, while overcoming the additional runtime requirements
+ by using pre-generated tables and tokenizer routines. To make the code
+ generation as simple as possible, it is possible reuse the token definition
+ types developed using the dynamic model without any
+ changes. As will be shown in this section, building a code generator based
+ on an existing token definition type is a matter of writing 3 lines of
+ code.
+ 
+
+ Assuming you already built a dynamic lexer for your problem, there are
+ two more steps needed to create a static lexical analyzer using Spirit.Lex:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ generating the C++ code for the static analyzer (including the tokenization
+ function and corresponding tables), and
+ </li>
+<li class="listitem">
+ modifying the dynamic lexical anlyzer to use the generated code.
+ </li>
+</ol></div>
+
+ Both steps are described in more detail in the two sections below (for
+ the full source code used in this example see the code here: <a href="../../../../../example/lex/static_lexer/word_count_tokens.hpp" target="_top">the
+ common token definition</a>, <a href="../../../../../example/lex/static_lexer/word_count_generate.cpp" target="_top">the
+ code generator</a>, <a href="../../../../../example/lex/static_lexer/word_count_static.hpp" target="_top">the
+ generated code</a>, and <a href="../../../../../example/lex/static_lexer/word_count_static.cpp" target="_top">the
+ static lexical analyzer</a>).
+ 
+
+ But first we provide the code snippets needed to understand the further
+ descriptions. Both, the definition of the used token identifier and the
+ of the token definition class in this example are put into a separate header
+ file to make these available to the code generator and the static lexical
+ analyzer.
+ 
+
+ 
+
+
+
+<pre class="programlisting">enum tokenids
+{
+ IDANY = boost::spirit::lex::min_token_id + 1,
+};
+</pre>
+
+ 
+
+ 
+
+ The important point here is, that the token definition class is not different
+ from a similar class to be used for a dynamic lexical analyzer. The library
+ has been designed in a way, that all components (dynamic lexical analyzer,
+ code generator, and static lexical analyzer) can reuse the very same token
+ definition syntax.
+ 
+
+ 
+
+
+
+<pre class="programlisting">// This token definition class can be used without any change for all three
+// possible use cases: a dynamic lexical analyzer, a code generator, and a
+// static lexical analyzer.
+template <typename BaseLexer>
+struct word_count_tokens : boost::spirit::lex::lexer<BaseLexer>
+{
+ word_count_tokens()
+ : word_count_tokens::base_type(
+ boost::spirit::lex::match_flags::match_not_dot_newline)
+ {
+ // define tokens and associate them with the lexer
+ word = "[^ \t\n]+";
+ this->self = word | '\n' | boost::spirit::lex::token_def<>(".", IDANY);
+ }
+
+ boost::spirit::lex::token_def<std::string> word;
+};
+</pre>
+
+ 
+
+ 
+
+ The only thing changing between the three different use cases is the template
+ parameter used to instantiate a concrete token definition. Fot the dynamic
+ model and the code generator you probably will use the <a class="link" href="../reference/lexer.html#spirit.lex.reference.lexer.the_lexertl__lexer_class_implementing_the_dynamic_model"><code class="computeroutput">lexertl_lexer<></code></a>
+ template, where for the static model you will use the <a class="link" href="../reference/lexer.html#spirit.lex.reference.lexer.the_lexertl__static_lexer_class_implementing_the_static_model"><code class="computeroutput">lexertl_static_lexer<></code></a>
+ type as the template parameter.
+ 
+
+ This example not only shows how to build a static lexer, but it additionally
+ demonstrates how such a lexer can be used for parsing in conjunction with
+ a Spirit.Qi grammar. For completeness we provide the
+ simple grammar used in this example. As you can see, this grammar does
+ not have any dependencies on the static lexical analyzer, and for this
+ reason it is not different from a grammar used either without a lexer or
+ using a dynamic lexical analyzer as described before.
+ 
+
+ 
+
+
+
+<pre class="programlisting">// This is an ordinary grammar definition following the rules defined by
+// Spirit.Qi. There is nothing specific about it, except it gets the token
+// definition class instance passed to the constructor to allow accessing the
+// embedded token_def<> instances.
+template <typename Iterator>
+struct word_count_grammar : grammar<Iterator>
+{
+ template <typename TokenDef>
+ word_count_grammar(TokenDef const& tok)
+ : word_count_grammar::base_type(start)
+ , c(0), w(0), l(0)
+ {
+ using boost::phoenix::ref;
+ using boost::phoenix::size;
+
+ // associate the defined tokens with the lexer, at the same time
+ // defining the actions to be executed
+ start = *( tok.word [ ++ref(w), ref(c) += size(_1) ]
+ | lit('\n') [ ++ref(l), ++ref(c) ]
+ | token(IDANY) [ ++ref(c) ]
+ )
+ ;
+ }
+
+ std::size_t c, w, l; // counter for characters, words, and lines
+ rule<Iterator> start;
+};
+</pre>
+
+ 
+
+ 
+<a name="spirit.lex.abstracts.lexer_static_model.generating_the_static_analyzer"></a><h6>
+<a name="id871519"></a>
+ <a class="link" href="lexer_static_model.html#spirit.lex.abstracts.lexer_static_model.generating_the_static_analyzer">Generating
+ the Static Analyzer</a>
+ </h6>
+
+ The first additional step to perform in order to create a static lexical
+ analyzer is to create a small standalone program for creating the lexer
+ tables and the corresponding tokenization function. For this purpose the
+ Spirit.Lex library exposes a special API - the function
+ <a class="link" href="../../../"><code class="computeroutput">generate_static()</code></a>.
+ It implements the whole code generator, no further code is needed. All
+ what it takes to invoke this function is to supply a token definition instance,
+ an output stream to use to generate the code to, and an optional string
+ to be used as a suffix for the name of the generated function. All in all
+ just a couple lines of code.
+ 
+
+ 
+
+
+
+<pre class="programlisting">int main(int argc, char* argv[])
+{
+ // create the lexer object instance needed to invoke the generator
+ word_count_tokens<lexertl::lexer<> > word_count; // the token definition
+
+ // open the output file, where the generated tokenizer function will be
+ // written to
+ std::ofstream out(argc < 2 ? "word_count_static.hpp" : argv[1]);
+
+ // invoke the generator, passing the token definition, the output stream
+ // and the name suffix of the tables and functions to be generated
+ //
+ // The suffix "wc" used below results in a type lexertl::static_::lexer_wc
+ // to be generated, which needs to be passed as a template parameter to the
+ // lexertl::static_lexer template (see word_count_static.cpp).
+ return lexertl::generate_static(word_count, out, "wc") ? 0 : -1;
+}
+</pre>
+
+ 
+
+ 
+
+ The shown code generator will generate output, which should be stored in
+ a file for later inclusion into the static lexical analzyer as shown in
+ the next topic (the full generated code can be viewed here).
+ 
+<div class="note" title="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">
+ The generated code will have compiled in the version number of the current
+ Spirit.Lex library. This version number is used
+ at compilation time of your static lexer object to ensure this is compiled
+ using exactly the same version of the Spirit.Lex
+ library as the lexer tables have been generated with. If the versions
+ do not match you will see an compilation error mentioning an <code class="computeroutput">incompatible_static_lexer_version</code>.
+ </td></tr>
+</table></div>
+<a name="spirit.lex.abstracts.lexer_static_model.modifying_the_dynamic_analyzer"></a><h6>
+<a name="id871868"></a>
+ <a class="link" href="lexer_static_model.html#spirit.lex.abstracts.lexer_static_model.modifying_the_dynamic_analyzer">Modifying
+ the Dynamic Analyzer</a>
+ </h6>
+
+ The second required step to convert an existing dynamic lexer into a static
+ one is to change your main program at two places. First, you need to change
+ the type of the used lexer (that is the template parameter used while instantiating
+ your token definition class). While in the dynamic model we have been using
+ the <a class="link" href="../reference/lexer.html#spirit.lex.reference.lexer.the_lexertl__lexer_class_implementing_the_dynamic_model"><code class="computeroutput">lexertl_lexer<></code></a>
+ template, we now need to change that to the <a class="link" href="../reference/lexer.html#spirit.lex.reference.lexer.the_lexertl__static_lexer_class_implementing_the_static_model"><code class="computeroutput">lexertl_static_lexer<></code></a>
+ type. The second change is tightly related to the first one and involves
+ correcting the corresponding <code class="computeroutput">#include</code>
+ statement to:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/lex_static_lexertl.hpp>
+</pre>
+
+ 
+
+ 
+
+ Otherwise the main program is not different from an equivalent program
+ using the dynamic model. This feature makes it really easy for instance
+ to develop the lexer in dynamic mode and to switch to the static mode after
+ the code has been stabilized. The simple generator application showed above
+ enables the integration of the code generator into any existing build process.
+ The following code snippet provides the overall main function, highlighting
+ the code to be changed.
+ 
+
+ 
+
+
+
+<pre class="programlisting">int main(int argc, char* argv[])
+{
+ // Define the token type to be used: 'std::string' is available as the type
+ // of the token value.
+ typedef lexertl::token<
+ char const*, boost::mpl::vector<std::string>
+ > token_type;
+
+ // Define the lexer type to be used as the base class for our token
+ // definition.
+ //
+ // This is the only place where the code is different from an equivalent
+ // dynamic lexical analyzer. We use the `lexertl::static_lexer<>` instead of
+ // the `lexertl::lexer<>` as the base class for our token defintion type.
+ //
+ // As we specified the suffix "wc" while generating the static tables we
+ // need to pass the type lexertl::static_::lexer_wc as the second template
+ // parameter below (see word_count_generate.cpp).
+ typedef lexertl::static_lexer<
+ token_type, lexertl::static_::lexer_wc
+ > lexer_type;
+
+ // Define the iterator type exposed by the lexer.
+ typedef word_count_tokens<lexer_type>::iterator_type iterator_type;
+
+ // Now we use the types defined above to create the lexer and grammar
+ // object instances needed to invoke the parsing process.
+ word_count_tokens<lexer_type> word_count; // Our lexer
+ word_count_grammar<iterator_type> g (word_count); // Our parser
+
+ // Read in the file into memory.
+ std::string str (read_from_file(1 == argc ? "word_count.input" : argv[1]));
+ char const* first = str.c_str();
+ char const* last = &first[str.size()];
+
+ // Parsing is done based on the the token stream, not the character stream.
+ bool r = tokenize_and_parse(first, last, word_count, g);
+
+ if (r) { // success
+ std::cout << "lines: " << g.l << ", words: " << g.w
+ << ", characters: " << g.c << "\n";
+ }
+ else {
+ std::string rest(first, last);
+ std::cerr << "Parsing failed\n" << "stopped at: \""
+ << rest << "\"\n";
+ }
+ return 0;
+}
+</pre>
+
+ 
+
+ 
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The generated code for the static lexer contains the token ids as these
+ have been assigned either explicitly by the programmer or implicitely
+ during lexer construction. It is your responsibility to make sure that
+ all instances of a particular static lexer type use exactly the same
+ token ids. This is ensured by default as long as no <code class="computeroutput">first_id</code>
+ is specified during construction of the static lexer instances (the constructor
+ of the lexer object has a seocnd default parameter allowing to designate
+ a starting token id to be used while assigning the ids to the token definitions).
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_parsing.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_tokenizing.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/abstracts/lexer_tokenizing.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,250 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Tokenizing Input Data</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../abstracts.html" title="Abstracts">
+<link rel="prev" href="lexer_primitives/lexer_token_definition.html" title="Ways to define Tokens">
+<link rel="next" href="lexer_semantic_actions.html" title="Lexer Semantic Actions">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_primitives/lexer_token_definition.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Tokenizing Input Data">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.abstracts.lexer_tokenizing"></a><a class="link" href="lexer_tokenizing.html" title="Tokenizing Input Data"> Tokenizing
+ Input Data</a>
+</h4></div></div></div>
+<a name="spirit.lex.abstracts.lexer_tokenizing.the_tokenize_function"></a><h6>
+<a name="id863845"></a>
+ <a class="link" href="lexer_tokenizing.html#spirit.lex.abstracts.lexer_tokenizing.the_tokenize_function">The
+ tokenize function</a>
+ </h6>
+
+ The <code class="computeroutput">tokenize()</code>
+ function is a helper function simplifying the usage of a lexer in a standalone
+ fashion. Consider you have a standalone lexer where all the required functionality
+ is implemented inside of lexer semantic actions. A good example for this
+ is the word_count_lexer
+ described in more detail in the section <a class="link" href="../tutorials/lexer_quickstart2.html" title="Quickstart 2 - A better word counter using Spirit.Lex">Lex
+ Quickstart 2 - A better word counter using Spirit.Lex</a>.
+ As a reminder, here is the token definition class:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Lexer>
+struct word_count_tokens : lexer<Lexer>
+{
+ word_count_tokens()
+ : c(0), w(0), l(0)
+ , word("[^ \t\n]+") // define tokens
+ , eol("\n")
+ , any(".")
+ {
+ using boost::spirit::lex::_start;
+ using boost::spirit::lex::_end;
+ using boost::phoenix::ref;
+
+ // associate tokens with the lexer
+ this->self
+ = word [++ref(w), ref(c) += distance(_start, _end)]
+ | eol [++ref(c), ++ref(l)]
+ | any [++ref(c)]
+ ;
+ }
+
+ std::size_t c, w, l;
+ token_def<> word, eol, any;
+};
+</pre>
+
+ 
+
+ 
+
+ The construct used to tokenize the given input, while discarding all generated
+ tokens is a common application of the lexer. For this reason Spirit.Lex
+ exposes an API function <code class="computeroutput">tokenize()</code> minimizing the code required:
+ 
+<pre class="programlisting">// Read input from the given file
+std::string str (read_from_file(1 == argc ? "word_count.input" : argv[1]));
+
+word_count_tokens<lexer_type> word_count_lexer;
+std::string::iterator first = str.begin();
+
+// Tokenize all the input, while discarding all generated tokens
+bool r = tokenize(first, str.end(), word_count_lexer);
+</pre>
+
+ This code is completely equivalent to the more verbose version as shown
+ in the section <a class="link" href="../tutorials/lexer_quickstart2.html" title="Quickstart 2 - A better word counter using Spirit.Lex">Lex
+ Quickstart 2 - A better word counter using Spirit.Lex</a>.
+ The function <code class="computeroutput">tokenize()</code>
+ will return either if the end of the input has been reached (in this case
+ the return value will be <code class="computeroutput">true</code>),
+ or if the lexer couldn't match any of the token definitions in the input
+ (in this case the return value will be <code class="computeroutput">false</code>
+ and the iterator <code class="computeroutput">first</code>
+ will point to the first not matched character in the input sequence).
+ 
+
+ The prototype of this function is:
+ 
+<pre class="programlisting">template <typename Iterator, typename Lexer>
+bool tokenize(Iterator& first, Iterator last, Lexer const& lex
+ , typename Lexer::char_type const* initial_state = 0);
+</pre>
+<div class="variablelist" title="where:">
+where:
+<dl>
+<dt>Iterator& first</dt>
+<dd>
+ The begin of the input sequence to tokenize. The value of this iterator
+ will be updated by the lexer, pointing to the first not matched character
+ of the input after the function returns.
+ </dd>
+<dt>Iterator last</dt>
+<dd>
+ The end of the input sequence to tokenize.
+ </dd>
+<dt>Lexer const& lex</dt>
+<dd>
+ The lexer instance to use for tokenization.
+ </dd>
+<dt>Lexer::char_type const* initial_state</dt>
+<dd>
+ This optional parameter can be used to specify the initial lexer state
+ fo rthe tokenization.
+ </dd>
+</dl>
+</div>
+
+ A second overload of the <code class="computeroutput">tokenize()</code> function allows to specify any arbitrary
+ function or function object to be called for each of the generated tokens.
+ For some applications this is very useful, as it might avoid having lexer
+ semantic actions. For an example of how to use this function, please have
+ a look at word_count_functor.cpp:
+ 
+
+ 
+
+ The main function simply loads the given file into memory (as a <code class="computeroutput">std::string</code>), instantiates an instance of
+ the token definition template using the correct iterator type (<code class="computeroutput">word_count_tokens<char const*></code>), and finally calls <code class="computeroutput">lex::tokenize</code>, passing an instance of the
+ counter function object. The return value of <code class="computeroutput">lex::tokenize()</code> will be <code class="computeroutput">true</code>
+ if the whole input sequence has been successfully tokenized, and <code class="computeroutput">false</code> otherwise.
+ 
+
+ 
+
+
+
+<pre class="programlisting">int main(int argc, char* argv[])
+{
+ // these variables are used to count characters, words and lines
+ std::size_t c = 0, w = 0, l = 0;
+
+ // read input from the given file
+ std::string str (read_from_file(1 == argc ? "word_count.input" : argv[1]));
+
+ // create the token definition instance needed to invoke the lexical analyzer
+ word_count_tokens<lexertl::lexer<> > word_count_functor;
+
+ // tokenize the given string, the bound functor gets invoked for each of
+ // the matched tokens
+ char const* first = str.c_str();
+ char const* last = &first[str.size()];
+ bool r = tokenize(first, last, word_count_functor,
+ boost::bind(counter(), _1, boost::ref(c), boost::ref(w), boost::ref(l)));
+
+ // print results
+ if (r) {
+ std::cout << "lines: " << l << ", words: " << w
+ << ", characters: " << c << "\n";
+ }
+ else {
+ std::string rest(first, last);
+ std::cout << "Lexical analysis failed\n" << "stopped at: \""
+ << rest << "\"\n";
+ }
+ return 0;
+}
+</pre>
+
+ 
+
+ 
+
+ Here is the prototype of this <code class="computeroutput">tokenize()</code> function overload:
+ 
+<pre class="programlisting">template <typename Iterator, typename Lexer, typename F>
+bool tokenize(Iterator& first, Iterator last, Lexer const& lex, F f
+ , typename Lexer::char_type const* initial_state = 0);
+</pre>
+<div class="variablelist" title="where:">
+where:
+<dl>
+<dt>Iterator& first</dt>
+<dd>
+ The begin of the input sequence to tokenize. The value of this iterator
+ will be updated by the lexer, pointing to the first not matched character
+ of the input after the function returns.
+ </dd>
+<dt>Iterator last</dt>
+<dd>
+ The end of the input sequence to tokenize.
+ </dd>
+<dt>Lexer const& lex</dt>
+<dd>
+ The lexer instance to use for tokenization.
+ </dd>
+<dt>F f</dt>
+<dd>
+ A function or function object to be called for each matched token.
+ This function is expected to have the prototype: <code class="computeroutput">bool
+ f(Lexer::token_type);</code>
+ and should return <code class="computeroutput">false</code>
+ if the supplied token instance is invald (the <code class="computeroutput">tokenize()</code> function will return immediatly).
+ </dd>
+<dt>Lexer::char_type const* initial_state</dt>
+<dd>
+ This optional parameter can be used to specify the initial lexer state
+ fo rthe tokenization.
+ </dd>
+</dl>
+</div>
+<a name="spirit.lex.abstracts.lexer_tokenizing.the_generate_static_function"></a><h6>
+<a name="id867477"></a>
+ <a class="link" href="lexer_tokenizing.html#spirit.lex.abstracts.lexer_tokenizing.the_generate_static_function">The
+ generate_static function</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_primitives/lexer_token_definition.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../abstracts.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/lexer_introduction.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/lexer_introduction.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,248 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Introduction to Spirit.Lex</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lex.html" title="Lex - Writing Lexical Analyzers">
+<link rel="prev" href="../lex.html" title="Lex - Writing Lexical Analyzers">
+<link rel="next" href="tutorials.html" title="Spirit.Lex Tutorials">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../lex.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Introduction to Spirit.Lex">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.lex.lexer_introduction"></a><a class="link" href="lexer_introduction.html" title="Introduction to Spirit.Lex"> Introduction to Spirit.Lex</a>
+</h3></div></div></div>
+
+ Lexical scanning is the process of analyzing the stream of input characters
+ and separating it into strings called tokens, separated by whitespace. Most
+ compiler texts start here, and devote several chapters to discussing various
+ ways to build scanners. Spirit.Lex is a library built
+ to take care of the complexities of creating a lexer for your grammar (in
+ this documentation we will use the terms 'lexical analyzer', 'lexer' and
+ 'scanner' interchangably). All it needs to create a lexer is to know the
+ set of patterns describing the different tokens you want to recognize in
+ the input. To make this a bit more formal, here are some definitions:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ A token is a sequence of consecutive characters having a collective meaning.
+ Tokens may have attributes specific to the token type, carrying additional
+ information about the matched character sequence.
+ </li>
+<li class="listitem">
+ A pattern is a rule expressed as a regular expression and describing how
+ a particular token can be formed. For example, <code class="literal">[A-Za-z][A-Za-z_0-9]*</code>
+ is a pattern for a rule matching C++ identifiers.
+ </li>
+<li class="listitem">
+ Characters between tokens are called whitespace; these include spaces,
+ tabs, newlines, and formfeeds. Many people also count comments as whitespace,
+ though since some tools such as lint look at comments, this conflation
+ is not perfect.
+ </li>
+</ul></div>
+<a name="spirit.lex.lexer_introduction.why_use_a_separate_lexer_"></a><h5>
+<a name="id850040"></a>
+ <a class="link" href="lexer_introduction.html#spirit.lex.lexer_introduction.why_use_a_separate_lexer_">Why
+ Use a Separate Lexer?</a>
+ </h5>
+
+ Typically, lexical scanning is done in a separate module from the parser,
+ feeding the parser with a stream of input tokens only. Theoretically it is
+ not necessary implement this separation as in the end there is only one set
+ of syntactical rules defining the language, so in theory we could write the
+ whole parser in one module. In fact, Spirit.Qi allows
+ you to write parsers without using a lexer, parsing the input character stream
+ directly, and for the most part this is the way Spirit
+ has been used since its invention.
+ 
+
+ However, this separation has both practical and theoretical bases and proves
+ to be very useful in practical applications. In 1956, Noam Chomsky defined
+ the "Chomsky Hierarchy" of grammars:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Type 0: Unrestricted grammars (e.g., natural languages)
+ </li>
+<li class="listitem">
+ Type 1: Context-Sensitive grammars
+ </li>
+<li class="listitem">
+ Type 2: Context-Free grammars
+ </li>
+<li class="listitem">
+ Type 3: Regular grammars
+ </li>
+</ul></div>
+
+ The complexity of these grammars increases from regular grammars being the
+ simplest to unrestricted grammars being the most complex. Similarly, the
+ complexity of the recognizers for these grammars increases. Although, a few
+ features of some programming languages (such as C++) are Type 1, fortunately
+ for the most part programming languages can be described using only the Types
+ 3 and 2. The neat part about these two types is that they are well known
+ and the ways to parse them are well understood. It has been shown that any
+ regular grammar can be parsed using a state machine (finite automaton). Similarly,
+ context-free grammars can always be parsed using a push-down automaton (essentially
+ a state machine augmented by a stack).
+ 
+
+ In real programming languages and practical grammars the parts that can be
+ handled as regular expressions tend to be the lower-level parts, such as
+ the definition of an identifier or of an integer value:
+ 
+<pre class="programlisting">letter := [a-zA-Z]
+digit := [0-9]
+
+identifier := letter [ letter | digit ]*
+integer := digit+
+</pre>
+
+ Higher level parts of practical grammars tend to be more complex and can't
+ be implemented using plain regular expressions. We need to store information
+ on the built-in hardware stack while recursing the grammar hierarchy, and
+ that in fact this is the preferred approach used for top-down parsing. Since
+ it takes a different kind of abstract machine to parse the two types of grammars,
+ it proved to be efficient to separate the lexical scanner into a separate
+ module which is built around the idea of a state machine. The goal here is
+ to use the simplest parsing technique needed for the job.
+ 
+
+ Another, more practical, reason for separating the scanner from the parser
+ is the need for backtracking during parsing. The input data is a stream of
+ characters, which is often thought to be processed left to right without
+ any backtracking. Unfortunately, in practice most of the time that isn't
+ possible. Almost every language has certain keywords such as IF, FOR, and
+ WHILE. The decision if a certain character sequence actually comprises a
+ keyword or just an identifier often can be made only after seeing the first
+ delimiter after it. This already is a limited form of
+ backtracking, since we need to store the string long enough to be able to
+ make the decision. The same is true for more coarse grained language features
+ such as nested IF/ELSE statements, where the decision about to which IF belongs
+ the last ELSE statement can be made only after seeing the whole construct.
+ 
+
+ So the structure of a conventional compiler often involves splitting up the
+ functions of the lower-level and higher-level parsing. The lexical scanner
+ deals with things at the character level, collecting characters into strings,
+ converting character sequence into different representations as integers,
+ etc., and passing them along to the parser proper as indivisible tokens.
+ It's also considered normal to let the scanner do additional jobs, such as
+ identifying keywords, storing identifiers in tables, etc.
+ 
+
+ Now, Spirit follows this
+ structure, where Spirit.Lex can be used to implement
+ state machine based recognizers, while Spirit.Qi can
+ be used to build recognizers for context free grammars. Since both modules
+ are seemlessly integrated with each other and with the C++ target language
+ it is even possible to use the provided functionality to build more complex
+ grammar recognizers.
+ 
+<a name="spirit.lex.lexer_introduction.advantages_of_using__emphasis_spirit_lex__emphasis_"></a><h5>
+<a name="id850249"></a>
+ <a class="link" href="lexer_introduction.html#spirit.lex.lexer_introduction.advantages_of_using__emphasis_spirit_lex__emphasis_">Advantages
+ of using Spirit.Lex</a>
+ </h5>
+
+ The advantage of using Spirit.Lex to create the lexical
+ analyzer over using more traditional tools such as Flex
+ is its carefully crafted integration with the Spirit
+ library and the C++ host language. You don't need any external tools to generate
+ the code, your lexer will be perfectly integrated with the rest of your program,
+ making it possible to freely access any context information and data structure.
+ Since the C++ compiler sees all the code it will generate optimal code nomatter
+ what configuration options have been chosen by the user. Spirit.Lex
+ gives you the vast majority of features you could get from a similar Flex program without the need
+ to leave C++ as a host language:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The definition of tokens is done using regular expressions (patterns)
+ </li>
+<li class="listitem">
+ The token definitions can refer to special substitution strings (pattern
+ macros) simplifying pattern definitions
+ </li>
+<li class="listitem">
+ The generated lexical scanner may have multiple start states
+ </li>
+<li class="listitem">
+ It is possible to attach code to any of the token definitions; this code
+ gets executed whenever the corresponding token pattern has been matched
+ </li>
+</ul></div>
+
+ Even if it is possible to use Spirit.Lex to generate
+ C++ code representing the lexical analyzer (we will refer to that as the
+ static model, described in more detail in the section
+ <a class="link" href="abstracts/lexer_static_model.html" title="The Static Lexer Model">The Static
+ Model</a>) - a model very similar to the way Flex
+ operates - we will mainly focus on the opposite, the dynamic
+ model. You can directly integrate the token definitions into your C++ program,
+ building the lexical analyzer dynamically at runtime. The dynamic model is
+ something not supported by Flex
+ or other lexical scanner generators (such as re2c,
+ Ragel, etc.).
+ But it is very flexible and allows you to speed up the development of your
+ application.
+ 
+<a name="spirit.lex.lexer_introduction.the_library_structure_of__emphasis_spirit_lex__emphasis_"></a><h5>
+<a name="id850352"></a>
+ <a class="link" href="lexer_introduction.html#spirit.lex.lexer_introduction.the_library_structure_of__emphasis_spirit_lex__emphasis_">The
+ Library Structure of Spirit.Lex</a>
+ </h5>
+
+ The <a class="link" href="lexer_introduction.html#spirit.lexerflow" title="Figure 6. The Library structure and Common Flow of Information while using Spirit.Lex in an application">figure</a> below shows a high level
+ overview of how the Spirit.Lex library might be used
+ in an application. Spirit.Lex allows to create lexical
+ analyzers based on patterns. These patterns are regular expression based
+ rules used to define the different tokens to be recognized in the character
+ input sequence. The input sequence is expected to be provided to the lexical
+ analyzer as an arbitrary standard forward iterator. The lexical analyzer
+ itself exposes a standard forward iterator as well. The difference here is
+ that the exposed iterator provides access to the token sequence instead of
+ to the character sequence. The tokens in this sequence are constructed on
+ the fly by analyzing the underlying character sequence and matching this
+ to the patterns as defined by the application.
+ 
+
+ 
+<div class="figure">
+<a name="spirit.lexerflow"></a>Figure 6. The Library structure and Common Flow of Information while
+ using Spirit.Lex in an application
+<div class="figure-contents"><img src="../.././images/lexerflow.png" alt="The Library structure and Common Flow of Information while using Spirit.Lex in an application"></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../lex.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/quick_reference.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/quick_reference.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,60 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Quick Reference</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lex.html" title="Lex - Writing Lexical Analyzers">
+<link rel="prev" href="abstracts/lexer_states.html" title="Lexer States">
+<link rel="next" href="quick_reference/common_notation.html" title="Common Notation">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="abstracts/lexer_states.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="quick_reference/common_notation.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Quick Reference">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.lex.quick_reference"></a><a class="link" href="quick_reference.html" title="Quick Reference"> Quick Reference</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><a href="quick_reference/common_notation.html">Common
+ Notation</a></dt>
+<dt><a href="quick_reference/lexers.html"> Primitive Lexer
+ Components</a></dt>
+<dt><a href="quick_reference/semantic_actions.html">Semantic
+ Actions</a></dt>
+<dt>Phoenix</dt>
+</dl></div>
+
+ This quick reference section is provided for convenience. You can use this
+ section as a sort of a "cheat-sheet" on the most commonly used
+ Lex components. It is not intended to be complete, but should give you an
+ easy way to recall a particular component without having to dig up on pages
+ and pages of reference doumentation.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="abstracts/lexer_states.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="quick_reference/common_notation.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/common_notation.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/common_notation.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,103 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Common Notation</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="../quick_reference.html" title="Quick Reference">
+<link rel="next" href="lexers.html" title="Primitive Lexer Components">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexers.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Common Notation">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.quick_reference.common_notation"></a><a class="link" href="common_notation.html" title="Common Notation">Common
+ Notation</a>
+</h4></div></div></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">L</code></dt>
+<dd>
+ Lexer type
+ </dd>
+<dt><code class="computeroutput">l, a,
+ b,
+ c,
+ d</code></dt>
+<dd>
+ Lexer objects
+ </dd>
+<dt><code class="computeroutput">Iterator</code></dt>
+<dd>
+ The type of an iterator referring to the underlying input sequence
+ </dd>
+<dt><code class="computeroutput">IdType</code></dt>
+<dd>
+ The token id type
+ </dd>
+<dt><code class="computeroutput">Context</code></dt>
+<dd>
+ The lexer components <code class="computeroutput">Context</code>
+ type
+ </dd>
+<dt><code class="computeroutput">ch</code></dt>
+<dd>
+ Character-class specific character (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">Ch</code></dt>
+<dd>
+ Character-class specific character type (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">str</code></dt>
+<dd>
+ Character-class specific string (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">Str</code></dt>
+<dd>
+ Character-class specific string type (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">Attrib</code></dt>
+<dd>
+ An attribute type
+ </dd>
+<dt><code class="computeroutput">fa</code></dt>
+<dd>
+ A (semantic action) function with signature <code class="computeroutput">void
+ f(Iterator&,
+ Iterator&,
+ pass_flag&,
+ Idtype&,
+ Context&)</code>.
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexers.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/lexers.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/lexers.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,205 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Primitive Lexer Components</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="common_notation.html" title="Common Notation">
+<link rel="next" href="semantic_actions.html" title="Semantic Actions">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="common_notation.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Primitive Lexer Components">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.quick_reference.lexers"></a><a class="link" href="lexers.html" title="Primitive Lexer Components"> Primitive Lexer
+ Components</a>
+</h4></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ch</code>
+ 
+ </td>
+<td>
+ 
+ n/a
+ 
+ </td>
+<td>
+ 
+ Matches <code class="computeroutput">ch</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_(ch)</code>
+ 
+ </td>
+<td>
+ 
+ n/a
+ 
+ </td>
+<td>
+ 
+ Matches <code class="computeroutput">ch</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">str</code>
+ 
+ </td>
+<td>
+ 
+ n/a
+ 
+ </td>
+<td>
+ 
+ Matches regular expression <code class="computeroutput">str</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">string(str)</code>
+ 
+ </td>
+<td>
+ 
+ n/a
+ 
+ </td>
+<td>
+ 
+ Matches regular expression <code class="computeroutput">str</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">token_def<Attrib></code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Attrib</code>
+ 
+ </td>
+<td>
+ 
+ Matches the immediate argument
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">a |
+ b</code>
+ 
+ </td>
+<td>
+ 
+ n/a
+ 
+ </td>
+<td>
+ 
+ Matches any of the expressions <code class="computeroutput">a</code>
+ or <code class="computeroutput">b</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">l[fa]</code>
+ 
+ </td>
+<td>
+ 
+ Attribute of <code class="computeroutput">l</code>
+ 
+ </td>
+<td>
+ 
+ Call semantic action <code class="computeroutput">fa</code>
+ (after matching <code class="computeroutput">l</code>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ The column Attribute in the table above lists the
+ parser attribute exposed by the lexer component if it is used as a parser
+ (see Attribute). A 'n/a' in this columns means the lexer component is
+ not usable as a parser.
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="common_notation.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/phoenix.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/phoenix.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,100 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Phoenix</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="semantic_actions.html" title="Semantic Actions">
+<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"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Phoenix">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.quick_reference.phoenix"></a><a class="link" href="phoenix.html" title="Phoenix">Phoenix</a>
+</h4></div></div></div>
+
+ Boost.Phoenix makes
+ it easier to attach semantic actions. You just inline your lambda expressions:
+ 
+<pre class="programlisting">l[phoenix-lambda-expression]
+</pre>
+
+ Spirit.Lex provides some Boost.Phoenix
+ placeholders to access important information from the <code class="computeroutput">Context</code>
+ that are otherwise fiddly to extract.
+ 
+<div class="variablelist" title="Spirit.Lex specific Phoenix placeholders">
+Spirit.Lex specific Phoenix placeholders
+<dl>
+<dt><code class="computeroutput">_start, _end</code></dt>
+<dd>
+ Iterators pointing to the begin and the end of the matched input sequence.
+ </dd>
+<dt><code class="computeroutput">_pass</code></dt>
+<dd>
+ Assign <code class="computeroutput">false</code> to <code class="computeroutput">_pass</code> to force the current match
+ to fail.
+ </dd>
+<dt><code class="computeroutput">_tokenid</code></dt>
+<dd>
+ The token id of the matched token.
+ </dd>
+<dt><code class="computeroutput">_val</code></dt>
+<dd>
+ The token value of the matched token.
+ </dd>
+<dt><code class="computeroutput">_state</code></dt>
+<dd>
+ The lexer state the token has been matched in.
+ </dd>
+<dt><code class="computeroutput">_eoi</code></dt>
+<dd>
+ Iterator referring to the current end of the input sequence.
+ </dd>
+</dl>
+</div>
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+ All of the placeholders in the list above (except <code class="computeroutput">_eoi</code>)
+ can be changed from the inside of the semantic action allowing to modify
+ the lexer behavior.
+ </td></tr>
+</table></div>
+
+ For more information see <a class="link" href="../abstracts/lexer_semantic_actions.html" title="Lexer Semantic Actions">Lexer
+ Semantic Actions</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/semantic_actions.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/quick_reference/semantic_actions.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,79 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Semantic Actions</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="lexers.html" title="Primitive Lexer Components">
+<link rel="next" href="phoenix.html" title="Phoenix">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexers.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="phoenix.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Semantic Actions">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.quick_reference.semantic_actions"></a><a class="link" href="semantic_actions.html" title="Semantic Actions">Semantic
+ Actions</a>
+</h4></div></div></div>
+
+ Has the form:
+ 
+<pre class="programlisting">l[f]
+</pre>
+
+ where <code class="computeroutput">f</code> is a function with
+ the signatures:
+ 
+<pre class="programlisting">void f();
+void f(Iterator&, Iterator&);
+void f(Iterator&, Iterator&, pass_flag&);
+void f(Iterator&, Iterator&, pass_flag&, Idtype&);
+void f(Iterator&, Iterator&, pass_flag&, Idtype&, Context&);
+</pre>
+
+ You can use <code class="computeroutput">Boost.Bind</code>
+ to bind member functions. For function objects, the allowed signatures
+ are:
+ 
+<pre class="programlisting">void operator()(unused_type, unused_type, unused_type, unused_type, unused_type) const;
+void operator()(Iterator&, Iterator&, unused_type, unused_type, unused_type) const;
+void operator()(Iterator&, Iterator&, pass_flag&, unused_type, unused_type) const;
+void operator()(Iterator&, Iterator&, pass_flag&, Idtype&, unused_type) const;
+void operator()(Iterator&, Iterator&, pass_flag&, Idtype&, Context&) const;
+</pre>
+
+ The <code class="computeroutput">unused_type</code> is used
+ in the signatures above to signify 'don't care'.
+ 
+
+ For more information see <a class="link" href="../abstracts/lexer_semantic_actions.html" title="Lexer Semantic Actions">Lexer
+ Semantic Actions</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexers.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="phoenix.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,53 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Reference</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lex.html" title="Lex - Writing Lexical Analyzers">
+<link rel="prev" href="quick_reference/phoenix.html" title="Phoenix">
+<link rel="next" href="reference/lexer_concepts.html" title="Lexer Concepts">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_reference/phoenix.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/lexer_concepts.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Reference">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.lex.reference"></a><a class="link" href="reference.html" title="Reference"> Reference</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt> Lexer Concepts</dt>
+<dt> Basics</dt>
+<dt><a href="reference/primitives.html"> Token definition
+ Primitives</a></dt>
+<dt> Lexer Class</dt>
+<dt> Token Class</dt>
+<dt> TokenDef Class</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_reference/phoenix.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/lexer_concepts.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/lex_basics.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/lex_basics.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,162 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Basics</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="lexer_concepts/narylexer.html" title="NaryLexer">
+<link rel="next" href="primitives.html" title="Token definition Primitives">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_concepts/narylexer.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitives.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Basics">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.reference.lex_basics"></a><a class="link" href="lex_basics.html" title="Basics"> Basics</a>
+</h4></div></div></div>
+<a name="spirit.lex.reference.lex_basics.character_encoding_namespace"></a><h6>
+<a name="id878385"></a>
+ <a class="link" href="lex_basics.html#spirit.lex.reference.lex_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>
+ </h6>
+
+ Some generators need to know which character set a <code class="computeroutput">char</code>
+ or <code class="computeroutput">wchar_t</code> is operating on.
+ For example, the regular expression <code class="computeroutput">[a-9]</code> spans a different set of characters in
+ different character sets. Where necessary, Spirit encodes (tags) the token
+ definitions with the character set.
+ 
+
+ We have a namespace for each character set Spirit will be supporting. That
+ includes <code class="computeroutput">ascii</code>, <code class="computeroutput">iso8859_1</code>, <code class="computeroutput">standard</code>
+ and <code class="computeroutput">standard_wide</code> (and
+ in the future, <code class="computeroutput">unicode</code>).
+ In each of the character encoding namespaces, we place tagged versions
+ of token definitions such as <code class="computeroutput">char_</code>
+ and <code class="computeroutput">string</code>.
+ 
+
+ Example:
+ 
+<pre class="programlisting">using boost::spirit::ascii::char_; // use ASCII character token definitions
+</pre>
+
+ Namespaces:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ boost::spirit::ascii
+ </li>
+<li class="listitem">
+ boost::spirit::iso8859_1
+ </li>
+<li class="listitem">
+ boost::spirit::standard
+ </li>
+<li class="listitem">
+ boost::spirit::standard_wide
+ </li>
+</ul></div>
+
+ For ease of use, the components in this namespaces are also brought into
+ the lex sub-namespaces with the same names:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ boost::spirit::lex::ascii
+ </li>
+<li class="listitem">
+ boost::spirit::lex::iso8859_1
+ </li>
+<li class="listitem">
+ boost::spirit::lex::standard
+ </li>
+<li class="listitem">
+ boost::spirit::lex::standard_wide
+ </li>
+</ul></div>
+<a name="spirit.lex.reference.lex_basics.examples"></a><h6>
+<a name="id878585"></a>
+ <a class="link" href="lex_basics.html#spirit.lex.reference.lex_basics.examples">Examples</a>
+ </h6>
+
+ All sections in the reference present some real world examples. The examples
+ use a common test harness to keep the example code as minimal and direct
+ to the point as possible. The test harness is presented below.
+ 
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/lex.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ Our test functions:
+ 
+
+ This one tests token definitions.
+ 
+
+ 
+<a name="spirit.lex.reference.lex_basics.models"></a><h6>
+<a name="id878797"></a>
+ <a class="link" href="lex_basics.html#spirit.lex.reference.lex_basics.models">Models</a>
+ </h6>
+
+ Predefined models include:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ any literal string, e.g. "Hello, World",
+ </li>
+<li class="listitem">
+ a pointer/reference to a null-terminated array of characters
+ </li>
+<li class="listitem">
+ a <code class="computeroutput">std::basic_string<Char></code>
+</li>
+</ul></div>
+
+ The namespace <code class="computeroutput">boost::spirit::traits</code> is open for users to provide their
+ own specializations.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_concepts/narylexer.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitives.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,64 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lexer Class</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="primitives/char_tokendef.html" title="Tokens Matching Single Characters">
+<link rel="next" href="token.html" title="Token Class">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitives/char_tokendef.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="token.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lexer Class">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.reference.lexer"></a><a class="link" href="lexer.html" title="Lexer Class"> Lexer Class</a>
+</h4></div></div></div>
+<a name="spirit.lex.reference.lexer.the_lexertl__lexer_class_implementing_the_dynamic_model"></a><h6>
+<a name="id879564"></a>
+ <a class="link" href="lexer.html#spirit.lex.reference.lexer.the_lexertl__lexer_class_implementing_the_dynamic_model">The
+ lexertl::lexer Class Implementing the Dynamic Model</a>
+ </h6>
+<a name="spirit.lex.reference.lexer.the_lexertl__actor_lexer_class_implementing_the_dynamic_model"></a><h6>
+<a name="id879577"></a>
+ <a class="link" href="lexer.html#spirit.lex.reference.lexer.the_lexertl__actor_lexer_class_implementing_the_dynamic_model">The
+ lexertl::actor_lexer Class Implementing the Dynamic Model</a>
+ </h6>
+<a name="spirit.lex.reference.lexer.the_lexertl__static_lexer_class_implementing_the_static_model"></a><h6>
+<a name="id879591"></a>
+ <a class="link" href="lexer.html#spirit.lex.reference.lexer.the_lexertl__static_lexer_class_implementing_the_static_model">The
+ lexertl::static_lexer Class Implementing the Static Model</a>
+ </h6>
+<a name="spirit.lex.reference.lexer.the_lexertl__static_actor_lexer_class_implementing_the_static_model"></a><h6>
+<a name="id879604"></a>
+ <a class="link" href="lexer.html#spirit.lex.reference.lexer.the_lexertl__static_actor_lexer_class_implementing_the_static_model">The
+ lexertl::static_actor_lexer Class Implementing the Static Model</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitives/char_tokendef.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="token.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,61 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lexer Concepts</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="../reference.html" title="Reference">
+<link rel="next" href="lexer_concepts/lexer.html" title="Lexer">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_concepts/lexer.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lexer Concepts">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.reference.lexer_concepts"></a><a class="link" href="lexer_concepts.html" title="Lexer Concepts"> Lexer Concepts</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt>Lexer</dt>
+<dt>PrimitiveLexer</dt>
+<dt>UnaryLexer</dt>
+<dt>NaryLexer</dt>
+</dl></div>
+
+ Spirit.Lex components fall into a couple of generalized
+ concepts.
+ The Lexer is the most fundamental concept. All Spirit.Lex
+ components are models of the Lexer concept. PrimitiveLexer,
+ UnaryLexer, and NaryLexer are
+ all refinements of the Lexer concept.
+ 
+
+ The following sections provide details on these concepts.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_concepts/lexer.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/lexer.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/lexer.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,231 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lexer</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lexer_concepts.html" title="Lexer Concepts">
+<link rel="prev" href="../lexer_concepts.html" title="Lexer Concepts">
+<link rel="next" href="primitivelexer.html" title="PrimitiveLexer">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitivelexer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lexer">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.lex.reference.lexer_concepts.lexer"></a><a class="link" href="lexer.html" title="Lexer">Lexer</a>
+</h5></div></div></div>
+<a name="spirit.lex.reference.lexer_concepts.lexer.description"></a><h6>
+<a name="id875197"></a>
+ <a class="link" href="lexer.html#spirit.lex.reference.lexer_concepts.lexer.description">Description</a>
+ </h6>
+
+ The Lexer is the most fundamental concept. A Lexer
+ has a member function, <code class="computeroutput">collect</code>,
+ that accepts a token definition container <code class="computeroutput">Def</code>,
+ and a the name of the lexer state the token definitions of the lexer
+ component need to be added to (a string). It doesn't return anything
+ (return type is <code class="computeroutput">void</code>). Each
+ Lexer can represent a specific pattern or algorithm, or it can be a more
+ complex lexer component formed as a composition of other Lexer's. Additionally,
+ a Lexer exposes a member <code class="computeroutput">add_actions</code>,
+ that accepts the token definition container <code class="computeroutput">Def</code>,
+ while returning nothing (again, the returned type is <code class="computeroutput">void</code>).
+ 
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">l</code></dt>
+<dd>
+ A <code class="computeroutput">Lexer</code>.
+ </dd>
+<dt><code class="computeroutput">L</code></dt>
+<dd>
+ A <code class="computeroutput">Lexer</code> type.
+ </dd>
+<dt><code class="computeroutput">Def</code></dt>
+<dd>
+ A token definition conatiner type.
+ </dd>
+<dt><code class="computeroutput">State</code></dt>
+<dd>
+ A type used to represent lexer state names.
+ </dd>
+</dl>
+</div>
+<a name="spirit.lex.reference.lexer_concepts.lexer.valid_expressions"></a><h6>
+<a name="id875359"></a>
+ <a class="link" href="lexer.html#spirit.lex.reference.lexer_concepts.lexer.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In the expressions below, the behavior of the lexer component, <code class="computeroutput">l</code>, is left unspecified in the base
+ <code class="computeroutput">Lexer</code> concept. These
+ are specified in subsequent, more refined concepts and by the actual
+ models therof.
+ 
+
+ For any Lexer the following expressions must be valid:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">l.collect(def,
+ state)</code>
+ 
+ </td>
+<td>
+ 
+ Add all token definitions provided by this Lexer instance to
+ the lexer state <code class="computeroutput">state</code>
+ of the token definition container <code class="computeroutput">def</code>.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">void</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">l.add_actions(def)</code>
+ 
+ </td>
+<td>
+ 
+ Add all semantic actions provided by this Lexer instance to the
+ token definition container <code class="computeroutput">def</code>.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">void</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.lex.reference.lexer_concepts.lexer.type_expressions"></a><h6>
+<a name="id875578"></a>
+ <a class="link" href="lexer.html#spirit.lex.reference.lexer_concepts.lexer.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_lexer<L>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">L</code>
+ is a Lexer, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.lex.reference.lexer_concepts.lexer.postcondition"></a><h6>
+<a name="id875715"></a>
+ <a class="link" href="lexer.html#spirit.lex.reference.lexer_concepts.lexer.postcondition">Postcondition</a>
+ </h6>
+
+ Upon return from <code class="computeroutput">l.collect</code> the following post conditions
+ should hold:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+ On return, <code class="computeroutput">def</code> holds
+ all token definitions defined in the Lexer, <code class="computeroutput">l</code>.
+ This includes all Lexer's contained inside <code class="computeroutput">l</code>.
+ </li></ul></div>
+
+ Upon return from <code class="computeroutput">l.add_actions</code> the following post conditions
+ should hold:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+ On return, <code class="computeroutput">def</code> holds
+ all semantic actions correctly asociated with the corresponding token
+ definitions as defined in the Lexer, <code class="computeroutput">l</code>.
+ This includes all semantic actiosn defined by the Lexer's contained
+ inside <code class="computeroutput">l</code>.
+ </li></ul></div>
+<a name="spirit.lex.reference.lexer_concepts.lexer.models"></a><h6>
+<a name="id875823"></a>
+ <a class="link" href="lexer.html#spirit.lex.reference.lexer_concepts.lexer.models">Models</a>
+ </h6>
+
+ All lexer components in Spirit.Lex are models of
+ the Lexer concept.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitivelexer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/narylexer.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/narylexer.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,211 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>NaryLexer</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lexer_concepts.html" title="Lexer Concepts">
+<link rel="prev" href="unarylexer.html" title="UnaryLexer">
+<link rel="next" href="../lex_basics.html" title="Basics">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unarylexer.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../lex_basics.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="NaryLexer">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.lex.reference.lexer_concepts.narylexer"></a><a class="link" href="narylexer.html" title="NaryLexer">NaryLexer</a>
+</h5></div></div></div>
+<a name="spirit.lex.reference.lexer_concepts.narylexer.description"></a><h6>
+<a name="id877839"></a>
+ <a class="link" href="narylexer.html#spirit.lex.reference.lexer_concepts.narylexer.description">Description</a>
+ </h6>
+
+ NaryLexer is a composite lexer component that has
+ one or more subjects. The NaryLexer allows its subjects to be treated
+ in the same way as a single instance of a <a class="link" href="lexer.html" title="Lexer"><code class="computeroutput">Lexer</code></a> following the Composite
+ Design Pattern.
+ 
+<a name="spirit.lex.reference.lexer_concepts.narylexer.refinement_of"></a><h6>
+<a name="id877875"></a>
+ <a class="link" href="narylexer.html#spirit.lex.reference.lexer_concepts.narylexer.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="lexer.html" title="Lexer"><code class="computeroutput">Lexer</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">l</code></dt>
+<dd>
+ A NaryLexer.
+ </dd>
+<dt><code class="computeroutput">L</code></dt>
+<dd>
+ A NaryLexer type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.lex.reference.lexer_concepts.narylexer.valid_expressions"></a><h6>
+<a name="id877956"></a>
+ <a class="link" href="narylexer.html#spirit.lex.reference.lexer_concepts.narylexer.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In addition to the requirements defined in <a class="link" href="lexer.html" title="Lexer"><code class="computeroutput">Lexer</code></a>, for any NaryLexer the
+ following must be met:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">l.elements</code>
+ 
+ </td>
+<td>
+ 
+ The tuple of elements.
+ 
+ </td>
+<td>
+ 
+ A Boost.Fusion
+ Sequence of <a class="link" href="lexer.html" title="Lexer"><code class="computeroutput">Lexer</code></a> types.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.lex.reference.lexer_concepts.narylexer.type_expressions"></a><h6>
+<a name="id878081"></a>
+ <a class="link" href="narylexer.html#spirit.lex.reference.lexer_concepts.narylexer.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">l.elements_type</code>
+ 
+ </td>
+<td>
+ 
+ Elements tuple type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_nary_lexer<L>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">L</code>
+ is a NaryLexer, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.lex.reference.lexer_concepts.narylexer.invariants"></a><h6>
+<a name="id878253"></a>
+ <a class="link" href="narylexer.html#spirit.lex.reference.lexer_concepts.narylexer.invariants">Invariants</a>
+ </h6>
+
+ For each element, <code class="computeroutput">E</code>,
+ in any NaryLexer, <code class="computeroutput">L</code>,
+ the following invariant always holds:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+<code class="computeroutput">traits::is_lexer<E>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li></ul></div>
+<a name="spirit.lex.reference.lexer_concepts.narylexer.models"></a><h6>
+<a name="id878338"></a>
+ <a class="link" href="narylexer.html#spirit.lex.reference.lexer_concepts.narylexer.models">Models</a>
+ </h6>
+
+ The following lexer components conform to this model:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+ lexer sequence component
+ </li></ul></div>
+
+ FIXME Add more links to models of NaryLexer
+ concept
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unarylexer.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../lex_basics.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/primitivelexer.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/primitivelexer.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,127 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>PrimitiveLexer</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lexer_concepts.html" title="Lexer Concepts">
+<link rel="prev" href="lexer.html" title="Lexer">
+<link rel="next" href="unarylexer.html" title="UnaryLexer">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="unarylexer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="PrimitiveLexer">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.lex.reference.lexer_concepts.primitivelexer"></a><a class="link" href="primitivelexer.html" title="PrimitiveLexer">PrimitiveLexer</a>
+</h5></div></div></div>
+<a name="spirit.lex.reference.lexer_concepts.primitivelexer.description"></a><h6>
+<a name="id875860"></a>
+ <a class="link" href="primitivelexer.html#spirit.lex.reference.lexer_concepts.primitivelexer.description">Description</a>
+ </h6>
+
+ PrimitiveLexer is the most basic building block
+ that the client uses to build more complex lexer components.
+ 
+<a name="spirit.lex.reference.lexer_concepts.primitivelexer.refinement_of"></a><h6>
+<a name="id875883"></a>
+ <a class="link" href="primitivelexer.html#spirit.lex.reference.lexer_concepts.primitivelexer.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="lexer.html" title="Lexer"><code class="computeroutput">Lexer</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.lex.reference.lexer_concepts.primitivelexer.type_expressions"></a><h6>
+<a name="id875917"></a>
+ <a class="link" href="primitivelexer.html#spirit.lex.reference.lexer_concepts.primitivelexer.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_primitive_lexer<L>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">L</code>,
+ is a PrimitiveLexer, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.lex.reference.lexer_concepts.primitivelexer.models"></a><h6>
+<a name="id876054"></a>
+ <a class="link" href="primitivelexer.html#spirit.lex.reference.lexer_concepts.primitivelexer.models">Models</a>
+ </h6>
+
+ The following lexer components conform to this model:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ character literals (i.e. <code class="computeroutput">'x'</code>),
+ <code class="computeroutput">char_</code>,
+ </li>
+<li class="listitem">
+ string literals (<code class="computeroutput">"abc"</code>),
+ <code class="computeroutput">std::basic_string<></code>,
+ <code class="computeroutput">string</code>
+</li>
+</ul></div>
+
+ FIXME Add more links to PrimitiveLexer
+ models here.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="unarylexer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/unarylexer.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/lexer_concepts/unarylexer.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,208 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>UnaryLexer</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lexer_concepts.html" title="Lexer Concepts">
+<link rel="prev" href="primitivelexer.html" title="PrimitiveLexer">
+<link rel="next" href="narylexer.html" title="NaryLexer">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitivelexer.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="narylexer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="UnaryLexer">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.lex.reference.lexer_concepts.unarylexer"></a><a class="link" href="unarylexer.html" title="UnaryLexer">UnaryLexer</a>
+</h5></div></div></div>
+<a name="spirit.lex.reference.lexer_concepts.unarylexer.description"></a><h6>
+<a name="id876156"></a>
+ <a class="link" href="unarylexer.html#spirit.lex.reference.lexer_concepts.unarylexer.description">Description</a>
+ </h6>
+
+ UnaryLexer is a composite lexer component that has
+ a single subject. The UnaryLexer may change the behavior of its subject
+ following the Delegate Design Pattern.
+ 
+<a name="spirit.lex.reference.lexer_concepts.unarylexer.refinement_of"></a><h6>
+<a name="id876181"></a>
+ <a class="link" href="unarylexer.html#spirit.lex.reference.lexer_concepts.unarylexer.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="lexer.html" title="Lexer"><code class="computeroutput">Lexer</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">l</code></dt>
+<dd>
+ A UnaryLexer.
+ </dd>
+<dt><code class="computeroutput">L</code></dt>
+<dd>
+ A UnaryLexer type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.lex.reference.lexer_concepts.unarylexer.valid_expressions"></a><h6>
+<a name="id876260"></a>
+ <a class="link" href="unarylexer.html#spirit.lex.reference.lexer_concepts.unarylexer.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In addition to the requirements defined in <a class="link" href="lexer.html" title="Lexer"><code class="computeroutput">Lexer</code></a>, for any UnaryLexer the
+ following must be met:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">l.subject</code>
+ 
+ </td>
+<td>
+ 
+ Subject lexer component.
+ 
+ </td>
+<td>
+ 
+ <a class="link" href="lexer.html" title="Lexer"><code class="computeroutput">Lexer</code></a>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.lex.reference.lexer_concepts.unarylexer.type_expressions"></a><h6>
+<a name="id876376"></a>
+ <a class="link" href="unarylexer.html#spirit.lex.reference.lexer_concepts.unarylexer.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">L::subject_type</code>
+ 
+ </td>
+<td>
+ 
+ The subject lexer component type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_unary_lexer<L>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">L</code>
+ is a UnaryLexer, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.lex.reference.lexer_concepts.unarylexer.invariants"></a><h6>
+<a name="id877708"></a>
+ <a class="link" href="unarylexer.html#spirit.lex.reference.lexer_concepts.unarylexer.invariants">Invariants</a>
+ </h6>
+
+ For any UnaryLexer, <code class="computeroutput">L</code>,
+ the following invariant always holds:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+<code class="computeroutput">traits::is_lexer<L::subject_type>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li></ul></div>
+<a name="spirit.lex.reference.lexer_concepts.unarylexer.models"></a><h6>
+<a name="id877793"></a>
+ <a class="link" href="unarylexer.html#spirit.lex.reference.lexer_concepts.unarylexer.models">Models</a>
+ </h6>
+
+ The following lexer components conform to this model:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+ action lexer component (allowing to attach semantic actions)
+ </li></ul></div>
+
+ FIXME Add more links to models of UnaryLexer
+ concept
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitivelexer.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lexer_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="narylexer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/primitives.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/primitives.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,62 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Token definition Primitives</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="lex_basics.html" title="Basics">
+<link rel="next" href="primitives/char_tokendef.html" title="Tokens Matching Single Characters">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lex_basics.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitives/char_tokendef.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Token definition Primitives">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.reference.primitives"></a><a class="link" href="primitives.html" title="Token definition Primitives"> Token definition
+ Primitives</a>
+</h4></div></div></div>
+<div class="toc"><dl><dt><a href="primitives/char_tokendef.html"> Tokens
+ Matching Single Characters</a></dt></dl></div>
+
+ This module includes different primitives allowing to create token definitions.
+ It includes <code class="computeroutput">char_</code>, <code class="computeroutput">string</code>, character literals, and string
+ literals.
+ 
+<a name="spirit.lex.reference.primitives.module_headers"></a><h6>
+<a name="id878909"></a>
+ <a class="link" href="primitives.html#spirit.lex.reference.primitives.module_headers">Module Headers</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/lex/primitives.hpp>
+#include <boost/spirit/include/lex_primitives.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lex_basics.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitives/char_tokendef.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/primitives/char_tokendef.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/primitives/char_tokendef.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,214 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Tokens Matching Single Characters</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../primitives.html" title="Token definition Primitives">
+<link rel="prev" href="../primitives.html" title="Token definition Primitives">
+<link rel="next" href="../lexer.html" title="Lexer Class">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../primitives.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitives.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../lexer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Tokens Matching Single Characters">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.lex.reference.primitives.char_tokendef"></a><a class="link" href="char_tokendef.html" title="Tokens Matching Single Characters"> Tokens
+ Matching Single Characters</a>
+</h5></div></div></div>
+<a name="spirit.lex.reference.primitives.char_tokendef.description"></a><h6>
+<a name="id878995"></a>
+ <a class="link" href="char_tokendef.html#spirit.lex.reference.primitives.char_tokendef.description">Description</a>
+ </h6>
+
+ The character based token definitions described in this section are:
+ 
+
+ The <code class="computeroutput">char_</code> creates token
+ definitions matching single characters. The <code class="computeroutput">char_</code>
+ token definition has an associated <a class="link" href="../lex_basics.html#spirit.lex.reference.lex_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>. This is needed when doing basic operations
+ such as forcing lower or upper case and dealing with character ranges.
+ 
+<a name="spirit.lex.reference.primitives.char_tokendef.header"></a><h6>
+<a name="id879040"></a>
+ <a class="link" href="char_tokendef.html#spirit.lex.reference.primitives.char_tokendef.header">Header</a>
+ </h6>
+<a name="spirit.lex.reference.primitives.char_tokendef.module_headers"></a><h6>
+<a name="id879055"></a>
+ <a class="link" href="char_tokendef.html#spirit.lex.reference.primitives.char_tokendef.module_headers">Module
+ Headers</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/lex/lexer/char_token_def.hpp>
+#include <boost/spirit/include/lex_char_token_def.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.lex.reference.primitives.char_tokendef.namespace"></a><h6>
+<a name="id879132"></a>
+ <a class="link" href="char_tokendef.html#spirit.lex.reference.primitives.char_tokendef.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lit // alias:
+ boost::spirit::lex::lit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::char_</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+
+ In the table above, <code class="computeroutput">ns</code>
+ is a <a class="link" href="../lex_basics.html#spirit.lex.reference.lex_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<a name="spirit.lex.reference.primitives.char_tokendef.model_of"></a><h6>
+<a name="id879253"></a>
+ <a class="link" href="char_tokendef.html#spirit.lex.reference.primitives.char_tokendef.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../lexer_concepts/primitivelexer.html" title="PrimitiveLexer"><code class="computeroutput">PrimitiveLexer</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">ch</code>,
+ <code class="computeroutput">ch1</code>, <code class="computeroutput">ch2</code></dt>
+<dd>
+ Character-class specific character (See Character Class Types), or
+ a <a class="link" href="../../../karma/reference/karma_basics.html#spirit.karma.reference.karma_basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a character-class specific character
+ value
+ </dd>
+<dt><code class="computeroutput">ns</code></dt>
+<dd>
+ A <a class="link" href="../lex_basics.html#spirit.lex.reference.lex_basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.lex.reference.primitives.char_tokendef.expression_semantics"></a><h6>
+<a name="id879357"></a>
+ <a class="link" href="char_tokendef.html#spirit.lex.reference.primitives.char_tokendef.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../lexer_concepts/primitivelexer.html" title="PrimitiveLexer"><code class="computeroutput">PrimitiveLexer</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ch</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character literal <code class="computeroutput">ch</code>.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(ch)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character literal <code class="computeroutput">ch</code>.
+ This generator never fails (except if the underlying output stream
+ reports an error).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(ch)</code>
+ 
+ </td>
+<td>
+ 
+ Generate the character <code class="computeroutput">ch</code>
+ as provided by the immediate literal value the generator is initialized
+ from. If this generator has an associated attribute it succeeds
+ only as long as the attribute is equal to the immediate literal
+ (except if the underlying output stream reports an error). Otherwise
+ this generator fails and does not generate any output.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.lex.reference.primitives.char_tokendef.example"></a><h6>
+<a name="id879539"></a>
+ <a class="link" href="char_tokendef.html#spirit.lex.reference.primitives.char_tokendef.example">Example</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../primitives.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../primitives.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../lexer.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/token.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/token.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,42 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Token Class</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="lexer.html" title="Lexer Class">
+<link rel="next" href="tokendef.html" title="TokenDef Class">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tokendef.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Token Class"><div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.reference.token"></a><a class="link" href="token.html" title="Token Class"> Token Class</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tokendef.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/reference/tokendef.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/reference/tokendef.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,42 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>TokenDef Class</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="token.html" title="Token Class">
+<link rel="next" href="../../support.html" title="Supporting libraries">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="token.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../support.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="TokenDef Class"><div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.reference.tokendef"></a><a class="link" href="tokendef.html" title="TokenDef Class"> TokenDef Class</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="token.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../support.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/tutorials.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/tutorials.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,55 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Spirit.Lex Tutorials</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../lex.html" title="Lex - Writing Lexical Analyzers">
+<link rel="prev" href="lexer_introduction.html" title="Introduction to Spirit.Lex">
+<link rel="next" href="tutorials/lexer_tutorials.html" title="Spirit.Lex Tutorials Overview">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_introduction.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/lexer_tutorials.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Spirit.Lex Tutorials">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.lex.tutorials"></a><a class="link" href="tutorials.html" title="Spirit.Lex Tutorials"> Spirit.Lex
+ Tutorials</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><a href="tutorials/lexer_tutorials.html"> Spirit.Lex
+ Tutorials Overview</a></dt>
+<dt><a href="tutorials/lexer_quickstart1.html"> Quickstart
+ 1 - A word counter using Spirit.Lex</a></dt>
+<dt><a href="tutorials/lexer_quickstart2.html"> Quickstart
+ 2 - A better word counter using Spirit.Lex</a></dt>
+<dt><a href="tutorials/lexer_quickstart3.html"> Quickstart
+ 3 - Counting Words Using a Parser</a></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_introduction.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../lex.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/lexer_tutorials.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart1.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart1.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,348 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Quickstart 1 - A word counter using Spirit.Lex</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Spirit.Lex Tutorials">
+<link rel="prev" href="lexer_tutorials.html" title="Spirit.Lex Tutorials Overview">
+<link rel="next" href="lexer_quickstart2.html" title="Quickstart 2 - A better word counter using Spirit.Lex">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_tutorials.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_quickstart2.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Quickstart 1 - A word counter using Spirit.Lex">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.tutorials.lexer_quickstart1"></a><a class="link" href="lexer_quickstart1.html" title="Quickstart 1 - A word counter using Spirit.Lex"> Quickstart
+ 1 - A word counter using Spirit.Lex</a>
+</h4></div></div></div>
+
+ Spirit.Lex is very modular, which follows the general
+ building principle of the Spirit
+ libraries. You never pay for features you don't use. It is nicely integrated
+ with the other parts of Spirit
+ but nevertheless can be used separately to build standalone lexical analyzers.
+ The first quick start example describes a standalone application: counting
+ characters, words, and lines in a file, very similar to what the well known
+ Unix command <code class="computeroutput">wc</code> is doing
+ (for the full example code see here: word_count_functor.cpp).
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart1.prerequisites"></a><h6>
+<a name="id850621"></a>
+ <a class="link" href="lexer_quickstart1.html#spirit.lex.tutorials.lexer_quickstart1.prerequisites">Prerequisites</a>
+ </h6>
+
+ The only required <code class="computeroutput">#include</code>
+ specific to Spirit.Lex follows. It is a wrapper for
+ all necessary definitions to use Spirit.Lex in a standalone
+ fashion, and on top of the Lexertl
+ library. Additionally we <code class="computeroutput">#include</code>
+ two of the Boost headers to define <code class="computeroutput">boost::bind()</code> and <code class="computeroutput">boost::ref()</code>.
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/lex_lexertl.hpp>
+#include <boost/bind.hpp>
+#include <boost/ref.hpp>
+</pre>
+
+ 
+
+ 
+
+ To make all the code below more readable we introduce the following namespaces.
+ 
+
+ 
+
+
+
+<pre class="programlisting">using namespace boost::spirit::lex;
+</pre>
+
+ 
+
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart1.defining_tokens"></a><h6>
+<a name="id850866"></a>
+ <a class="link" href="lexer_quickstart1.html#spirit.lex.tutorials.lexer_quickstart1.defining_tokens">Defining
+ Tokens</a>
+ </h6>
+
+ The most important step while creating a lexer using Spirit.Lex
+ is to define the tokens to be recognized in the input sequence. This is
+ normally done by defining the regular expressions describing the matching
+ character sequences, and optionally their corresponding token ids. Additionally
+ the defined tokens need to be associated with an instance of a lexer object
+ as provided by the library. The following code snippet shows how this can
+ be done using Spirit.Lex.
+ 
+
+ 
+
+ The template <code class="computeroutput">word_count_tokens</code>
+ defines three different tokens: <code class="computeroutput">ID_WORD</code>,
+ <code class="computeroutput">ID_EOL</code>, and <code class="computeroutput">ID_CHAR</code>, representing a word (anything
+ except a whitespace or a newline), a newline character, and any other
+ character (<code class="computeroutput">ID_WORD</code>,
+ <code class="computeroutput">ID_EOL</code>, and <code class="computeroutput">ID_CHAR</code> are enum values representing
+ the token ids, but could be anything else convertible to an integer as
+ well). The direct base class of any token definition class needs to be
+ the template <code class="computeroutput">lexer_def<></code>, where the corresponding template
+ parameter (here: <code class="computeroutput">lexertl_lexer<BaseIterator></code>) defines which underlying lexer engine
+ has to be used to provide the required state machine functionality. In
+ this example we use the Lexertl based lexer engine as the underlying
+ lexer type.
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Lexer>
+struct word_count_tokens : lexer<Lexer>
+{
+ word_count_tokens()
+ {
+ // define tokens (the regular expression to match and the corresponding
+ // token id) and add them to the lexer
+ this->self.add
+ ("[^ \t\n]+", ID_WORD) // words (anything except ' ', '\t' or '\n')
+ ("\n", ID_EOL) // newline characters
+ (".", ID_CHAR) // anything else is a plain character
+ ;
+ }
+};
+</pre>
+
+ 
+
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart1.doing_the_useful_work"></a><h6>
+<a name="id851174"></a>
+ <a class="link" href="lexer_quickstart1.html#spirit.lex.tutorials.lexer_quickstart1.doing_the_useful_work">Doing
+ the Useful Work</a>
+ </h6>
+
+ We will use a setup, where we want the Spirit.Lex
+ library to invoke a given function after any of of the generated tokens
+ is recognized. For this reason we need to implement a functor taking at
+ least the generated token as an argument and returning a boolean value
+ allowing to stop the tokenization process. The default token type used
+ in this example carries a token value of the type boost::iterator_range<code class="computeroutput"><BaseIterator></code>
+ pointing to the matched range in the underlying input sequence.
+ 
+
+ 
+
+ In this example the struct 'counter' is used as a functor counting the
+ characters, words and lines in the analyzed input sequence by identifying
+ the matched tokens as passed from the Spirit.Lex
+ library.
+ 
+
+ 
+
+
+
+<pre class="programlisting">struct counter
+{
+ // the function operator gets called for each of the matched tokens
+ // c, l, w are references to the counters used to keep track of the numbers
+ template <typename Token>
+ bool operator()(Token const& t, std::size_t& c, std::size_t& w, std::size_t& l) const
+ {
+ switch (t.id()) {
+ case ID_WORD: // matched a word
+ // since we're using a default token type in this example, every
+ // token instance contains a `iterator_range<BaseIterator>` as its token
+ // attribute pointing to the matched character sequence in the input
+ ++w; c += t.value().size();
+ break;
+ case ID_EOL: // matched a newline character
+ ++l; ++c;
+ break;
+ case ID_CHAR: // matched something else
+ ++c;
+ break;
+ }
+ return true; // always continue to tokenize
+ }
+};
+</pre>
+
+ 
+
+ 
+
+ All what's left is to write some boilerplate code helping to tie together
+ the pieces described so far. To simplify this example we call the <code class="computeroutput">lex::tokenize()</code>
+ function implemented in Spirit.Lex (for a more detailed
+ description of this function see here: FIXME),
+ even if we could have written a loop to iterate over the lexer iterators
+ [<code class="computeroutput">first</code>, <code class="computeroutput">last</code>)
+ as well.
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart1.pulling_everything_together"></a><h6>
+<a name="id852908"></a>
+ <a class="link" href="lexer_quickstart1.html#spirit.lex.tutorials.lexer_quickstart1.pulling_everything_together">Pulling
+ Everything Together</a>
+ </h6>
+
+ 
+
+ The main function simply loads the given file into memory (as a <code class="computeroutput">std::string</code>), instantiates an instance of
+ the token definition template using the correct iterator type (<code class="computeroutput">word_count_tokens<char const*></code>), and finally calls <code class="computeroutput">lex::tokenize</code>, passing an instance of the
+ counter function object. The return value of <code class="computeroutput">lex::tokenize()</code> will be <code class="computeroutput">true</code>
+ if the whole input sequence has been successfully tokenized, and <code class="computeroutput">false</code> otherwise.
+ 
+
+ 
+
+
+
+<pre class="programlisting">int main(int argc, char* argv[])
+{
+ // these variables are used to count characters, words and lines
+ std::size_t c = 0, w = 0, l = 0;
+
+ // read input from the given file
+ std::string str (read_from_file(1 == argc ? "word_count.input" : argv[1]));
+
+ // create the token definition instance needed to invoke the lexical analyzer
+ word_count_tokens<lexertl::lexer<> > word_count_functor;
+
+ // tokenize the given string, the bound functor gets invoked for each of
+ // the matched tokens
+ char const* first = str.c_str();
+ char const* last = &first[str.size()];
+ bool r = tokenize(first, last, word_count_functor,
+ boost::bind(counter(), _1, boost::ref(c), boost::ref(w), boost::ref(l)));
+
+ // print results
+ if (r) {
+ std::cout << "lines: " << l << ", words: " << w
+ << ", characters: " << c << "\n";
+ }
+ else {
+ std::string rest(first, last);
+ std::cout << "Lexical analysis failed\n" << "stopped at: \""
+ << rest << "\"\n";
+ }
+ return 0;
+}
+</pre>
+
+ 
+
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart1.comparing__emphasis_spirit_lex__emphasis__with__ulink_url__http___flex_sourceforge_net___flex__ulink_"></a><h6>
+<a name="id853734"></a>
+ <a class="link" href="lexer_quickstart1.html#spirit.lex.tutorials.lexer_quickstart1.comparing__emphasis_spirit_lex__emphasis__with__ulink_url__http___flex_sourceforge_net___flex__ulink_">Comparing
+ Spirit.Lex with Flex</a>
+ </h6>
+
+ This example was deliberately chosen to be as much as possible similar
+ to the equivalent Flex
+ program (see below), which isn't too different from what has to be written
+ when using Spirit.Lex.
+ 
+<div class="note" title="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">
+ Interestingly enough, performance comparisons of lexical analyzers written
+ using Spirit.Lex with equivalent programs generated
+ by Flex show that both
+ have comparable execution speeds! Generally, thanks to the highly optimized
+ Lexertl library
+ and due its carefully designed integration with Spirit
+ the abstraction penalty to be paid for using Spirit.Lex
+ is neglectible.
+ </td></tr>
+</table></div>
+
+ The remaining examples in this tutorial will use more sophisticated features
+ of Spirit.Lex, mainly to allow further simplification
+ of the code to be written, while maintaining the similarity with corresponding
+ features of Flex. Spirit.Lex
+ has been designed to be as much as possible similar to Flex,
+ that is why this documentation will provide the corresponding Flex
+ code for the shown Spirit.Lex examples almost everywhere.
+ So consequently, here is the Flex
+ code corresponding to the example as shown above.
+ 
+
+ 
+
+
+
+<pre class="programlisting">%{
+ #define ID_WORD 1000
+ #define ID_EOL 1001
+ #define ID_CHAR 1002
+ int c = 0, w = 0, l = 0;
+%}
+%%
+[^ \t\n]+ { return ID_WORD; }
+\n { return ID_EOL; }
+. { return ID_CHAR; }
+%%
+bool count(int tok)
+{
+ switch (tok) {
+ case ID_WORD: ++w; c += yyleng; break;
+ case ID_EOL: ++l; ++c; break;
+ case ID_CHAR: ++c; break;
+ default:
+ return false;
+ }
+ return true;
+}
+void main()
+{
+ int tok = EOF;
+ do {
+ tok = yylex();
+ if (!count(tok))
+ break;
+ } while (EOF != tok);
+ printf("%d %d %d\n", l, w, c);
+}
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_tutorials.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_quickstart2.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart2.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart2.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,324 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Quickstart 2 - A better word counter using Spirit.Lex</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Spirit.Lex Tutorials">
+<link rel="prev" href="lexer_quickstart1.html" title="Quickstart 1 - A word counter using Spirit.Lex">
+<link rel="next" href="lexer_quickstart3.html" title="Quickstart 3 - Counting Words Using a Parser">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_quickstart1.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_quickstart3.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Quickstart 2 - A better word counter using Spirit.Lex">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.tutorials.lexer_quickstart2"></a><a class="link" href="lexer_quickstart2.html" title="Quickstart 2 - A better word counter using Spirit.Lex"> Quickstart
+ 2 - A better word counter using Spirit.Lex</a>
+</h4></div></div></div>
+
+ People knowing Flex will
+ probably complain about the example from the section <a class="link" href="lexer_quickstart1.html" title="Quickstart 1 - A word counter using Spirit.Lex">Lex
+ Quickstart 1 - A word counter using Spirit.Lex</a>
+ as being overly complex and not being written to leverage the possibilities
+ provided by this tool. In particular the previous example did not directly
+ use the lexer actions to count the lines, words, and characters. So the
+ example provided in this step of the tutorial will show how to use semantic
+ actions in Spirit.Lex. Even if it still will allow
+ to count text elements only it introduces other new concepts and configuration
+ options along the lines (for the full example code see here: word_count_lexer.cpp).
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart2.prerequisites"></a><h6>
+<a name="id854510"></a>
+ <a class="link" href="lexer_quickstart2.html#spirit.lex.tutorials.lexer_quickstart2.prerequisites">Prerequisites</a>
+ </h6>
+
+ In addition to the only required <code class="computeroutput">#include</code>
+ specific to Spirit.Lex this example needs to include
+ a couple of header files from the Boost.Phoenix
+ library. This example shows how to attach functors to token definitions,
+ which could be done using any type of C++ technique resulting in a callable
+ object. Using Boost.Phoenix
+ for this task simplifies things and avoids adding dependencies to other
+ libraries (Boost.Phoenix
+ is already in use for Spirit
+ anyway).
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/lex_lexertl.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/spirit/include/phoenix_statement.hpp>
+#include <boost/spirit/include/phoenix_algorithm.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+</pre>
+
+ 
+
+ 
+
+ To make all the code below more readable we introduce the following namespaces.
+ 
+
+ 
+
+
+
+<pre class="programlisting">using namespace boost::spirit;
+using namespace boost::spirit::lex;
+</pre>
+
+ 
+
+ 
+
+ To give a preview at what to expect from this example, here is the flex
+ program which has been used as the starting point. The useful code is directly
+ included inside the actions associated with each of the token definitions.
+ 
+
+ 
+
+
+
+<pre class="programlisting">%{
+ int c = 0, w = 0, l = 0;
+%}
+%%
+[^ \t\n]+ { ++w; c += yyleng; }
+\n { ++c; ++l; }
+. { ++c; }
+%%
+main()
+{
+ yylex();
+ printf("%d %d %d\n", l, w, c);
+}
+</pre>
+
+ 
+
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart2.semantic_actions_in__emphasis_spirit_lex__emphasis_"></a><h6>
+<a name="id855166"></a>
+ <a class="link" href="lexer_quickstart2.html#spirit.lex.tutorials.lexer_quickstart2.semantic_actions_in__emphasis_spirit_lex__emphasis_">Semantic
+ Actions in Spirit.Lex</a>
+ </h6>
+
+ Spirit.Lex uses a very similar way of associating
+ actions with the token definitions (which should look familiar to anybody
+ knowlegdeable with Spirit
+ as well): specifying the operations to execute inside of a pair of <code class="computeroutput">[]</code> brackets. In order to be able to attach
+ semantic actions to token definitions for each of them there is defined
+ an instance of a <code class="computeroutput">token_def<></code>.
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Lexer>
+struct word_count_tokens : lexer<Lexer>
+{
+ word_count_tokens()
+ : c(0), w(0), l(0)
+ , word("[^ \t\n]+") // define tokens
+ , eol("\n")
+ , any(".")
+ {
+ using boost::spirit::lex::_start;
+ using boost::spirit::lex::_end;
+ using boost::phoenix::ref;
+
+ // associate tokens with the lexer
+ this->self
+ = word [++ref(w), ref(c) += distance(_start, _end)]
+ | eol [++ref(c), ++ref(l)]
+ | any [++ref(c)]
+ ;
+ }
+
+ std::size_t c, w, l;
+ token_def<> word, eol, any;
+};
+</pre>
+
+ 
+
+ 
+
+ The semantics of the shown code is as follows. The code inside the <code class="computeroutput">[]</code> brackets will be executed whenever the
+ corresponding token has been matched by the lexical analyzer. This is very
+ similar to Flex, where
+ the action code associated with a token definition gets executed after
+ the recognition of a matching input sequence. The code above uses function
+ objects constructed using Boost.Phoenix,
+ but it is possible to insert any C++ function or function object as long
+ as it exposes the proper interface. For more details on please refer to
+ the section <a class="link" href="../abstracts/lexer_semantic_actions.html" title="Lexer Semantic Actions">Lexer
+ Semantic Actions</a>.
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart2.associating_token_definitions_with_the_lexer"></a><h6>
+<a name="id855784"></a>
+ <a class="link" href="lexer_quickstart2.html#spirit.lex.tutorials.lexer_quickstart2.associating_token_definitions_with_the_lexer">Associating
+ Token Definitions with the Lexer</a>
+ </h6>
+
+ If you compare this code to the code from <a class="link" href="lexer_quickstart1.html" title="Quickstart 1 - A word counter using Spirit.Lex">Lex
+ Quickstart 1 - A word counter using Spirit.Lex</a>
+ with regard to the way how token definitions are associated with the lexer,
+ you will notice a different syntax being used here. In the previous example
+ we have been using the <code class="computeroutput">self.add()</code> style of the API, while we here directly
+ assign the token definitions to <code class="computeroutput">self</code>,
+ combining the different token definitions using the <code class="computeroutput">|</code>
+ operator. Here is the code snippet again:
+ 
+<pre class="programlisting">self = word [++ref(w), ref(c) += distance(_1)]
+ | eol [++ref(c), ++ref(l)]
+ | any [++ref(c)]
+ ;
+</pre>
+
+ This way we have a very powerful and natural way of building the lexical
+ analyzer. If translated into English this may be read as: The lexical analyer
+ will recognize ('<code class="computeroutput">=</code>') tokens
+ as defined by any of ('<code class="computeroutput">|</code>')
+ the token definitions <code class="computeroutput">word</code>,
+ <code class="computeroutput">eol</code>, and <code class="computeroutput">any</code>.
+ 
+
+ A second difference to the previous example is that we do not explicitly
+ specify any token ids to use for the separate tokens. Using semantic actions
+ to trigger some useful work has freed us from the need to define those.
+ To ensure every token gets assigned a id the Spirit.Lex
+ library internally assigns unique numbers to the token definitions, starting
+ with the constant defined by <code class="computeroutput">boost::spirit::lex::min_token_id</code>.
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart2.pulling_everything_together"></a><h6>
+<a name="id856072"></a>
+ <a class="link" href="lexer_quickstart2.html#spirit.lex.tutorials.lexer_quickstart2.pulling_everything_together">Pulling
+ everything together</a>
+ </h6>
+
+ In order to execute the code defined above we still need to instantiate
+ an instance of the lexer type, feed it from some input sequence and create
+ a pair of iterators allowing to iterate over the token sequence as created
+ by the lexer. This code shows how to achieve these steps:
+ 
+
+ 
+
+
+
+<pre class="programlisting">int main(int argc, char* argv[])
+{
+
+<a class="co" name="spirit8co" href="lexer_quickstart2.html#spirit8"><img src="../../../../../../../doc/src/images/callouts/1.png" alt="1" border="0"></a> typedef lexertl::token<char const*, lex::omit, boost::mpl::false_> token_type;
+
+<a class="co" name="spirit9co" href="lexer_quickstart2.html#spirit9"><img src="../../../../../../../doc/src/images/callouts/2.png" alt="2" border="0"></a> typedef lexertl::actor_lexer<token_type> lexer_type;
+
+<a class="co" name="spirit10co" href="lexer_quickstart2.html#spirit10"><img src="../../../../../../../doc/src/images/callouts/3.png" alt="3" border="0"></a> word_count_tokens<lexer_type> word_count_lexer;
+
+<a class="co" name="spirit11co" href="lexer_quickstart2.html#spirit11"><img src="../../../../../../../doc/src/images/callouts/4.png" alt="4" border="0"></a> std::string str (read_from_file(1 == argc ? "word_count.input" : argv[1]));
+ char const* first = str.c_str();
+ char const* last = &first[str.size()];
+
+<a class="co" name="spirit12co" href="lexer_quickstart2.html#spirit12"><img src="../../../../../../../doc/src/images/callouts/5.png" alt="5" border="0"></a> lexer_type::iterator_type iter = word_count_lexer.begin(first, last);
+ lexer_type::iterator_type end = word_count_lexer.end();
+
+<a class="co" name="spirit13co" href="lexer_quickstart2.html#spirit13"><img src="../../../../../../../doc/src/images/callouts/6.png" alt="6" border="0"></a> while (iter != end && token_is_valid(*iter))
+ ++iter;
+
+ if (iter == end) {
+ std::cout << "lines: " << word_count_lexer.l
+ << ", words: " << word_count_lexer.w
+ << ", characters: " << word_count_lexer.c
+ << "\n";
+ }
+ else {
+ std::string rest(first, last);
+ std::cout << "Lexical analysis failed\n" << "stopped at: \""
+ << rest << "\"\n";
+ }
+ return 0;
+}
+</pre>
+
+ 
+
+ 
+
+ 
+<div class="calloutlist"><table border="0" summary="Callout list">
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit8"></a> </td>
+<td valign="top" align="left"> Specifying <code class="computeroutput">omit</code> as the
+ token attribute type generates a token class not holding any token attribute
+ at all (not even the iterator range of the matched input sequence), therefore
+ optimizing the token, the lexer, and possibly the parser implementation
+ as much as possible. Specifying <code class="computeroutput">mpl::false_</code>
+ as the 3rd template parameter generates a token type and an iterator,
+ both holding no lexer state, allowing for even more aggressive optimizations.
+ As a result the token instances contain the token ids as the only data
+ member. </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit9"></a> </td>
+<td valign="top" align="left"> This defines the lexer type to use </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit10"></a> </td>
+<td valign="top" align="left"> Create the lexer object instance
+ needed to invoke the lexical analysis </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit11"></a> </td>
+<td valign="top" align="left"> Read input from the given file,
+ tokenize all the input, while discarding all generated tokens </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit12"></a> </td>
+<td valign="top" align="left"> Create
+ a pair of iterators returning the sequence of generated tokens </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit13"></a> </td>
+<td valign="top" align="left"> Here we
+ simply iterate over all tokens, making sure to break the loop if an invalid
+ token gets returned from the lexer </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_quickstart1.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_quickstart3.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart3.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_quickstart3.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,427 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Quickstart 3 - Counting Words Using a Parser</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Spirit.Lex Tutorials">
+<link rel="prev" href="lexer_quickstart2.html" title="Quickstart 2 - A better word counter using Spirit.Lex">
+<link rel="next" href="../abstracts.html" title="Abstracts">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_quickstart2.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../abstracts.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Quickstart 3 - Counting Words Using a Parser">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.tutorials.lexer_quickstart3"></a><a class="link" href="lexer_quickstart3.html" title="Quickstart 3 - Counting Words Using a Parser"> Quickstart
+ 3 - Counting Words Using a Parser</a>
+</h4></div></div></div>
+
+ The whole purpose of integrating Spirit.Lex as part
+ of the Spirit library
+ was to add a library allowing to merge lexical analysis with the parsing
+ process as defined by a Spirit
+ grammar. Spirit parsers
+ read their input from an input sequence accessed by iterators. So naturally,
+ we chose iterators to be used as the interface beween the lexer and the
+ parser. A second goal of the lexer/parser integration was to enable the
+ usage of possibly different lexical analyzer libraries. The utilization
+ of iterators seemed to be the right choice from this standpoint as well,
+ mainly because these can be used as an abstraction layer hiding implementation
+ specifics of the used lexer library. The <a class="link" href="lexer_quickstart3.html#spirit.lex.flowcontrol" title="Figure 7. The common flow control implemented while parsing combined with lexical analysis">picture</a>
+ below shows the common flow control implemented while parsing combined
+ with lexical analysis.
+ 
+
+ 
+<div class="figure">
+<a name="spirit.lex.flowcontrol"></a>Figure 7. The common flow control implemented while parsing
+ combined with lexical analysis
+<div class="figure-contents"><img src="../../.././images/flowofcontrol.png" alt="The common flow control implemented while parsing combined with lexical analysis"></div>
+</div>
+ 
+ 
+
+ Another problem related to the integration of the lexical analyzer with
+ the parser was to find a way how the defined tokens syntactically could
+ be blended with the grammar definition syntax of Spirit.
+ For tokens defined as instances of the <code class="computeroutput">token_def<></code> class the most natural way of integration
+ was to allow to directly use these as parser components. Semantically these
+ parser components succeed matching their input whenever the corresponding
+ token type has been matched by the lexer. This quick start example will
+ demonstrate this (and more) by counting words again, simply by adding up
+ the numbers inside of semantic actions of a parser (for the full example
+ code see here: word_count.cpp).
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart3.prerequisites"></a><h6>
+<a name="id857053"></a>
+ <a class="link" href="lexer_quickstart3.html#spirit.lex.tutorials.lexer_quickstart3.prerequisites">Prerequisites</a>
+ </h6>
+
+ This example uses two of the Spirit
+ library components: Spirit.Lex and Spirit.Qi,
+ consequently we have to <code class="computeroutput">#include</code>
+ the corresponding header files. Again, we need to include a couple of header
+ files from the Boost.Phoenix
+ library. This example shows how to attach functors to parser components,
+ which could be done using any type of C++ technique resulting in a callable
+ object. Using Boost.Phoenix
+ for this task simplifies things and avoids adding dependencies to other
+ libraries (Boost.Phoenix
+ is already in use for Spirit
+ anyway).
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/qi.hpp>
+#include <boost/spirit/include/lex_lexertl.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <boost/spirit/include/phoenix_statement.hpp>
+#include <boost/spirit/include/phoenix_container.hpp>
+</pre>
+
+ 
+
+ 
+
+ To make all the code below more readable we introduce the following namespaces.
+ 
+
+ 
+
+
+
+<pre class="programlisting">using namespace boost::spirit;
+using namespace boost::spirit::ascii;
+using namespace boost::spirit::qi;
+using namespace boost::spirit::lex;
+</pre>
+
+ 
+
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart3.defining_tokens"></a><h6>
+<a name="id859293"></a>
+ <a class="link" href="lexer_quickstart3.html#spirit.lex.tutorials.lexer_quickstart3.defining_tokens">Defining
+ Tokens</a>
+ </h6>
+
+ If compared to the two previous quick start examples (<a class="link" href="lexer_quickstart1.html" title="Quickstart 1 - A word counter using Spirit.Lex">Lex
+ Quickstart 1 - A word counter using Spirit.Lex</a>
+ and <a class="link" href="lexer_quickstart2.html" title="Quickstart 2 - A better word counter using Spirit.Lex">Lex Quickstart
+ 2 - A better word counter using Spirit.Lex</a>)
+ the token definition class for this example does not reveal any surprises.
+ However, it uses lexer token definition macros to simplify the composition
+ of the regular expressions, which will be described in more detail in the
+ section FIXME. Generally, any token definition
+ is usable without modification either for a standalone lexical analyzer
+ or in conjunction with a parser.
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Lexer>
+struct word_count_tokens : lexer<Lexer>
+{
+ word_count_tokens()
+ {
+ // define patterns (lexer macros) to be used during token definition
+ // below
+ this->self.add_pattern
+ ("WORD", "[^ \t\n]+")
+ ;
+
+ // define tokens and associate them with the lexer
+ word = "{WORD}"; // reference the pattern 'WORD' as defined above
+
+ // this lexer will recognize 3 token types: words, newlines, and
+ // everything else
+ this->self.add
+ (word) // no token id is needed here
+ ('\n') // characters are usable as tokens as well
+ (".", IDANY) // string literals will not be esacped by the library
+ ;
+ }
+
+ // the token 'word' exposes the matched string as its parser attribute
+ token_def<std::string> word;
+};
+</pre>
+
+ 
+
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart3.using_token_definition_instances_as_parsers"></a><h6>
+<a name="id859630"></a>
+ <a class="link" href="lexer_quickstart3.html#spirit.lex.tutorials.lexer_quickstart3.using_token_definition_instances_as_parsers">Using
+ Token Definition Instances as Parsers</a>
+ </h6>
+
+ While the integration of lexer and parser in the control flow is achieved
+ by using special iterators wrapping the lexical analyzer, we still nead
+ a means of expressing in the grammar what tokens to match and where. The
+ token definition class above uses three different ways of defining a token:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Using an instance of a <code class="computeroutput">token_def<></code>, which is handy whenever you
+ need to specify a token attribute (for more information about lexer related
+ attributes please look here: <a class="link" href="../abstracts/lexer_attributes.html" title="Lexer Attributes">Lexer
+ Attributes</a>).
+ </li>
+<li class="listitem">
+ Using a single character as the token, in this case the character represents
+ itself as a token, where the token id is the ASCII character value.
+ </li>
+<li class="listitem">
+ Using a regular expression represented as a string, where the token id
+ needs to be specified explicitly to make the token accessible from the
+ grammar level.
+ </li>
+</ul></div>
+
+ All three token definition methods require a different method of grammar
+ integration. But as you can see from the following code snippet, each of
+ this methods is straightforward and blends the corresponding token instance
+ naturally with the surrounding Spirit.Qi grammar syntax.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Token definition
+ 
+ </th>
+<th>
+ 
+ Parser integration
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">token_def<></code>
+ 
+ </td>
+<td>
+ 
+ The <code class="computeroutput">token_def<></code>
+ instance is directly usable as a parser component. Parsing of this
+ component will succeed if the regular expression used to define
+ this has been matched successfully.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ single character
+ 
+ </td>
+<td>
+ 
+ The single character is directly usable in the grammar, under certain
+ circumstances it needs to be wrapped by a <code class="computeroutput">char_()</code> parser component, though. Parsing
+ of this component will succeed if the single character has been
+ matched.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ explicit token id
+ 
+ </td>
+<td>
+ 
+ To use an explicit token id in a Spirit.Qi
+ grammar you are required to wrap it with the special <code class="computeroutput">token()</code>
+ parser component. Parsing of this component will succeed if the
+ current token has the same token id as specified in the expression
+ <code class="computeroutput">token(<id>)</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ The grammar definition below uses each of the three types demonstrating
+ their usage.
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+struct word_count_grammar : grammar<Iterator>
+{
+ template <typename TokenDef>
+ word_count_grammar(TokenDef const& tok)
+ : word_count_grammar::base_type(start)
+ , c(0), w(0), l(0)
+ {
+ using boost::phoenix::ref;
+ using boost::phoenix::size;
+
+ start = *( tok.word [++ref(w), ref(c) += size(_1)]
+ | lit('\n') [++ref(c), ++ref(l)]
+ | token(IDANY) [++ref(c)]
+ )
+ ;
+ }
+
+ std::size_t c, w, l;
+ rule<Iterator> start;
+};
+</pre>
+
+ 
+
+ 
+
+ As already described (see: <a class="link" href="../../../">Attributes</a>),
+ the Spirit.Qi parser library builds upon a set of
+ of fully attributed parser components. Consequently, all the token definitions
+ do support the this attribute model as well. The most natural way of implementing
+ this was to use the token values as the attributes exposed by the parser
+ component corresponding to the token definition (you can read more about
+ this topic here: <a class="link" href="../abstracts/lexer_primitives/lexer_token_values.html" title="About Tokens and Token Values">About
+ Tokens and Token Values</a>). The example above takes advantage of the
+ full integration of the token values as the <code class="computeroutput">token_def<></code>'s parser attributes: the <code class="computeroutput">word</code> token definition is declared as
+ a <code class="computeroutput">token_def<std::string></code>,
+ making every instance of a <code class="computeroutput">word</code>
+ token carry the string representation of the matched input sequence as
+ its value. The semantic action attached to <code class="computeroutput">tok.word</code>
+ receives this string (represented by the <code class="computeroutput">_1</code>
+ placeholder) and uses it to calculate the number of matched characters:
+ <code class="computeroutput">ref(c) +=
+ size(_1)</code>.
+ 
+<a name="spirit.lex.tutorials.lexer_quickstart3.pulling_everything_together"></a><h6>
+<a name="id860483"></a>
+ <a class="link" href="lexer_quickstart3.html#spirit.lex.tutorials.lexer_quickstart3.pulling_everything_together">Pulling
+ Everything Together</a>
+ </h6>
+
+ The main function needs to implement a bit more logic now as we have to
+ initialize and start not only the lexical analysis but the parsing process
+ as well. The three type definitions (<code class="computeroutput">typedef</code>
+ statements) simplify the creation of the lexical analyzer and the grammar.
+ After reading the contents of the given file into memory it calls the function
+ <a class="link" href="../../../"><code class="computeroutput">tokenize_and_parse()</code></a>
+ to initialize the lexical analysis and parsing processes.
+ 
+
+ 
+
+
+
+<pre class="programlisting">int main(int argc, char* argv[])
+{
+<a class="co" name="spirit14co" href="lexer_quickstart3.html#spirit14"><img src="../../../../../../../doc/src/images/callouts/1.png" alt="1" border="0"></a> typedef lexertl::token<
+ char const*, boost::mpl::vector<std::string>
+ > token_type;
+
+<a class="co" name="spirit15co" href="lexer_quickstart3.html#spirit15"><img src="../../../../../../../doc/src/images/callouts/2.png" alt="2" border="0"></a> typedef lexertl::lexer<token_type> lexer_type;
+
+<a class="co" name="spirit16co" href="lexer_quickstart3.html#spirit16"><img src="../../../../../../../doc/src/images/callouts/3.png" alt="3" border="0"></a> typedef word_count_tokens<lexer_type>::iterator_type iterator_type;
+
+ // now we use the types defined above to create the lexer and grammar
+ // object instances needed to invoke the parsing process
+ word_count_tokens<lexer_type> word_count; // Our lexer
+ word_count_grammar<iterator_type> g (word_count); // Our parser
+
+ // read in the file int memory
+ std::string str (read_from_file(1 == argc ? "word_count.input" : argv[1]));
+ char const* first = str.c_str();
+ char const* last = &first[str.size()];
+
+<a class="co" name="spirit17co" href="lexer_quickstart3.html#spirit17"><img src="../../../../../../../doc/src/images/callouts/4.png" alt="4" border="0"></a> bool r = tokenize_and_parse(first, last, word_count, g);
+
+ if (r) {
+ std::cout << "lines: " << g.l << ", words: " << g.w
+ << ", characters: " << g.c << "\n";
+ }
+ else {
+ std::string rest(first, last);
+ std::cerr << "Parsing failed\n" << "stopped at: \""
+ << rest << "\"\n";
+ }
+ return 0;
+}
+</pre>
+
+ 
+
+ 
+
+ 
+<div class="calloutlist"><table border="0" summary="Callout list">
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit14"></a> </td>
+<td valign="top" align="left"> Define the token type to be used: <code class="computeroutput">std::string</code>
+ is available as the type of the token attribute </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit15"></a> </td>
+<td valign="top" align="left"> Define the lexer type
+ to use implementing the state machine </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit16"></a> </td>
+<td valign="top" align="left"> Define the iterator type exposed
+ by the lexer type </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit17"></a> </td>
+<td valign="top" align="left"> Parsing is done based on the the token stream, not
+ the character stream read from the input. The function <code class="computeroutput">tokenize_and_parse()</code>
+ wraps the passed iterator range <code class="computeroutput">[first, last)</code>
+ by the lexical analyzer and uses its exposed iterators to parse the toke
+ stream. </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexer_quickstart2.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../abstracts.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_tutorials.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/lex/tutorials/lexer_tutorials.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,122 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Spirit.Lex Tutorials Overview</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Spirit.Lex Tutorials">
+<link rel="prev" href="../tutorials.html" title="Spirit.Lex Tutorials">
+<link rel="next" href="lexer_quickstart1.html" title="Quickstart 1 - A word counter using Spirit.Lex">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../tutorials.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_quickstart1.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Spirit.Lex Tutorials Overview">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.lex.tutorials.lexer_tutorials"></a><a class="link" href="lexer_tutorials.html" title="Spirit.Lex Tutorials Overview"> Spirit.Lex
+ Tutorials Overview</a>
+</h4></div></div></div>
+
+ The Spirit.Lex library implements several components
+ on top of possibly different lexer generator libraries. It exposes a pair
+ of iterators, which, when dereferenced, return a stream of tokens generated
+ from the underlying character stream. The generated tokens are based on
+ the token definitions supplied by the user.
+ 
+
+ Currently, Spirit.Lex is built on top of Ben Hansons
+ excellent Lexertl
+ library (which is a proposed Boost library). Lexertl
+ provides the necessary functionality to build state machines based on a
+ set of supplied regular expressions. But Spirit.Lex
+ is not restricted to be used with Lexertl.
+ We expect it to be usable in conjunction with any other lexical scanner
+ generator library, all what needs to be implemented is a set of wrapper
+ objects exposing a well defined interface as described in this documentation.
+ 
+<div class="note" title="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">
+ For the sake of clarity all examples in this documentation assume Spirit.Lex
+ to be used on top of Lexertl.
+ </td></tr>
+</table></div>
+
+ Building a lexer using Spirit.Lex is highly configurable,
+ where most of this configuration has to be done at compile time. Almost
+ all of the configurable parameters have generally useful default values,
+ though, which means that starting a project is easy and straightforward.
+ Here is a (non-complete) list of features you can tweak to adjust the generated
+ lexer instance to the actual needs:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Select and customize the token type to be generated by the lexer instance.
+ </li>
+<li class="listitem">
+ Select and customize the token value types the generated token instances
+ will be able to hold.
+ </li>
+<li class="listitem">
+ Select the iterator type of the underlying input stream, which will be
+ used as the source for the character stream to tokenize.
+ </li>
+<li class="listitem">
+ Customize the iterator type returned by the lexer to enable debug support,
+ special handling of certain input sequences, etc.
+ </li>
+<li class="listitem">
+ Select the dynamic or the static
+ runtime model for the lexical analyzer.
+ </li>
+</ul></div>
+
+ Special care has been taken during the development of the library that
+ optimal code will be generated regardless of the configuration options
+ selected.
+ 
+
+ The series of tutorial examples of this section will guide you through
+ some common use cases helping to understand the big picture. The first
+ two quick start examples (<a class="link" href="lexer_quickstart1.html" title="Quickstart 1 - A word counter using Spirit.Lex">Lex
+ Quickstart 1 - A word counter using Spirit.Lex</a>
+ and <a class="link" href="lexer_quickstart2.html" title="Quickstart 2 - A better word counter using Spirit.Lex">Lex Quickstart
+ 2 - A better word counter using Spirit.Lex</a>)
+ introduce the Spirit.Lex library while building two
+ standalone applications, not being connected to or depending on any other
+ part of Spirit. The
+ section <a class="link" href="lexer_quickstart3.html" title="Quickstart 3 - Counting Words Using a Parser">Lex Quickstart
+ 3 - Counting Words Using a Parser</a> demonstrates how to use a lexer
+ in conjunction with a parser (where obviously the parser is built using
+ Spirit.Qi).
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../tutorials.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lexer_quickstart1.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/notes.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/notes.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,49 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Notes</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="faq.html" title="Spirit FAQ">
+<link rel="next" href="notes/porting_from_spirit_1_8_x.html" title="Porting from Spirit 1.8.x">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="faq.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="notes/porting_from_spirit_1_8_x.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Notes">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.notes"></a><a class="link" href="notes.html" title="Notes">Notes</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt><a href="notes/porting_from_spirit_1_8_x.html">Porting from
+ Spirit 1.8.x</a></dt>
+<dt>Style Guide</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="faq.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="notes/porting_from_spirit_1_8_x.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/notes/porting_from_spirit_1_8_x.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/notes/porting_from_spirit_1_8_x.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,680 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Porting from Spirit 1.8.x</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../notes.html" title="Notes">
+<link rel="prev" href="../notes.html" title="Notes">
+<link rel="next" href="style_guide.html" title="Style Guide">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../notes.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../notes.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="style_guide.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Porting from Spirit 1.8.x">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.notes.porting_from_spirit_1_8_x"></a><a class="link" href="porting_from_spirit_1_8_x.html" title="Porting from Spirit 1.8.x">Porting from
+ Spirit 1.8.x</a>
+</h3></div></div></div>
+
+ The current version of Spirit
+ is a complete rewrite of earlier versions (we refer to earlier versions as
+ Spirit.Classic).
+ The parser generators are now only one part of the whole library. The parser
+ submodule of Spirit is
+ now called Spirit.Qi. It is conceptually different and
+ exposes a completely different interface. Generally, there is no easy (or
+ automated) way of converting parsers written for Spirit.Classic
+ to Spirit.Qi. Therefore this section can give only guidelines
+ on how to approach porting your older parsers to the current version of
+ Spirit.
+ 
+<a name="spirit.notes.porting_from_spirit_1_8_x.include_files"></a><h5>
+<a name="id891039"></a>
+ <a class="link" href="porting_from_spirit_1_8_x.html#spirit.notes.porting_from_spirit_1_8_x.include_files">Include
+ Files</a>
+ </h5>
+
+ The overall directory structure of the Spirit
+ directories is described in the section <a class="link" href="../structure/include.html" title="Include">Include
+ Structure</a> and the FAQ entry <a class="link" href="../faq.html#spirit.faq.i_m_very_confused_about_the_header_hell_in_my_boost_spirit_directory__what_s_all_this_about_">Header
+ Hell</a>. This should give you a good overview on how to find the needed
+ header files for your new parsers. Moreover, each section in the <a class="link" href="../qi/reference.html" title="Reference">Qi
+ Reference</a> lists the required include files needed for any particular
+ component.
+ 
+
+ It is possible to tell from the name of a header file, what version it belongs
+ to. While all main include files for Spirit.Classic
+ have the string 'classic_' in their name, for instance:
+ 
+<pre class="programlisting">#include <boost/spirit/include/classic_core.hpp>
+</pre>
+
+ we named all main include files for Spirit.Qi to have
+ the string 'qi_' as part of their name, for instance:
+ 
+<pre class="programlisting">#include <boost/spirit/include/qi_core.hpp>
+</pre>
+
+ The following table gives a rough list of corresponding header file between
+ Spirit.Classic
+ and Spirit.Qi, but this can be used as a starting point
+ only, as several components have either been moved to different submodules
+ or might not exist in the never version anymore. We list only include files
+ for the topmost submodules. For header files required for more lower level
+ components please refer to the corresponding reference documentation of this
+ component.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Include file in Spirit.Classic
+ 
+ </th>
+<th>
+ 
+ Include file in Spirit.Qi
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic.hpp</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">qi.hpp</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic_actor.hpp</code>
+ 
+ </td>
+<td>
+ 
+ none, use Boost.Phoenix
+ for writing semantic actions
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic_attribute.hpp</code>
+ 
+ </td>
+<td>
+ 
+ none, use local variables for rules instead of closures, the primitives
+ parsers now directly support lazy parametrization
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic_core.hpp</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">qi_core.hpp</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic_debug.hpp</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">qi_debug.hpp</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic_dynamic.hpp</code>
+ 
+ </td>
+<td>
+ 
+ none, use Spirit.Qi predicates instead of if_p,
+ while_p, for_p (included by <code class="computeroutput">qi_core.hpp</code>),
+ the equivalent for lazy_p is now included by <code class="computeroutput">qi_auxiliary.hpp</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic_error_handling.hpp</code>
+ 
+ </td>
+<td>
+ 
+ none, included in <code class="computeroutput">qi_core.hpp</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic_meta.hpp</code>
+ 
+ </td>
+<td>
+ 
+ none
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic_symbols.hpp</code>
+ 
+ </td>
+<td>
+ 
+ none, included in <code class="computeroutput">qi_core.hpp</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">classic_utility.hpp</code>
+ 
+ </td>
+<td>
+ 
+ none, not part of Spirit.Qi anymore, these components
+ will be added over time to the Repository
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.notes.porting_from_spirit_1_8_x.the_free_parse_functions"></a><h5>
+<a name="id891677"></a>
+ <a class="link" href="porting_from_spirit_1_8_x.html#spirit.notes.porting_from_spirit_1_8_x.the_free_parse_functions">The
+ Free Parse Functions</a>
+ </h5>
+
+ The free parse functions (i.e. the main parser API) has been changed. This
+ includes the names of the free functions as well as their interface. In
+ Spirit.Classic
+ all free functions were named <code class="computeroutput">parse</code>.
+ In Spirit.Qi they are are named either <code class="computeroutput">qi::parse</code>
+ or <code class="computeroutput">qi::phrase_parse</code> depending on whether the parsing
+ should be done using a skipper (<code class="computeroutput">qi::phrase_parse</code>)
+ or not (<code class="computeroutput">qi::parse</code>). All free functions now return a
+ simple <code class="computeroutput">bool</code>. A returned <code class="computeroutput">true</code> means success (i.e. the parser has matched)
+ or <code class="computeroutput">false</code> (i.e. the parser either
+ didn't match). This is equivalent to the former old <code class="computeroutput">parse_info</code>
+ member <code class="computeroutput">hit</code>. Spirit.Qi
+ doesn't support tracking of the matched input length anymore. The old <code class="computeroutput">parse_info</code> member <code class="computeroutput">full</code>
+ can be emulated by comparing the iterators after <code class="computeroutput">qi::parse</code>
+ returned.
+ 
+
+ All code examples in this section assume the following include statements
+ and using directives to be inserted. For Spirit.Classic:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/classic.hpp>
+#include <boost/spirit/include/phoenix1.hpp>
+#include <iostreams>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">using namespace boost::spirit::classic;
+</pre>
+
+ 
+
+ 
+
+ and for Spirit.Qi:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/qi.hpp>
+#include <iostreams>
+#include <string>
+#include <algorithm>
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">using namespace boost::spirit;
+</pre>
+
+ 
+
+ 
+
+ The following similar examples should clearify the differences. First the
+ base example in Spirit.Classic:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string input("1,1");
+parse_info<std::string::iterator> pi = parse(input.begin(), input.end(), int_p);
+
+if (pi.hit)
+ std::cout << "successful match!\n";
+
+if (pi.full)
+ std::cout << "full match!\n";
+else
+ std::cout << "stopped at: " << std::string(pi.stop, input.end()) << "\n";
+
+std::cout << "matched length: " << pi.length << "\n";
+</pre>
+
+ 
+
+ 
+
+ And here is the equivalent piece of code using Spirit.Qi:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string input("1,1");
+std::string::iterator it = input.begin();
+bool result = qi::parse(it, input.end(), int_);
+
+if (result)
+ std::cout << "successful match!\n";
+
+if (it == input.end())
+ std::cout << "full match!\n";
+else
+ std::cout << "stopped at: " << std::string(it, input.end()) << "\n";
+
+// seldomly needed: use std::distance to calculate the length of the match
+std::cout << "matched length: " << std::distance(input.begin(), it) << "\n";
+</pre>
+
+ 
+
+ 
+
+ The changes required for phrase parsing (i.e. parsing using a skipper) are
+ similar. Here is how phrase parsing works in Spirit.Classic:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string input(" 1, 1");
+parse_info<std::string::iterator> pi = parse(input.begin(), input.end(), int_p, space_p);
+
+if (pi.hit)
+ std::cout << "successful match!\n";
+
+if (pi.full)
+ std::cout << "full match!\n";
+else
+ std::cout << "stopped at: " << std::string(pi.stop, input.end()) << "\n";
+
+std::cout << "matched length: " << pi.length << "\n";
+</pre>
+
+ 
+
+ 
+
+ And here the equivalent example in Spirit.Qi:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string input(" 1, 1");
+std::string::iterator it = input.begin();
+bool result = qi::phrase_parse(it, input.end(), int_, ascii::space);
+
+if (result)
+ std::cout << "successful match!\n";
+
+if (it == input.end())
+ std::cout << "full match!\n";
+else
+ std::cout << "stopped at: " << std::string(it, input.end()) << "\n";
+
+// seldomly needed: use std::distance to calculate the length of the match
+std::cout << "matched length: " << std::distance(input.begin(), it) << "\n";
+</pre>
+
+ 
+
+ 
+
+ Note, how character parsers are in a separate namespace (here <code class="computeroutput">boost::spirit::ascii::space</code>) as Spirit.Qi
+ now supports working with different character sets. See the section <a class="link" href="../qi/reference/basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a> for more information.
+ 
+<a name="spirit.notes.porting_from_spirit_1_8_x.naming_conventions"></a><h5>
+<a name="id895991"></a>
+ <a class="link" href="porting_from_spirit_1_8_x.html#spirit.notes.porting_from_spirit_1_8_x.naming_conventions">Naming
+ Conventions</a>
+ </h5>
+
+ In Spirit.Classic
+ all parser primitives have suffixes appended to their names, encoding their
+ type: <code class="computeroutput">"_p"</code> for parsers,
+ <code class="computeroutput">"_a"</code> for lazy actions,
+ <code class="computeroutput">"_d"</code> for directives,
+ etc. In Spirit.Qi we don't have anything similar. The
+ only suffixes are single underscore letters <code class="computeroutput">"_"</code>
+ applied where the name would otherwise conflict with a keyword or predefined
+ name (such as <code class="computeroutput">int_</code> for the
+ integer parser). Overall, most, if not all primitive parsers and directives
+ have been renamed. Please see the <a class="link" href="../qi/quick_reference.html" title="Quick Reference">Qi
+ Quick Reference</a> for an overview on the names for the different available
+ parser primitives, directives and operators.
+ 
+<a name="spirit.notes.porting_from_spirit_1_8_x.parser_attributes"></a><h5>
+<a name="id896063"></a>
+ <a class="link" href="porting_from_spirit_1_8_x.html#spirit.notes.porting_from_spirit_1_8_x.parser_attributes">Parser
+ Attributes</a>
+ </h5>
+
+ In Spirit.Classic
+ most of the parser primitives don't expose a specific attribute type. Most
+ parsers expose the pair of iterators pointing to the matched input sequence.
+ As in Spirit.Qi all parsers expose a parser specific
+ attribute type it introduces a special directive <code class="computeroutput">raw[]</code> allowing to achieve a similar effect as
+ in Spirit.Classic.
+ The <code class="computeroutput">raw[]</code>
+ directive exposes the pair of iterators pointing to the matching sequence
+ of its embedded parser. Even if we very much encourage you to rewrite your
+ parsers to take advantage of the generates parser specific attributes, sometimes
+ it is helpful to get access to the underlying matched input sequence.
+ 
+<a name="spirit.notes.porting_from_spirit_1_8_x.grammars_and_rules"></a><h5>
+<a name="id896122"></a>
+ <a class="link" href="porting_from_spirit_1_8_x.html#spirit.notes.porting_from_spirit_1_8_x.grammars_and_rules">Grammars
+ and Rules</a>
+ </h5>
+
+ The <code class="computeroutput">grammar<></code>
+ and <code class="computeroutput">rule<></code>
+ types are of equal importance to Spirit.Qi as they are
+ for Spirit.Classic.
+ Their main purpose is still the same: they allow to define non-terminals
+ and they are the main building blocks for more complex parsers. Nevertheless,
+ both types have been redesigned and their interfaces have changed. Let's
+ have a look at two examples first, we'll explain the differences afterwards.
+ Here is a simple grammar and its usage in Spirit.Classic:
+ 
+
+ 
+
+
+
+<pre class="programlisting">struct roman : public grammar<roman>
+{
+ template <typename ScannerT>
+ struct definition
+ {
+ definition(roman const& self)
+ {
+ hundreds.add
+ ("C" , 100)("CC" , 200)("CCC" , 300)("CD" , 400)("D" , 500)
+ ("DC" , 600)("DCC" , 700)("DCCC" , 800)("CM" , 900) ;
+
+ tens.add
+ ("X" , 10)("XX" , 20)("XXX" , 30)("XL" , 40)("L" , 50)
+ ("LX" , 60)("LXX" , 70)("LXXX" , 80)("XC" , 90) ;
+
+ ones.add
+ ("I" , 1)("II" , 2)("III" , 3)("IV" , 4)("V" , 5)
+ ("VI" , 6)("VII" , 7)("VIII" , 8)("IX" , 9) ;
+
+ first = eps_p [phoenix::var(self.r) = phoenix::val(0)]
+ >> ( +ch_p('M') [phoenix::var(self.r) += phoenix::val(1000)]
+ || hundreds [phoenix::var(self.r) += _1]
+ || tens [phoenix::var(self.r) += _1]
+ || ones [phoenix::var(self.r) += _1]
+ ) ;
+ }
+
+ rule<ScannerT> first;
+ symbols<unsigned> hundreds;
+ symbols<unsigned> tens;
+ symbols<unsigned> ones;
+
+ rule<ScannerT> const& start() const { return first; }
+ };
+
+ roman(unsigned& r_) : r(r_) {}
+ unsigned& r;
+};
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string input("MMIX"); // MMIX == 2009
+unsigned value = 0;
+roman r(value);
+parse_info<std::string::iterator> pi = parse(input.begin(), input.end(), r);
+if (pi.hit)
+ std::cout << "successfully matched: " << value << "\n";
+</pre>
+
+ 
+
+ 
+
+ And here is a similar grammar and its usage in Spirit.Qi:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+struct roman : qi::grammar<Iterator, unsigned()>
+{
+ roman() : qi::grammar<Iterator, unsigned()>(first)
+ {
+ hundreds.add
+ ("C" , 100)("CC" , 200)("CCC" , 300)("CD" , 400)("D" , 500)
+ ("DC" , 600)("DCC" , 700)("DCCC" , 800)("CM" , 900) ;
+
+ tens.add
+ ("X" , 10)("XX" , 20)("XXX" , 30)("XL" , 40)("L" , 50)
+ ("LX" , 60)("LXX" , 70)("LXXX" , 80)("XC" , 90) ;
+
+ ones.add
+ ("I" , 1)("II" , 2)("III" , 3)("IV" , 4)("V" , 5)
+ ("VI" , 6)("VII" , 7)("VIII" , 8)("IX" , 9) ;
+
+ // qi::_val refers to the attribute of the rule on the left hand side
+ first = eps [qi::_val = 0]
+ >> ( +lit('M') [qi::_val += 1000]
+ || hundreds [qi::_val += qi::_1]
+ || tens [qi::_val += qi::_1]
+ || ones [qi::_val += qi::_1]
+ ) ;
+ }
+
+ qi::rule<Iterator, unsigned()> first;
+ symbols<char, unsigned> hundreds;
+ symbols<char, unsigned> tens;
+ symbols<char, unsigned> ones;
+};
+</pre>
+
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string input("MMIX"); // MMIX == 2009
+std::string::iterator it = input.begin();
+unsigned value = 0;
+roman r;
+if (qi::parse(it, input.end(), r, value))
+ std::cout << "successfully matched: " << value << "\n";
+</pre>
+
+ 
+
+ 
+
+ Both versions look similarily enough, but we see several differences (we
+ will cover each of those differences in more detail below):
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Neither the grammars nor the rules depend on a scanner type anymore, both
+ depend only on the underlying iterator type. That means the dreaded scanner
+ business is no issue anymore!
+ </li>
+<li class="listitem">
+ Grammars have no embedded class <code class="computeroutput">definition</code>
+ anymore
+ </li>
+<li class="listitem">
+ Grammars and rules may have an explicit attribute type specified in their
+ definition
+ </li>
+<li class="listitem">
+ Grammars do not have any explicit start rules anymore. Instead one of the
+ contained rules is used as a start rule by default.
+ </li>
+</ul></div>
+
+ The first two points are tightly interrelated. The scanner business (see
+ the FAQ number one of Spirit.Classic
+ here: <a href="../../../../../../libs/spirit/classic/doc/faq.html#scanner_business" target="_top">The
+ Scanner Business</a>) has been a problem for a long time. The grammar
+ and rule types have been specifically redesigned to avoid this problem in
+ the future. This also means that we don't need any delayed instantiation
+ of the inner definition class in a grammar anymore. So the redesign not only
+ helped fixing a long standing design problem, it helped to simplify things
+ considerably.
+ 
+
+ All Spirit.Qi parser components have well defined attribute
+ types. Grammars and rules are no exception. But since both need to be generic
+ enough to be usable for any parser their attribute type has to be explicitly
+ specified. In the example above the <code class="computeroutput">roman</code>
+ grammar and the rule <code class="computeroutput">first</code>
+ both have an <code class="computeroutput">unsigned</code> attribute:
+ 
+<pre class="programlisting">// grammar definition
+template <typename Iterator>
+struct roman : qi::grammar<Iterator, unsigned()> {...};
+
+// rule definition
+qi::rule<Iterator, unsigned()> first;
+</pre>
+
+ The used notation resembles the definition of a function type. This is very
+ natural as you can think of the synthesized attribute of the grammar and
+ the rule as of its 'return value'. In fact the rule and the grammar both
+ 'return' an unsigned value - the value they matched.
+ 
+<div class="note" title="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">
+ The function type notation allows to specify parameters as well. These
+ are interpreted as the types of inherited attributes the rule or grammar
+ expect to be passed during parsing. For more information please see the
+ section about inherited and synthesized attributes for rules and grammars.
+ </td></tr>
+</table></div>
+
+ If no attribute is desired none needs to be specified. The default attrribute
+ type for both, grammars and rules, is <code class="computeroutput">unused_type</code>,
+ which is a special placeholder type.
+ 
+
+ The last difference might seem to be rather cosmetic and insignificant. But
+ it turns out that not having to specify which rule in a grammar is the start
+ rule (by returning it from the function <code class="computeroutput">start()</code>) also means that any rule in a grammar
+ can be directly used as the start rule. Nevertheless, the grammar base class
+ gets initialized with the rule it has to use as the start rule in case the
+ grammar instance is directly used as a parser.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../notes.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../notes.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="style_guide.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/notes/style_guide.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/notes/style_guide.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,147 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Style Guide</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../notes.html" title="Notes">
+<link rel="prev" href="porting_from_spirit_1_8_x.html" title="Porting from Spirit 1.8.x">
+<link rel="next" href="../repository.html" title="Spirit Repository">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="porting_from_spirit_1_8_x.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../notes.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../repository.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Style Guide">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.notes.style_guide"></a><a class="link" href="style_guide.html" title="Style Guide">Style Guide</a>
+</h3></div></div></div>
+
+ At some point, especially when there are lots of semantic actions attached
+ to various points, the grammar tends to be quite difficult to follow. In
+ order to keep an easy-to-read, consistent en aesthetically pleasing look
+ to the Spirit code, the following coding styleguide is advised.
+ 
+
+ This coding style is adapted and extended from the ANTLR/PCCTS style and
+ <a href="http://www.boost.org/development/requirements.html" target="_top">Boost Library
+ Requirements and Guidelines</a> and is the combined work of Joel de Guzman,
+ Chris Uzdavinis, and Hartmut Kaiser.
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Rule names use std C++ (Boost) convention. The rule name may be very long.
+ </li>
+<li class="listitem">
+ The '=' is neatly indented 4 spaces below. Like in Boost, use spaces instead
+ of tabs.
+ </li>
+<li class="listitem">
+ Breaking the operands into separate lines puts the semantic actions neatly
+ to the right.
+ </li>
+<li class="listitem">
+ Semicolon at the last line terminates the rule.
+ </li>
+<li class="listitem">
+ The adjacent parts of a sequence should be indented accordingly to have
+ all, what belongs to one level, at one indentation level.
+ </li>
+</ul></div>
+<pre class="programlisting">program
+ = program_heading [heading_action]
+ >> block [block_action]
+ >> '.'
+ | another_sequence
+ >> etc
+ ;
+</pre>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Prefer literals in the grammar instead of identifiers. e.g. <code class="computeroutput">"program"</code> instead of <code class="computeroutput">PROGRAM</code>, <code class="computeroutput">'>='</code>
+ instead of <code class="computeroutput">GTE</code> and <code class="computeroutput">'.'</code> instead of <code class="computeroutput">DOT</code>.
+ This makes it much easier to read. If this isn't possible (for instance
+ where the used tokens must be identified through integers) capitalized
+ identifiers should be used instead.
+ </li>
+<li class="listitem">
+ Breaking the operands may not be needed for short expressions. e.g. <code class="computeroutput">*(',' >>
+ file_identifier)</code>
+ as long as the line does not exceed 80 characters.
+ </li>
+<li class="listitem">
+ If a sequence fits on one line, put spaces inside the parentheses to clearly
+ separate them from the rules.
+ </li>
+</ul></div>
+<pre class="programlisting">program_heading
+ = no_case["program"]
+ >> identifier
+ >> '('
+ >> file_identifier
+ >> *( ',' >> file_identifier )
+ >> ')'
+ >> ';'
+ ;
+</pre>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+ Nesting directives: If a rule does not fit on one line (80 characters)
+ it should be continued on the next line intended by one level. The brackets
+ of directives, semantic expressions (using Phoenix or LL lambda expressions)
+ or parsers should be placed as follows.
+ </li></ul></div>
+<pre class="programlisting">identifier
+ = no_case
+ [
+ lexeme
+ [
+ alpha >> *(alnum | '_') [id_action]
+ ]
+ ]
+ ;
+</pre>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+ Nesting unary operators (e.g.Kleene star): Unary rule operators (Kleene
+ star, <code class="computeroutput">'!'</code>, <code class="computeroutput">'+'</code>
+ etc.) should be moved out one space before the corresponding indentation
+ level, if this rule has a body or a sequence after it, which does not fit
+ on on line. This makes the formatting more consistent and moves the rule
+ 'body' at the same indentation level as the rule itself, highlighting the
+ unary operator.
+ </li></ul></div>
+<pre class="programlisting">block
+ = *( label_declaration_part
+ | constant_definition_part
+ | type_definition_part
+ | variable_declaration_part
+ | procedure_and_function_declaration_part
+ )
+ >> statement_part
+ ;
+</pre>
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="porting_from_spirit_1_8_x.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../notes.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../repository.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/preface.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/preface.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,377 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Preface</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="../index.html" title="Spirit 2.1">
+<link rel="next" href="what_s_new.html" title="What's New">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="what_s_new.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Preface">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.preface"></a><a class="link" href="preface.html" title="Preface">Preface</a>
+</h2></div></div></div>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ “Examples of designs that meet most of the criteria for
+ "goodness" (easy to understand, flexible, efficient) are a recursive-descent
+ parser, which is traditional procedural code. Another example is the STL,
+ which is a generic library of containers and algorithms depending crucially
+ on both traditional procedural code and on parametric polymorphism.”
+ --Bjarne Stroustrup
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.preface.history"></a><h4>
+<a name="id586015"></a>
+ <a class="link" href="preface.html#spirit.preface.history">History</a>
+ </h4>
+<a name="spirit.preface._emphasis_80s__emphasis_"></a><h4>
+<a name="id586028"></a>
+ <a class="link" href="preface.html#spirit.preface._emphasis_80s__emphasis_">80s</a>
+ </h4>
+
+ In the mid-80s, Joel wrote his first calculator in Pascal. Such an unforgettable
+ coding experience, he was amazed at how a mutually recursive set of functions
+ can model a grammar specification. In time, the skills he acquired from that
+ academic experience became very practical as he was tasked to do some parsing.
+ For instance, whenever he needed to perform any form of binary or text I/O,
+ he tried to approach each task somewhat formally by writing a grammar using
+ Pascal-like syntax diagrams and then a corresponding recursive-descent parser.
+ This process worked very well.
+ 
+<a name="spirit.preface._emphasis_90s__emphasis_"></a><h4>
+<a name="id586046"></a>
+ <a class="link" href="preface.html#spirit.preface._emphasis_90s__emphasis_">90s</a>
+ </h4>
+
+ The arrival of the Internet and the World Wide Web magnified the need for parsing
+ a thousand-fold. At one point Joel had to write an HTML parser for a Web browser
+ project. Using the W3C formal specifications, he easily wrote a recursive-descent
+ HTML parser. With the influence of the Internet, RFC specifications were abundent.
+ SGML, HTML, XML, email addresses and even those seemingly trivial URLs were
+ all formally specified using small EBNF-style grammar specifications. Joel
+ had more parsing to do, and he wished for a tool similar to larger parser generators
+ such as YACC and ANTLR, where a parser is built automatically from a grammar
+ specification.
+ 
+
+ This ideal tool would be able to parse anything from email addresses and command
+ lines, to XML and scripting languages. Scalability was a primary goal. The
+ tool would be able to do this without incurring a heavy development load, which
+ was not possible with the above mentioned parser generators. The result was
+ Spirit.
+ 
+
+ Spirit was a personal project that was conceived when Joel was involved in
+ R&D in Japan. Inspired by the GoF's composite and interpreter patterns,
+ he realized that he can model a recursive-descent parser with hierarchical-object
+ composition of primitives (terminals) and composites (productions). The original
+ version was implemented with run-time polymorphic classes. A parser was generated
+ at run time by feeding in production rule strings such as:
+ 
+<pre class="programlisting">"prod ::= {'A' | 'B'} 'C';"
+</pre>
+
+ A compile function compiled the parser, dynamically creating a hierarchy of
+ objects and linking semantic actions on the fly. A very early text can be found
+ here: pre-Spirit.
+ 
+<a name="spirit.preface._emphasis_2001_to_2006__emphasis_"></a><h4>
+<a name="id586088"></a>
+ <a class="link" href="preface.html#spirit.preface._emphasis_2001_to_2006__emphasis_">2001
+ to 2006</a>
+ </h4>
+
+ Version 1.0 to 1.8 was a complete rewrite of the original Spirit parser using
+ expression templates and static polymorphism, inspired by the works of Todd
+ Veldhuizen (<a href="http://ubiety.uwaterloo.ca/~tveldhui/papers/Expression-Templates/exprtmpl.html" target="_top">Expression
+ Templates</a>, C++ Report, June 1995). Initially, the static-Spirit version
+ was meant only to replace the core of the original dynamic-Spirit. Dynamic-Spirit
+ needed a parser to implement itself anyway. The original employed a hand-coded
+ recursive-descent parser to parse the input grammar specification strings.
+ It was at this time when Hartmut Kaiser joined the Spirit development.
+ 
+
+ After its initial "open-source" debut in May 2001, static-Spirit
+ became a success. At around November 2001, the Spirit website had an activity
+ percentile of 98%, making it the number one parser tool at Source Forge at
+ the time. Not bad for a niche project like a parser library. The "static"
+ portion of Spirit was forgotten and static-Spirit simply became Spirit. The
+ library soon evolved to acquire more dynamic features.
+ 
+
+ Spirit was formally accepted into Boost
+ in October 2002. Boost is a peer-reviewed, open collaborative development effort
+ around a collection of free Open Source C++ libraries covering a wide range
+ of domains. The Boost Libraries have become widely known as an industry standard
+ for design and implementation quality, robustness, and reusability.
+ 
+<a name="spirit.preface._emphasis_2007__emphasis_"></a><h4>
+<a name="id586123"></a>
+ <a class="link" href="preface.html#spirit.preface._emphasis_2007__emphasis_">2007</a>
+ </h4>
+
+ Over the years, especially after Spirit was accepted into Boost, Spirit has
+ served its purpose quite admirably. Classic-Spirit
+ (versions prior to 2.0) focused on transduction parsing, where the input string
+ is merely translated to an output string. Many parsers fall into the transduction
+ type. When the time came to add attributes to the parser library, it was done
+ in a rather ad-hoc manner, with the goal being 100% backward compatible with
+ Classic Spirit. As a result, some parsers have attributes, some don't.
+ 
+
+ Spirit V2 is another major rewrite. Spirit V2 grammars are fully attributed
+ (see <a href="http://en.wikipedia.org/wiki/Attribute_grammar" target="_top">Attribute
+ Grammar</a>) which means that all parser components have attributes. To
+ do this efficiently and elegantly, we had to use a couple of infrastructure
+ libraries. Some did not exist, some were quite new when Spirit debuted, and
+ some needed work. Boost.Mpl
+ is an important infrastructure library, yet is not sufficient to implement
+ Spirit V2. Another library had to be written: Boost.Fusion.
+ Fusion sits between MPL and STL --between compile time and runtime -- mapping
+ types to values. Fusion is a direct descendant of both MPL and Boost.Tuples.
+ Fusion is now a full-fledged Boost
+ library. Phoenix also
+ had to be beefed up to support Spirit V2. The result is Boost.Phoenix.
+ Last but not least, Spirit V2 uses an <a href="http://ubiety.uwaterloo.ca/~tveldhui/papers/Expression-Templates/exprtmpl.html" target="_top">Expression
+ Templates</a> library called Boost.Proto.
+ 
+
+ Even though it has evolved and matured to become a multi-module library, Spirit
+ is still used for micro-parsing tasks as well as scripting languages. Like
+ C++, you only pay for features that you need. The power of Spirit comes from
+ its modularity and extensibility. Instead of giving you a sledgehammer, it
+ gives you the right ingredients to easily create a sledgehammer.
+ 
+<a name="spirit.preface.new_ideas__spirit_v2"></a><h4>
+<a name="id586198"></a>
+ <a class="link" href="preface.html#spirit.preface.new_ideas__spirit_v2">New Ideas: Spirit V2</a>
+ </h4>
+
+ Just before the development of Spirit V2 began, Hartmut came across the StringTemplate library that is
+ a part of the ANTLR parser framework. attribute quote to http:/www.stringtemplate.org
+ It is a Java template engine (with ports for C# and Python) for generating
+ source code, web pages, emails, or any other formatted text output. end
+ of quote! The concepts presented in that library lead Hartmut to
+ the next step in the evolution of Spirit. Parsing and generation are tightly
+ connected to a formal notation, or a grammar. The grammar describes both input
+ and output, and therefore, a parser library should have a grammar driven output.
+ This duality is expressed in Spirit by the parser library Spirit.Qi
+ and the generator library Spirit.Karma using the same
+ component infastructure.
+ 
+
+ The idea of creating a lexer library well integrated with the Spirit parsers
+ is not new. This has been discussed almost since Classic-Spirit (pre V2) initially
+ debuted. Several attempts to integrate existing lexer libraries and frameworks
+ with Spirit have been made and served as a proof of concept and usability (for
+ example see Wave:
+ The Boost C/C++ Preprocessor Library, and SLex:
+ a fully dynamic C++ lexer implemented with Spirit). Based on these experiences
+ we added Spirit.Lex: a fully integrated lexer library
+ to the mix, allowing the user to take advantage of the power of regular expressions
+ for token matching, removing pressure from the parser components, simplifying
+ parser grammars. Again, Spirit's modular structure allowed us to reuse the
+ same underlying component library as for the parser and generator libraries.
+ 
+<a name="spirit.preface.how_to_use_this_manual"></a><h4>
+<a name="id586255"></a>
+ <a class="link" href="preface.html#spirit.preface.how_to_use_this_manual">How to use this manual</a>
+ </h4>
+
+ Each major section (there are 3: <a class="link" href="qi.html" title="Qi - Writing Parsers">Qi</a>, <a class="link" href="karma.html" title="Karma - Writing Generators">Karma</a>, and <a class="link" href="lex.html" title="Lex - Writing Lexical Analyzers">Lex</a>)
+ is roughly divided into 3 parts:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Tutorials: A step by step guide with heavily annotated code. These are meant
+ to get the user acquainted with the library as quickly as possible. The objective
+ is to build the confidence of the user in using the library through abundant
+ examples and detailed instructions. Examples speak volumes and we have volumes
+ of examples!
+ </li>
+<li class="listitem">
+ Abstracts: A high level summary of key topics. The objective is to give the
+ user a high level view of the library, the key concepts, background and theories.
+ </li>
+<li class="listitem">
+ Reference: Detailed formal technical reference. We start with a quick reference
+ -- an easy to use table that maps into the reference proper. The reference
+ proper starts with C++ Concepts
+ followed by models of the concepts.
+ </li>
+</ol></div>
+
+ Some icons are used to mark certain topics indicative of their relevance. These
+ icons precede some text to indicate:
+ 
+<div class="table">
+<a name="id586308"></a>Table 1. Icons
+<div class="table-contents"><table class="table" summary="Icons">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Icon
+ 
+ </th>
+<th>
+ 
+ Name
+ 
+ </th>
+<th>
+ 
+ Meaning
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <img src="../../images/note.png" alt="note">
+ 
+ </td>
+<td>
+ 
+ Note
+ 
+ </td>
+<td>
+ 
+ Generally useful information (an aside that doesn't fit in the flow of
+ the text)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <img src="../../images/tip.png" alt="tip">
+ 
+ </td>
+<td>
+ 
+ Tip
+ 
+ </td>
+<td>
+ 
+ Suggestion on how to do something (especially something that not be obvious)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <img src="../../images/important.png" alt="important">
+ 
+ </td>
+<td>
+ 
+ Important
+ 
+ </td>
+<td>
+ 
+ Important note on something to take particular notice of
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <img src="../../images/caution.png" alt="caution">
+ 
+ </td>
+<td>
+ 
+ Caution
+ 
+ </td>
+<td>
+ 
+ Take special care with this - it may not be what you expect and may cause
+ bad results
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <img src="../../images/alert.png" alt="alert">
+ 
+ </td>
+<td>
+ 
+ Danger
+ 
+ </td>
+<td>
+ 
+ This is likely to cause serious trouble if ignored
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ 
+ This documentation is automatically generated by Boost QuickBook documentation
+ tool. QuickBook can be found in the <a href="http://www.boost.org/tools/index.html" target="_top">Boost
+ Tools</a>.
+ 
+<a name="spirit.preface.support"></a><h4>
+<a name="id586549"></a>
+ <a class="link" href="preface.html#spirit.preface.support">Support</a>
+ </h4>
+
+ Please direct all questions to Spirit's mailing list. You can subscribe to
+ the <a href="http://www.nabble.com/The-Spirit-Parser-Library-f3430.html" target="_top">Spirit
+ General List</a>. The mailing list has a searchable archive. A search link
+ to this archive is provided in Spirit's
+ home page. You may also read and post messages to the mailing list through
+ <a href="news://news.gmane.org/gmane.comp.spirit.general" target="_top">Spirit General
+ NNTP news portal</a> (thanks to Gmane).
+ The news group mirrors the mailing list. Here is a link to the archives: http://news.gmane.org/gmane.comp.parsers.spirit.general.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="what_s_new.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,91 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Qi - Writing Parsers</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="abstracts/parsing_expression_grammar.html" title="Parsing Expression Grammar">
+<link rel="next" href="qi/tutorials.html" title="Tutorials">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="abstracts/parsing_expression_grammar.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="qi/tutorials.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Qi - Writing Parsers">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.qi"></a><a class="link" href="qi.html" title="Qi - Writing Parsers"> Qi - Writing Parsers</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt>Tutorials</dt>
+<dd><dl>
+<dt>Quick Start</dt>
+<dt>Warming up</dt>
+<dt>Semantic Actions</dt>
+<dt><a href="qi/tutorials/complex___our_first_complex_parser.html">Complex
+ - Our first complex parser</a></dt>
+<dt><a href="qi/tutorials/sum___adding_numbers.html">Sum - adding
+ numbers</a></dt>
+<dt><a href="qi/tutorials/number_list___stuffing_numbers_into_a_std__vector.html">Number
+ List - stuffing numbers into a std::vector</a></dt>
+<dt><a href="qi/tutorials/number_list_redux___list_syntax.html">Number
+ List Redux - list syntax</a></dt>
+<dt><a href="qi/tutorials/number_list_attribute___one_more__with_style.html">Number
+ List Attribute - one more, with style</a></dt>
+<dt>Roman Numerals</dt>
+<dt><a href="qi/tutorials/employee___parsing_into_structs.html">Employee
+ - Parsing into structs</a></dt>
+<dt>Mini XML - ASTs!</dt>
+<dt><a href="qi/tutorials/mini_xml___error_handling.html">Mini
+ XML - Error Handling</a></dt>
+</dl></dd>
+<dt>Quick Reference</dt>
+<dd><dl>
+<dt>Common Notation</dt>
+<dt>Qi Parsers</dt>
+<dt><a href="qi/quick_reference/compound_attribute_rules.html">Compound
+ Attribute Rules</a></dt>
+<dt>Non-terminals</dt>
+<dt><a href="qi/quick_reference/semantic_actions.html">Semantic
+ Actions</a></dt>
+<dt>Phoenix</dt>
+</dl></dd>
+<dt>Reference</dt>
+<dd><dl>
+<dt>Parser Concepts</dt>
+<dt>Basics</dt>
+<dt>Auxiliary</dt>
+<dt> Binary</dt>
+<dt>Char</dt>
+<dt> Directive</dt>
+<dt>Numeric</dt>
+<dt>Operator</dt>
+<dt>String</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="abstracts/parsing_expression_grammar.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="qi/tutorials.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,61 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Quick Reference</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi.html" title="Qi - Writing Parsers">
+<link rel="prev" href="tutorials/mini_xml___error_handling.html" title="Mini XML - Error Handling">
+<link rel="next" href="quick_reference/common_notation.html" title="Common Notation">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="tutorials/mini_xml___error_handling.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="quick_reference/common_notation.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Quick Reference">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.qi.quick_reference"></a><a class="link" href="quick_reference.html" title="Quick Reference">Quick Reference</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt>Common Notation</dt>
+<dt>Qi Parsers</dt>
+<dt><a href="quick_reference/compound_attribute_rules.html">Compound
+ Attribute Rules</a></dt>
+<dt>Non-terminals</dt>
+<dt><a href="quick_reference/semantic_actions.html">Semantic
+ Actions</a></dt>
+<dt>Phoenix</dt>
+</dl></div>
+
+ This quick reference section is provided for convenience. You can use this
+ section as a sort of a "cheat-sheet" on the most commonly used
+ Qi components. It is not intended to be complete, but should give you an
+ easy way to recall a particular component without having to dig up on pages
+ and pages of reference doumentation.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="tutorials/mini_xml___error_handling.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="quick_reference/common_notation.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/common_notation.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/common_notation.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,151 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Common Notation</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="../quick_reference.html" title="Quick Reference">
+<link rel="next" href="qi_parsers.html" title="Qi Parsers">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="qi_parsers.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Common Notation">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.quick_reference.common_notation"></a><a class="link" href="common_notation.html" title="Common Notation">Common Notation</a>
+</h4></div></div></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">P</code></dt>
+<dd>
+ Parser type
+ </dd>
+<dt><code class="computeroutput">p, a,
+ b,
+ c</code></dt>
+<dd>
+ Parser objects
+ </dd>
+<dt><code class="computeroutput">A, B,
+ C</code></dt>
+<dd>
+ Attribute types of parsers <code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code> and <code class="computeroutput">c</code>
+ </dd>
+<dt><code class="computeroutput">I</code></dt>
+<dd>
+ The iterator type used for parsing
+ </dd>
+<dt><code class="computeroutput">Unused</code></dt>
+<dd>
+ An <code class="computeroutput">unused_type</code>
+ </dd>
+<dt><code class="computeroutput">Context</code></dt>
+<dd>
+ The enclosing rule's <code class="computeroutput">Context</code>
+ type
+ </dd>
+<dt><code class="computeroutput">attrib</code></dt>
+<dd>
+ An attribute value
+ </dd>
+<dt><code class="computeroutput">Attrib</code></dt>
+<dd>
+ An attribute type
+ </dd>
+<dt><code class="computeroutput">b</code></dt>
+<dd>
+ A boolean expression
+ </dd>
+<dt><code class="computeroutput">fp</code></dt>
+<dd>
+ A (lazy parser) function with signature <code class="computeroutput">P(Unused, Context)</code>
+ </dd>
+<dt><code class="computeroutput">fa</code></dt>
+<dd>
+ A (semantic action) function with signature <code class="computeroutput">void(Attrib, Context, bool&)</code>. The third parameter is a boolean
+ flag that can be set to false to force the parse to fail. Both <code class="computeroutput">Context</code> and the boolean flag are
+ optional.
+ </dd>
+<dt><code class="computeroutput">first</code></dt>
+<dd>
+ An iterator pointing to the start of input
+ </dd>
+<dt><code class="computeroutput">last</code></dt>
+<dd>
+ An iterator pointing to the end of input
+ </dd>
+<dt><code class="computeroutput">Ch</code></dt>
+<dd>
+ Character-class specific character type (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">ch</code></dt>
+<dd>
+ Character-class specific character (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">ch2</code></dt>
+<dd>
+ Character-class specific character (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">charset</code></dt>
+<dd>
+ Character-set specifier string (example: "a-z0-9")
+ </dd>
+<dt><code class="computeroutput">str</code></dt>
+<dd>
+ Character-class specific string (See Character Class Types)
+ </dd>
+<dt><code class="computeroutput">Str</code></dt>
+<dd>
+ Attribute of <code class="computeroutput">str</code>:
+ <code class="computeroutput">std::basic_string<T></code>
+ where <code class="computeroutput">T</code> is the underlying
+ character type of <code class="computeroutput">str</code>
+ </dd>
+<dt><code class="computeroutput">tuple<></code></dt>
+<dd>
+ Used as a placeholder for a fusion sequence
+ </dd>
+<dt><code class="computeroutput">vector<></code></dt>
+<dd>
+ Used as a placeholder for an STL container
+ </dd>
+<dt><code class="computeroutput">variant<></code></dt>
+<dd>
+ Used as a placeholder for a boost::variant
+ </dd>
+<dt><code class="computeroutput">optional<></code></dt>
+<dd>
+ Used as a placeholder for a boost::optional
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="qi_parsers.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/compound_attribute_rules.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/compound_attribute_rules.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,339 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Compound Attribute Rules</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="qi_parsers/action.html" title="action">
+<link rel="next" href="non_terminals.html" title="Non-terminals">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="qi_parsers/action.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="non_terminals.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Compound Attribute Rules">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.quick_reference.compound_attribute_rules"></a><a class="link" href="compound_attribute_rules.html" title="Compound Attribute Rules">Compound
+ Attribute Rules</a>
+</h4></div></div></div>
+<a name="spirit.qi.quick_reference.compound_attribute_rules.notation"></a><h6>
+<a name="id626914"></a>
+ <a class="link" href="compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Notation</a>
+ </h6>
+
+ The notation we will use will be of the form:
+ 
+<pre class="programlisting">a: A, b: B, ... --> composite-expression: composite-attribute
+</pre>
+
+ <code class="computeroutput">a</code>, <code class="computeroutput">b</code>,
+ etc. are the operands. <code class="computeroutput">A</code>,
+ <code class="computeroutput">B</code>, etc. are the operand's
+ attribute types. <code class="computeroutput">composite-expression</code>
+ is the expression involving the operands and <code class="computeroutput">composite-attribute</code>
+ is the resulting attribute type of the composite expression.
+ 
+
+ For instance:
+ 
+<pre class="programlisting">a: A, b: B --> (a >> b): tuple<A, B>
+</pre>
+
+ reads as: given, <code class="computeroutput">a</code> and
+ <code class="computeroutput">b</code> are parsers, and <code class="computeroutput">A</code> is the type of the attribute of <code class="computeroutput">a</code>, and <code class="computeroutput">B</code>
+ is the type of the attribute of <code class="computeroutput">b</code>,
+ then the type of the attribute of <code class="computeroutput">a
+ >> b</code>
+ will be <code class="computeroutput">tuple<A, B></code>.
+ 
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ In the attribute tables, we will use <code class="computeroutput">vector<A></code> and <code class="computeroutput">tuple<A, B...></code> as placeholders only. The notation
+ of <code class="computeroutput">vector<A></code>
+ stands for any STL
+ container holding elements of type <code class="computeroutput">A</code>
+ and the notation <code class="computeroutput">tuple<A, B...></code> stands for any Boost.Fusion sequence
+ holding <code class="computeroutput">A</code>, <code class="computeroutput">B</code>, ... etc. elements. Finally, <code class="computeroutput">Unused</code> stands for <code class="computeroutput">unused_type</code>.
+ </td></tr>
+</table></div>
+<a name="spirit.qi.quick_reference.compound_attribute_rules.compound_parser_attribute_types"></a><h6>
+<a name="id627396"></a>
+ <a class="link" href="compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.compound_parser_attribute_types">Compound
+ Parser Attribute Types</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ sequence (<code class="computeroutput">>></code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a >> b): tuple<A, B>
+a: A, b: Unused --> (a >> b): A
+a: Unused, b: B --> (a >> b): B
+a: Unused, b: Unused --> (a >> b): Unused
+
+a: A, b: A --> (a >> b): vector<A>
+a: vector<A>, b: A --> (a >> b): vector<A>
+a: A, b: vector<A> --> (a >> b): vector<A>
+a: vector<A>, b: vector<A> --> (a >> b): vector<A></pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ expect (<code class="computeroutput">></code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a > b): tuple<A, B>
+a: A, b: Unused --> (a > b): A
+a: Unused, b: B --> (a > b): B
+a: Unused, b: Unused --> (a > b): Unused
+
+a: A, b: A --> (a > b): vector<A>
+a: vector<A>, b: A --> (a > b): vector<A>
+a: A, b: vector<A> --> (a > b): vector<A>
+a: vector<A>, b: vector<A> --> (a > b): vector<A></pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ alternative (<code class="computeroutput">|</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a | b): variant<A, B>
+a: A, b: Unused --> (a | b): A
+a: Unused, b: B --> (a | b): B
+a: Unused, b: Unused --> (a | b): Unused
+a: A, b: A --> (a | b): A</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ difference (<code class="computeroutput">-</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a - b): A
+a: Unused, b: B --> (a - b): Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ kleene (unary <code class="computeroutput">*</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> *a: vector<A>
+a: Unused --> *a: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ plus (unary <code class="computeroutput">+</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> +a: vector<A>
+a: Unused --> +a: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ list (<code class="computeroutput">%</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a % b): vector<A>
+a: Unused, b: B --> (a % b): Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ repetition
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat(...,...)[a]: vector<A>
+a: Unused --> repeat(...,...)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ sequential or (<code class="computeroutput">||</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a || b): tuple<optional<A>, optional<B> >
+a: A, b: Unused --> (a || b): optional<A>
+a: Unused, b: B --> (a || b): optional<B>
+a: Unused, b: Unused --> (a || b): Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ optional (unary <code class="computeroutput">-</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> -a: optional<A>
+a: Unused --> -a: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ and predicate (<code class="computeroutput">&</code>)
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">a:
+ A -->
+ &a: Unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ not predicate (<code class="computeroutput">!</code>)
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">a:
+ A -->
+ !a: Unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ permutation (<code class="computeroutput">^</code>)
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a ^ b): tuple<optional<A>, optional<B> >
+a: A, b: Unused --> (a ^ b): optional<A>
+a: Unused, b: B --> (a ^ b): optional<B>
+a: Unused, b: Unused --> (a ^ b): Unused</pre>
+
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="qi_parsers/action.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="non_terminals.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/non_terminals.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/non_terminals.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,342 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Non-terminals</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="compound_attribute_rules.html" title="Compound Attribute Rules">
+<link rel="next" href="semantic_actions.html" title="Semantic Actions">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="compound_attribute_rules.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Non-terminals">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.quick_reference.non_terminals"></a><a class="link" href="non_terminals.html" title="Non-terminals">Non-terminals</a>
+</h4></div></div></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">RT</code></dt>
+<dd>
+ Synthesized attribute. The rule or grammar's return type.
+ </dd>
+<dt><code class="computeroutput">Arg1</code>,
+ <code class="computeroutput">Arg2</code>, <code class="computeroutput">ArgN</code></dt>
+<dd>
+ Inherited attributes. Zero or more arguments.
+ </dd>
+<dt><code class="computeroutput">L1</code>,
+ <code class="computeroutput">L2</code>, <code class="computeroutput">LN</code></dt>
+<dd>
+ Zero or more local variables.
+ </dd>
+<dt><code class="computeroutput">r, r2</code></dt>
+<dd>
+ Rules
+ </dd>
+<dt><code class="computeroutput">g</code></dt>
+<dd>
+ A grammar
+ </dd>
+<dt><code class="computeroutput">p</code></dt>
+<dd>
+ A parser expression
+ </dd>
+<dt><code class="computeroutput">my_grammar</code></dt>
+<dd>
+ A user defined grammar
+ </dd>
+</dl>
+</div>
+<div class="variablelist" title="Terminology">
+Terminology
+<dl>
+<dt>Signature</dt>
+<dd>
+ <code class="computeroutput">RT(Arg1, Arg2 ...
+ ,ArgN)</code>. The signature specifies the synthesized
+ (return value) and inherited (arguments) attributes.
+ </dd>
+<dt>Locals</dt>
+<dd>
+ <code class="computeroutput">locals<L1, L2 ...,
+ LN></code>.
+ The local variables.
+ </dd>
+<dt>Skipper</dt>
+<dd>
+ The skip-parser type
+ </dd>
+</dl>
+</div>
+<div class="variablelist" title="Template Arguments">
+Template Arguments
+<dl>
+<dt><code class="computeroutput">Iterator</code></dt>
+<dd>
+ The iterator type you will use for parsing.
+ </dd>
+<dt><code class="computeroutput">A1</code>,
+ <code class="computeroutput">A2</code>, <code class="computeroutput">A3</code></dt>
+<dd>
+ Can be one of 1)Signature 2)Locals 3)Skipper.
+ </dd>
+</dl>
+</div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">rule<Iterator,
+ A1,
+ A2,
+ A3>
+ r(name);</code>
+ 
+ </td>
+<td>
+ 
+ Rule declaration. <code class="computeroutput">Iterator</code>
+ is required. <code class="computeroutput">A1, A2, A3</code>
+ are optional and can be specified in any order. <code class="computeroutput">name</code>
+ is an optional string that gives the rule its name, useful for
+ debugging and error handling.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">rule<Iterator,
+ A1,
+ A2,
+ A3>
+ r(r2);</code>
+ 
+ </td>
+<td>
+ 
+ Copy construct rule <code class="computeroutput">r</code>
+ from rule <code class="computeroutput">r2</code>.
+ <code class="computeroutput">boost::shared_ptr</code> semantics.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r =
+ r2;</code>
+ 
+ </td>
+<td>
+ 
+ Assign rule <code class="computeroutput">r2</code>
+ to <code class="computeroutput">r</code>. <code class="computeroutput">boost::shared_ptr</code> semantics.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r.alias()</code>
+ 
+ </td>
+<td>
+ 
+ return an alias of <code class="computeroutput">r</code>.
+ The alias is a parser that holds a reference to <code class="computeroutput">r</code>.
+ Reference semantics.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r.copy()</code>
+ 
+ </td>
+<td>
+ 
+ Get a copy of <code class="computeroutput">r</code>.
+ <code class="computeroutput">boost::shared_ptr</code> semantics.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r.name(name)</code>
+ 
+ </td>
+<td>
+ 
+ Naming a rule
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r.name()</code>
+ 
+ </td>
+<td>
+ 
+ Getting the name of a rule
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ debug(r)
+ 
+ </td>
+<td>
+ 
+ Debug rule <code class="computeroutput">r</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r =
+ p;</code>
+ 
+ </td>
+<td>
+ 
+ Rule definition
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">r %=
+ p;</code>
+ 
+ </td>
+<td>
+ 
+ Auto-rule definition. The attribute of <code class="computeroutput">p</code>
+ should be compatible with the synthesized attribute of <code class="computeroutput">r</code>. When <code class="computeroutput">p</code>
+ is successful, its attribute is automatically propagated to <code class="computeroutput">r</code>'s synthesized attribute.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">template <typename Iterator>
+struct my_grammar : grammar<Iterator, A1, A2, A3>
+{
+ my_grammar() : my_grammar::base_type(start, name)
+ {
+ // Rule definitions
+ start = /* ... */;
+ }
+
+ rule<Iterator, A1, A2, A3> start;
+ // more rule declarations...
+};
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ Grammar definition. <code class="computeroutput">name</code>
+ is an optional string that gives the grammar its name, useful for
+ debugging and error handling.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ my_grammar<Iterator> g
+ 
+ </td>
+<td>
+ 
+ Instantiating a grammar
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">g.name(name)</code>
+ 
+ </td>
+<td>
+ 
+ Naming a grammar
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">g.name()</code>
+ 
+ </td>
+<td>
+ 
+ Getting the name of a grammar
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="compound_attribute_rules.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/phoenix.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/phoenix.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,86 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Phoenix</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="semantic_actions.html" title="Semantic Actions">
+<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"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Phoenix">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.quick_reference.phoenix"></a><a class="link" href="phoenix.html" title="Phoenix">Phoenix</a>
+</h4></div></div></div>
+
+ Boost.Phoenix makes
+ it easier to attach semantic actions. You just inline your lambda expressions:
+ 
+<pre class="programlisting">p[phoenix-lambda-expression]
+</pre>
+
+ Spirit.Qi provides some Boost.Phoenix
+ placeholders to important information from the <code class="computeroutput">Attrib</code>
+ and <code class="computeroutput">Context</code> that are otherwise
+ fiddly to extract.
+ 
+<div class="variablelist" title="Spirit.Qi specific Phoenix placeholders">
+Spirit.Qi specific Phoenix placeholders
+<dl>
+<dt><code class="computeroutput">_1, _2... , _N</code></dt>
+<dd>
+ Nth attribute of <code class="computeroutput">p</code>
+ </dd>
+<dt><code class="computeroutput">_val</code></dt>
+<dd>
+ The enclosing rule's synthesized attribute.
+ </dd>
+<dt><code class="computeroutput">_r1, _r2... , _rN</code></dt>
+<dd>
+ The enclosing rule's Nth inherited attribute.
+ </dd>
+<dt><code class="computeroutput">_a, _b... , _j</code></dt>
+<dd>
+ The enclosing rule's local variables (<code class="computeroutput">_a</code>
+ refers to the first).
+ </dd>
+<dt><code class="computeroutput">_val</code></dt>
+<dd>
+ The enclosing rule's synthesized attribute.
+ </dd>
+<dt><code class="computeroutput">_pass</code></dt>
+<dd>
+ Assign <code class="computeroutput">false</code> to <code class="computeroutput">_pass</code> to force a parser failure.
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,54 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Qi Parsers</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="common_notation.html" title="Common Notation">
+<link rel="next" href="qi_parsers/char.html" title="char">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="common_notation.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="qi_parsers/char.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Qi Parsers">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.quick_reference.qi_parsers"></a><a class="link" href="qi_parsers.html" title="Qi Parsers">Qi Parsers</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt>char</dt>
+<dt>numeric</dt>
+<dt>string</dt>
+<dt>auxiliary</dt>
+<dt>binary</dt>
+<dt>directive</dt>
+<dt>operator</dt>
+<dt>action</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="common_notation.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="qi_parsers/char.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/action.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/action.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,86 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>action</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi_parsers.html" title="Qi Parsers">
+<link rel="prev" href="operator.html" title="operator">
+<link rel="next" href="../compound_attribute_rules.html" title="Compound Attribute Rules">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="operator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../compound_attribute_rules.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="action">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.quick_reference.qi_parsers.action"></a><a class="link" href="action.html" title="action">action</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">p[fa]</code>
+ 
+ </td>
+<td>
+ 
+ Attribute of <code class="computeroutput">p</code>
+ 
+ </td>
+<td>
+ 
+ Call semantic action, <code class="computeroutput">fa</code>
+ if p succeeds.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="operator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../compound_attribute_rules.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/auxiliary.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/auxiliary.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,195 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>auxiliary</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi_parsers.html" title="Qi Parsers">
+<link rel="prev" href="string.html" title="string">
+<link rel="next" href="binary.html" title="binary">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="auxiliary">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.quick_reference.qi_parsers.auxiliary"></a><a class="link" href="auxiliary.html" title="auxiliary">auxiliary</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eol</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Matches the end of line (<code class="computeroutput">\r</code> or <code class="computeroutput">\n</code> or <code class="computeroutput">\r\n</code>)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eoi</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Matches the end of input (first == last)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Match an empty string
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps(b)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ If <code class="computeroutput">b</code> is true,
+ match an empty string
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lazy(fp)</code>
+ 
+ </td>
+<td>
+ 
+ Attribute of <code class="computeroutput">P</code>
+ where <code class="computeroutput">P</code> is the
+ return type of <code class="computeroutput">fp</code>
+ 
+ </td>
+<td>
+ 
+ Invoke <code class="computeroutput">fp</code> at
+ parse time, returning a parser <code class="computeroutput">p</code>
+ which is then called to parse.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">fp</code>
+ 
+ </td>
+<td>
+ 
+ see <code class="computeroutput">lazy(fp)</code>
+ above
+ 
+ </td>
+<td>
+ 
+ Equivalent to <code class="computeroutput">lazy[fp]</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/auxiliary/attr.html" title="Attribute (attr)"><code class="computeroutput">attr(attrib)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Attrib</code>
+ 
+ </td>
+<td>
+ 
+ Doesn't consume/parse any input, but exposes the argument <code class="computeroutput">attrib</code> as its attribute.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/binary.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/binary.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,240 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>binary</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi_parsers.html" title="Qi Parsers">
+<link rel="prev" href="auxiliary.html" title="auxiliary">
+<link rel="next" href="directive.html" title="directive">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="auxiliary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="directive.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="binary">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.quick_reference.qi_parsers.binary"></a><a class="link" href="binary.html" title="binary">binary</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">byte_</code>
+ 
+ </td>
+<td>
+ 
+ 8 bits native endian
+ 
+ </td>
+<td>
+ 
+ Matches an 8 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">word</code>
+ 
+ </td>
+<td>
+ 
+ 16 bits native endian
+ 
+ </td>
+<td>
+ 
+ Matches a 16 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_word</code>
+ 
+ </td>
+<td>
+ 
+ 16 bits big endian
+ 
+ </td>
+<td>
+ 
+ Matches a 16 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_word</code>
+ 
+ </td>
+<td>
+ 
+ 16 bits little endian
+ 
+ </td>
+<td>
+ 
+ Matches a 16 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">dword</code>
+ 
+ </td>
+<td>
+ 
+ 32 bits native endian
+ 
+ </td>
+<td>
+ 
+ Matches a 32 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_dword</code>
+ 
+ </td>
+<td>
+ 
+ 32 bits big endian
+ 
+ </td>
+<td>
+ 
+ Matches a 32 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_dword</code>
+ 
+ </td>
+<td>
+ 
+ 32 bits little endian
+ 
+ </td>
+<td>
+ 
+ Matches a 32 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">qword</code>
+ 
+ </td>
+<td>
+ 
+ 64 bits native endian
+ 
+ </td>
+<td>
+ 
+ Matches a 64 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_qword</code>
+ 
+ </td>
+<td>
+ 
+ 64 bits big endian
+ 
+ </td>
+<td>
+ 
+ Matches a 64 bit binary
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_qword</code>
+ 
+ </td>
+<td>
+ 
+ 64 bits little endian
+ 
+ </td>
+<td>
+ 
+ Matches a 64 bit binary
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="auxiliary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="directive.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/char.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/char.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,407 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>char</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi_parsers.html" title="Qi Parsers">
+<link rel="prev" href="../qi_parsers.html" title="Qi Parsers">
+<link rel="next" href="numeric.html" title="numeric">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="char">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.quick_reference.qi_parsers.char"></a><a class="link" href="char.html" title="char">char</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string/string.html" title="String (string, lit)"><code class="computeroutput">ch</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Matches <code class="computeroutput">ch</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string/string.html" title="String (string, lit)"><code class="computeroutput">lit(ch)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Matches <code class="computeroutput">ch</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches any character
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_(ch)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches <code class="computeroutput">ch</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_("c")</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a single char string literal, <code class="computeroutput">c</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_(ch,
+ ch2)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a range of chars from <code class="computeroutput">ch</code>
+ to <code class="computeroutput">ch2</code> (inclusive)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">char_(charset)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character set <code class="computeroutput">charset</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">alnum</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::isalnum</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">alpha</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::isalpha</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">blank</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::isblank</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">cntrl</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::iscntrl</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">digit</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::isdigit</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">graph</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::isgraph</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">print</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::isprint</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">punct</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::ispunct</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">space</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::isspace</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">xdigit</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::isxdigit</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lower</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::islower</code> in the current character
+ set
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">upper</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Ch</code>
+ 
+ </td>
+<td>
+ 
+ Matches a character based on the equivalent of <code class="computeroutput">std::isupper</code> in the current character
+ set
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/directive.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/directive.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,244 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>directive</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi_parsers.html" title="Qi Parsers">
+<link rel="prev" href="binary.html" title="binary">
+<link rel="next" href="operator.html" title="operator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="operator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="directive">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.quick_reference.qi_parsers.directive"></a><a class="link" href="directive.html" title="directive">directive</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/lexeme.html" title="Inhibiting Skipping (lexeme[])"><code class="computeroutput">lexeme</code></a><code class="computeroutput">[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Disable skip parsing for <code class="computeroutput">a</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/no_case.html" title="Inhibiting Case Sensitivity (no_case[])"><code class="computeroutput">no_case</code></a><code class="computeroutput">[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Inhibits case-sensitivity for <code class="computeroutput">a</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/omit.html" title="Ignoring Attribute (omit[])"><code class="computeroutput">omit</code></a><code class="computeroutput">[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Ignores the attribute type of <code class="computeroutput">a</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/raw.html" title="Transduction Parsing (raw[])"><code class="computeroutput">raw</code></a><code class="computeroutput">[a]</code>
+ 
+ </td>
+<td>
+ 
+ boost::iterator_range<code class="computeroutput"><I></code>
+ 
+ </td>
+<td>
+ 
+ Presents the transduction of <code class="computeroutput">a</code>
+ as an iterator range
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/repeat.html" title="Repetition (repeat[])"><code class="computeroutput">repeat</code></a><code class="computeroutput">[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> zero
+ or more times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/repeat.html" title="Repetition (repeat[])"><code class="computeroutput">repeat</code></a><code class="computeroutput">(N)[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> <code class="computeroutput">N</code> times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/repeat.html" title="Repetition (repeat[])"><code class="computeroutput">repeat</code></a><code class="computeroutput">(N, M)[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> <code class="computeroutput">N</code> to <code class="computeroutput">M</code>
+ times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/repeat.html" title="Repetition (repeat[])"><code class="computeroutput">repeat</code></a><code class="computeroutput">(N, inf)[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> <code class="computeroutput">N</code> or more times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/skip.html" title="Re-Establish Skipping (skip[])"><code class="computeroutput">skip</code></a><code class="computeroutput">[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Re-establish the skipper that got inhibited by lexeme
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/directive/skip.html" title="Re-Establish Skipping (skip[])"><code class="computeroutput">skip</code></a><code class="computeroutput">(p)[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Use <code class="computeroutput">p</code> as a skipper
+ for parsing <code class="computeroutput">a</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="operator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/numeric.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/numeric.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,310 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>numeric</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi_parsers.html" title="Qi Parsers">
+<link rel="prev" href="char.html" title="char">
+<link rel="next" href="string.html" title="string">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="numeric">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.quick_reference.qi_parsers.numeric"></a><a class="link" href="numeric.html" title="numeric">numeric</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">float_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">float</code>
+ 
+ </td>
+<td>
+ 
+ Parse a floating point number into a <code class="computeroutput">float</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">double_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">double</code>
+ 
+ </td>
+<td>
+ 
+ Parse a floating point number into a <code class="computeroutput">double</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_double</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long double</code>
+ 
+ </td>
+<td>
+ 
+ Parse a floating point number into a <code class="computeroutput">long
+ double</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">bin</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned</code>
+ 
+ </td>
+<td>
+ 
+ Parse a binary integer into an <code class="computeroutput">unsigned</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">oct</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned</code>
+ 
+ </td>
+<td>
+ 
+ Parse an octal integer into an <code class="computeroutput">unsigned</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">hex</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned</code>
+ 
+ </td>
+<td>
+ 
+ Parse a hexadecimal integer into an <code class="computeroutput">unsigned</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ushort_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned short</code>
+ 
+ </td>
+<td>
+ 
+ Parse an unsigned short integer
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ulong_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long</code>
+ 
+ </td>
+<td>
+ 
+ Parse an unsigned long integer
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">uint_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned int</code>
+ 
+ </td>
+<td>
+ 
+ Parse an unsigned int
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ulong_long</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unsigned long
+ long</code>
+ 
+ </td>
+<td>
+ 
+ Parse an unsigned long long
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">short_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">short</code>
+ 
+ </td>
+<td>
+ 
+ Parse a short integer
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long</code>
+ 
+ </td>
+<td>
+ 
+ Parse a long integer
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">int_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">int</code>
+ 
+ </td>
+<td>
+ 
+ Parse an int
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_long</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">long long</code>
+ 
+ </td>
+<td>
+ 
+ Parse a long long
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/operator.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/operator.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,306 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>operator</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi_parsers.html" title="Qi Parsers">
+<link rel="prev" href="directive.html" title="directive">
+<link rel="next" href="action.html" title="action">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="directive.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="action.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="operator">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.quick_reference.qi_parsers.operator"></a><a class="link" href="operator.html" title="operator">operator</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">!a</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Not predicate. If the predicate <code class="computeroutput">a</code>
+ matches, fail. Otherwise, return a zero length match.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">&a</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ And predicate. If the predicate <code class="computeroutput">a</code>
+ matches, return a zero length match. Otherwise, fail.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">-a</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">optional<A></code>
+ 
+ </td>
+<td>
+ 
+ Optional. Parse <code class="computeroutput">a</code>
+ zero or one time
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">*a</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Kleene. Parse <code class="computeroutput">a</code>
+ zero or more times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">+a</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ Plus. Parse <code class="computeroutput">a</code>
+ one or more times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">a |
+ b</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">variant<A,
+ B></code>
+ 
+ </td>
+<td>
+ 
+ Alternative. Parse <code class="computeroutput">a</code>
+ or <code class="computeroutput">b</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">a >>
+ b</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">tuple<A,
+ B></code>
+ 
+ </td>
+<td>
+ 
+ Sequence. Parse <code class="computeroutput">a</code>
+ followed by <code class="computeroutput">b</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">a >
+ b</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">tuple<A,
+ B></code>
+ 
+ </td>
+<td>
+ 
+ Expect. Parse <code class="computeroutput">a</code>
+ followed by <code class="computeroutput">b</code>.
+ <code class="computeroutput">b</code> is expected
+ to match when <code class="computeroutput">a</code>
+ matches, otherwise, an <code class="computeroutput">expectation_failure</code>
+ is thrown.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">a -
+ b</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+<td>
+ 
+ Difference. Parse <code class="computeroutput">a</code>
+ but not <code class="computeroutput">b</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">a ||
+ b</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">tuple<A,
+ B></code>
+ 
+ </td>
+<td>
+ 
+ Sequential Or. Parse <code class="computeroutput">a</code>
+ or <code class="computeroutput">b</code> or <code class="computeroutput">a</code> followed by <code class="computeroutput">b</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">a %
+ b</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">vector<A></code>
+ 
+ </td>
+<td>
+ 
+ List. Parse <code class="computeroutput">a</code>
+ delimited <code class="computeroutput">b</code> one
+ or more times
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">a ^
+ b</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">tuple<</code>
+ <code class="computeroutput">optional<A>,</code>
+ <code class="computeroutput">optional<B>
+ ></code>
+ 
+ </td>
+<td>
+ 
+ Permutation. Parse <code class="computeroutput">a</code>
+ and <code class="computeroutput">b</code> in any
+ order
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="directive.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="action.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/string.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/qi_parsers/string.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,187 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>string</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi_parsers.html" title="Qi Parsers">
+<link rel="prev" href="numeric.html" title="numeric">
+<link rel="next" href="auxiliary.html" title="auxiliary">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="numeric.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="string">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.quick_reference.qi_parsers.string"></a><a class="link" href="string.html" title="string">string</a>
+</h5></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string/string.html" title="String (string, lit)"><code class="computeroutput">str</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Matches <code class="computeroutput">str</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string/string.html" title="String (string, lit)"><code class="computeroutput">lit(str)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Unused</code>
+ 
+ </td>
+<td>
+ 
+ Matches <code class="computeroutput">str</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string/string.html" title="String (string, lit)"><code class="computeroutput">string(str)</code></a>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">Str</code>
+ 
+ </td>
+<td>
+ 
+ Matches <code class="computeroutput">str</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <a class="link" href="../../reference/string/symbols.html" title="Symbols (symbols)"><code class="computeroutput">symbols<Ch,
+ T></code></a>
+ 
+ </td>
+<td>
+ 
+ N/A
+ 
+ </td>
+<td>
+ 
+ Declare a symbol table, <code class="computeroutput">sym</code>.
+ <code class="computeroutput">Ch</code> is the underlying
+ char type of the symbol table keys. <code class="computeroutput">T</code>
+ is the data type associated with each key.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">sym.add
+ (str1, val1)
+ (str2, val2)
+ /*...more...*/
+;
+</pre>
+
+ 
+ </td>
+<td>
+ 
+ N/A
+ 
+ </td>
+<td>
+ 
+ Add symbols into a symbol table, <code class="computeroutput">sym</code>.
+ val1 and val2 are optional data of type <code class="computeroutput">T</code>,
+ the data type associated with each key.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">T</code>
+ 
+ </td>
+<td>
+ 
+ Matches entries in the symbol table, <code class="computeroutput">sym</code>.
+ If successful, returns the data associated with the key
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="numeric.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi_parsers.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/semantic_actions.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/quick_reference/semantic_actions.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,71 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Semantic Actions</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../quick_reference.html" title="Quick Reference">
+<link rel="prev" href="non_terminals.html" title="Non-terminals">
+<link rel="next" href="phoenix.html" title="Phoenix">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="non_terminals.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="phoenix.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Semantic Actions">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.quick_reference.semantic_actions"></a><a class="link" href="semantic_actions.html" title="Semantic Actions">Semantic
+ Actions</a>
+</h4></div></div></div>
+
+ Has the form:
+ 
+<pre class="programlisting">p[f]
+</pre>
+
+ where <code class="computeroutput">f</code> is a function with
+ the signatures:
+ 
+<pre class="programlisting">void f(Attrib const&);
+void f(Attrib const&, Context&);
+void f(Attrib const&, Context&, bool&);
+</pre>
+
+ You can use <code class="computeroutput">Boost.Bind</code>
+ to bind member functions. For function objects, the allowed signatures
+ are:
+ 
+<pre class="programlisting">void operator()(Attrib const&, unused_type, unused_type) const;
+void operator()(Attrib const&, Context&, unused_type) const;
+void operator()(Attrib const&, Context&, bool&) const;
+</pre>
+
+ The <code class="computeroutput">unused_type</code> is used
+ in the signatures above to signify 'don't care'.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="non_terminals.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="phoenix.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,55 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Reference</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi.html" title="Qi - Writing Parsers">
+<link rel="prev" href="quick_reference/phoenix.html" title="Phoenix">
+<link rel="next" href="reference/parser_concepts.html" title="Parser Concepts">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_reference/phoenix.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/parser_concepts.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Reference">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.qi.reference"></a><a class="link" href="reference.html" title="Reference">Reference</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt>Parser Concepts</dt>
+<dt>Basics</dt>
+<dt>Auxiliary</dt>
+<dt> Binary</dt>
+<dt>Char</dt>
+<dt> Directive</dt>
+<dt>Numeric</dt>
+<dt>Operator</dt>
+<dt>String</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_reference/phoenix.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/parser_concepts.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,68 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Auxiliary</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="basics.html" title="Basics">
+<link rel="next" href="auxiliary/attr.html" title="Attribute (attr)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="basics.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary/attr.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Auxiliary">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.reference.auxiliary"></a><a class="link" href="auxiliary.html" title="Auxiliary">Auxiliary</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt> Attribute (attr)</dt>
+<dt> End of Line (eol)</dt>
+<dt><a href="auxiliary/eoi.html"> End of Input
+ (<code class="computeroutput">eoi</code>)</a></dt>
+<dt> Epsilon (eps)</dt>
+<dt> Lazy (lazy)</dt>
+</dl></div>
+
+ This module includes different auxiliary parsers not fitting into any of
+ the other categories. This module includes the <code class="computeroutput">attr</code>,
+ <code class="computeroutput">eoi</code>, <code class="computeroutput">eol</code>,
+ <code class="computeroutput">eps</code>, and <code class="computeroutput">lazy</code> parsers.
+ 
+<a name="spirit.qi.reference.auxiliary.module_header"></a><h6>
+<a name="id642487"></a>
+ <a class="link" href="auxiliary.html#spirit.qi.reference.auxiliary.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/auxiliary.hpp>
+#include <boost/spirit/include/qi_auxiliary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="basics.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary/attr.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/attr.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/attr.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,258 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Attribute (attr)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../auxiliary.html" title="Auxiliary">
+<link rel="prev" href="../auxiliary.html" title="Auxiliary">
+<link rel="next" href="eol.html" title="End of Line (eol)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="eol.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Attribute (attr)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.auxiliary.attr"></a><a class="link" href="attr.html" title="Attribute (attr)"> Attribute (<code class="computeroutput">attr</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.auxiliary.attr.description"></a><h6>
+<a name="id642578"></a>
+ <a class="link" href="attr.html#spirit.qi.reference.auxiliary.attr.description">Description</a>
+ </h6>
+
+ The Attribute parser does not consume any input, for this reason it always
+ matches an empty string and always succeeds. It's purpose is to expose
+ its specified parameter as an attribute.
+ 
+<a name="spirit.qi.reference.auxiliary.attr.header"></a><h6>
+<a name="id642595"></a>
+ <a class="link" href="attr.html#spirit.qi.reference.auxiliary.attr.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/auxiliary/attr.hpp>
+#include <boost/spirit/include/qi_attr.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.auxiliary.attr.namespace"></a><h6>
+<a name="id642670"></a>
+ <a class="link" href="attr.html#spirit.qi.reference.auxiliary.attr.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::attr // alias:
+ boost::spirit::qi::attr</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.attr.model_of"></a><h6>
+<a name="id642748"></a>
+ <a class="link" href="attr.html#spirit.qi.reference.auxiliary.attr.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A arbitrary typed constant value, e.g. 0.0, "Hello", or
+ a variable of arbitrary type or a __lazyargument_
+ that evaluates to an arbitrary type.
+ </dd>
+<dt><code class="computeroutput">A</code></dt>
+<dd>
+ The type of <code class="computeroutput">a</code> or
+ if it is a __lazyargument_,
+ its return type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.auxiliary.attr.expression_semantics"></a><h6>
+<a name="id642841"></a>
+ <a class="link" href="attr.html#spirit.qi.reference.auxiliary.attr.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">attr(a)</code>
+ 
+ </td>
+<td>
+ 
+ Create a pseudo parser exposing the current value of <code class="computeroutput">a</code> as its attribute without
+ consuming any input at parse time.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.attr.attributes"></a><h6>
+<a name="id642943"></a>
+ <a class="link" href="attr.html#spirit.qi.reference.auxiliary.attr.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">attr(a)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">A</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.attr.complexity"></a><h6>
+<a name="id643032"></a>
+ <a class="link" href="attr.html#spirit.qi.reference.auxiliary.attr.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(1)
+ 
+
+ 
+</blockquote></div>
+
+ The complexity is constant as no input is consumed and no matching is
+ done.
+ 
+<a name="spirit.qi.reference.auxiliary.attr.example"></a><h6>
+<a name="id643060"></a>
+ <a class="link" href="attr.html#spirit.qi.reference.auxiliary.attr.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">namespace phx = boost::phoenix;
+using boost::spirit::qi::attr;
+</pre>
+
+ 
+
+ 
+
+ Using <code class="computeroutput">attr</code> with literals:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string str;
+test_parser_attr("", attr("boost"), str);
+std::cout << str << std::endl; // will print 'boost'
+
+double d;
+test_parser_attr("", attr(1.0), d);
+std::cout << d << std::endl; // will print '1.0'
+</pre>
+
+ 
+
+ 
+
+ Using <code class="computeroutput">attr</code> with Phoenix function objects:
+ 
+
+ 
+
+
+
+<pre class="programlisting">d = 0.0;
+double d1 = 1.2;
+test_parser_attr("", attr(phx::ref(d1)), d);
+std::cout << d << std::endl; // will print '1.2'
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="eol.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eoi.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eoi.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,213 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>End of Input (eoi)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../auxiliary.html" title="Auxiliary">
+<link rel="prev" href="eol.html" title="End of Line (eol)">
+<link rel="next" href="eps.html" title="Epsilon (eps)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eol.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="eps.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="End of Input (eoi)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.auxiliary.eoi"></a><a class="link" href="eoi.html" title="End of Input (eoi)"> End of Input
+ (<code class="computeroutput">eoi</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.auxiliary.eoi.description"></a><h6>
+<a name="id645264"></a>
+ <a class="link" href="eoi.html#spirit.qi.reference.auxiliary.eoi.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">eoi</code> parser matches
+ the end of input (returns a sucessful match with 0 length when the input
+ is exhausted)
+ 
+<a name="spirit.qi.reference.auxiliary.eoi.header"></a><h6>
+<a name="id645288"></a>
+ <a class="link" href="eoi.html#spirit.qi.reference.auxiliary.eoi.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/auxiliary/eoi.hpp>
+#include <boost/spirit/include/qi_eoi.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.auxiliary.eoi.namespace"></a><h6>
+<a name="id645362"></a>
+ <a class="link" href="eoi.html#spirit.qi.reference.auxiliary.eoi.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::eoi // alias:
+ boost::spirit::qi::eoi</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.eoi.model_of"></a><h6>
+<a name="id645440"></a>
+ <a class="link" href="eoi.html#spirit.qi.reference.auxiliary.eoi.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.auxiliary.eoi.expression_semantics"></a><h6>
+<a name="id645474"></a>
+ <a class="link" href="eoi.html#spirit.qi.reference.auxiliary.eoi.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">eoi</code>
+ 
+ </td>
+<td>
+ 
+ Create a parser that matches the end of input.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.eoi.attributes"></a><h6>
+<a name="id645558"></a>
+ <a class="link" href="eoi.html#spirit.qi.reference.auxiliary.eoi.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">eoi</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.eoi.complexity"></a><h6>
+<a name="id645636"></a>
+ <a class="link" href="eoi.html#spirit.qi.reference.auxiliary.eoi.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(1)
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.auxiliary.eoi.example"></a><h6>
+<a name="id645660"></a>
+ <a class="link" href="eoi.html#spirit.qi.reference.auxiliary.eoi.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::eoi;
+</pre>
+
+ 
+
+ 
+
+ Using <code class="computeroutput">eoi</code>:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("", eoi);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eol.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="eps.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eol.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eol.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,211 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>End of Line (eol)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../auxiliary.html" title="Auxiliary">
+<link rel="prev" href="attr.html" title="Attribute (attr)">
+<link rel="next" href="eoi.html" title="End of Input (eoi)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="attr.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="eoi.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="End of Line (eol)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.auxiliary.eol"></a><a class="link" href="eol.html" title="End of Line (eol)"> End of Line (<code class="computeroutput">eol</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.auxiliary.eol.description"></a><h6>
+<a name="id644742"></a>
+ <a class="link" href="eol.html#spirit.qi.reference.auxiliary.eol.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">eol</code> parser matches
+ the end of line (CR/LF and combinations thereof).
+ 
+<a name="spirit.qi.reference.auxiliary.eol.header"></a><h6>
+<a name="id644766"></a>
+ <a class="link" href="eol.html#spirit.qi.reference.auxiliary.eol.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/auxiliary/eol.hpp>
+#include <boost/spirit/include/qi_eol.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.auxiliary.eol.namespace"></a><h6>
+<a name="id644840"></a>
+ <a class="link" href="eol.html#spirit.qi.reference.auxiliary.eol.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::eol // alias:
+ boost::spirit::qi::eol</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.eol.model_of"></a><h6>
+<a name="id644918"></a>
+ <a class="link" href="eol.html#spirit.qi.reference.auxiliary.eol.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.auxiliary.eol.expression_semantics"></a><h6>
+<a name="id644952"></a>
+ <a class="link" href="eol.html#spirit.qi.reference.auxiliary.eol.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">eol</code>
+ 
+ </td>
+<td>
+ 
+ Create a parser that matches the end of line.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.eol.attributes"></a><h6>
+<a name="id645036"></a>
+ <a class="link" href="eol.html#spirit.qi.reference.auxiliary.eol.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">eol</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.eol.complexity"></a><h6>
+<a name="id645114"></a>
+ <a class="link" href="eol.html#spirit.qi.reference.auxiliary.eol.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(1)
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.auxiliary.eol.example"></a><h6>
+<a name="id645138"></a>
+ <a class="link" href="eol.html#spirit.qi.reference.auxiliary.eol.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::eol;
+</pre>
+
+ 
+
+ 
+
+ Using <code class="computeroutput">eol</code>:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("\n", eol);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="attr.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="eoi.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eps.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/eps.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,327 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Epsilon (eps)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../auxiliary.html" title="Auxiliary">
+<link rel="prev" href="eoi.html" title="End of Input (eoi)">
+<link rel="next" href="lazy.html" title="Lazy (lazy)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eoi.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lazy.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Epsilon (eps)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.auxiliary.eps"></a><a class="link" href="eps.html" title="Epsilon (eps)"> Epsilon (<code class="computeroutput">eps</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.auxiliary.eps.description"></a><h6>
+<a name="id645786"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.description">Description</a>
+ </h6>
+
+ The Epsilon (<code class="computeroutput">eps</code>) is
+ a multi-purpose parser that returns a zero length match.
+ 
+<a name="spirit.qi.reference.auxiliary.eps.simple_form"></a><h6>
+<a name="id645810"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.simple_form">Simple
+ Form</a>
+ </h6>
+
+ In its simplest form, <code class="computeroutput">eps</code>
+ matches the null string and always returns a match of zero length:
+ 
+<pre class="programlisting">eps // always returns a zero-length match
+</pre>
+
+ This form is usually used to trigger a semantic action unconditionally.
+ For example, it is useful in triggering error messages when a set of
+ alternatives fail:
+ 
+<pre class="programlisting">r = a | b | c | eps[error()]; // Call error if a, b, and c fail to match
+</pre>
+<a name="spirit.qi.reference.auxiliary.eps.semantic_predicate"></a><h6>
+<a name="id645911"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.semantic_predicate">Semantic
+ Predicate</a>
+ </h6>
+
+ Semantic predicates allow you to attach a conditional function anywhere
+ in the grammar. In this role, the epsilon takes a __lazyargument_
+ that returns <code class="computeroutput">true</code> or <code class="computeroutput">false</code>. The __lazyargument_
+ is typically a test that is called to resolve ambiguity in the grammar.
+ A parse failure will be reported when the __lazyargument_
+ result evaluates to <code class="computeroutput">false</code>.
+ Otherwise an empty match will be reported. The general form is:
+ 
+<pre class="programlisting">eps_p(f) >> rest;
+</pre>
+
+ The __lazyargument_ <code class="computeroutput">f</code> is called to do a semantic test (say,
+ checking if a symbol is in the symbol table). If test returns true,
+ <code class="computeroutput">rest</code> will be evaluated.
+ Otherwise, the production will return early with a no-match without ever
+ touching rest.
+ 
+<a name="spirit.qi.reference.auxiliary.eps.header"></a><h6>
+<a name="id646019"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/auxiliary/eps.hpp>
+#include <boost/spirit/include/qi_eps.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.auxiliary.eps.namespace"></a><h6>
+<a name="id646093"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::eps // alias:
+ boost::spirit::qi::eps</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.eps.model_of"></a><h6>
+<a name="id646171"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">f</code></dt>
+<dd>
+ A __lazyargument_ that evaluates
+ <code class="computeroutput">bool</code>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.auxiliary.eps.expression_semantics"></a><h6>
+<a name="id646242"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps</code>
+ 
+ </td>
+<td>
+ 
+ Match an empty string (always matches).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">eps(f)</code>
+ 
+ </td>
+<td>
+ 
+ If <code class="computeroutput">f</code> evaluates
+ to <code class="computeroutput">true</code>, return
+ a zero length match.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.eps.attributes"></a><h6>
+<a name="id646375"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">eps</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.eps.complexity"></a><h6>
+<a name="id646453"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ For plain (<code class="computeroutput">eps</code>) the
+ complexity is O(1). For Semantic predicates (<code class="computeroutput">eps(f)</code>) the complexity is defined by the
+ function <code class="computeroutput">f</code>.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.auxiliary.eps.example"></a><h6>
+<a name="id647603"></a>
+ <a class="link" href="eps.html#spirit.qi.reference.auxiliary.eps.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::eps;
+using boost::spirit::qi::int_;
+using boost::spirit::qi::_1;
+namespace phx = boost::phoenix;
+</pre>
+
+ 
+
+ 
+
+ 
+
+ Basic <code class="computeroutput">eps</code>:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("", eps); // always matches
+</pre>
+
+ 
+
+ 
+
+ 
+
+ This example simulates the "classic" <code class="computeroutput">if_p</code>
+ parser. Here, <code class="computeroutput">int_</code>
+ will be tried only if the condition, <code class="computeroutput">c</code>,
+ is true.
+ 
+
+ 
+
+
+
+<pre class="programlisting">bool c = true; // a flag
+test_parser("1234", eps(phx::ref(c) == true) >> int_);
+</pre>
+
+ 
+
+ 
+
+ 
+
+ This example simulates the "classic" <code class="computeroutput">while_p</code>
+ parser. Here, the kleene loop will exit once the condition, c, becomes
+ true. Notice that the condition, <code class="computeroutput">c, is turned to
+ </code>false<code class="computeroutput"> when we get
+ to parse
+ </code>4`.
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_phrase_parser("1 2 3 4",
+ *(eps(phx::ref(c) == true) >> int_[phx::ref(c) = (_1 == 4)]));
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eoi.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="lazy.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/lazy.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/auxiliary/lazy.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,277 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Lazy (lazy)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../auxiliary.html" title="Auxiliary">
+<link rel="prev" href="eps.html" title="Epsilon (eps)">
+<link rel="next" href="../binary.html" title="Binary">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eps.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../binary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Lazy (lazy)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.auxiliary.lazy"></a><a class="link" href="lazy.html" title="Lazy (lazy)"> Lazy (<code class="computeroutput">lazy</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.auxiliary.lazy.description"></a><h6>
+<a name="id648167"></a>
+ <a class="link" href="lazy.html#spirit.qi.reference.auxiliary.lazy.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">lazy</code> parser, as its
+ name suggests, invokes a lazy Phoenix
+ function that returns a parser at parse time. This parser will be used
+ once it is created to continue the parse.
+ 
+<a name="spirit.qi.reference.auxiliary.lazy.header"></a><h6>
+<a name="id648197"></a>
+ <a class="link" href="lazy.html#spirit.qi.reference.auxiliary.lazy.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/auxiliary/lazy.hpp>
+#include <boost/spirit/include/qi_lazy.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.auxiliary.lazy.namespace"></a><h6>
+<a name="id648272"></a>
+ <a class="link" href="lazy.html#spirit.qi.reference.auxiliary.lazy.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lazy // alias:
+ boost::spirit::qi::lazy</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.lazy.model_of"></a><h6>
+<a name="id648350"></a>
+ <a class="link" href="lazy.html#spirit.qi.reference.auxiliary.lazy.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">fp</code></dt>
+<dd>
+ A __lazyargument_ that evaluates
+ to a <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.auxiliary.lazy.expression_semantics"></a><h6>
+<a name="id648423"></a>
+ <a class="link" href="lazy.html#spirit.qi.reference.auxiliary.lazy.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">fp</code>
+ 
+ </td>
+<td>
+ 
+ Create a lazy-parser from a __lazyargument_,
+ <code class="computeroutput">fp</code>. <code class="computeroutput">fp</code> will be invoked at parse
+ time. <code class="computeroutput">fp</code> is expected
+ to return a <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a> object. This
+ parser is then invoked in order to parse the input.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lazy(fp)</code>
+ 
+ </td>
+<td>
+ 
+ Create a lazy-parser from a __lazyargument_,
+ <code class="computeroutput">fp</code>. <code class="computeroutput">fp</code> will be invoked at parse
+ time. <code class="computeroutput">fp</code> is expected
+ to return a <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a> object. This
+ parser is then invoked in order to parse the input.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.lazy.attributes"></a><h6>
+<a name="id648614"></a>
+ <a class="link" href="lazy.html#spirit.qi.reference.auxiliary.lazy.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">fp</code>
+ 
+ </td>
+<td>
+ 
+ The attribute type of the return type of <code class="computeroutput">fp</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lazy(fp)</code>
+ 
+ </td>
+<td>
+ 
+ The attribute type of the return type of <code class="computeroutput">fp</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.auxiliary.lazy.complexity"></a><h6>
+<a name="id648736"></a>
+ <a class="link" href="lazy.html#spirit.qi.reference.auxiliary.lazy.complexity">Complexity</a>
+ </h6>
+
+ The complexity of the <code class="computeroutput">lazy</code>
+ parser is determined by the complexity of the parser returned from <code class="computeroutput">fp</code>.
+ 
+<a name="spirit.qi.reference.auxiliary.lazy.example"></a><h6>
+<a name="id648767"></a>
+ <a class="link" href="lazy.html#spirit.qi.reference.auxiliary.lazy.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::lazy;
+using boost::spirit::ascii::string;
+using boost::phoenix::val;
+</pre>
+
+ 
+
+ 
+
+ Using <code class="computeroutput">lazy</code>:
+ 
+
+ 
+
+ Here, the phoenix::val expression creates a function that returns its
+ argument when invoked. The lazy expression defers the invocation of
+ this function at parse time. Then, this parser (string parser) is called
+ into action. All this takes place at parse time.
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("Hello", lazy(val(string("Hello"))));</pre>
+
+ 
+
+ 
+
+ The above is equivalent to:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("Hello", val(string("Hello")));
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="eps.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../auxiliary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../binary.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/basics.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/basics.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,408 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Basics</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="parser_concepts/naryparser.html" title="NaryParser">
+<link rel="next" href="auxiliary.html" title="Auxiliary">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="parser_concepts/naryparser.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Basics">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.reference.basics"></a><a class="link" href="basics.html" title="Basics">Basics</a>
+</h4></div></div></div>
+<a name="spirit.qi.reference.basics.lazy_argument"></a><h6>
+<a name="id638975"></a>
+ <a class="link" href="basics.html#spirit.qi.reference.basics.lazy_argument">Lazy Argument</a>
+ </h6>
+
+ Some parsers (e.g. primitives and non-terminals) may take in additional
+ attributes. Such parsers take the form:
+ 
+<pre class="programlisting">p(a1, a2,... aN)
+</pre>
+
+ where <code class="computeroutput">p</code> is a parser. Each
+ of the arguments (a1...aN) can either be an immediate value, or a function,
+ <code class="computeroutput">f</code>, with signature:
+ 
+<pre class="programlisting">T f(Unused, Context)
+</pre>
+
+ where <code class="computeroutput">T</code>, the function's
+ return value, is compatible with the argument type expected and <code class="computeroutput">Context</code> is the parser's Context type
+ (The first argument is <code class="computeroutput">unused</code>
+ to make the <code class="computeroutput">Context</code> the
+ second argument. This is done for uniformity with Semantic Actions).
+ 
+<a name="spirit.qi.reference.basics.character_encoding_namespace"></a><h6>
+<a name="id639112"></a>
+ <a class="link" href="basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>
+ </h6>
+
+ Some parsers need to know which character set a <code class="computeroutput">char</code>
+ or <code class="computeroutput">wchar_t</code> is operating on.
+ For example, the <code class="computeroutput">alnum</code>
+ parser works differently with ISO8859.1 and ASCII encodings. Where necessary,
+ Spirit encodes (tags) the parser with the character set.
+ 
+
+ We have a namespace for each character set Spirit will be supporting. That
+ includes <code class="computeroutput">ascii</code>, <code class="computeroutput">iso8859_1</code>, <code class="computeroutput">standard</code>
+ and <code class="computeroutput">standard_wide</code> (and
+ in the future, <code class="computeroutput">unicode</code>).
+ In each of the character encoding namespaces, we place tagged versions
+ of parsers such as <code class="computeroutput">alnum</code>,
+ <code class="computeroutput">space</code> etc.
+ 
+
+ Example:
+ 
+<pre class="programlisting">using boost::spirit::ascii::space; // use the ASCII space parser
+</pre>
+
+ Namespaces:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ boost::spirit::ascii
+ </li>
+<li class="listitem">
+ boost::spirit::iso8859_1
+ </li>
+<li class="listitem">
+ boost::spirit::standard
+ </li>
+<li class="listitem">
+ boost::spirit::standard_wide
+ </li>
+</ul></div>
+
+ For ease of use, the components in this namespaces are also brought into
+ the qi sub-namespaces with the same names:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ boost::spirit::qi::ascii
+ </li>
+<li class="listitem">
+ boost::spirit::qi::iso8859_1
+ </li>
+<li class="listitem">
+ boost::spirit::qi::standard
+ </li>
+<li class="listitem">
+ boost::spirit::qi::standard_wide
+ </li>
+</ul></div>
+<a name="spirit.qi.reference.basics.examples"></a><h6>
+<a name="id639295"></a>
+ <a class="link" href="basics.html#spirit.qi.reference.basics.examples">Examples</a>
+ </h6>
+
+ All sections in the reference present some real world examples. The examples
+ use a common test harness to keep the example code as minimal and direct
+ to the point as possible. The test harness is presented below.
+ 
+
+ Some includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/qi.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <iostream>
+#include <string>
+#include <cstdlib>
+</pre>
+
+ 
+
+ 
+
+ Our test functions:
+ 
+
+ These functions test the parsers without attributes.
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename P>
+void test_parser(
+ char const* input, P const& p, bool full_match = true)
+{
+ using boost::spirit::qi::parse;
+
+ char const* f(input);
+ char const* l(f + strlen(f));
+ if (parse(f, l, p) && (!full_match || (f == l)))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+
+template <typename P>
+void test_phrase_parser(
+ char const* input, P const& p, bool full_match = true)
+{
+ using boost::spirit::qi::phrase_parse;
+ using boost::spirit::qi::ascii::space;
+
+ char const* f(input);
+ char const* l(f + strlen(f));
+ if (phrase_parse(f, l, p, space) && (!full_match || (f == l)))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ These functions test the parsers with user supplied attributes.
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename P, typename T>
+void test_parser_attr(
+ char const* input, P const& p, T& attr, bool full_match = true)
+{
+ using boost::spirit::qi::parse;
+
+ char const* f(input);
+ char const* l(f + strlen(f));
+ if (parse(f, l, p, attr) && (!full_match || (f == l)))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+
+template <typename P, typename T>
+void test_phrase_parser_attr(
+ char const* input, P const& p, T& attr, bool full_match = true)
+{
+ using boost::spirit::qi::phrase_parse;
+ using boost::spirit::qi::ascii::space;
+
+ char const* f(input);
+ char const* l(f + strlen(f));
+ if (phrase_parse(f, l, p, space, attr) && (!full_match || (f == l)))
+ std::cout << "ok" << std::endl;
+ else
+ std::cout << "fail" << std::endl;
+}
+</pre>
+
+ 
+
+ 
+
+ The <code class="computeroutput">print_info</code> utility
+ function prints information contained in the <code class="computeroutput">info</code>
+ class.
+ 
+
+ 
+
+
+
+<pre class="programlisting">struct printer
+{
+ typedef boost::spirit::utf8_string string;
+
+ void element(string const& tag, string const& value, int depth) const
+ {
+ for (int i = 0; i < (depth*4); ++i) // indent to depth
+ std::cout << ' ';
+
+ std::cout << "tag: " << tag;
+ if (value != "")
+ std::cout << ", value: " << value;
+ std::cout << std::endl;
+ }
+};
+
+void print_info(boost::spirit::info const& what)
+{
+ using boost::spirit::basic_info_walker;
+
+ printer pr;
+ basic_info_walker<printer> walker(pr, what.tag, 0);
+ boost::apply_visitor(walker, what.value);
+}
+</pre>
+
+ 
+
+ 
+<a name="spirit.qi.reference.basics.string"></a><h6>
+<a name="id641869"></a>
+ <a class="link" href="basics.html#spirit.qi.reference.basics.string">String</a>
+ </h6>
+<a name="spirit.qi.reference.basics.header"></a><h6>
+<a name="id641882"></a>
+ <a class="link" href="basics.html#spirit.qi.reference.basics.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/support/string_traits.hpp>
+#include <boost/spirit/support_string_traits.hpp>
+</pre>
+
+ A string can be any object <code class="computeroutput">s</code>,
+ of type, <code class="computeroutput">S</code>, that satisfies
+ the following expression traits:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">boost::spirit::traits::is_string<S></code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">S</code>
+ is a string, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">boost::spirit::traits::char_type_of<S></code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that returns the underlying char type of a string
+ type, <code class="computeroutput">S</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">boost::spirit::traits::get_c_string(s)</code>
+ 
+ </td>
+<td>
+ 
+ Function that returns the underlying raw C-string from <code class="computeroutput">s</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">boost::spirit::traits::get_begin(s)</code>
+ 
+ </td>
+<td>
+ 
+ Function that returns an STL
+ iterator from <code class="computeroutput">s</code>
+ that points to the beginning the string.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">boost::spirit::traits::get_end(s)</code>
+ 
+ </td>
+<td>
+ 
+ Function that returns an STL
+ iterator from <code class="computeroutput">s</code>
+ that points to the end of the string.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.basics.models"></a><h6>
+<a name="id642355"></a>
+ <a class="link" href="basics.html#spirit.qi.reference.basics.models">Models</a>
+ </h6>
+
+ Predefined models include:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ any literal string, e.g. "Hello, World",
+ </li>
+<li class="listitem">
+ a pointer/reference to a null-terminated array of characters
+ </li>
+<li class="listitem">
+ a <code class="computeroutput">std::basic_string<Char></code>
+</li>
+</ul></div>
+
+ The namespace <code class="computeroutput">boost::spirit::traits</code> is open for users to provide their
+ own specializations.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="parser_concepts/naryparser.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="auxiliary.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/binary.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/binary.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,68 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Binary</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="auxiliary/lazy.html" title="Lazy (lazy)">
+<link rel="next" href="binary/binary_native.html" title="Binary Native Endian">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="auxiliary/lazy.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary/binary_native.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Binary">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.reference.binary"></a><a class="link" href="binary.html" title="Binary"> Binary</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="binary/binary_native.html"> Binary
+ Native Endian</a></dt>
+<dt><a href="binary/binary_little.html"> Binary
+ Little Endian</a></dt>
+<dt><a href="binary/binary_big.html"> Binary Big
+ Endian</a></dt>
+</dl></div>
+
+ This module includes different parsers for parsing binary data in various
+ endianness.
+ It includes parsers for default (native), little, and big endian binary
+ input.
+ 
+<a name="spirit.qi.reference.binary.module_header"></a><h6>
+<a name="id649031"></a>
+ <a class="link" href="binary.html#spirit.qi.reference.binary.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/binary.hpp>
+#include <boost/spirit/include/qi_binary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="auxiliary/lazy.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary/binary_native.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/binary_big.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/binary_big.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,403 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Binary Big Endian</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../binary.html" title="Binary">
+<link rel="prev" href="binary_little.html" title="Binary Little Endian">
+<link rel="next" href="../char.html" title="Char">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary_little.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../char.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Binary Big Endian">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.binary.binary_big"></a><a class="link" href="binary_big.html" title="Binary Big Endian"> Binary Big
+ Endian</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.binary.binary_big.description"></a><h6>
+<a name="id656140"></a>
+ <a class="link" href="binary_big.html#spirit.qi.reference.binary.binary_big.description">Description</a>
+ </h6>
+
+ Binary big endian parsers are designed to parse binary byte streams that
+ are laid out in big endian.
+ 
+<a name="spirit.qi.reference.binary.binary_big.header"></a><h6>
+<a name="id656157"></a>
+ <a class="link" href="binary_big.html#spirit.qi.reference.binary.binary_big.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/binary.hpp>
+#include <boost/spirit/include/qi_binary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.binary.binary_big.namespace"></a><h6>
+<a name="id656232"></a>
+ <a class="link" href="binary_big.html#spirit.qi.reference.binary.binary_big.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::big_word //
+ alias: boost::spirit::qi::big_word</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::big_dword //
+ alias: boost::spirit::qi::big_dword</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::big_qword //
+ alias: boost::spirit::qi::big_qword</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ <code class="computeroutput">big_qword</code> is only available
+ on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code>
+ is defined (i.e. on platforms having native support for <code class="computeroutput">unsigned long
+ long</code> (64 bit) integer types).
+ </td></tr>
+</table></div>
+<a name="spirit.qi.reference.binary.binary_big.model_of"></a><h6>
+<a name="id656426"></a>
+ <a class="link" href="binary_big.html#spirit.qi.reference.binary.binary_big.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">w</code></dt>
+<dd>
+ A 16 bit binary value or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always in native endian.
+ </dd>
+<dt><code class="computeroutput">dw</code></dt>
+<dd>
+ A 32 bit binary value or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 32 bit binary value. This value
+ is always in native endian.
+ </dd>
+<dt><code class="computeroutput">qw</code></dt>
+<dd>
+ A 64 bit binary value or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 64 bit binary value. This value
+ is always in native endian.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.binary.binary_big.expression_semantics"></a><h6>
+<a name="id656538"></a>
+ <a class="link" href="binary_big.html#spirit.qi.reference.binary.binary_big.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_word</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 16 bit big endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_dword</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 32 bit big endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_qword</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 64 bit big endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_word(w)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 16 bit big endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 32 bit big endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 32 bit big endian binary.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.binary.binary_big.attributes"></a><h6>
+<a name="id656776"></a>
+ <a class="link" href="binary_big.html#spirit.qi.reference.binary.binary_big.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_word</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least16_t</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_dword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least32_t</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_qword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least64_t</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_word(w)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">big_qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.binary.binary_big.complexity"></a><h6>
+<a name="id657064"></a>
+ <a class="link" href="binary_big.html#spirit.qi.reference.binary.binary_big.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of bytes parsed
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.binary.binary_big.example"></a><h6>
+<a name="id657088"></a>
+ <a class="link" href="binary_big.html#spirit.qi.reference.binary.binary_big.example">Example</a>
+ </h6>
+
+ 
+
+ Using declarations and variables:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::big_word;
+using boost::spirit::qi::big_dword;
+using boost::spirit::qi::big_qword;
+
+boost::uint8_t uc;
+boost::uint16_t us;
+boost::uint32_t ui;
+boost::uint64_t ul;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the big endian binary parsers:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser_attr("\x01\x02", big_word, us); assert(us == 0x0102);
+test_parser_attr("\x01\x02\x03\x04", big_dword, ui); assert(ui == 0x01020304);
+test_parser_attr("\x01\x02\x03\x04\x05\x06\x07\x08", big_qword, ul);
+assert(0x0102030405060708LL);
+
+test_parser("\x01\x02", big_word(0x0102));
+test_parser("\x01\x02\x03\x04", big_dword(0x01020304));
+test_parser("\x01\x02\x03\x04\x05\x06\x07\x08",
+ big_qword(0x0102030405060708LL));
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary_little.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../char.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/binary_little.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/binary_little.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,404 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Binary Little Endian</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../binary.html" title="Binary">
+<link rel="prev" href="binary_native.html" title="Binary Native Endian">
+<link rel="next" href="binary_big.html" title="Binary Big Endian">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary_native.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary_big.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Binary Little Endian">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.binary.binary_little"></a><a class="link" href="binary_little.html" title="Binary Little Endian"> Binary
+ Little Endian</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.binary.binary_little.description"></a><h6>
+<a name="id651883"></a>
+ <a class="link" href="binary_little.html#spirit.qi.reference.binary.binary_little.description">Description</a>
+ </h6>
+
+ Binary little endian parsers are designed to parse binary byte streams
+ that are laid out in little endian.
+ 
+<a name="spirit.qi.reference.binary.binary_little.header"></a><h6>
+<a name="id651900"></a>
+ <a class="link" href="binary_little.html#spirit.qi.reference.binary.binary_little.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/binary.hpp>
+#include <boost/spirit/include/qi_binary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.binary.binary_little.namespace"></a><h6>
+<a name="id651974"></a>
+ <a class="link" href="binary_little.html#spirit.qi.reference.binary.binary_little.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::little_word //
+ alias: boost::spirit::qi::little_word</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::little_dword //
+ alias: boost::spirit::qi::little_dword</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::little_qword //
+ alias: boost::spirit::qi::little_qword</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ <code class="computeroutput">little_qword</code> is only
+ available on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code> is defined (i.e.
+ on platforms having native support for <code class="computeroutput">unsigned
+ long long</code>
+ (64 bit) integer types).
+ </td></tr>
+</table></div>
+<a name="spirit.qi.reference.binary.binary_little.model_of"></a><h6>
+<a name="id652168"></a>
+ <a class="link" href="binary_little.html#spirit.qi.reference.binary.binary_little.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">w</code></dt>
+<dd>
+ A 16 bit binary value or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always in native endian.
+ </dd>
+<dt><code class="computeroutput">dw</code></dt>
+<dd>
+ A 32 bit binary value or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 32 bit binary value. This value
+ is always in native endian.
+ </dd>
+<dt><code class="computeroutput">qw</code></dt>
+<dd>
+ A 64 bit binary value or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 64 bit binary value. This value
+ is always in native endian.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.binary.binary_little.expression_semantics"></a><h6>
+<a name="id652280"></a>
+ <a class="link" href="binary_little.html#spirit.qi.reference.binary.binary_little.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_word</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 16 bit little endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_dword</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 32 bit little endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_qword</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 64 bit little endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_word(w)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 16 bit little endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 32 bit little endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 32 bit little endian binary.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.binary.binary_little.attributes"></a><h6>
+<a name="id652519"></a>
+ <a class="link" href="binary_little.html#spirit.qi.reference.binary.binary_little.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_word</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least16_t</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_dword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least32_t</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_qword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least64_t</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_word(w)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">little_qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.binary.binary_little.complexity"></a><h6>
+<a name="id655606"></a>
+ <a class="link" href="binary_little.html#spirit.qi.reference.binary.binary_little.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of bytes parsed
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.binary.binary_little.example"></a><h6>
+<a name="id655630"></a>
+ <a class="link" href="binary_little.html#spirit.qi.reference.binary.binary_little.example">Example</a>
+ </h6>
+
+ 
+
+ Using declarations and variables:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::little_word;
+using boost::spirit::qi::little_dword;
+using boost::spirit::qi::little_qword;
+
+boost::uint8_t uc;
+boost::uint16_t us;
+boost::uint32_t ui;
+boost::uint64_t ul;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the little endian binary parsers:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser_attr("\x01\x02", little_word, us); assert(us == 0x0201);
+test_parser_attr("\x01\x02\x03\x04", little_dword, ui); assert(ui == 0x04030201);
+test_parser_attr("\x01\x02\x03\x04\x05\x06\x07\x08", little_qword, ul);
+assert(ul == 0x0807060504030201LL);
+
+test_parser("\x01\x02", little_word(0x0201));
+test_parser("\x01\x02\x03\x04", little_dword(0x04030201));
+test_parser("\x01\x02\x03\x04\x05\x06\x07\x08",
+ little_qword(0x0807060504030201LL));
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary_native.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary_big.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/binary_native.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/binary/binary_native.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,491 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Binary Native Endian</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../binary.html" title="Binary">
+<link rel="prev" href="../binary.html" title="Binary">
+<link rel="next" href="binary_little.html" title="Binary Little Endian">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../binary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary_little.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Binary Native Endian">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.binary.binary_native"></a><a class="link" href="binary_native.html" title="Binary Native Endian"> Binary
+ Native Endian</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.binary.binary_native.description"></a><h6>
+<a name="id649115"></a>
+ <a class="link" href="binary_native.html#spirit.qi.reference.binary.binary_native.description">Description</a>
+ </h6>
+
+ Binary native endian parsers are designed to parse binary byte streams
+ that are laid out in the native endianness
+ of the target architecture.
+ 
+<a name="spirit.qi.reference.binary.binary_native.header"></a><h6>
+<a name="id649137"></a>
+ <a class="link" href="binary_native.html#spirit.qi.reference.binary.binary_native.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/binary.hpp>
+#include <boost/spirit/include/qi_binary.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.binary.binary_native.namespace"></a><h6>
+<a name="id649211"></a>
+ <a class="link" href="binary_native.html#spirit.qi.reference.binary.binary_native.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::byte_ // alias:
+ boost::spirit::qi::byte_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::word // alias:
+ boost::spirit::qi::word</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::dword // alias:
+ boost::spirit::qi::dword</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::qword // alias:
+ boost::spirit::qi::qword</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ <code class="computeroutput">qword</code> is only available
+ on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code>
+ is defined (i.e. on platforms having native support for <code class="computeroutput">unsigned long
+ long</code> (64 bit) integer types).
+ </td></tr>
+</table></div>
+<a name="spirit.qi.reference.binary.binary_native.model_of"></a><h6>
+<a name="id649439"></a>
+ <a class="link" href="binary_native.html#spirit.qi.reference.binary.binary_native.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">b</code></dt>
+<dd>
+ A single byte (8 bit binary value) or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a single byte. This value is always
+ in native endian.
+ </dd>
+<dt><code class="computeroutput">w</code></dt>
+<dd>
+ A 16 bit binary value or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 16 bit binary value. This value
+ is always in native endian.
+ </dd>
+<dt><code class="computeroutput">dw</code></dt>
+<dd>
+ A 32 bit binary value or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 32 bit binary value. This value
+ is always in native endian.
+ </dd>
+<dt><code class="computeroutput">qw</code></dt>
+<dd>
+ A 64 bit binary value or a <a class="link" href="../basics.html#spirit.qi.reference.basics.lazy_argument">Lazy
+ Argument</a> that evaluates to a 64 bit binary value. This value
+ is always in native endian.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.binary.binary_native.expression_semantics"></a><h6>
+<a name="id649575"></a>
+ <a class="link" href="binary_native.html#spirit.qi.reference.binary.binary_native.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">byte_</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 8 bit native endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">word</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 16 bit native endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">dword</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 32 bit native endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">qword</code>
+ 
+ </td>
+<td>
+ 
+ Matches any 64 bit native endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">byte_(b)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 8 bit native endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">word(w)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 16 bit native endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 32 bit native endian binary.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ Matches an exact 64 bit native endian binary.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.binary.binary_native.attributes"></a><h6>
+<a name="id650493"></a>
+ <a class="link" href="binary_native.html#spirit.qi.reference.binary.binary_native.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">byte_</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least8_t</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">word</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least16_t</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">dword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least32_t</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">qword</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">boost::uint_least64_t</code>)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">byte_(b)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">word(w)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">dword(dw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">qword(qw)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.binary.binary_native.complexity"></a><h6>
+<a name="id650862"></a>
+ <a class="link" href="binary_native.html#spirit.qi.reference.binary.binary_native.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of bytes parsed
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.binary.binary_native.example"></a><h6>
+<a name="id650886"></a>
+ <a class="link" href="binary_native.html#spirit.qi.reference.binary.binary_native.example">Example</a>
+ </h6>
+
+ 
+
+ Using declarations and variables:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::byte_;
+using boost::spirit::qi::word;
+using boost::spirit::qi::dword;
+using boost::spirit::qi::qword;
+
+boost::uint8_t uc;
+boost::uint16_t us;
+boost::uint32_t ui;
+boost::uint64_t ul;
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the native binary parsers for little endian platforms:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser_attr("\x01", byte_, uc); assert(uc == 0x01);
+test_parser_attr("\x01\x02", word, us); assert(us == 0x0201);
+test_parser_attr("\x01\x02\x03\x04", dword, ui); assert(ui == 0x04030201);
+test_parser_attr("\x01\x02\x03\x04\x05\x06\x07\x08", qword, ul);
+assert(ul == 0x0807060504030201LL);
+
+test_parser("\x01", byte_(0x01));
+test_parser("\x01\x02", word(0x0201));
+test_parser("\x01\x02\x03\x04", dword(0x04030201));
+test_parser("\x01\x02\x03\x04\x05\x06\x07\x08",
+ qword(0x0807060504030201LL));
+</pre>
+
+ 
+
+ 
+
+ Basic usage of the native binary parsers for big endian platforms:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser_attr("\x01", byte_, uc); assert(uc == 0x01);
+test_parser_attr("\x01\x02", word, us); assert(us == 0x0102);
+test_parser_attr("\x01\x02\x03\x04", dword, ui); assert(ui == 0x01020304);
+test_parser_attr("\x01\x02\x03\x04\x05\x06\x07\x08", qword, ul);
+assert(0x0102030405060708LL);
+
+test_parser("\x01", byte_(0x01));
+test_parser("\x01\x02", word(0x0102));
+test_parser("\x01\x02\x03\x04", dword(0x01020304));
+test_parser("\x01\x02\x03\x04\x05\x06\x07\x08",
+ qword(0x0102030405060708LL));
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../binary.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../binary.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binary_little.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/char.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/char.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,70 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Char</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="binary/binary_big.html" title="Binary Big Endian">
+<link rel="next" href="char/char.html" title="Char (char_, lit)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary/binary_big.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char/char.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Char">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.reference.char"></a><a class="link" href="char.html" title="Char">Char</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt> Char (char_, lit)</dt>
+<dt><a href="char/char_class.html"> Char Classification
+ (<code class="computeroutput">alnum</code>, <code class="computeroutput">digit</code>,
+ etc.)</a></dt>
+</dl></div>
+
+ This module includes parsers for single characters. Currently, this module
+ includes literal chars (e.g. <code class="computeroutput">'x'</code>,
+ <code class="computeroutput">L'x'</code>),
+ <code class="computeroutput">char_</code> (single characters,
+ ranges and character sets) and the encoding specific character classifiers
+ (<code class="computeroutput">alnum</code>, <code class="computeroutput">alpha</code>,
+ <code class="computeroutput">digit</code>, <code class="computeroutput">xdigit</code>,
+ etc.).
+ 
+<a name="spirit.qi.reference.char.module_header"></a><h6>
+<a name="id657785"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/char.hpp>
+#include <boost/spirit/include/qi_char.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binary/binary_big.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char/char.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/char/char.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/char/char.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,608 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Char (char_, lit)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../char.html" title="Char">
+<link rel="prev" href="../char.html" title="Char">
+<link rel="next" href="char_class.html" title="Char Classification (alnum, digit, etc.)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../char.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char_class.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Char (char_, lit)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.char.char"></a><a class="link" href="char.html" title="Char (char_, lit)"> Char (<code class="computeroutput">char_</code>, <code class="computeroutput">lit</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.char.char.description"></a><h6>
+<a name="id657883"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">char_</code> parser matches
+ single characters. The <code class="computeroutput">char_</code>
+ parser has an associated <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>. This is needed when doing basic operations
+ such as inhibiting case sensitivity and dealing with character ranges.
+ 
+
+ There are various forms of <code class="computeroutput">char_</code>.
+ 
+<a name="spirit.qi.reference.char.char.char_"></a><h6>
+<a name="id657930"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.char_">char_</a>
+ </h6>
+
+ The no argument form of <code class="computeroutput">char_</code>
+ matches any character in the assocaiated <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<pre class="programlisting">char_ // matches any character
+</pre>
+<a name="spirit.qi.reference.char.char.char__ch_"></a><h6>
+<a name="id657971"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.char__ch_">char_(ch)</a>
+ </h6>
+
+ The single argument form of <code class="computeroutput">char_</code>
+ (with a character argument) matches the supplied character.
+ 
+<pre class="programlisting">char_('x') // matches 'x'
+char_(L'x') // matches L'x'
+char_(x) // matches x (a char)
+</pre>
+<a name="spirit.qi.reference.char.char.char__first__last_"></a><h6>
+<a name="id658059"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.char__first__last_">char_(first,
+ last)</a>
+ </h6>
+
+ <code class="computeroutput">char_</code> with two arguments,
+ matches a range of characters.
+ 
+<pre class="programlisting">char_('a','z') // alphabetic characters
+char_(L'0',L'9') // digits
+</pre>
+
+ A range of characters is created from a low-high character pair. Such
+ a parser matches a single character that is in the range, including both
+ endpoints. Note, the first character must be before
+ the second, according to the underlying <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+
+ Character mapping is inherently platform dependent. It is not guaranteed
+ in the standard for example that <code class="computeroutput">'A'
+ < 'Z'</code>,
+ that is why in Spirit2, we purposely attach a specific <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a> (such as ASCII, ISO-8859-1) to the <code class="computeroutput">char_</code> parser to eliminate such ambiguities.
+ 
+<div class="note" title="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">
+
+ Sparse bit vectors
+ 
+
+ To accomodate 16/32 and 64 bit characters, the char-set statically
+ switches from a <code class="computeroutput">std::bitset</code>
+ implementation when the character type is not greater than 8 bits,
+ to a sparse bit/boolean set which uses a sorted vector of disjoint
+ ranges (<code class="computeroutput">range_run</code>).
+ The set is constructed from ranges such that adjacent or overlapping
+ ranges are coalesced.
+ 
+
+ <code class="computeroutput">range_runs</code> are very
+ space-economical in situations where there are lots of ranges and a
+ few individual disjoint values. Searching is O(log n) where n is the
+ number of ranges.
+ 
+</td></tr>
+</table></div>
+<a name="spirit.qi.reference.char.char.char__def_"></a><h6>
+<a name="id658239"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.char__def_">char_(def)</a>
+ </h6>
+
+ Lastly, when given a string (a plain C string, a <code class="computeroutput">std::basic_string</code>,
+ etc.), the string is regarded as a char-set definition string following
+ a syntax that resembles posix style regular expression character sets
+ (except that double quotes delimit the set elements instead of square
+ brackets and there is no special negation ^ character). Examples:
+ 
+<pre class="programlisting">char_("a-zA-Z") // alphabetic characters
+char_("0-9a-fA-F") // hexadecimal characters
+char_("actgACTG") // DNA identifiers
+char_("\x7f\x7e") // Hexadecimal 0x7F and 0x7E
+</pre>
+<a name="spirit.qi.reference.char.char.lit_ch_"></a><h6>
+<a name="id658352"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.lit_ch_">lit(ch)</a>
+ </h6>
+
+ <code class="computeroutput">lit</code>, when passed a single
+ character, behaves like the single argument <code class="computeroutput">char_</code>
+ except that <code class="computeroutput">lit</code> does
+ not synthesize an attribute. A plain <code class="computeroutput">char</code>
+ or <code class="computeroutput">wchar_t</code> is equivalent
+ to a <code class="computeroutput">lit</code>.
+ 
+<div class="note" title="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">
+ <code class="computeroutput">lit</code> is reused by both
+ the <a class="link" href="../string/string.html" title="String (string, lit)">string parsers</a>
+ and the char parsers. In general, a char parser is created when you
+ pass in a character and a string parser is created when you pass in
+ a string. The exception is when you pass a single element literal string,
+ e.g. <code class="computeroutput">lit("x")</code>.
+ In this case, we optimize this to create a char parser instead of a
+ string parser.
+ </td></tr>
+</table></div>
+
+ Examples:
+ 
+<pre class="programlisting">'x'
+lit('x')
+lit(L'x')
+lit(c) // c is a char
+</pre>
+<a name="spirit.qi.reference.char.char.header"></a><h6>
+<a name="id658515"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/char/char.hpp>
+#include <boost/spirit/qi_char.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.char.char.namespace"></a><h6>
+<a name="id658583"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lit // alias:
+ boost::spirit::qi::lit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::char_</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+
+ In the table above, <code class="computeroutput">ns</code>
+ is a <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<a name="spirit.qi.reference.char.char.model_of"></a><h6>
+<a name="id658701"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">c</code>,
+ <code class="computeroutput">f</code>, <code class="computeroutput">l</code></dt>
+<dd>
+ A literal char, e.g. <code class="computeroutput">'x'</code>,
+ <code class="computeroutput">L'x'</code>
+ or anything that can be converted to a <code class="computeroutput">char</code>
+ or <code class="computeroutput">wchar_t</code>, or a __lazyargument_ that evaluates to anything
+ that can be converted to a <code class="computeroutput">char</code>
+ or <code class="computeroutput">wchar_t</code>.
+ </dd>
+<dt><code class="computeroutput">ns</code></dt>
+<dd>
+ A <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ </dd>
+<dt><code class="computeroutput">cs</code></dt>
+<dd>
+ A <a class="link" href="../basics.html#spirit.qi.reference.basics.string">String</a>
+ or a __lazyargument_ that evaluates
+ to a <a class="link" href="../basics.html#spirit.qi.reference.basics.string">String</a>
+ that specifies a char-set definition string following a syntax that
+ resembles posix style regular expression character sets (except the
+ square brackets and the negation <code class="computeroutput">^</code>
+ character).
+ </dd>
+<dt><code class="computeroutput">cp</code></dt>
+<dd>
+ A char parser, a char range parser or a char set parser.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.char.char.expression_semantics"></a><h6>
+<a name="id658908"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">c</code>
+ 
+ </td>
+<td>
+ 
+ Create char parser from a char, <code class="computeroutput">c</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(c)</code>
+ 
+ </td>
+<td>
+ 
+ Create a char parser from a char, <code class="computeroutput">c</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_</code>
+ 
+ </td>
+<td>
+ 
+ Create a char parser that matches any character in the <code class="computeroutput">ns</code> encoding.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(c)</code>
+ 
+ </td>
+<td>
+ 
+ Create a char parser with <code class="computeroutput">ns</code>
+ encoding from a char, <code class="computeroutput">c</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(f,
+ l)</code>
+ 
+ </td>
+<td>
+ 
+ Create a char-range parser that matches characters from range
+ (<code class="computeroutput">f</code> to <code class="computeroutput">l</code>, inclusive) with <code class="computeroutput">ns</code> encoding.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(cs)</code>
+ 
+ </td>
+<td>
+ 
+ Create a char-set parser with <code class="computeroutput">ns</code>
+ encoding from a char-set definition string, <code class="computeroutput">cs</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">~cp</code>
+ 
+ </td>
+<td>
+ 
+ Negate <code class="computeroutput">cp</code>. The
+ result is a negated char parser that matches any character in
+ the <code class="computeroutput">ns</code> encoding
+ except the characters matched by <code class="computeroutput">cp</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.char.char.attributes"></a><h6>
+<a name="id659315"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">c</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code> or if
+ <code class="computeroutput">c</code> is a __lazyargument_, the character type returned
+ by invoking it.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(c)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code> or if
+ <code class="computeroutput">c</code> is a __lazyargument_, the character type returned
+ by invoking it.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_</code>
+ 
+ </td>
+<td>
+ 
+ The character type of the <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(c)</code>
+ 
+ </td>
+<td>
+ 
+ The character type of the <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(f,
+ l)</code>
+ 
+ </td>
+<td>
+ 
+ The character type of the <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::char_(cs)</code>
+ 
+ </td>
+<td>
+ 
+ The character type of the <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">~cp</code>
+ 
+ </td>
+<td>
+ 
+ The attribute of <code class="computeroutput">cp</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.char.char.complexity"></a><h6>
+<a name="id659707"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), except for char-sets with
+ 16-bit (or more) characters (e.g. <code class="computeroutput">wchar_t</code>).
+ These have O(log N) complexity,
+ where N is the number of distinct character ranges in the set.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.char.char.example"></a><h6>
+<a name="id659748"></a>
+ <a class="link" href="char.html#spirit.qi.reference.char.char.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::lit;
+using boost::spirit::ascii::char_;
+</pre>
+
+ 
+
+ 
+
+ Basic literals:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("x", 'x'); // plain literal
+test_parser("x", lit('x')); // explicit literal
+test_parser("x", char_('x')); // ascii::char_
+</pre>
+
+ 
+
+ 
+
+ Range:
+ 
+
+ 
+
+
+
+<pre class="programlisting">char ch;
+test_parser_attr("5", char_('0','9'), ch); // ascii::char_ range
+std::cout << ch << std::endl; // prints '5'
+</pre>
+
+ 
+
+ 
+
+ Character set:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser_attr("5", char_("0-9"), ch); // ascii::char_ set
+std::cout << ch << std::endl; // prints '5'
+</pre>
+
+ 
+
+ 
+
+ Lazy char_ using Phoenix
+ 
+
+ 
+
+
+
+<pre class="programlisting">namespace phx = boost::phoenix;
+test_parser("x", phx::val('x')); // direct
+test_parser("5",
+ char_(phx::val('0'),phx::val('9'))); // ascii::char_ range
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../char.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="char_class.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/char/char_class.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/char/char_class.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,408 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Char Classification (alnum, digit, etc.)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../char.html" title="Char">
+<link rel="prev" href="char.html" title="Char (char_, lit)">
+<link rel="next" href="../directive.html" title="Directive">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../char.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../directive.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Char Classification (alnum, digit, etc.)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.char.char_class"></a><a class="link" href="char_class.html" title="Char Classification (alnum, digit, etc.)"> Char Classification
+ (<code class="computeroutput">alnum</code>, <code class="computeroutput">digit</code>,
+ etc.)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.char.char_class.description"></a><h6>
+<a name="id661474"></a>
+ <a class="link" href="char_class.html#spirit.qi.reference.char.char_class.description">Description</a>
+ </h6>
+
+ The library has the full repertoire of single character parsers for character
+ classification. This includes the usual <code class="computeroutput">alnum</code>,
+ <code class="computeroutput">alpha</code>, <code class="computeroutput">digit</code>, <code class="computeroutput">xdigit</code>,
+ etc. parsers. These parsers have an associated <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>. This is needed when doing basic operations
+ such as inhibiting case sensitivity.
+ 
+<a name="spirit.qi.reference.char.char_class.header"></a><h6>
+<a name="id661526"></a>
+ <a class="link" href="char_class.html#spirit.qi.reference.char.char_class.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/char/char_class.hpp>
+#include <boost/spirit/qi_char_class.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.char.char_class.namespace"></a><h6>
+<a name="id661593"></a>
+ <a class="link" href="char_class.html#spirit.qi.reference.char.char_class.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">ns::alnum</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::alpha</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::blank</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::cntrl</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::digit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::graph</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::lower</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::print</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::punct</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::space</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::upper</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::xdigit</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+
+ In the table above, <code class="computeroutput">ns</code>
+ is a <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<a name="spirit.qi.reference.char.char_class.model_of"></a><h6>
+<a name="id661952"></a>
+ <a class="link" href="char_class.html#spirit.qi.reference.char.char_class.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">ns</code></dt>
+<dd>
+ A <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.char.char_class.expression_semantics"></a><h6>
+<a name="id662018"></a>
+ <a class="link" href="char_class.html#spirit.qi.reference.char.char_class.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::alnum</code>
+ 
+ </td>
+<td>
+ 
+ Matches alpha-numeric characters
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::alpha</code>
+ 
+ </td>
+<td>
+ 
+ Matches alphabetic characters
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::blank</code>
+ 
+ </td>
+<td>
+ 
+ Matches spaces or tabs
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::cntrl</code>
+ 
+ </td>
+<td>
+ 
+ Matches control characters
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::digit</code>
+ 
+ </td>
+<td>
+ 
+ Matches numeric digits
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::graph</code>
+ 
+ </td>
+<td>
+ 
+ Matches non-space printing characters
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::lower</code>
+ 
+ </td>
+<td>
+ 
+ Matches lower case letters
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::print</code>
+ 
+ </td>
+<td>
+ 
+ Matches printable characters
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::punct</code>
+ 
+ </td>
+<td>
+ 
+ Matches punctuation symbols
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::space</code>
+ 
+ </td>
+<td>
+ 
+ Matches spaces, tabs, returns, and newlines
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::upper</code>
+ 
+ </td>
+<td>
+ 
+ Matches upper case letters
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::xdigit</code>
+ 
+ </td>
+<td>
+ 
+ Matches hexadecimal digits
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.char.char_class.attributes"></a><h6>
+<a name="id662457"></a>
+ <a class="link" href="char_class.html#spirit.qi.reference.char.char_class.attributes">Attributes</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The character type of the <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>, <code class="computeroutput">ns</code>.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.char.char_class.complexity"></a><h6>
+<a name="id662493"></a>
+ <a class="link" href="char_class.html#spirit.qi.reference.char.char_class.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N)
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.char.char_class.example"></a><h6>
+<a name="id662517"></a>
+ <a class="link" href="char_class.html#spirit.qi.reference.char.char_class.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::alnum;
+using boost::spirit::ascii::blank;
+using boost::spirit::ascii::digit;
+using boost::spirit::ascii::lower;
+</pre>
+
+ 
+
+ 
+
+ Basic usage:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("1", alnum);
+test_parser(" ", blank);
+test_parser("1", digit);
+test_parser("a", lower);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../char.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../directive.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/directive.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/directive.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,74 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Directive</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="char/char_class.html" title="Char Classification (alnum, digit, etc.)">
+<link rel="next" href="directive/lexeme.html" title="Inhibiting Skipping (lexeme[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char/char_class.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="directive/lexeme.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Directive">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.reference.directive"></a><a class="link" href="directive.html" title="Directive"> Directive</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="directive/lexeme.html"> Inhibiting
+ Skipping (<code class="computeroutput">lexeme[]</code>)</a></dt>
+<dt><a href="directive/no_case.html"> Inhibiting
+ Case Sensitivity (<code class="computeroutput">no_case[]</code>)</a></dt>
+<dt><a href="directive/omit.html"> Ignoring Attribute
+ (<code class="computeroutput">omit[]</code>)</a></dt>
+<dt><a href="directive/raw.html"> Transduction
+ Parsing (<code class="computeroutput">raw[]</code>)</a></dt>
+<dt><a href="directive/repeat.html"> Repetition
+ (<code class="computeroutput">repeat[]</code>)</a></dt>
+<dt><a href="directive/skip.html"> Re-Establish
+ Skipping (<code class="computeroutput">skip[]</code>)</a></dt>
+</dl></div>
+
+ This module includes different directives usable to augment and parametrize
+ other parsers. It includes the <code class="computeroutput">no_case</code>,
+ <code class="computeroutput">lexeme</code>, <code class="computeroutput">omit</code>,
+ <code class="computeroutput">raw</code>, and <code class="computeroutput">skip</code> directives.
+ 
+<a name="spirit.qi.reference.directive.module_header"></a><h6>
+<a name="id662846"></a>
+ <a class="link" href="directive.html#spirit.qi.reference.directive.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/directive.hpp>
+#include <boost/spirit/include/qi_directive.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="char/char_class.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="directive/lexeme.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/lexeme.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/lexeme.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,254 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Inhibiting Skipping (lexeme[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="../directive.html" title="Directive">
+<link rel="next" href="no_case.html" title="Inhibiting Case Sensitivity (no_case[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../directive.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="no_case.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Inhibiting Skipping (lexeme[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.directive.lexeme"></a><a class="link" href="lexeme.html" title="Inhibiting Skipping (lexeme[])"> Inhibiting
+ Skipping (<code class="computeroutput">lexeme[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.directive.lexeme.description"></a><h6>
+<a name="id662940"></a>
+ <a class="link" href="lexeme.html#spirit.qi.reference.directive.lexeme.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">lexeme[]</code>
+ directive turns off white space skipping. At the phrase level, the parser
+ ignores white spaces, possibly including comments. Use <code class="computeroutput">lexeme</code> in situations where you want
+ to work at the character level instead of the phrase level. Parsers can
+ be made to work at the character level by enclosing the pertinent parts
+ inside the <code class="computeroutput">lexeme</code> directive.
+ For example, here's a rule that parses integers:
+ 
+<pre class="programlisting">integer = lexeme[ -(lit('+') | '-') >> +digit ];
+</pre>
+
+ The <code class="computeroutput">lexeme</code> directive
+ instructs its subject parser to work on the character level. Without
+ it, the <code class="computeroutput">integer</code> rule
+ would have allowed erroneous embedded white spaces in inputs such as
+ <code class="computeroutput">"1 2 345"</code> which
+ will be parsed as <code class="computeroutput">"12345"</code>.
+ 
+<a name="spirit.qi.reference.directive.lexeme.header"></a><h6>
+<a name="id663087"></a>
+ <a class="link" href="lexeme.html#spirit.qi.reference.directive.lexeme.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/directive/lexeme.hpp>
+#include <boost/spirit/include/qi_lexeme.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.directive.lexeme.namespace"></a><h6>
+<a name="id663298"></a>
+ <a class="link" href="lexeme.html#spirit.qi.reference.directive.lexeme.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lexeme // alias:
+ boost::spirit::qi::lexeme</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.lexeme.model_of"></a><h6>
+<a name="id663376"></a>
+ <a class="link" href="lexeme.html#spirit.qi.reference.directive.lexeme.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.directive.lexeme.expression_semantics"></a><h6>
+<a name="id663447"></a>
+ <a class="link" href="lexeme.html#spirit.qi.reference.directive.lexeme.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">lexeme[a]</code>
+ 
+ </td>
+<td>
+ 
+ Turns off white space skipping for the subject parser, <code class="computeroutput">a</code> (and all its children).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.lexeme.attributes"></a><h6>
+<a name="id663552"></a>
+ <a class="link" href="lexeme.html#spirit.qi.reference.directive.lexeme.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">lexeme[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> lexeme[a]: A
+a: Unused --> lexeme[a]: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.lexeme.complexity"></a><h6>
+<a name="id663723"></a>
+ <a class="link" href="lexeme.html#spirit.qi.reference.directive.lexeme.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The complexity is defined by the complexity of the subject parser,
+ <code class="computeroutput">a</code>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.directive.lexeme.example"></a><h6>
+<a name="id663754"></a>
+ <a class="link" href="lexeme.html#spirit.qi.reference.directive.lexeme.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::lexeme;
+using boost::spirit::qi::lit;
+using boost::spirit::ascii::digit;
+</pre>
+
+ 
+
+ 
+
+ Simple usage of <code class="computeroutput">lexeme[]</code>:
+ 
+
+ 
+
+ The use of lexeme here will prevent skipping in between the digits
+ and the sign making inputs such as <code class="computeroutput">"1
+ 2 345"</code> erroneous.
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_phrase_parser("12345", lexeme[ -(lit('+') | '-') >> +digit ]);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../directive.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="no_case.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/no_case.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/no_case.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,271 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Inhibiting Case Sensitivity (no_case[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="lexeme.html" title="Inhibiting Skipping (lexeme[])">
+<link rel="next" href="omit.html" title="Ignoring Attribute (omit[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexeme.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="omit.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Inhibiting Case Sensitivity (no_case[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.directive.no_case"></a><a class="link" href="no_case.html" title="Inhibiting Case Sensitivity (no_case[])"> Inhibiting
+ Case Sensitivity (<code class="computeroutput">no_case[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.directive.no_case.description"></a><h6>
+<a name="id664018"></a>
+ <a class="link" href="no_case.html#spirit.qi.reference.directive.no_case.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">no_case[]</code>
+ directive does not consume any input. The actual matching is done by
+ its subject parser. It's purpose is to force matching of the subject
+ parser (and all its children) to be case insensitive.
+ 
+<a name="spirit.qi.reference.directive.no_case.header"></a><h6>
+<a name="id664046"></a>
+ <a class="link" href="no_case.html#spirit.qi.reference.directive.no_case.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/directive/no_case.hpp>
+#include <boost/spirit/include/qi_no_case.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.directive.no_case.namespace"></a><h6>
+<a name="id664120"></a>
+ <a class="link" href="no_case.html#spirit.qi.reference.directive.no_case.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">ns::no_case</code>
+ 
+ </td></tr></tbody>
+</table></div>
+
+ In the table above, <code class="computeroutput">ns</code>
+ is a <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<a name="spirit.qi.reference.directive.no_case.model_of"></a><h6>
+<a name="id664202"></a>
+ <a class="link" href="no_case.html#spirit.qi.reference.directive.no_case.model_of">Model
+ of</a>
+ </h6>
+
+ The model of <code class="computeroutput">no_case</code>
+ is the model of its subject parser.
+ 
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>.
+ </dd>
+<dt><code class="computeroutput">ns</code></dt>
+<dd>
+ A <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.directive.no_case.expression_semantics"></a><h6>
+<a name="id664287"></a>
+ <a class="link" href="no_case.html#spirit.qi.reference.directive.no_case.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in the subject's concept.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">ns::no_case[a]</code>
+ 
+ </td>
+<td>
+ 
+ Force matching of the subject parser, <code class="computeroutput">a</code>
+ (and all its children) to be case insensitive
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.no_case.attributes"></a><h6>
+<a name="id664390"></a>
+ <a class="link" href="no_case.html#spirit.qi.reference.directive.no_case.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">ns::no_case[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> ns::no_case[a]: A
+a: Unused --> ns::no_case[a]: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.no_case.complexity"></a><h6>
+<a name="id664584"></a>
+ <a class="link" href="no_case.html#spirit.qi.reference.directive.no_case.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The complexity is defined by the complexity of the subject parser,
+ <code class="computeroutput">a</code>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.directive.no_case.example"></a><h6>
+<a name="id664615"></a>
+ <a class="link" href="no_case.html#spirit.qi.reference.directive.no_case.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::no_case;
+using boost::spirit::ascii::char_;
+using boost::spirit::ascii::alnum;
+using boost::spirit::qi::symbols;
+</pre>
+
+ 
+
+ 
+
+ Simple usage of <code class="computeroutput">no_case[]</code>:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("X", no_case[char_('x')]);
+test_parser("6", no_case[alnum]);
+</pre>
+
+ 
+
+ 
+
+ A more sophisticated use case of <code class="computeroutput">no_case[]</code> in conjunction with a symbol table
+ (see <a class="link" href="../string/symbols.html" title="Symbols (symbols)"><code class="computeroutput">symbols<Ch, T></code></a>
+ for more details):
+ 
+
+ 
+
+
+
+<pre class="programlisting">symbols<char, int> sym;
+
+sym.add
+ ("apple", 1) // symbol strings are added in lowercase...
+ ("banana", 2)
+ ("orange", 3)
+;
+
+int i;
+// ...because sym is used for case-insensitive parsing
+test_parser_attr("Apple", no_case[ sym ], i);
+std::cout << i << std::endl;
+test_parser_attr("ORANGE", no_case[ sym ], i);
+std::cout << i << std::endl;
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lexeme.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="omit.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/omit.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/omit.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,229 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Ignoring Attribute (omit[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="no_case.html" title="Inhibiting Case Sensitivity (no_case[])">
+<link rel="next" href="raw.html" title="Transduction Parsing (raw[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="no_case.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="raw.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Ignoring Attribute (omit[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.directive.omit"></a><a class="link" href="omit.html" title="Ignoring Attribute (omit[])"> Ignoring Attribute
+ (<code class="computeroutput">omit[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.directive.omit.description"></a><h6>
+<a name="id665252"></a>
+ <a class="link" href="omit.html#spirit.qi.reference.directive.omit.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">omit[]</code>
+ ignores the attribute of its subject parser replacing it with <code class="computeroutput">unused</code>.
+ 
+<a name="spirit.qi.reference.directive.omit.header"></a><h6>
+<a name="id665287"></a>
+ <a class="link" href="omit.html#spirit.qi.reference.directive.omit.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/directive/omit.hpp>
+#include <boost/spirit/include/qi_omit.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.directive.omit.namespace"></a><h6>
+<a name="id665361"></a>
+ <a class="link" href="omit.html#spirit.qi.reference.directive.omit.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::omit // alias:
+ boost::spirit::qi::omit</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.omit.model_of"></a><h6>
+<a name="id665439"></a>
+ <a class="link" href="omit.html#spirit.qi.reference.directive.omit.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.directive.omit.expression_semantics"></a><h6>
+<a name="id665918"></a>
+ <a class="link" href="omit.html#spirit.qi.reference.directive.omit.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">omit[a]</code>
+ 
+ </td>
+<td>
+ 
+ Ignore the attribute of the subject parser, <code class="computeroutput">a</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.omit.attributes"></a><h6>
+<a name="id666020"></a>
+ <a class="link" href="omit.html#spirit.qi.reference.directive.omit.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">omit[a]</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused_type</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.omit.complexity"></a><h6>
+<a name="id666108"></a>
+ <a class="link" href="omit.html#spirit.qi.reference.directive.omit.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The complexity is defined by the complexity of the subject parser,
+ <code class="computeroutput">a</code>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.directive.omit.example"></a><h6>
+<a name="id666140"></a>
+ <a class="link" href="omit.html#spirit.qi.reference.directive.omit.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::omit;
+using boost::spirit::qi::int_;
+using boost::spirit::ascii::char_;
+</pre>
+
+ 
+
+ 
+
+ 
+
+ This parser ignores the first two characters and extracts the succeeding
+ <code class="computeroutput">int</code>:
+ 
+
+ 
+
+
+
+<pre class="programlisting">int i;
+test_parser_attr("xx345", omit[char_ >> char_] >> int_, i);
+std::cout << i << std::endl; // should print 345
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="no_case.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="raw.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/raw.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/raw.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,254 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Transduction Parsing (raw[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="omit.html" title="Ignoring Attribute (omit[])">
+<link rel="next" href="repeat.html" title="Repetition (repeat[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="omit.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="repeat.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Transduction Parsing (raw[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.directive.raw"></a><a class="link" href="raw.html" title="Transduction Parsing (raw[])"> Transduction
+ Parsing (<code class="computeroutput">raw[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.directive.raw.description"></a><h6>
+<a name="id666436"></a>
+ <a class="link" href="raw.html#spirit.qi.reference.directive.raw.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">raw[]</code>
+ disregards the attribute of its subject parser, instead exposing the
+ half-open range <code class="computeroutput">[first, last)</code> pointing to the matched characters from
+ the input stream. The <code class="computeroutput">raw[]</code> directive breings back the classic
+ Spirit transduction (un-attributed) behavior for a subject parser.
+ 
+<a name="spirit.qi.reference.directive.raw.header"></a><h6>
+<a name="id666497"></a>
+ <a class="link" href="raw.html#spirit.qi.reference.directive.raw.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/directive/raw.hpp>
+#include <boost/spirit/include/qi_raw.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.directive.raw.namespace"></a><h6>
+<a name="id666572"></a>
+ <a class="link" href="raw.html#spirit.qi.reference.directive.raw.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::raw // alias:
+ boost::spirit::qi::raw</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.raw.model_of"></a><h6>
+<a name="id666650"></a>
+ <a class="link" href="raw.html#spirit.qi.reference.directive.raw.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>.
+ </dd>
+<dt><code class="computeroutput">Iter</code></dt>
+<dd>
+ A ForwardIterator type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.directive.raw.expression_semantics"></a><h6>
+<a name="id666746"></a>
+ <a class="link" href="raw.html#spirit.qi.reference.directive.raw.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">raw[a]</code>
+ 
+ </td>
+<td>
+ 
+ Disregard the attribute of the subject parser, <code class="computeroutput">a</code>. Expose instead the half-open
+ range <code class="computeroutput">[first, last)</code> pointing to the matched characters
+ from the input stream.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.raw.attributes"></a><h6>
+<a name="id666872"></a>
+ <a class="link" href="raw.html#spirit.qi.reference.directive.raw.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">raw[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> raw[a]: boost::iterator_range<Iter>
+a: Unused --> raw[a]: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="note" title="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">
+ See boost::iterator_range.
+ </td></tr>
+</table></div>
+<a name="spirit.qi.reference.directive.raw.complexity"></a><h6>
+<a name="id667086"></a>
+ <a class="link" href="raw.html#spirit.qi.reference.directive.raw.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The complexity is defined by the complexity of the subject parser,
+ <code class="computeroutput">a</code>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.directive.raw.example"></a><h6>
+<a name="id667118"></a>
+ <a class="link" href="raw.html#spirit.qi.reference.directive.raw.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::raw;
+using boost::spirit::ascii::alpha;
+using boost::spirit::ascii::alnum;
+</pre>
+
+ 
+
+ 
+
+ 
+
+ This parser matches and extracts C++ identifiers:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string id;
+test_parser_attr("James007", raw[(alpha | '_') >> *(alnum | '_')], id);
+std::cout << id << std::endl; // should print James007
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="omit.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="repeat.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/repeat.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/repeat.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,445 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Repetition (repeat[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="raw.html" title="Transduction Parsing (raw[])">
+<link rel="next" href="skip.html" title="Re-Establish Skipping (skip[])">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="raw.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="skip.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Repetition (repeat[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.directive.repeat"></a><a class="link" href="repeat.html" title="Repetition (repeat[])"> Repetition
+ (<code class="computeroutput">repeat[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.directive.repeat.description"></a><h6>
+<a name="id667427"></a>
+ <a class="link" href="repeat.html#spirit.qi.reference.directive.repeat.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">repeat[]</code>
+ provides a more powerful and flexible mechanism for repeating a parser.
+ There are grammars that are impractical and cumbersome, if not impossible,
+ for the basic EBNF iteration syntax (Kleene Star and the Plus) to specify.
+ Examples:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ A file name may have a maximum of 255 characters only.
+ </li>
+<li class="listitem">
+ A specific bitmap file format has exactly 4096 RGB color information.
+ </li>
+<li class="listitem">
+ A 256 bit binary string (1..256 1s or 0s).
+ </li>
+</ul></div>
+<a name="spirit.qi.reference.directive.repeat.header"></a><h6>
+<a name="id667469"></a>
+ <a class="link" href="repeat.html#spirit.qi.reference.directive.repeat.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/directive/repeat.hpp>
+#include <boost/spirit/include/qi_repeat.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.directive.repeat.namespace"></a><h6>
+<a name="id667544"></a>
+ <a class="link" href="repeat.html#spirit.qi.reference.directive.repeat.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::repeat // alias:
+ boost::spirit::qi::repeat</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::inf // alias:
+ boost::spirit::qi::inf</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.repeat.model_of"></a><h6>
+<a name="id667659"></a>
+ <a class="link" href="repeat.html#spirit.qi.reference.directive.repeat.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>.
+ </dd>
+<dt><code class="computeroutput">n</code>,<code class="computeroutput">min</code>,<code class="computeroutput">max</code></dt>
+<dd>
+ An <code class="computeroutput">int</code> anything that
+ can be converted to an <code class="computeroutput">int</code>,
+ or a __lazyargument_ that evaluates
+ to anything that can be converted to an <code class="computeroutput">int</code>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.directive.repeat.expression_semantics"></a><h6>
+<a name="id667788"></a>
+ <a class="link" href="repeat.html#spirit.qi.reference.directive.repeat.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat[a]</code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> zero
+ or more times. Same as Kleene Star.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(n)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> exactly
+ <code class="computeroutput">n</code> times.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(min,
+ max)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> at least
+ <code class="computeroutput">min</code> times and
+ at most <code class="computeroutput">max</code> times.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(min,
+ inf)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Repeat <code class="computeroutput">a</code> at least
+ <code class="computeroutput">min</code> or more (continuing
+ until <code class="computeroutput">a</code> fails
+ or the input is consumed).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.repeat.attributes"></a><h6>
+<a name="id670283"></a>
+ <a class="link" href="repeat.html#spirit.qi.reference.directive.repeat.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat[a]: vector<A>
+a: Unused --> repeat[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(n)[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat(n)[a]: vector<A>
+a: Unused --> repeat(n)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(min,
+ max)[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat(min, max)[a]: vector<A>
+a: Unused --> repeat(min, max)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">repeat(min,
+ inf)[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> repeat(min, inf)[a]: vector<A>
+a: Unused --> repeat(min, inf)[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.repeat.complexity"></a><h6>
+<a name="id670955"></a>
+ <a class="link" href="repeat.html#spirit.qi.reference.directive.repeat.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity is defined by the complexity of its subject
+ parser. The complexity of <code class="computeroutput">repeat</code>
+ itself is O(N), where N is the number of repetitions to execute.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.directive.repeat.example"></a><h6>
+<a name="id670987"></a>
+ <a class="link" href="repeat.html#spirit.qi.reference.directive.repeat.example">Example</a>
+ </h6>
+
+ Using the repeat directive, we can now write our examples above.
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::repeat;
+using boost::spirit::qi::lit;
+using boost::spirit::qi::uint_parser;
+using boost::spirit::qi::_1;
+using boost::spirit::ascii::char_;
+namespace phx = boost::phoenix;
+</pre>
+
+ 
+
+ 
+
+ 
+
+ A parser for a file name with a maximum of 255 characters:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("batman.jpeg", repeat(1, 255)[char_("a-zA-Z_./")]);</pre>
+
+ 
+
+ 
+
+ A parser for a specific bitmap file format which has exactly 4096 RGB
+ color information. (for the purpose of this example, we will be testing
+ only 3 RGB color information.)
+ 
+
+ 
+
+
+
+<pre class="programlisting">uint_parser<unsigned, 16, 6, 6> rgb;
+std::vector<unsigned> colors;
+test_parser_attr("ffffff0000003f3f3f", repeat(3)[rgb], colors);
+std::cout
+ << std::hex
+ << colors[0] << ','
+ << colors[1] << ','
+ << colors[2] << std::endl;</pre>
+
+ 
+
+ 
+
+ A 256 bit binary string (1..256 1s or 0s). (For the purpose of this
+ example, we will be testing only 16 bits.)
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("1011101011110010", repeat(16)[lit('1') | '0']);
+</pre>
+
+ 
+
+ 
+
+ The Loop parsers can be dynamic. Consider the parsing of a binary file
+ of Pascal-style length prefixed string, where the first byte determines
+ the length of the incoming string. Here's a sample input:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <img src="../../../../../../../../images/pascal_string.png" alt="pascal_string">
+ 
+
+ 
+</blockquote></div>
+
+ 
+
+ This trivial example cannot be practically defined in traditional EBNF.
+ Although some EBNF variants allow more powerful repetition constructs
+ other than the Kleene Star, we are still limited to parsing fixed strings.
+ The nature of EBNF forces the repetition factor to be a constant. On
+ the other hand, Spirit allows the repetition factor to be variable
+ at run time. We could write a grammar that accepts the input string
+ above. Example using phoenix:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string str;
+int n;
+test_parser_attr("\x0bHello World",
+ char_[phx::ref(n) = _1] >> repeat(phx::ref(n))[char_], str);
+std::cout << n << ',' << str << std::endl; // will print "11,Hello World"
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="raw.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="skip.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/skip.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/directive/skip.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,287 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Re-Establish Skipping (skip[])</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../directive.html" title="Directive">
+<link rel="prev" href="repeat.html" title="Repetition (repeat[])">
+<link rel="next" href="../numeric.html" title="Numeric">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="repeat.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../numeric.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Re-Establish Skipping (skip[])">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.directive.skip"></a><a class="link" href="skip.html" title="Re-Establish Skipping (skip[])"> Re-Establish
+ Skipping (<code class="computeroutput">skip[]</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.directive.skip.description"></a><h6>
+<a name="id671897"></a>
+ <a class="link" href="skip.html#spirit.qi.reference.directive.skip.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">skip</code> directive is
+ the inverse of <a class="link" href="lexeme.html" title="Inhibiting Skipping (lexeme[])"><code class="computeroutput">lexeme</code></a>. While the <a class="link" href="lexeme.html" title="Inhibiting Skipping (lexeme[])"><code class="computeroutput">lexeme</code></a> directive turns off white
+ space skipping, the <code class="computeroutput">skip</code>
+ directive turns it on again. This is simply done by wrapping the parts
+ inside the <code class="computeroutput">skip</code> directive:
+ 
+<pre class="programlisting">skip[a]
+</pre>
+
+ It is also possible to supply a skip parser to the <code class="computeroutput">skip</code>
+ directive:
+ 
+<pre class="programlisting">skip(p)[a] // Use `p` as a skipper for parsing `a`
+</pre>
+
+ This makes it possible to: * Perform localized phrase level parsing while
+ doing character level parsing. * Replace the current skipper anywhere
+ with an entirely different skipper while doing phrase level parsing.
+ 
+<a name="spirit.qi.reference.directive.skip.header"></a><h6>
+<a name="id672020"></a>
+ <a class="link" href="skip.html#spirit.qi.reference.directive.skip.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/directive/skip.hpp>
+#include <boost/spirit/include/qi_skip.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.directive.skip.namespace"></a><h6>
+<a name="id672094"></a>
+ <a class="link" href="skip.html#spirit.qi.reference.directive.skip.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody><tr><td>
+ 
+ <code class="computeroutput">boost::spirit::skip // alias:
+ boost::spirit::qi::skip</code>
+ 
+ </td></tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.skip.model_of"></a><h6>
+<a name="id672172"></a>
+ <a class="link" href="skip.html#spirit.qi.reference.directive.skip.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.directive.skip.expression_semantics"></a><h6>
+<a name="id672241"></a>
+ <a class="link" href="skip.html#spirit.qi.reference.directive.skip.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">skip[a]</code>
+ 
+ </td>
+<td>
+ 
+ Re-establish the skipper that got inhibited by lexeme
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">skip(p)[a]</code>
+ 
+ </td>
+<td>
+ 
+ Use <code class="computeroutput">p</code> as a skipper
+ for parsing <code class="computeroutput">a</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.skip.attributes"></a><h6>
+<a name="id672392"></a>
+ <a class="link" href="skip.html#spirit.qi.reference.directive.skip.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">skip[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> skip[a]: A
+a: Unused --> lexeme[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">skip(p)[a]</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> skip(p)[a]: A
+a: Unused --> lexeme[a]: Unused</pre>
+
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.directive.skip.complexity"></a><h6>
+<a name="id672711"></a>
+ <a class="link" href="skip.html#spirit.qi.reference.directive.skip.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The complexity is defined by the complexity of the subject parser,
+ <code class="computeroutput">a</code>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.directive.skip.example"></a><h6>
+<a name="id672742"></a>
+ <a class="link" href="skip.html#spirit.qi.reference.directive.skip.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::skip;
+using boost::spirit::qi::int_;
+using boost::spirit::ascii::space;
+</pre>
+
+ 
+
+ 
+
+ Simple usage of <code class="computeroutput">skip[]</code>:
+ 
+
+ 
+
+ Explicitly specify a skip parser. This parser parses comma delimited
+ numbers, ignoring spaces.
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("1, 2, 3, 4, 5", skip(space)[int_ >> *(',' >> int_)]);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="repeat.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../directive.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../numeric.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,81 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Numeric</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="directive/skip.html" title="Re-Establish Skipping (skip[])">
+<link rel="next" href="numeric/uint.html" title="Unsigned Integers (uint_, etc.)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="directive/skip.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric/uint.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Numeric">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.reference.numeric"></a><a class="link" href="numeric.html" title="Numeric">Numeric</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="numeric/uint.html"> Unsigned Integers
+ (<code class="computeroutput">uint_</code>, etc.)</a></dt>
+<dt><a href="numeric/int.html"> Signed Integers
+ (<code class="computeroutput">int_</code>, etc.)</a></dt>
+<dt><a href="numeric/real.html"> Real Numbers (<code class="computeroutput">float_</code>, <code class="computeroutput">double_</code>,
+ etc.)</a></dt>
+</dl></div>
+
+ The library includes a couple of predefined objects for parsing signed
+ and unsigned integers and real numbers. These parsers are fully parametric.
+ Most of the important aspects of numeric parsing can be finely adjusted
+ to suit. This includes the radix base, the minimum and maximum number of
+ allowable digits, the exponent, the fraction etc. Policies control the
+ real number parsers' behavior. There are some predefined policies covering
+ the most common real number formats but the user can supply her own when
+ needed.
+ 
+
+ The numeric parsers are fine tuned (employing loop unrolling and extensive
+ template metaprogramming) with exceptional performance that rivals the
+ low level C functions such as <code class="computeroutput">atof</code>,
+ <code class="computeroutput">strtod</code>, <code class="computeroutput">atol</code>,
+ <code class="computeroutput">strtol</code>. Benchmarks reveal
+ up to 4X speed over the C counterparts. This goes to show that you can
+ write extremely tight generic C++ code that rivals, if not surpasses C.
+ 
+<a name="spirit.qi.reference.numeric.module_header"></a><h6>
+<a name="id673012"></a>
+ <a class="link" href="numeric.html#spirit.qi.reference.numeric.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/numeric.hpp>
+#include <boost/spirit/include/qi_numeric.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="directive/skip.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="numeric/uint.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/int.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/int.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,577 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Signed Integers (int_, etc.)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../numeric.html" title="Numeric">
+<link rel="prev" href="uint.html" title="Unsigned Integers (uint_, etc.)">
+<link rel="next" href="real.html" title="Real Numbers (float_, double_, etc.)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="uint.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="real.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Signed Integers (int_, etc.)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.numeric.int"></a><a class="link" href="int.html" title="Signed Integers (int_, etc.)"> Signed Integers
+ (<code class="computeroutput">int_</code>, etc.)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.numeric.int.description"></a><h6>
+<a name="id676543"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">int_parser</code> can parse
+ signed integers of arbitrary length and size. This is almost the same
+ as the <code class="computeroutput">uint_parser</code>. The
+ only difference is the additional task of parsing the <code class="computeroutput">'+'</code>
+ or <code class="computeroutput">'-'</code> sign preceding the number.
+ The class interface is the same as that of the <code class="computeroutput">uint_parser</code>.
+ 
+
+ The <code class="computeroutput">int_parser</code> parser
+ can be used to parse ordinary primitive C/C++ integers or even user defined
+ scalars such as bigints (unlimited precision integers) as long as the
+ type follows certain expression requirements (documented below).
+ 
+<a name="spirit.qi.reference.numeric.int.header"></a><h6>
+<a name="id676606"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/numeric/int.hpp>
+#include <boost/spirit/include/qi_int.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.numeric.int.namespace"></a><h6>
+<a name="id676681"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::short_ // alias:
+ boost::spirit::qi::short_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::int_ // alias:
+ boost::spirit::qi::int_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::long_ // alias:
+ boost::spirit::qi::long_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::long_long //
+ alias: boost::spirit::qi::long_long</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ <code class="computeroutput">long_long</code> is only available
+ on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code>
+ is defined (i.e. on platforms having native support for <code class="computeroutput">signed long
+ long</code> (64 bit) unsigned integer
+ types).
+ </td></tr>
+</table></div>
+<a name="spirit.qi.reference.numeric.int.synopsis"></a><h6>
+<a name="id676911"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting">template <
+ typename T
+ , unsigned Radix
+ , unsigned MinDigits
+ , int MaxDigits>
+struct int_parser;
+</pre>
+<a name="spirit.qi.reference.numeric.int.template_parameters"></a><h6>
+<a name="id677007"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.template_parameters">Template
+ parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Parameter
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+<th>
+ 
+ Default
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T</code>
+ 
+ </td>
+<td>
+ 
+ The numeric base type of the numeric parser.
+ 
+ </td>
+<td>
+ 
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Radix</code>
+ 
+ </td>
+<td>
+ 
+ The radix base. This can be either 2: binary, 8: octal, 10: decimal
+ and 16: hexadecimal.
+ 
+ </td>
+<td>
+ 
+ 10
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">MinDigits</code>
+ 
+ </td>
+<td>
+ 
+ The minimum number of digits allowable.
+ 
+ </td>
+<td>
+ 
+ 1
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">MaxDigits</code>
+ 
+ </td>
+<td>
+ 
+ The maximum number of digits allowable. If this is -1, then the
+ maximum limit becomes unbounded.
+ 
+ </td>
+<td>
+ 
+ -1
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.numeric.int.model_of"></a><h6>
+<a name="id677180"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">NP</code></dt>
+<dd>
+ An instance of <code class="computeroutput">int_parser</code>
+ (type).
+ </dd>
+<dt><code class="computeroutput">n</code></dt>
+<dd>
+ An object of <code class="computeroutput">T</code>, the
+ numeric base type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.numeric.int.expression_semantics"></a><h6>
+<a name="id677271"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">NP()</code>
+ 
+ </td>
+<td>
+ 
+ Instantiate and (default) construct an <code class="computeroutput">int_parser</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">short_</code>
+ 
+ </td>
+<td>
+ 
+ Create an <code class="computeroutput">int_parser<short, 10, 1, -1></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_</code>
+ 
+ </td>
+<td>
+ 
+ Create an <code class="computeroutput">int_parser<long, 10, 1, -1></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">int_</code>
+ 
+ </td>
+<td>
+ 
+ Create an <code class="computeroutput">int_parser<int, 10, 1, -1></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_long</code>
+ 
+ </td>
+<td>
+ 
+ Create an <code class="computeroutput">int_parser<long
+ long,
+ 10,
+ 1,
+ -1></code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.numeric.int.attributes"></a><h6>
+<a name="id677655"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.attributes">Attributes</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <code class="computeroutput">T</code>, The numeric base
+ type of the numeric parser.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.numeric.int.complexity"></a><h6>
+<a name="id677686"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of digits being parsed plus the sign.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.numeric.int.minimum_expression_requirements_for__code__phrase_role__identifier__t__phrase___code_"></a><h6>
+<a name="id677710"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.minimum_expression_requirements_for__code__phrase_role__identifier__t__phrase___code_">Minimum
+ Expression Requirements for <code class="computeroutput">T</code></a>
+ </h6>
+
+ The numeric base type, <code class="computeroutput">T</code>,
+ the expression requirements below must be valid:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T()</code>
+ 
+ </td>
+<td>
+ 
+ Default construct.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T(0)</code>
+ 
+ </td>
+<td>
+ 
+ Construct from an <code class="computeroutput">int</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">n +
+ n</code>
+ 
+ </td>
+<td>
+ 
+ Addition.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">n -
+ n</code>
+ 
+ </td>
+<td>
+ 
+ Subtraction.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">n *
+ n</code>
+ 
+ </td>
+<td>
+ 
+ Multiplication.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::is_bounded</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">true</code> or <code class="computeroutput">false</code> if <code class="computeroutput">T</code>
+ bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::digits</code>
+ 
+ </td>
+<td>
+ 
+ Maximum Digits for <code class="computeroutput">T</code>,
+ radix digits. Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::digits10</code>
+ 
+ </td>
+<td>
+ 
+ Maximum Digits for <code class="computeroutput">T</code>,
+ base 10. Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::max()</code>
+ 
+ </td>
+<td>
+ 
+ Maximum value for <code class="computeroutput">T</code>.
+ Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::min()</code>
+ 
+ </td>
+<td>
+ 
+ Minimum value for <code class="computeroutput">T</code>.
+ Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.numeric.int.example"></a><h6>
+<a name="id678265"></a>
+ <a class="link" href="int.html#spirit.qi.reference.numeric.int.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::int_;
+</pre>
+
+ 
+
+ 
+
+ Basic signed integers:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("+12345", int_);
+test_parser("-12345", int_);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="uint.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="real.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/real.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/real.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,1064 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Real Numbers (float_, double_, etc.)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../numeric.html" title="Numeric">
+<link rel="prev" href="int.html" title="Signed Integers (int_, etc.)">
+<link rel="next" href="../operator.html" title="Operator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../operator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Real Numbers (float_, double_, etc.)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.numeric.real"></a><a class="link" href="real.html" title="Real Numbers (float_, double_, etc.)"> Real Numbers (<code class="computeroutput">float_</code>, <code class="computeroutput">double_</code>,
+ etc.)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.numeric.real.description"></a><h6>
+<a name="id678415"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">real_parser</code> can parse
+ real numbers of arbitrary length and size limited by its template parameter,
+ <code class="computeroutput">T</code>. The numeric base type
+ <code class="computeroutput">T</code> can be a user defined
+ numeric type such as fixed_point (fixed point reals) and bignum (unlimited
+ precision numbers) as long as the type follows certain expression requirements
+ (documented below).
+ 
+<a name="spirit.qi.reference.numeric.real.header"></a><h6>
+<a name="id678454"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/numeric/real.hpp>
+#include <boost/spirit/include/qi_real.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.numeric.real.namespace"></a><h6>
+<a name="id678528"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::float_ // alias:
+ boost::spirit::qi::float_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::double_ //
+ alias: boost::spirit::qi::double_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::long_double //
+ alias: boost::spirit::qi::long_double</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.numeric.real.synopsis"></a><h6>
+<a name="id678683"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting">template <typename T, typename RealPolicies>
+struct real_parser;
+</pre>
+<a name="spirit.qi.reference.numeric.real.template_parameters"></a><h6>
+<a name="id678748"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.template_parameters">Template
+ parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Parameter
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+<th>
+ 
+ Default
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T</code>
+ 
+ </td>
+<td>
+ 
+ The numeric base type of the numeric parser.
+ 
+ </td>
+<td>
+ 
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RealPolicies</code>
+ 
+ </td>
+<td>
+ 
+ Policies control the parser's behavior.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">real_policies<T></code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.numeric.real.model_of"></a><h6>
+<a name="id678878"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">NP</code></dt>
+<dd>
+ An instance of <code class="computeroutput">real_parser</code>
+ (type).
+ </dd>
+<dt><code class="computeroutput">RP</code></dt>
+<dd>
+ A <code class="computeroutput">RealPolicies</code> (type).
+ </dd>
+<dt><code class="computeroutput">n</code></dt>
+<dd>
+ An object of <code class="computeroutput">T</code>, the
+ numeric base type.
+ </dd>
+<dt><code class="computeroutput">exp</code></dt>
+<dd>
+ A <code class="computeroutput">int</code> exponent.
+ </dd>
+<dt><code class="computeroutput">b</code></dt>
+<dd>
+ A <code class="computeroutput">bool</code> flag.
+ </dd>
+<dt><code class="computeroutput">f</code>,
+ <code class="computeroutput">l</code></dt>
+<dd>
+ ForwardIterator. first/last
+ iterator pair.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.numeric.real.expression_semantics"></a><h6>
+<a name="id679081"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">NP()</code>
+ 
+ </td>
+<td>
+ 
+ Instantiate and (default) construct an <code class="computeroutput">real_parser</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">float_</code>
+ 
+ </td>
+<td>
+ 
+ Create an <code class="computeroutput">real_parser<float, real_policies<T> ></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">double_</code>
+ 
+ </td>
+<td>
+ 
+ Create an <code class="computeroutput">real_parser<double, real_policies<T> ></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">long_double</code>
+ 
+ </td>
+<td>
+ 
+ Create an <code class="computeroutput">real_parser<long
+ double,
+ real_policies<T>
+ ></code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.numeric.real.attributes"></a><h6>
+<a name="id679369"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.attributes">Attributes</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <code class="computeroutput">T</code>, The numeric base
+ type of the numeric parser.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.numeric.real.complexity"></a><h6>
+<a name="id679400"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of characters (including the digits,
+ exponent, sign, etc.) being parsed.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.numeric.real.minimum_expression_requirements_for__code__phrase_role__identifier__t__phrase___code_"></a><h6>
+<a name="id679424"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.minimum_expression_requirements_for__code__phrase_role__identifier__t__phrase___code_">Minimum
+ Expression Requirements for <code class="computeroutput">T</code></a>
+ </h6>
+
+ The numeric base type, <code class="computeroutput">T</code>,
+ the minimum expression requirements listed below must be valid. Take
+ note that additional requirements may be imposed by custom policies.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T()</code>
+ 
+ </td>
+<td>
+ 
+ Default construct.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T(0)</code>
+ 
+ </td>
+<td>
+ 
+ Construct from an <code class="computeroutput">int</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">n +
+ n</code>
+ 
+ </td>
+<td>
+ 
+ Addition.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">n -
+ n</code>
+ 
+ </td>
+<td>
+ 
+ Subtraction.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">n *
+ n</code>
+ 
+ </td>
+<td>
+ 
+ Multiplication.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::is_bounded</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">true</code> or <code class="computeroutput">false</code> if <code class="computeroutput">T</code>
+ bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::digits</code>
+ 
+ </td>
+<td>
+ 
+ Maximum Digits for <code class="computeroutput">T</code>,
+ radix digits. Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::digits10</code>
+ 
+ </td>
+<td>
+ 
+ Maximum Digits for <code class="computeroutput">T</code>,
+ base 10. Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::max()</code>
+ 
+ </td>
+<td>
+ 
+ Maximum value for <code class="computeroutput">T</code>.
+ Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::min()</code>
+ 
+ </td>
+<td>
+ 
+ Minimum value for <code class="computeroutput">T</code>.
+ Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">boost::spirit::traits::scale(exp,
+ n)</code>
+ 
+ </td>
+<td>
+ 
+ Multiply <code class="computeroutput">n</code> by
+ <code class="computeroutput">10^exp</code>. Default implementation
+ is provided for <code class="computeroutput">float</code>,
+ <code class="computeroutput">double</code> and <code class="computeroutput">long double</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">boost::spirit::traits::negate(b,
+ n)</code>
+ 
+ </td>
+<td>
+ 
+ Negate <code class="computeroutput">n</code> if
+ <code class="computeroutput">b</code> is <code class="computeroutput">true</code>. Default implementation is
+ provided for <code class="computeroutput">float</code>,
+ <code class="computeroutput">double</code> and <code class="computeroutput">long double</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">boost::spirit::traits::is_equal_to_one(n)</code>
+ 
+ </td>
+<td>
+ 
+ Return <code class="computeroutput">true</code> if
+ <code class="computeroutput">n</code> is equal to
+ <code class="computeroutput">1.0</code>. Default implementation
+ is provided for <code class="computeroutput">float</code>,
+ <code class="computeroutput">double</code> and <code class="computeroutput">long double</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ The additional spirit real number traits above are provided to allow
+ custom implementations to implement efficient real number parsers.
+ For example, for certain custom real numbers, scaling to a base 10
+ exponent is a very cheap operation.
+ </td></tr>
+</table></div>
+<a name="spirit.qi.reference.numeric.real._code__phrase_role__identifier__realpolicies__phrase___code_"></a><h6>
+<a name="id680456"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real._code__phrase_role__identifier__realpolicies__phrase___code_"><code class="computeroutput">RealPolicies</code></a>
+ </h6>
+
+ The <code class="computeroutput">RealPolicies</code> template
+ parameter is a class that groups all the policies that control the parser's
+ behavior. Policies control the real number parsers' behavior.
+ 
+
+ The default is <code class="computeroutput">real_policies<T></code>. The default is provided to take
+ care of the most common case (there are many ways to represent, and hence
+ parse, real numbers). In most cases, the default policies are sufficient
+ and can be used straight out of the box. They are designed to parse C/C++
+ style floating point numbers of the form <code class="computeroutput">nnn.fff.Eeee</code>
+ where <code class="computeroutput">nnn</code> is the whole
+ number part, <code class="computeroutput">fff</code> is the
+ fractional part, <code class="computeroutput">E</code> is
+ <code class="computeroutput">'e'</code> or <code class="computeroutput">'E'</code>
+ and <code class="computeroutput">eee</code> is the exponent
+ optionally preceded by <code class="computeroutput">'-'</code>
+ or <code class="computeroutput">'+'</code> with the additional
+ detection of NaN and Inf as mandated by the C99 Standard and proposed
+ for inclusion into the C++0x Standard: nan, nan(...), inf and infinity
+ (the matching is case-insensitive). This corresponds to the following
+ grammar:
+ 
+<pre class="programlisting">sign
+ = lit('+') | '-'
+ ;
+
+nan
+ = -lit("1.0#") >> no_case["nan"]
+ >> -('(' >> *(char_ - ')') >> ')')
+ ;
+
+inf
+ = no_case[lit("inf") >> -lit("inity")]
+ ;
+
+floating_literal
+ = -sign >>
+ ( nan
+ | inf
+ | fractional_constant >> !exponent_part
+ | +digit >> exponent_part
+ )
+ ;
+
+fractional_constant
+ = *digit >> '.' >> +digit
+ | +digit >> -lit('.')
+ ;
+
+exponent_part
+ = (lit('e') | 'E') >> -sign >> +digit
+ ;
+</pre>
+
+ There are four <code class="computeroutput">RealPolicies</code>
+ pre-defined for immediate use:
+ 
+<div class="table">
+<a name="id681057"></a>Table 4. Predefined Policies
+<div class="table-contents"><table class="table" summary="Predefined Policies">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Policies
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ureal_policies<double> ></code>
+ 
+ </td>
+<td>
+ 
+ Without sign.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">real_policies<double>
+ ></code>
+ 
+ </td>
+<td>
+ 
+ With sign.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">strict_ureal_policies<double> ></code>
+ 
+ </td>
+<td>
+ 
+ Without sign, dot required.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">strict_real_policies<double> ></code>
+ 
+ </td>
+<td>
+ 
+ With sign, dot required.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ <div class="note" title="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">
+ Integers are considered a subset of real numbers, so for instance,
+ <code class="computeroutput">double_</code> recognizes
+ integer numbers (without a dot) just as well. To avoid this ambiguity,
+ <code class="computeroutput">strict_ureal_policies</code>
+ and <code class="computeroutput">strict_real_policies</code>
+ require a dot to be present for a number to be considered a successful
+ match.
+ </td></tr>
+</table></div>
+<a name="spirit.qi.reference.numeric.real._code__phrase_role__identifier__realpolicies__phrase___code__expression_requirements"></a><h6>
+<a name="id681288"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real._code__phrase_role__identifier__realpolicies__phrase___code__expression_requirements"><code class="computeroutput">RealPolicies</code> Expression Requirements</a>
+ </h6>
+
+ For models of <code class="computeroutput">RealPolicies</code>
+ the following expressions must be valid:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::allow_leading_dot</code>
+ 
+ </td>
+<td>
+ 
+ Allow leading dot.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::allow_trailing_dot</code>
+ 
+ </td>
+<td>
+ 
+ Allow trailing dot.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::expect_dot</code>
+ 
+ </td>
+<td>
+ 
+ Require a dot.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::parse_sign(f,
+ l)</code>
+ 
+ </td>
+<td>
+ 
+ Parse the prefix sign (e.g. '-'). Return <code class="computeroutput">true</code>
+ if successful, otherwise <code class="computeroutput">false</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::parse_n(f,
+ l,
+ n)</code>
+ 
+ </td>
+<td>
+ 
+ Parse the integer at the left of the decimal point. Return <code class="computeroutput">true</code> if successful, otherwise
+ <code class="computeroutput">false</code>. If successful,
+ place the result into <code class="computeroutput">n</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::parse_dot(f,
+ l)</code>
+ 
+ </td>
+<td>
+ 
+ Parse the decimal point. Return <code class="computeroutput">true</code>
+ if successful, otherwise <code class="computeroutput">false</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::parse_frac_n(f,
+ l,
+ n)</code>
+ 
+ </td>
+<td>
+ 
+ Parse the fraction after the decimal point. Return <code class="computeroutput">true</code> if successful, otherwise
+ <code class="computeroutput">false</code>. If successful,
+ place the result into <code class="computeroutput">n</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::parse_exp(f,
+ l)</code>
+ 
+ </td>
+<td>
+ 
+ Parse the exponent prefix (e.g. 'e'). Return <code class="computeroutput">true</code>
+ if successful, otherwise <code class="computeroutput">false</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::parse_exp_n(f,
+ l,
+ n)</code>
+ 
+ </td>
+<td>
+ 
+ Parse the actual exponent. Return <code class="computeroutput">true</code>
+ if successful, otherwise <code class="computeroutput">false</code>.
+ If successful, place the result into <code class="computeroutput">n</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::parse_nan(f,
+ l,
+ n)</code>
+ 
+ </td>
+<td>
+ 
+ Parse a NaN. Return <code class="computeroutput">true</code>
+ if successful, otherwise <code class="computeroutput">false</code>.
+ If successful, place the result into <code class="computeroutput">n</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">RP::parse_inf(f,
+ l,
+ n)</code>
+ 
+ </td>
+<td>
+ 
+ Parse an Inf. Return <code class="computeroutput">true</code>
+ if successful, otherwise <code class="computeroutput">false</code>.
+ If successful, place the result into <code class="computeroutput">n</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ The <code class="computeroutput">parse_nan</code> and <code class="computeroutput">parse_inf</code> functions get called whenever:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ a number to parse does not start with a digit (after having successfully
+ parsed an optional sign)
+ 
+
+ 
+</blockquote></div>
+
+ or
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ after a real number of the value 1 (having no exponential part and
+ a fractional part value of 0) has been parsed.
+ 
+
+ 
+</blockquote></div>
+
+ The first call recognizes representations of NaN or Inf starting with
+ a non-digit character (such as NaN, Inf, QNaN etc.). The second call
+ recognizes representation formats starting with a <code class="computeroutput">1.0</code>
+ (such as <code class="computeroutput">"1.0#NAN"</code>
+ or <code class="computeroutput">"1.0#INF"</code> etc.).
+ 
+
+ The functions should return true if a Nan or Inf has been found. In this
+ case the attribute <code class="computeroutput">n</code>
+ should be set to the matched value (NaN or Inf). The optional sign will
+ be automatically applied afterwards.
+ 
+<a name="spirit.qi.reference.numeric.real._code__phrase_role__identifier__realpolicies__phrase___code__specializations"></a><h6>
+<a name="id682130"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real._code__phrase_role__identifier__realpolicies__phrase___code__specializations"><code class="computeroutput">RealPolicies</code> Specializations</a>
+ </h6>
+
+ The easiest way to implement a proper real parsing policy is to derive
+ a new type from the the type <code class="computeroutput">real_policies</code>
+ while overriding the aspects of the parsing which need to be changed.
+ For example, here's the implementation of the pre-defined <code class="computeroutput">strict_real_policies</code>:
+ 
+<pre class="programlisting">template <typename T>
+struct strict_real_policies : real_policies<T>
+{
+ static bool const expect_dot = true;
+};
+</pre>
+<a name="spirit.qi.reference.numeric.real.example"></a><h6>
+<a name="id682264"></a>
+ <a class="link" href="real.html#spirit.qi.reference.numeric.real.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::double_;
+using boost::spirit::qi::real_parser;
+</pre>
+
+ 
+
+ 
+
+ Basic real number parsing:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("+12345e6", double_);
+</pre>
+
+ 
+
+ 
+
+ A custom real number policy:
+ 
+
+ 
+
+
+
+<pre class="programlisting">///////////////////////////////////////////////////////////////////////////////
+// These policies can be used to parse thousand separated
+// numbers with at most 2 decimal digits after the decimal
+// point. e.g. 123,456,789.01
+///////////////////////////////////////////////////////////////////////////////
+template <typename T>
+struct ts_real_policies : boost::spirit::qi::ureal_policies<T>
+{
+ // 2 decimal places Max
+ template <typename Iterator, typename Attribute>
+ static bool
+ parse_frac_n(Iterator& first, Iterator const& last, Attribute& attr)
+ {
+ return boost::spirit::qi::
+ extract_uint<T, 10, 1, 2, true>::call(first, last, attr);
+ }
+
+ // No exponent
+ template <typename Iterator>
+ static bool
+ parse_exp(Iterator&, Iterator const&)
+ {
+ return false;
+ }
+
+ // No exponent
+ template <typename Iterator, typename Attribute>
+ static bool
+ parse_exp_n(Iterator&, Iterator const&, Attribute&)
+ {
+ return false;
+ }
+
+ // Thousands separated numbers
+ template <typename Iterator, typename Attribute>
+ static bool
+ parse_n(Iterator& first, Iterator const& last, Attribute& attr)
+ {
+ using boost::spirit::qi::uint_parser;
+ namespace qi = boost::spirit::qi;
+
+ uint_parser<unsigned, 10, 1, 3> uint3;
+ uint_parser<unsigned, 10, 3, 3> uint3_3;
+
+ T result = 0;
+ if (parse(first, last, uint3, result))
+ {
+ bool hit = false;
+ T n;
+ Iterator save = first;
+
+ while (qi::parse(first, last, ',') && qi::parse(first, last, uint3_3, n))
+ {
+ result = result * 1000 + n;
+ save = first;
+ hit = true;
+ }
+
+ first = save;
+ if (hit)
+ attr = result;
+ return hit;
+ }
+ return false;
+ }
+};
+</pre>
+
+ 
+
+ 
+
+ And its use:
+ 
+
+ 
+
+
+
+<pre class="programlisting">real_parser<double, ts_real_policies<double> > ts_real;
+test_parser("123,456,789.01", ts_real);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="int.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../operator.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/uint.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/numeric/uint.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,641 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Unsigned Integers (uint_, etc.)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../numeric.html" title="Numeric">
+<link rel="prev" href="../numeric.html" title="Numeric">
+<link rel="next" href="int.html" title="Signed Integers (int_, etc.)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../numeric.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="int.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Unsigned Integers (uint_, etc.)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.numeric.uint"></a><a class="link" href="uint.html" title="Unsigned Integers (uint_, etc.)"> Unsigned Integers
+ (<code class="computeroutput">uint_</code>, etc.)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.numeric.uint.description"></a><h6>
+<a name="id673103"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">uint_parser</code> class
+ is the simplest among the members of the numerics package. The <code class="computeroutput">uint_parser</code> can parse unsigned integers
+ of arbitrary length and size. The <code class="computeroutput">uint_parser</code>
+ parser can be used to parse ordinary primitive C/C++ integers or even
+ user defined scalars such as bigints (unlimited precision integers) as
+ long as the type follows certain expression requirements (documented
+ below). The <code class="computeroutput">uint_parser</code>
+ is a template class. Template parameters fine tune its behavior.
+ 
+<a name="spirit.qi.reference.numeric.uint.header"></a><h6>
+<a name="id673149"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/numeric/uint.hpp>
+#include <boost/spirit/include/qi_uint.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.numeric.uint.namespace"></a><h6>
+<a name="id673223"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::bin // alias:
+ boost::spirit::qi::bin</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::oct // alias:
+ boost::spirit::qi::oct</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::hex // alias:
+ boost::spirit::qi::hex</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::ushort_ //
+ alias: boost::spirit::qi::ushort_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::ulong_ // alias:
+ boost::spirit::qi::ulong_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::uint_ // alias:
+ boost::spirit::qi::uint_</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::ulong_long //
+ alias: boost::spirit::qi::ulong_long</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ <code class="computeroutput">ulong_long</code> is only
+ available on platforms where the preprocessor constant <code class="computeroutput">BOOST_HAS_LONG_LONG</code> is defined (i.e.
+ on platforms having native support for <code class="computeroutput">unsigned
+ long long</code>
+ (64 bit) unsigned integer types).
+ </td></tr>
+</table></div>
+<a name="spirit.qi.reference.numeric.uint.synopsis"></a><h6>
+<a name="id673566"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting">template <
+ typename T
+ , unsigned Radix
+ , unsigned MinDigits
+ , int MaxDigits>
+struct uint_parser;
+</pre>
+<a name="spirit.qi.reference.numeric.uint.template_parameters"></a><h6>
+<a name="id673662"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.template_parameters">Template
+ parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Parameter
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+<th>
+ 
+ Default
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T</code>
+ 
+ </td>
+<td>
+ 
+ The numeric base type of the numeric parser.
+ 
+ </td>
+<td>
+ 
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Radix</code>
+ 
+ </td>
+<td>
+ 
+ The radix base. This can be either 2: binary, 8: octal, 10: decimal
+ and 16: hexadecimal.
+ 
+ </td>
+<td>
+ 
+ 10
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">MinDigits</code>
+ 
+ </td>
+<td>
+ 
+ The minimum number of digits allowable.
+ 
+ </td>
+<td>
+ 
+ 1
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">MaxDigits</code>
+ 
+ </td>
+<td>
+ 
+ The maximum number of digits allowable. If this is -1, then the
+ maximum limit becomes unbounded.
+ 
+ </td>
+<td>
+ 
+ -1
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.numeric.uint.model_of"></a><h6>
+<a name="id673835"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">NP</code></dt>
+<dd>
+ An instance of <code class="computeroutput">uint_parser</code>
+ (type).
+ </dd>
+<dt><code class="computeroutput">n</code></dt>
+<dd>
+ An object of <code class="computeroutput">T</code>, the
+ numeric base type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.numeric.uint.expression_semantics"></a><h6>
+<a name="id673926"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">NP()</code>
+ 
+ </td>
+<td>
+ 
+ Instantiate and (default) construct a <code class="computeroutput">uint_parser</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">bin</code>
+ 
+ </td>
+<td>
+ 
+ Create a <code class="computeroutput">uint_parser<unsigned, 2, 1, -1></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">oct</code>
+ 
+ </td>
+<td>
+ 
+ Create a <code class="computeroutput">uint_parser<unsigned, 8, 1, -1></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">hex</code>
+ 
+ </td>
+<td>
+ 
+ Create a <code class="computeroutput">uint_parser<unsigned, 16, 1, -1></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ushort_</code>
+ 
+ </td>
+<td>
+ 
+ Create a <code class="computeroutput">uint_parser<unsigned
+ short,
+ 10,
+ 1,
+ -1></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ulong_</code>
+ 
+ </td>
+<td>
+ 
+ Create a <code class="computeroutput">uint_parser<unsigned
+ long,
+ 10,
+ 1,
+ -1></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">uint_</code>
+ 
+ </td>
+<td>
+ 
+ Create a <code class="computeroutput">uint_parser<unsigned
+ int,
+ 10,
+ 1,
+ -1></code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ulong_long</code>
+ 
+ </td>
+<td>
+ 
+ Create a <code class="computeroutput">uint_parser<unsigned
+ long long, 10, 1, -1></code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.numeric.uint.attributes"></a><h6>
+<a name="id674542"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.attributes">Attributes</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <code class="computeroutput">T</code>, The numeric base
+ type of the numeric parser.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.numeric.uint.complexity"></a><h6>
+<a name="id674573"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N), where N is the number of digits being parsed.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.numeric.uint.minimum_expression_requirements_for__code__phrase_role__identifier__t__phrase___code_"></a><h6>
+<a name="id674597"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.minimum_expression_requirements_for__code__phrase_role__identifier__t__phrase___code_">Minimum
+ Expression Requirements for <code class="computeroutput">T</code></a>
+ </h6>
+
+ The numeric base type, <code class="computeroutput">T</code>,
+ the expression requirements below must be valid:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T()</code>
+ 
+ </td>
+<td>
+ 
+ Default construct.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T(0)</code>
+ 
+ </td>
+<td>
+ 
+ Construct from an <code class="computeroutput">int</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">n +
+ n</code>
+ 
+ </td>
+<td>
+ 
+ Addition.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">n *
+ n</code>
+ 
+ </td>
+<td>
+ 
+ Multiplication.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::is_bounded</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">true</code> or <code class="computeroutput">false</code> if <code class="computeroutput">T</code>
+ bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::digits</code>
+ 
+ </td>
+<td>
+ 
+ Maximum Digits for <code class="computeroutput">T</code>,
+ radix digits. Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::digits10</code>
+ 
+ </td>
+<td>
+ 
+ Maximum Digits for <code class="computeroutput">T</code>,
+ base 10. Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::max()</code>
+ 
+ </td>
+<td>
+ 
+ Maximum value for <code class="computeroutput">T</code>.
+ Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">std::numeric_limits<T>::min()</code>
+ 
+ </td>
+<td>
+ 
+ Minimum value for <code class="computeroutput">T</code>.
+ Required only if <code class="computeroutput">T</code>
+ is bounded.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.numeric.uint.example"></a><h6>
+<a name="id676221"></a>
+ <a class="link" href="uint.html#spirit.qi.reference.numeric.uint.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::uint_;
+using boost::spirit::qi::uint_parser;
+</pre>
+
+ 
+
+ 
+
+ Basic unsigned integers:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("12345", uint_);
+</pre>
+
+ 
+
+ 
+
+ 
+
+ Thousand separated number parser:
+ 
+
+ 
+
+
+
+<pre class="programlisting">uint_parser<unsigned, 10, 1, 3> uint3_p; // 1..3 digits
+uint_parser<unsigned, 10, 3, 3> uint3_3_p; // exactly 3 digits
+test_parser("12,345,678", uint3_p >> *(',' >> uint3_3_p));
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../numeric.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../numeric.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="int.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,105 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Operator</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="numeric/real.html" title="Real Numbers (float_, double_, etc.)">
+<link rel="next" href="operator/alternative.html" title="Alternative (a | b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="numeric/real.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="operator/alternative.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Operator">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.reference.operator"></a><a class="link" href="operator.html" title="Operator">Operator</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="operator/alternative.html"> Alternative
+ (<code class="computeroutput">a |
+ b</code>)</a></dt>
+<dt><a href="operator/and_predicate.html"> And
+ Predicate (<code class="computeroutput">&a</code>)</a></dt>
+<dt><a href="operator/difference.html"> Difference
+ (<code class="computeroutput">a -
+ b</code>)</a></dt>
+<dt><a href="operator/expect.html"> Expectation
+ (<code class="computeroutput">a >
+ b</code>)</a></dt>
+<dt> Kleene (*a)</dt>
+<dt> List (a % b)</dt>
+<dt><a href="operator/not_predicate.html"> Not
+ Predicate (<code class="computeroutput">!a</code>)</a></dt>
+<dt><a href="operator/optional.html"> Optional
+ (<code class="computeroutput">-a</code>)</a></dt>
+<dt><a href="operator/permutation.html"> Permutation
+ (<code class="computeroutput">a ^
+ b</code>)</a></dt>
+<dt> Plus (+a)</dt>
+<dt><a href="operator/sequence.html"> Sequence
+ (<code class="computeroutput">a >>
+ b</code>)</a></dt>
+<dt><a href="operator/sequential_or.html"> Sequential
+ Or (<code class="computeroutput">a ||
+ b</code>)</a></dt>
+</dl></div>
+
+ Operators are used as a means for object composition and embedding. Simple
+ parsers may be composed to form composites through operator overloading,
+ crafted to approximate the syntax of <a class="link" href="../../abstracts/parsing_expression_grammar.html" title="Parsing Expression Grammar">Parsing
+ Expression Grammar</a> (PEG). An expression such as:
+ 
+<pre class="programlisting">a | b
+</pre>
+
+ yields a new parser type which is a composite of its operands, <code class="computeroutput">a</code> and <code class="computeroutput">b</code>.
+ 
+
+ This module includes different parsers which get instantiated if one of
+ the overloaded operators is used with more primitive parser constructs.
+ It includes Alternative (<code class="computeroutput">|</code>),
+ And predicate (unary <code class="computeroutput">&</code>),
+ Difference (<code class="computeroutput">-</code>), Expect (<code class="computeroutput">></code>), Kleene star (unary <code class="computeroutput">*</code>), Lists (unary <code class="computeroutput">%</code>),
+ Not predicate (unary <code class="computeroutput">!</code>), Optional
+ (<code class="computeroutput">-</code>), Permutation (<code class="computeroutput">^</code>), Plus (unary <code class="computeroutput">+</code>),
+ Sequence (<code class="computeroutput">>></code>) and Sequential-Or
+ (<code class="computeroutput">||</code>).
+ 
+<a name="spirit.qi.reference.operator.module_header"></a><h6>
+<a name="id685603"></a>
+ <a class="link" href="operator.html#spirit.qi.reference.operator.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/karma/operator.hpp>
+#include <boost/spirit/include/karma_operator.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="numeric/real.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="operator/alternative.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/alternative.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/alternative.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,297 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Alternative (a | b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="../operator.html" title="Operator">
+<link rel="next" href="and_predicate.html" title="And Predicate (&a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../operator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="and_predicate.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Alternative (a | b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.alternative"></a><a class="link" href="alternative.html" title="Alternative (a | b)"> Alternative
+ (<code class="computeroutput">a |
+ b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.alternative.description"></a><h6>
+<a name="id685704"></a>
+ <a class="link" href="alternative.html#spirit.qi.reference.operator.alternative.description">Description</a>
+ </h6>
+
+ The alternative operator, <code class="computeroutput">a
+ | b</code>,
+ matches one of two or more operands (<code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code>, ... etc.):
+ 
+<pre class="programlisting">a | b | ...
+</pre>
+
+ Alternative operands are tried one by one on a first-match-wins basis
+ starting from the leftmost operand. After a successfully matched alternative
+ is found, the parser concludes its search, essentially short-circuiting
+ the search for other potentially viable candidates. This short-circuiting
+ implicitly gives the highest priority to the leftmost alternative.
+ 
+
+ Short-circuiting is done in the same manner as C or C++'s logical expressions;
+ e.g. <code class="computeroutput">if (x < 3 || y
+ < 2)</code> where, if <code class="computeroutput">x
+ < 3</code>,
+ the <code class="computeroutput">y <
+ 2</code> test is not done at all. In addition
+ to providing an implicit priority rule for alternatives which is necessary,
+ given its non-deterministic nature, short-circuiting improves the execution
+ time. If the order of your alternatives is logically irrelevant, strive
+ to put the (expected) most common choice first for maximum efficiency.
+ 
+<a name="spirit.qi.reference.operator.alternative.header"></a><h6>
+<a name="id685868"></a>
+ <a class="link" href="alternative.html#spirit.qi.reference.operator.alternative.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/alternative.hpp>
+#include <boost/spirit/include/qi_alternative.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.alternative.model_of"></a><h6>
+<a name="id685943"></a>
+ <a class="link" href="alternative.html#spirit.qi.reference.operator.alternative.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.alternative.expression_semantics"></a><h6>
+<a name="id686021"></a>
+ <a class="link" href="alternative.html#spirit.qi.reference.operator.alternative.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a |
+ b</code>
+ 
+ </td>
+<td>
+ 
+ Match <code class="computeroutput">a</code> or <code class="computeroutput">b</code>.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.alternative.attributes"></a><h6>
+<a name="id686131"></a>
+ <a class="link" href="alternative.html#spirit.qi.reference.operator.alternative.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a |
+ b</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a | b): variant<A, B>
+a: A, b: Unused --> (a | b): A
+a: Unused, b: B --> (a | b): B
+a: Unused, b: Unused --> (a | b): Unused
+a: A, b: A --> (a | b): A</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.alternative.complexity"></a><h6>
+<a name="id687103"></a>
+ <a class="link" href="alternative.html#spirit.qi.reference.operator.alternative.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the alternative parser is defined by the
+ sum of the complexities of its elements. The complexity of the alternative
+ parser itself is O(N), where N is the number of alternatives.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.alternative.example"></a><h6>
+<a name="id687127"></a>
+ <a class="link" href="alternative.html#spirit.qi.reference.operator.alternative.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::string;
+using boost::spirit::qi::int_;
+using boost::spirit::qi::_1;
+using boost::variant;
+</pre>
+
+ 
+
+ 
+
+ 
+
+ Simple usage:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("Hello", string("Hello") | int_);
+test_parser("123", string("Hello") | int_);</pre>
+
+ 
+
+ 
+
+ Extracting the attribute variant (using Boost.Variant):
+ 
+
+ 
+
+
+
+<pre class="programlisting">variant<std::string, int> attr;
+test_parser_attr("Hello", string("Hello") | int_, attr);</pre>
+
+ 
+
+ 
+
+ This should print <code class="computeroutput">"Hello"</code>.
+ Note: There are better ways to extract the value from the variant.
+ See Boost.Variant
+ visitation. This code is solely for demonstration.
+ 
+
+ 
+
+
+
+<pre class="programlisting">if (boost::get<int>(&attr))
+ std::cout << boost::get<int>(attr) << std::endl;
+else
+ std::cout << boost::get<std::string>(attr) << std::endl;</pre>
+
+ 
+
+ 
+
+ Extracting the attributes using Semantic Actions with Phoenix
+ (this should print <code class="computeroutput">123</code>):
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("123", (string("Hello") | int_)[std::cout << _1 << std::endl]);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../operator.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="and_predicate.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/and_predicate.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/and_predicate.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,216 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>And Predicate (&a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="alternative.html" title="Alternative (a | b)">
+<link rel="next" href="difference.html" title="Difference (a - b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="alternative.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="difference.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="And Predicate (&a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.and_predicate"></a><a class="link" href="and_predicate.html" title="And Predicate (&a)"> And
+ Predicate (<code class="computeroutput">&a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.and_predicate.description"></a><h6>
+<a name="id687828"></a>
+ <a class="link" href="and_predicate.html#spirit.qi.reference.operator.and_predicate.description">Description</a>
+ </h6>
+
+ Syntactic predicates assert a certain conditional syntax to be satisfied
+ before evaluating another production. Similar to semantic predicates,
+ <a class="link" href="../auxiliary/eps.html" title="Epsilon (eps)"><code class="computeroutput">eps</code></a>,
+ syntactic predicates do not consume any input. The and predicate,
+ <code class="computeroutput">&a</code>,
+ is a positive syntactic predicate that returns a zero length match only
+ if its predicate matches.
+ 
+<a name="spirit.qi.reference.operator.and_predicate.header"></a><h6>
+<a name="id687869"></a>
+ <a class="link" href="and_predicate.html#spirit.qi.reference.operator.and_predicate.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/and_predicate.hpp>
+#include <boost/spirit/include/qi_and_predicate.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.and_predicate.model_of"></a><h6>
+<a name="id687943"></a>
+ <a class="link" href="and_predicate.html#spirit.qi.reference.operator.and_predicate.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.and_predicate.expression_semantics"></a><h6>
+<a name="id688014"></a>
+ <a class="link" href="and_predicate.html#spirit.qi.reference.operator.and_predicate.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">&a</code>
+ 
+ </td>
+<td>
+ 
+ If the predicate <code class="computeroutput">a</code>
+ matches, return a zero length match. Otherwise, fail.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.and_predicate.attributes"></a><h6>
+<a name="id688111"></a>
+ <a class="link" href="and_predicate.html#spirit.qi.reference.operator.and_predicate.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">&a</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused_type</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.and_predicate.complexity"></a><h6>
+<a name="id688204"></a>
+ <a class="link" href="and_predicate.html#spirit.qi.reference.operator.and_predicate.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The complexity is defined by the complexity of the predicate, <code class="computeroutput">a</code>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.and_predicate.example"></a><h6>
+<a name="id688235"></a>
+ <a class="link" href="and_predicate.html#spirit.qi.reference.operator.and_predicate.example">Example</a>
+ </h6>
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::lit;</pre>
+
+ 
+
+ 
+
+ Basic look-ahead example: make sure that the last character is a semicolon,
+ but don't consume it, just peek at the next character:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_phrase_parser("Hello ;", lit("Hello") >> &lit(';'), false);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="alternative.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="difference.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/difference.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/difference.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,233 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Difference (a - b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="and_predicate.html" title="And Predicate (&a)">
+<link rel="next" href="expect.html" title="Expectation (a > b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="and_predicate.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="expect.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Difference (a - b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.difference"></a><a class="link" href="difference.html" title="Difference (a - b)"> Difference
+ (<code class="computeroutput">a -
+ b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.difference.description"></a><h6>
+<a name="id688391"></a>
+ <a class="link" href="difference.html#spirit.qi.reference.operator.difference.description">Description</a>
+ </h6>
+
+ The difference operator, <code class="computeroutput">a
+ - b</code>,
+ is a binary operator that matches the first (LHS) operand but not the
+ second (RHS).
+ [<a name="id688420" href="#ftn.id688420" class="footnote">7</a>]
+ 
+<a name="spirit.qi.reference.operator.difference.header"></a><h6>
+<a name="id688459"></a>
+ <a class="link" href="difference.html#spirit.qi.reference.operator.difference.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/difference.hpp>
+#include <boost/spirit/include/qi_difference.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.difference.model_of"></a><h6>
+<a name="id688534"></a>
+ <a class="link" href="difference.html#spirit.qi.reference.operator.difference.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/binaryparser.html" title="BinaryParser"><code class="computeroutput">BinaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.difference.expression_semantics"></a><h6>
+<a name="id688612"></a>
+ <a class="link" href="difference.html#spirit.qi.reference.operator.difference.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/binaryparser.html" title="BinaryParser"><code class="computeroutput">BinaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a -
+ b</code>
+ 
+ </td>
+<td>
+ 
+ Parse <code class="computeroutput">a</code> but not
+ <code class="computeroutput">b</code>.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.difference.attributes"></a><h6>
+<a name="id688722"></a>
+ <a class="link" href="difference.html#spirit.qi.reference.operator.difference.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a -
+ b</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a - b): A
+a: Unused, b: B --> (a - b): Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.difference.complexity"></a><h6>
+<a name="id688938"></a>
+ <a class="link" href="difference.html#spirit.qi.reference.operator.difference.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The complexity of the difference parser is defined by the sum of
+ the complexities of both operands.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.difference.example"></a><h6>
+<a name="id688962"></a>
+ <a class="link" href="difference.html#spirit.qi.reference.operator.difference.example">Example</a>
+ </h6>
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::char_;</pre>
+
+ 
+
+ 
+
+ Parse a C/C++ style comment:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("/*A Comment*/", "/*" >> *(char_ - "*/") >> "*/");
+</pre>
+
+ 
+
+ 
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a name="ftn.id688420" href="#id688420" class="para">7</a>] 
+ Unlike classic Spirit, with Spirit2, the expression will always fail
+ if the RHS is a successful match regardless if the RHS matches less
+ characters. For example, the rule <code class="computeroutput">lit("policeman") - "police"</code> will always fail
+ to match. Spirit2 does not count the matching chars while parsing
+ and there is no reliable and fast way to check if the LHS matches
+ more than the RHS.
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="and_predicate.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="expect.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/expect.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/expect.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,285 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Expectation (a > b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="difference.html" title="Difference (a - b)">
+<link rel="next" href="kleene.html" title="Kleene (*a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="difference.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="kleene.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Expectation (a > b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.expect"></a><a class="link" href="expect.html" title="Expectation (a > b)"> Expectation
+ (<code class="computeroutput">a >
+ b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.expect.description"></a><h6>
+<a name="id690220"></a>
+ <a class="link" href="expect.html#spirit.qi.reference.operator.expect.description">Description</a>
+ </h6>
+
+ Like the <a class="link" href="sequence.html" title="Sequence (a >> b)">Sequence</a>,
+ the expectation operator, <code class="computeroutput">a
+ > b</code>,
+ parses two or more operands (<code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code>, ... etc.), in sequence:
+ 
+<pre class="programlisting">a > b > ...
+</pre>
+
+ However, while the plain <a class="link" href="sequence.html" title="Sequence (a >> b)">Sequence</a>
+ simply returns a no-match (returns <code class="computeroutput">false</code>)
+ when one of the elements fail, the expectation: <code class="computeroutput">></code>
+ operator throws an <a class="link" href="expect.html#spirit.qi.reference.operator.expect.expectation_failure"><code class="computeroutput">expectation_failure</code></a><code class="computeroutput"><Iter></code> when the second or succeeding operands
+ (all operands except the first) fail to match.
+ 
+<a name="spirit.qi.reference.operator.expect.header"></a><h6>
+<a name="id690348"></a>
+ <a class="link" href="expect.html#spirit.qi.reference.operator.expect.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/expect.hpp>
+#include <boost/spirit/include/qi_expect.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.expect.model_of"></a><h6>
+<a name="id690422"></a>
+ <a class="link" href="expect.html#spirit.qi.reference.operator.expect.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+<dt><code class="computeroutput">Iter</code></dt>
+<dd>
+ a ForwardIterator type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.expect.expectation_failure"></a><h6>
+<a name="id690525"></a>
+ <a class="link" href="expect.html#spirit.qi.reference.operator.expect.expectation_failure">Expectation
+ Failure</a>
+ </h6>
+
+ When any operand, except the first, fail to match an <code class="computeroutput">expectation_failure<Iter></code> is thrown:
+ 
+<pre class="programlisting">template <typename Iter>
+struct expectation_failure
+{
+ Iter first; // [first, last) iterator pointing
+ Iter last; // to the error position in the input.
+ <code class="computeroutput">info</code> what; // Information about the nature of the error.
+};
+</pre>
+<a name="spirit.qi.reference.operator.expect.expression_semantics"></a><h6>
+<a name="id690662"></a>
+ <a class="link" href="expect.html#spirit.qi.reference.operator.expect.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a >
+ b</code>
+ 
+ </td>
+<td>
+ 
+ Match <code class="computeroutput">a</code> followed
+ by <code class="computeroutput">b</code>. If <code class="computeroutput">a</code> fails, no-match. If <code class="computeroutput">b</code> fails, throw an <code class="computeroutput">expectation_failure<Iter></code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.expect.attributes"></a><h6>
+<a name="id690805"></a>
+ <a class="link" href="expect.html#spirit.qi.reference.operator.expect.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a >
+ b</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a > b): tuple<A, B>
+a: A, b: Unused --> (a > b): A
+a: Unused, b: B --> (a > b): B
+a: Unused, b: Unused --> (a > b): Unused
+
+a: A, b: A --> (a > b): vector<A>
+a: vector<A>, b: A --> (a > b): vector<A>
+a: A, b: vector<A> --> (a > b): vector<A>
+a: vector<A>, b: vector<A> --> (a > b): vector<A></pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.expect.complexity"></a><h6>
+<a name="id691486"></a>
+ <a class="link" href="expect.html#spirit.qi.reference.operator.expect.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the expectation parser is defined by the
+ sum of the complexities of its elements. The complexity of the expectation
+ operator itself is O(N), where N is the number of elements in the
+ sequence.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.expect.example"></a><h6>
+<a name="id691510"></a>
+ <a class="link" href="expect.html#spirit.qi.reference.operator.expect.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::char_;
+using boost::spirit::qi::expectation_failure;
+</pre>
+
+ 
+
+ 
+
+ 
+
+ The code below uses an expectation operator to throw an <a class="link" href="expect.html#spirit.qi.reference.operator.expect.expectation_failure"><code class="computeroutput">expectation_failure</code></a> with a
+ deliberate parsing error when <code class="computeroutput">"o"</code>
+ is expected and <code class="computeroutput">"i"</code>
+ is what is found in the input. The <code class="computeroutput">catch</code>
+ block prints the information related to the error. Note: This is low
+ level code that demonstrates the bare-metal. Typically,
+ you use an Error Handler to deal with the error.
+ 
+
+ 
+
+
+
+<pre class="programlisting">try
+{
+ test_parser("xi", char_('x') > char_('o')); // should throw an exception
+}
+catch (expectation_failure<char const*> const& x)
+{
+ std::cout << "expected: "; print_info(x.what);
+ std::cout << "got: \"" << std::string(x.first, x.last) << '"' << std::endl;
+}</pre>
+
+ 
+
+ 
+
+ The code above will print:
+ 
+
+
+
+<pre class="programlisting">expected: tag: literal-char, value: o
+got: "i"
+</pre>
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="difference.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="kleene.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/kleene.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/kleene.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,221 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Kleene (*a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="expect.html" title="Expectation (a > b)">
+<link rel="next" href="list.html" title="List (a % b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="expect.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="list.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Kleene (*a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.kleene"></a><a class="link" href="kleene.html" title="Kleene (*a)"> Kleene (<code class="computeroutput">*a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.kleene.description"></a><h6>
+<a name="id691960"></a>
+ <a class="link" href="kleene.html#spirit.qi.reference.operator.kleene.description">Description</a>
+ </h6>
+
+ The kleene operator, <code class="computeroutput">*a</code>,
+ is a unary operator that matches its operand zero or more times.
+ 
+<a name="spirit.qi.reference.operator.kleene.header"></a><h6>
+<a name="id691988"></a>
+ <a class="link" href="kleene.html#spirit.qi.reference.operator.kleene.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/kleene.hpp>
+#include <boost/spirit/include/qi_kleene.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.kleene.model_of"></a><h6>
+<a name="id692062"></a>
+ <a class="link" href="kleene.html#spirit.qi.reference.operator.kleene.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.kleene.expression_semantics"></a><h6>
+<a name="id692133"></a>
+ <a class="link" href="kleene.html#spirit.qi.reference.operator.kleene.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">*a</code>
+ 
+ </td>
+<td>
+ 
+ Match <code class="computeroutput">a</code> zero
+ or more times.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.kleene.attributes"></a><h6>
+<a name="id692232"></a>
+ <a class="link" href="kleene.html#spirit.qi.reference.operator.kleene.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">*a</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> *a: vector<A>
+a: Unused --> *a: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.kleene.complexity"></a><h6>
+<a name="id692537"></a>
+ <a class="link" href="kleene.html#spirit.qi.reference.operator.kleene.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the Kleene star is defined by the complexity
+ of its subject, <code class="computeroutput">a</code>,
+ multiplied by the number of repetitions. The complexity of the Kleene
+ star itself is O(N), where N is the number successful repetitions.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.kleene.example"></a><h6>
+<a name="id692568"></a>
+ <a class="link" href="kleene.html#spirit.qi.reference.operator.kleene.example">Example</a>
+ </h6>
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::int_;</pre>
+
+ 
+
+ 
+
+ Parse a comma separated list of numbers and put them in a vector:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<int> attr;
+test_phrase_parser_attr(
+ "111, 222, 333, 444, 555", int_ >> *(',' >> int_), attr);
+std::cout
+ << attr[0] << ',' << attr[1] << ',' << attr[2] << ','
+ << attr[3] << ',' << attr[4]
+ << std::endl;
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="expect.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="list.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/list.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/list.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,232 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>List (a % b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="kleene.html" title="Kleene (*a)">
+<link rel="next" href="not_predicate.html" title="Not Predicate (!a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="kleene.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="not_predicate.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="List (a % b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.list"></a><a class="link" href="list.html" title="List (a % b)"> List (<code class="computeroutput">a % b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.list.description"></a><h6>
+<a name="id692928"></a>
+ <a class="link" href="list.html#spirit.qi.reference.operator.list.description">Description</a>
+ </h6>
+
+ The list operator, <code class="computeroutput">a % b</code>,
+ is a binary operator that matches a list of one or more repetitions of
+ <code class="computeroutput">a</code> separated by occurrences
+ of <code class="computeroutput">b</code>. This is equivalent
+ to <code class="computeroutput">a >>
+ *(b
+ >> a)</code>.
+ 
+<a name="spirit.qi.reference.operator.list.header"></a><h6>
+<a name="id693010"></a>
+ <a class="link" href="list.html#spirit.qi.reference.operator.list.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/list.hpp>
+#include <boost/spirit/include/qi_list.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.list.model_of"></a><h6>
+<a name="id693084"></a>
+ <a class="link" href="list.html#spirit.qi.reference.operator.list.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/binaryparser.html" title="BinaryParser"><code class="computeroutput">BinaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.list.expression_semantics"></a><h6>
+<a name="id693160"></a>
+ <a class="link" href="list.html#spirit.qi.reference.operator.list.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/binaryparser.html" title="BinaryParser"><code class="computeroutput">BinaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a %
+ b</code>
+ 
+ </td>
+<td>
+ 
+ Match a list of one or more repetitions of <code class="computeroutput">a</code>
+ separated by occurrences of <code class="computeroutput">b</code>.
+ This is equivalent to <code class="computeroutput">a
+ >> *(b >>
+ a)</code>.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.list.attributes"></a><h6>
+<a name="id693301"></a>
+ <a class="link" href="list.html#spirit.qi.reference.operator.list.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a -
+ b</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a % b): vector<A>
+a: Unused, b: B --> (a % b): Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.list.complexity"></a><h6>
+<a name="id693528"></a>
+ <a class="link" href="list.html#spirit.qi.reference.operator.list.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the List is defined by the complexity of
+ its subject, <code class="computeroutput">a</code>, multiplied
+ by the number of repetitions. The complexity of the List itself is
+ O(N), where N is the number successful repetitions.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.list.example"></a><h6>
+<a name="id693559"></a>
+ <a class="link" href="list.html#spirit.qi.reference.operator.list.example">Example</a>
+ </h6>
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::int_;</pre>
+
+ 
+
+ 
+
+ Parse a comma separated list of numbers and put them in a vector:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<int> attr;
+test_phrase_parser_attr(
+ "111, 222, 333, 444, 555", int_ % ',', attr);
+std::cout
+ << attr[0] << ',' << attr[1] << ',' << attr[2] << ','
+ << attr[3] << ',' << attr[4]
+ << std::endl;
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="kleene.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="not_predicate.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/not_predicate.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/not_predicate.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,245 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Not Predicate (!a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="list.html" title="List (a % b)">
+<link rel="next" href="optional.html" title="Optional (-a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="list.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="optional.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Not Predicate (!a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.not_predicate"></a><a class="link" href="not_predicate.html" title="Not Predicate (!a)"> Not
+ Predicate (<code class="computeroutput">!a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.not_predicate.description"></a><h6>
+<a name="id693900"></a>
+ <a class="link" href="not_predicate.html#spirit.qi.reference.operator.not_predicate.description">Description</a>
+ </h6>
+
+ Syntactic predicates assert a certain conditional syntax to be satisfied
+ before evaluating another production. Similar to semantic predicates,
+ <a class="link" href="../auxiliary/eps.html" title="Epsilon (eps)"><code class="computeroutput">eps</code></a>,
+ syntactic predicates do not consume any input. The not predicate,
+ <code class="computeroutput">!a</code>,
+ is a negative syntactic predicate that returns a zero length match only
+ if its predicate fails to match.
+ 
+<a name="spirit.qi.reference.operator.not_predicate.header"></a><h6>
+<a name="id693941"></a>
+ <a class="link" href="not_predicate.html#spirit.qi.reference.operator.not_predicate.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/not_predicate.hpp>
+#include <boost/spirit/include/qi_not_predicate.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.not_predicate.model_of"></a><h6>
+<a name="id694015"></a>
+ <a class="link" href="not_predicate.html#spirit.qi.reference.operator.not_predicate.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.not_predicate.expression_semantics"></a><h6>
+<a name="id694086"></a>
+ <a class="link" href="not_predicate.html#spirit.qi.reference.operator.not_predicate.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">!a</code>
+ 
+ </td>
+<td>
+ 
+ If the predicate <code class="computeroutput">a</code>
+ matches, fail. Otherwise, return a zero length match.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.not_predicate.attributes"></a><h6>
+<a name="id694183"></a>
+ <a class="link" href="not_predicate.html#spirit.qi.reference.operator.not_predicate.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">!a</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused_type</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.not_predicate.complexity"></a><h6>
+<a name="id694276"></a>
+ <a class="link" href="not_predicate.html#spirit.qi.reference.operator.not_predicate.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The complexity is defined by the complexity of the predicate, <code class="computeroutput">a</code>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.not_predicate.example"></a><h6>
+<a name="id694307"></a>
+ <a class="link" href="not_predicate.html#spirit.qi.reference.operator.not_predicate.example">Example</a>
+ </h6>
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::char_;
+using boost::spirit::ascii::alpha;
+using boost::spirit::qi::lit;
+using boost::spirit::qi::symbols;</pre>
+
+ 
+
+ 
+
+ Here's an alternative to the <code class="computeroutput">*(r - x) >> x</code>
+ idiom using the not-predicate instead. This parses a list of characters
+ terminated by a ';':
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("abcdef;", *(!lit(';') >> char_) >> ';');</pre>
+
+ 
+
+ 
+
+ The following parser ensures that we match distinct keywords (stored
+ in a symbol table). To do this, we make sure that the keyword does
+ not follow an alpha or an underscore:
+ 
+
+ 
+
+
+
+<pre class="programlisting">symbols<char, int> keywords;
+keywords = "begin", "end", "for";
+
+// This should fail:
+test_parser("beginner", keywords >> !(alpha | '_'));
+
+// This is ok:
+test_parser("end ", keywords >> !(alpha | '_'), false);
+
+// This is ok:
+test_parser("for()", keywords >> !(alpha | '_'), false);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="list.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="optional.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/optional.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/optional.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,242 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Optional (-a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="not_predicate.html" title="Not Predicate (!a)">
+<link rel="next" href="permutation.html" title="Permutation (a ^ b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="not_predicate.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="permutation.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Optional (-a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.optional"></a><a class="link" href="optional.html" title="Optional (-a)"> Optional
+ (<code class="computeroutput">-a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.optional.description"></a><h6>
+<a name="id694848"></a>
+ <a class="link" href="optional.html#spirit.qi.reference.operator.optional.description">Description</a>
+ </h6>
+
+ The optional operator, <code class="computeroutput">-a</code>, is a unary operator that matches
+ its operand zero or one time.
+ 
+<a name="spirit.qi.reference.operator.optional.header"></a><h6>
+<a name="id694876"></a>
+ <a class="link" href="optional.html#spirit.qi.reference.operator.optional.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/optional.hpp>
+#include <boost/spirit/include/qi_optional.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.optional.model_of"></a><h6>
+<a name="id694950"></a>
+ <a class="link" href="optional.html#spirit.qi.reference.operator.optional.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.optional.expression_semantics"></a><h6>
+<a name="id695021"></a>
+ <a class="link" href="optional.html#spirit.qi.reference.operator.optional.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">-a</code>
+ 
+ </td>
+<td>
+ 
+ Match <code class="computeroutput">a</code> zero
+ or one time.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.optional.attributes"></a><h6>
+<a name="id695119"></a>
+ <a class="link" href="optional.html#spirit.qi.reference.operator.optional.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">-a</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> -a: optional<A>
+a: Unused --> -a: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.optional.complexity"></a><h6>
+<a name="id695287"></a>
+ <a class="link" href="optional.html#spirit.qi.reference.operator.optional.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The complexity is defined by the complexity of the operand, <code class="computeroutput">a</code>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.optional.example"></a><h6>
+<a name="id695319"></a>
+ <a class="link" href="optional.html#spirit.qi.reference.operator.optional.example">Example</a>
+ </h6>
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::char_;
+using boost::spirit::qi::lexeme;
+using boost::spirit::qi::int_;
+using boost::fusion::vector;
+using boost::fusion::at_c;
+using boost::optional;</pre>
+
+ 
+
+ 
+
+ Parse a person info with name (in quotes) optional age
+ [<a name="id695523" href="#ftn.id695523" class="footnote">8</a>]
+ and optional sex, all separated by comma.
+ 
+
+ 
+
+
+
+<pre class="programlisting">vector<std::string, optional<int>, optional<char> > attr;
+
+test_phrase_parser_attr(
+ "\"James Bond\", M"
+ , lexeme['"' >> +(char_ - '"') >> '"'] // name
+ >> -(',' >> int_) // optional age
+ >> -(',' >> char_) // optional sex
+ , attr);
+
+// Should print: James Bond,M
+std::cout << at_c<0>(attr); // print name
+if (at_c<1>(attr)) // print optional age
+ std::cout << ',' << *at_c<1>(attr);
+if (at_c<2>(attr)) // print optional sex
+ std::cout << ',' << *at_c<2>(attr);
+std::cout << std::endl;
+</pre>
+
+ 
+
+ 
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a name="ftn.id695523" href="#id695523" class="para">8</a>] 
+ James Bond is shy about his age :-)
+ </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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="not_predicate.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="permutation.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/permutation.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/permutation.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,240 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Permutation (a ^ b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="optional.html" title="Optional (-a)">
+<link rel="next" href="plus.html" title="Plus (+a)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="optional.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="plus.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Permutation (a ^ b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.permutation"></a><a class="link" href="permutation.html" title="Permutation (a ^ b)"> Permutation
+ (<code class="computeroutput">a ^
+ b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.permutation.description"></a><h6>
+<a name="id696045"></a>
+ <a class="link" href="permutation.html#spirit.qi.reference.operator.permutation.description">Description</a>
+ </h6>
+
+ The permutation operator, <code class="computeroutput">a
+ ^ b</code>,
+ matches one or more operands (<code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code>, ... etc.) in any order:
+ 
+<pre class="programlisting">a ^ b ^ ...
+</pre>
+
+ The operands are the elements in the permutation set. Each element in
+ the permutation set may occur at most once, but not all elements of the
+ given set need to be present. For example:
+ 
+<pre class="programlisting">char_('a') ^ 'b' ^ 'c'
+</pre>
+
+ matches:
+ 
+<pre class="programlisting">"a", "ab", "abc", "cba", "bca" ... etc.
+</pre>
+<a name="spirit.qi.reference.operator.permutation.header"></a><h6>
+<a name="id696221"></a>
+ <a class="link" href="permutation.html#spirit.qi.reference.operator.permutation.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/permutation.hpp>
+#include <boost/spirit/include/qi_permutation.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.permutation.model_of"></a><h6>
+<a name="id696295"></a>
+ <a class="link" href="permutation.html#spirit.qi.reference.operator.permutation.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.permutation.expression_semantics"></a><h6>
+<a name="id696373"></a>
+ <a class="link" href="permutation.html#spirit.qi.reference.operator.permutation.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a ^
+ b</code>
+ 
+ </td>
+<td>
+ 
+ Match <code class="computeroutput">a</code> or <code class="computeroutput">b</code> in any order. Each operand
+ may match zero or one time.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.permutation.attributes"></a><h6>
+<a name="id696484"></a>
+ <a class="link" href="permutation.html#spirit.qi.reference.operator.permutation.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a ^
+ b</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a ^ b): tuple<optional<A>, optional<B> >
+a: A, b: Unused --> (a ^ b): optional<A>
+a: Unused, b: B --> (a ^ b): optional<B>
+a: Unused, b: Unused --> (a ^ b): Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.permutation.complexity"></a><h6>
+<a name="id699613"></a>
+ <a class="link" href="permutation.html#spirit.qi.reference.operator.permutation.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the permutation parser is defined by the
+ sum of the complexities of its elements, s, multiplied by log s.
+ The complexity of the permutation parser itself is O(N log N), where
+ N is the number of elements.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.permutation.example"></a><h6>
+<a name="id699637"></a>
+ <a class="link" href="permutation.html#spirit.qi.reference.operator.permutation.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::char_;
+</pre>
+
+ 
+
+ 
+
+ 
+
+ Parse a string containing DNA codes (ACTG)
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("ACTGGCTAGACT", *(char_('A') ^ 'C' ^ 'T' ^ 'G'));
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="optional.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="plus.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/plus.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/plus.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,219 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Plus (+a)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="permutation.html" title="Permutation (a ^ b)">
+<link rel="next" href="sequence.html" title="Sequence (a >> b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="permutation.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="sequence.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Plus (+a)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.plus"></a><a class="link" href="plus.html" title="Plus (+a)"> Plus (<code class="computeroutput">+a</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.plus.description"></a><h6>
+<a name="id699803"></a>
+ <a class="link" href="plus.html#spirit.qi.reference.operator.plus.description">Description</a>
+ </h6>
+
+ The plus operator, <code class="computeroutput">+a</code>,
+ is a unary operator that matches its operand one or more times.
+ 
+<a name="spirit.qi.reference.operator.plus.header"></a><h6>
+<a name="id699831"></a>
+ <a class="link" href="plus.html#spirit.qi.reference.operator.plus.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/plus.hpp>
+#include <boost/spirit/include/qi_plus.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.plus.model_of"></a><h6>
+<a name="id699905"></a>
+ <a class="link" href="plus.html#spirit.qi.reference.operator.plus.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.plus.expression_semantics"></a><h6>
+<a name="id699973"></a>
+ <a class="link" href="plus.html#spirit.qi.reference.operator.plus.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/unaryparser.html" title="UnaryParser"><code class="computeroutput">UnaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">+a</code>
+ 
+ </td>
+<td>
+ 
+ Match <code class="computeroutput">a</code> one or
+ more times.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.plus.attributes"></a><h6>
+<a name="id700069"></a>
+ <a class="link" href="plus.html#spirit.qi.reference.operator.plus.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">+a</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A --> +a: vector<A>
+a: Unused --> +a: Unused</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.plus.complexity"></a><h6>
+<a name="id700237"></a>
+ <a class="link" href="plus.html#spirit.qi.reference.operator.plus.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the Plus is defined by the complexity of
+ its subject, <code class="computeroutput">a</code>, multiplied
+ by the number of repetitions. The complexity of the Plus itself is
+ O(N), where N is the number successful repetitions.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.plus.example"></a><h6>
+<a name="id700269"></a>
+ <a class="link" href="plus.html#spirit.qi.reference.operator.plus.example">Example</a>
+ </h6>
+
+ 
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::alpha;
+using boost::spirit::qi::lexeme;</pre>
+
+ 
+
+ 
+
+ Parse one or more strings containing one or more alphabetic characters
+ and put them in a vector:
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<std::string> attr;
+test_phrase_parser_attr("yaba daba doo", +lexeme[+alpha], attr);
+std::cout << attr[0] << ',' << attr[1] << ',' << attr[2] << std::endl;
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="permutation.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="sequence.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/sequence.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/sequence.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,277 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Sequence (a >> b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="plus.html" title="Plus (+a)">
+<link rel="next" href="sequential_or.html" title="Sequential Or (a || b)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="plus.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="sequential_or.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Sequence (a >> b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.sequence"></a><a class="link" href="sequence.html" title="Sequence (a >> b)"> Sequence
+ (<code class="computeroutput">a >>
+ b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.sequence.description"></a><h6>
+<a name="id700597"></a>
+ <a class="link" href="sequence.html#spirit.qi.reference.operator.sequence.description">Description</a>
+ </h6>
+
+ The sequence operator, <code class="computeroutput">a >> b</code>,
+ which parses two or more operands (<code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code>, ... etc.), in sequence:
+ 
+<pre class="programlisting">a >> b >> ...
+</pre>
+<a name="spirit.qi.reference.operator.sequence.header"></a><h6>
+<a name="id700673"></a>
+ <a class="link" href="sequence.html#spirit.qi.reference.operator.sequence.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/sequence.hpp>
+#include <boost/spirit/include/qi_sequence.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.sequence.model_of"></a><h6>
+<a name="id700747"></a>
+ <a class="link" href="sequence.html#spirit.qi.reference.operator.sequence.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.sequence.expression_semantics"></a><h6>
+<a name="id700825"></a>
+ <a class="link" href="sequence.html#spirit.qi.reference.operator.sequence.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a >>
+ b</code>
+ 
+ </td>
+<td>
+ 
+ Match <code class="computeroutput">a</code> followed
+ by <code class="computeroutput">b</code>.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.sequence.attributes"></a><h6>
+<a name="id700936"></a>
+ <a class="link" href="sequence.html#spirit.qi.reference.operator.sequence.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a >>
+ b</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a >> b): tuple<A, B>
+a: A, b: Unused --> (a >> b): A
+a: Unused, b: B --> (a >> b): B
+a: Unused, b: Unused --> (a >> b): Unused
+
+a: A, b: A --> (a >> b): vector<A>
+a: vector<A>, b: A --> (a >> b): vector<A>
+a: A, b: vector<A> --> (a >> b): vector<A>
+a: vector<A>, b: vector<A> --> (a >> b): vector<A></pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.sequence.complexity"></a><h6>
+<a name="id701617"></a>
+ <a class="link" href="sequence.html#spirit.qi.reference.operator.sequence.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the sequence parser is defined by the sum
+ of the complexities of its elements. The complexity of the sequence
+ itself is O(N), where N is the number of elements in the sequence.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.sequence.example"></a><h6>
+<a name="id701641"></a>
+ <a class="link" href="sequence.html#spirit.qi.reference.operator.sequence.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::ascii::char_;
+using boost::spirit::qi::_1;
+using boost::spirit::qi::_2;
+namespace bf = boost::fusion;
+</pre>
+
+ 
+
+ 
+
+ 
+
+ Simple usage:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("xy", char_ >> char_);</pre>
+
+ 
+
+ 
+
+ Extracting the attribute tuple (using Boost.Fusion):
+ 
+
+ 
+
+
+
+<pre class="programlisting">bf::vector<char, char> attr;
+test_parser_attr("xy", char_ >> char_, attr);
+std::cout << bf::at_c<0>(attr) << ',' << bf::at_c<1>(attr) << std::endl;</pre>
+
+ 
+
+ 
+
+ Extracting the attribute vector (using STL):
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::vector<char> vec;
+test_parser_attr("xy", char_ >> char_, vec);
+std::cout << vec[0] << ',' << vec[1] << std::endl;</pre>
+
+ 
+
+ 
+
+ Extracting the attributes using Semantic Actions (using Phoenix):
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("xy", (char_ >> char_)[std::cout << _1 << ',' << _2 << std::endl]);
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="plus.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="sequential_or.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/sequential_or.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/operator/sequential_or.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,254 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Sequential Or (a || b)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../operator.html" title="Operator">
+<link rel="prev" href="sequence.html" title="Sequence (a >> b)">
+<link rel="next" href="../string.html" title="String">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="sequence.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../string.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Sequential Or (a || b)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.operator.sequential_or"></a><a class="link" href="sequential_or.html" title="Sequential Or (a || b)"> Sequential
+ Or (<code class="computeroutput">a ||
+ b</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.operator.sequential_or.description"></a><h6>
+<a name="id702379"></a>
+ <a class="link" href="sequential_or.html#spirit.qi.reference.operator.sequential_or.description">Description</a>
+ </h6>
+
+ The sequential-or operator, <code class="computeroutput">a
+ || b</code>,
+ where the expression <code class="computeroutput">a || b</code>
+ reads as match <code class="computeroutput">a</code> or
+ <code class="computeroutput">b</code> and in sequence. That
+ is, if both <code class="computeroutput">a</code> and <code class="computeroutput">b</code> match, it must be in sequence; this
+ is equivalent to <code class="computeroutput">a >>
+ -b
+ | b</code>:
+ 
+<pre class="programlisting">a || b || ...
+</pre>
+<a name="spirit.qi.reference.operator.sequential_or.header"></a><h6>
+<a name="id702516"></a>
+ <a class="link" href="sequential_or.html#spirit.qi.reference.operator.sequential_or.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/operator/sequential_or.hpp>
+#include <boost/spirit/include/qi_sequential_or.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.operator.sequential_or.model_of"></a><h6>
+<a name="id702590"></a>
+ <a class="link" href="sequential_or.html#spirit.qi.reference.operator.sequential_or.model_of">Model
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">a</code>,
+ <code class="computeroutput">b</code></dt>
+<dd>
+ A <a class="link" href="../parser_concepts/parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.operator.sequential_or.expression_semantics"></a><h6>
+<a name="id702668"></a>
+ <a class="link" href="sequential_or.html#spirit.qi.reference.operator.sequential_or.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/naryparser.html" title="NaryParser"><code class="computeroutput">NaryParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a ||
+ b</code>
+ 
+ </td>
+<td>
+ 
+ Match <code class="computeroutput">a</code> or <code class="computeroutput">b</code> in sequence. equivalent to
+ <code class="computeroutput">a >>
+ -b
+ | b</code>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.sequential_or.attributes"></a><h6>
+<a name="id702809"></a>
+ <a class="link" href="sequential_or.html#spirit.qi.reference.operator.sequential_or.attributes">Attributes</a>
+ </h6>
+
+ See <a class="link" href="../../quick_reference/compound_attribute_rules.html#spirit.qi.quick_reference.compound_attribute_rules.notation">Compound
+ Attribute Notation</a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">a ||
+ b</code>
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">a: A, b: B --> (a || b): tuple<A, B>
+a: A, b: Unused --> (a || b): A
+a: Unused, b: B --> (a || b): B
+a: Unused, b: Unused --> (a || b): Unused
+
+a: A, b: A --> (a || b): vector<A>
+a: vector<A>, b: A --> (a || b): vector<A>
+a: A, b: vector<A> --> (a || b): vector<A>
+a: vector<A>, b: vector<A> --> (a || b): vector<A></pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.operator.sequential_or.complexity"></a><h6>
+<a name="id703490"></a>
+ <a class="link" href="sequential_or.html#spirit.qi.reference.operator.sequential_or.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ The overall complexity of the sequential-or parser is defined by
+ the sum of the complexities of its elements. The complexity of the
+ sequential-or itself is O(N), where N is the number of elements in
+ the sequence.
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.operator.sequential_or.example"></a><h6>
+<a name="id703514"></a>
+ <a class="link" href="sequential_or.html#spirit.qi.reference.operator.sequential_or.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::int_;
+</pre>
+
+ 
+
+ 
+
+ 
+
+ Correctly parsing a number with optional fractional digits:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("123.456", int_ || ('.' >> int_)); // full
+test_parser("123", int_ || ('.' >> int_)); // just the whole number
+test_parser(".456", int_ || ('.' >> int_)); // just the fraction</pre>
+
+ 
+
+ 
+
+ A naive but incorrect solution would try to do this using optionals
+ (e.g.):
+ 
+
+
+
+<pre class="programlisting">int_ >> -('.' >> int_) // will not match ".456"
+-int_ >> ('.' >> int_) // will not match "123"
+-int_ >> -('.' >> int_) // will match empty strings! Ooops.
+</pre>
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="sequence.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../operator.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../string.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,62 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Parser Concepts</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="../reference.html" title="Reference">
+<link rel="next" href="parser_concepts/parser.html" title="Parser">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="parser_concepts/parser.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Parser Concepts">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.reference.parser_concepts"></a><a class="link" href="parser_concepts.html" title="Parser Concepts">Parser Concepts</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt>Parser</dt>
+<dt>PrimitiveParser</dt>
+<dt>UnaryParser</dt>
+<dt>BinaryParser</dt>
+<dt>NaryParser</dt>
+</dl></div>
+
+ Spirit.Qi parsers fall into a couple of generalized concepts.
+ The Parser is the most fundamental concept. All Spirit.Qi
+ parsers are models of the Parser concept. PrimitiveParser,
+ UnaryParser, BinaryParser and
+ NaryParser are all refinements of the Parser
+ concept.
+ 
+
+ The following sections provide details on these concepts.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../reference.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="parser_concepts/parser.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/binaryparser.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/binaryparser.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,239 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>BinaryParser</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../parser_concepts.html" title="Parser Concepts">
+<link rel="prev" href="unaryparser.html" title="UnaryParser">
+<link rel="next" href="naryparser.html" title="NaryParser">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unaryparser.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="naryparser.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="BinaryParser">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.parser_concepts.binaryparser"></a><a class="link" href="binaryparser.html" title="BinaryParser">BinaryParser</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.parser_concepts.binaryparser.description"></a><h6>
+<a name="id636004"></a>
+ <a class="link" href="binaryparser.html#spirit.qi.reference.parser_concepts.binaryparser.description">Description</a>
+ </h6>
+
+ BinaryParser is a composite parser that has a two
+ subjects, <code class="computeroutput">left</code> and <code class="computeroutput">right</code>. The BinaryParser allows its
+ subjects to be treated in the same way as a single instance of a <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ following the Composite Design Pattern.
+ 
+<a name="spirit.qi.reference.parser_concepts.binaryparser.refinement_of"></a><h6>
+<a name="id636056"></a>
+ <a class="link" href="binaryparser.html#spirit.qi.reference.parser_concepts.binaryparser.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">p</code></dt>
+<dd>
+ A BinaryParser.
+ </dd>
+<dt><code class="computeroutput">P</code></dt>
+<dd>
+ A BinaryParser type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.parser_concepts.binaryparser.valid_expressions"></a><h6>
+<a name="id636135"></a>
+ <a class="link" href="binaryparser.html#spirit.qi.reference.parser_concepts.binaryparser.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In addition to the requirements defined in <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>, for any BinaryParser
+ the following must be met:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">p.left</code>
+ 
+ </td>
+<td>
+ 
+ Left parser.
+ 
+ </td>
+<td>
+ 
+ <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">p.right</code>
+ 
+ </td>
+<td>
+ 
+ Right parser.
+ 
+ </td>
+<td>
+ 
+ <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.parser_concepts.binaryparser.type_expressions"></a><h6>
+<a name="id636296"></a>
+ <a class="link" href="binaryparser.html#spirit.qi.reference.parser_concepts.binaryparser.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">P::left_type</code>
+ 
+ </td>
+<td>
+ 
+ The left parser type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">P::right_type</code>
+ 
+ </td>
+<td>
+ 
+ The right parser type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_binary_parser<P>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">P</code>
+ is a BinaryParser, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.parser_concepts.binaryparser.invariants"></a><h6>
+<a name="id636497"></a>
+ <a class="link" href="binaryparser.html#spirit.qi.reference.parser_concepts.binaryparser.invariants">Invariants</a>
+ </h6>
+
+ For any BinaryParser, <code class="computeroutput">P</code>,
+ the following invariants always hold:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+<code class="computeroutput">traits::is_parser<P::left_type>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li>
+<li class="listitem">
+<code class="computeroutput">traits::is_parser<P::right_type>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li>
+</ul></div>
+<a name="spirit.qi.reference.parser_concepts.binaryparser.models"></a><h6>
+<a name="id636636"></a>
+ <a class="link" href="binaryparser.html#spirit.qi.reference.parser_concepts.binaryparser.models">Models</a>
+ </h6>
+
+ FIXME Add links to models of BinaryParser
+ concept
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="unaryparser.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="naryparser.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/naryparser.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/naryparser.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,205 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>NaryParser</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../parser_concepts.html" title="Parser Concepts">
+<link rel="prev" href="binaryparser.html" title="BinaryParser">
+<link rel="next" href="../basics.html" title="Basics">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binaryparser.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../basics.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="NaryParser">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.parser_concepts.naryparser"></a><a class="link" href="naryparser.html" title="NaryParser">NaryParser</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.parser_concepts.naryparser.description"></a><h6>
+<a name="id636671"></a>
+ <a class="link" href="naryparser.html#spirit.qi.reference.parser_concepts.naryparser.description">Description</a>
+ </h6>
+
+ NaryParser is a composite parser that has one or
+ more subjects. The NaryParser allows its subjects to be treated in the
+ same way as a single instance of a <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a> following the Composite
+ Design Pattern.
+ 
+<a name="spirit.qi.reference.parser_concepts.naryparser.refinement_of"></a><h6>
+<a name="id636707"></a>
+ <a class="link" href="naryparser.html#spirit.qi.reference.parser_concepts.naryparser.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">p</code></dt>
+<dd>
+ A NaryParser.
+ </dd>
+<dt><code class="computeroutput">P</code></dt>
+<dd>
+ A NaryParser type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.parser_concepts.naryparser.valid_expressions"></a><h6>
+<a name="id636786"></a>
+ <a class="link" href="naryparser.html#spirit.qi.reference.parser_concepts.naryparser.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In addition to the requirements defined in <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>, for any NaryParser the
+ following must be met:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">p.elements</code>
+ 
+ </td>
+<td>
+ 
+ The tuple of elements.
+ 
+ </td>
+<td>
+ 
+ A Boost.Fusion
+ Sequence of <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a> types.
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.parser_concepts.naryparser.type_expressions"></a><h6>
+<a name="id636909"></a>
+ <a class="link" href="naryparser.html#spirit.qi.reference.parser_concepts.naryparser.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">p.elements_type</code>
+ 
+ </td>
+<td>
+ 
+ Elements tuple type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_nary_parser<P>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">P</code>
+ is a NaryParser, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.parser_concepts.naryparser.invariants"></a><h6>
+<a name="id638856"></a>
+ <a class="link" href="naryparser.html#spirit.qi.reference.parser_concepts.naryparser.invariants">Invariants</a>
+ </h6>
+
+ For each element, <code class="computeroutput">E</code>,
+ in any NaryParser, <code class="computeroutput">P</code>,
+ the following invariant always holds:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+<code class="computeroutput">traits::is_parser<E>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li></ul></div>
+<a name="spirit.qi.reference.parser_concepts.naryparser.models"></a><h6>
+<a name="id638941"></a>
+ <a class="link" href="naryparser.html#spirit.qi.reference.parser_concepts.naryparser.models">Models</a>
+ </h6>
+
+ FIXME Add links to models of NaryParser
+ concept
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="binaryparser.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../basics.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/parser.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/parser.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,273 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Parser</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../parser_concepts.html" title="Parser Concepts">
+<link rel="prev" href="../parser_concepts.html" title="Parser Concepts">
+<link rel="next" href="primitiveparser.html" title="PrimitiveParser">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitiveparser.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Parser">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.parser_concepts.parser"></a><a class="link" href="parser.html" title="Parser">Parser</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.parser_concepts.parser.description"></a><h6>
+<a name="id633653"></a>
+ <a class="link" href="parser.html#spirit.qi.reference.parser_concepts.parser.description">Description</a>
+ </h6>
+
+ The Parser is the most fundamental concept. A Parser
+ has a member function, <code class="computeroutput">parse</code>,
+ that accepts a first-last ForwardIterator pair and returns
+ bool as its result. The iterators delimit the data being parsed. The
+ Parser's <code class="computeroutput">parse</code> member
+ function returns <code class="computeroutput">true</code> if
+ the parse succeeds, in which case the first iterator is advanced accordingly.
+ Each Parser can represent a specific pattern or algorithm, or it can
+ be a more complex parser formed as a composition of other Parsers.
+ 
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">p</code></dt>
+<dd>
+ A <code class="computeroutput">Parser</code>.
+ </dd>
+<dt><code class="computeroutput">P</code></dt>
+<dd>
+ A <code class="computeroutput">Parser</code> type.
+ </dd>
+<dt><code class="computeroutput">Iter</code></dt>
+<dd>
+ a ForwardIterator type.
+ </dd>
+<dt><code class="computeroutput">f</code>,
+ <code class="computeroutput">l</code></dt>
+<dd>
+ ForwardIterator. first/last
+ iterator pair.
+ </dd>
+<dt><code class="computeroutput">Context</code></dt>
+<dd>
+ The parser's Context type.
+ </dd>
+<dt><code class="computeroutput">context</code></dt>
+<dd>
+ The parser's Context, or <code class="computeroutput">unused</code>.
+ </dd>
+<dt><code class="computeroutput">skip</code></dt>
+<dd>
+ A skip Parser, or <code class="computeroutput">unused</code>.
+ </dd>
+<dt><code class="computeroutput">attrib</code></dt>
+<dd>
+ A Compatible Attribute, or <code class="computeroutput">unused</code>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.parser_concepts.parser.valid_expressions"></a><h6>
+<a name="id633923"></a>
+ <a class="link" href="parser.html#spirit.qi.reference.parser_concepts.parser.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In the expressions below, the behavior of the parser, <code class="computeroutput">p</code>,
+ how <code class="computeroutput">skip</code> and <code class="computeroutput">attrib</code> are handled by <code class="computeroutput">p</code>, are left unspecified in the base
+ <code class="computeroutput">Parser</code> concept. These
+ are specified in subsequent, more refined concepts and by the actual
+ models therof.
+ 
+
+ For any Parser the following expressions must be valid:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">p.parse(f, l, context, skip, attr)</pre>
+
+ 
+ </td>
+<td>
+ 
+ Match the input sequence starting from <code class="computeroutput">f</code>.
+ Return <code class="computeroutput">true</code> if successful,
+ otherwise return <code class="computeroutput">false</code>.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">bool</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">p.what(context)</code>
+ 
+ </td>
+<td>
+ 
+ Get information about a Parser.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">info</code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.parser_concepts.parser.type_expressions"></a><h6>
+<a name="id634810"></a>
+ <a class="link" href="parser.html#spirit.qi.reference.parser_concepts.parser.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">P::template attribute<Context, Iter>::type</code>
+ 
+ </td>
+<td>
+ 
+ The Parser's expected attribute.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_parser<P>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">P</code>
+ is a Parser, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.parser_concepts.parser.postcondition"></a><h6>
+<a name="id635008"></a>
+ <a class="link" href="parser.html#spirit.qi.reference.parser_concepts.parser.postcondition">Postcondition</a>
+ </h6>
+
+ Upon return from <code class="computeroutput">p.parse</code> the following post conditions
+ should hold:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ On a successful match, <code class="computeroutput">f</code>
+ is positioned one past the first non-matching character/token.
+ </li>
+<li class="listitem">
+ On a failed match, if a <code class="computeroutput">skip</code>
+ parser is <code class="computeroutput">unused</code>,
+ <code class="computeroutput">f</code> is restored to its
+ original position prior to entry.
+ </li>
+<li class="listitem">
+ On a failed match, if a <code class="computeroutput">skip</code>
+ parser is not <code class="computeroutput">unused</code>,
+ <code class="computeroutput">f</code> is positioned one
+ past the first character/token not matching <code class="computeroutput">skip</code>.
+ </li>
+<li class="listitem">
+ On a failed match, <code class="computeroutput">attrib</code>
+ is left untouched.
+ </li>
+<li class="listitem">
+ No post-skips: trailing <code class="computeroutput">skip</code>
+ characters/tokens will not be skipped.
+ </li>
+</ul></div>
+<a name="spirit.qi.reference.parser_concepts.parser.models"></a><h6>
+<a name="id635135"></a>
+ <a class="link" href="parser.html#spirit.qi.reference.parser_concepts.parser.models">Models</a>
+ </h6>
+
+ All parsers in Spirit.Qi are models of the Parser
+ concept.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="primitiveparser.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/primitiveparser.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/primitiveparser.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,127 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>PrimitiveParser</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../parser_concepts.html" title="Parser Concepts">
+<link rel="prev" href="parser.html" title="Parser">
+<link rel="next" href="unaryparser.html" title="UnaryParser">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="parser.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="unaryparser.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="PrimitiveParser">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.parser_concepts.primitiveparser"></a><a class="link" href="primitiveparser.html" title="PrimitiveParser">PrimitiveParser</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.parser_concepts.primitiveparser.description"></a><h6>
+<a name="id635170"></a>
+ <a class="link" href="primitiveparser.html#spirit.qi.reference.parser_concepts.primitiveparser.description">Description</a>
+ </h6>
+
+ PrimitiveParser is the most basic building block
+ that the client uses to build more complex parsers.
+ 
+<a name="spirit.qi.reference.parser_concepts.primitiveparser.refinement_of"></a><h6>
+<a name="id635193"></a>
+ <a class="link" href="primitiveparser.html#spirit.qi.reference.parser_concepts.primitiveparser.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ 
+
+ 
+</blockquote></div>
+<a name="spirit.qi.reference.parser_concepts.primitiveparser.pre_skip"></a><h6>
+<a name="id635229"></a>
+ <a class="link" href="primitiveparser.html#spirit.qi.reference.parser_concepts.primitiveparser.pre_skip">Pre-skip</a>
+ </h6>
+
+ Upon entry to the <code class="computeroutput">parse</code>
+ member function, a PrimitiveParser is required to do a pre-skip. Leading
+ <code class="computeroutput">skip</code> characters/tokens
+ will be skipped prior to parsing. Only PrimitiveParsers are required
+ to perform this pre-skip. This is typically carried out through a call
+ to <code class="computeroutput">qi::skip_over</code>:
+ 
+<pre class="programlisting">qi::skip_over(f, l, skip);
+</pre>
+<a name="spirit.qi.reference.parser_concepts.primitiveparser.type_expressions"></a><h6>
+<a name="id635320"></a>
+ <a class="link" href="primitiveparser.html#spirit.qi.reference.parser_concepts.primitiveparser.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_primitive_parser<P>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">P</code>,
+ is a PrimitiveParser, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.parser_concepts.primitiveparser.models"></a><h6>
+<a name="id635457"></a>
+ <a class="link" href="primitiveparser.html#spirit.qi.reference.parser_concepts.primitiveparser.models">Models</a>
+ </h6>
+
+ FIXME Add links to PrimitiveParser
+ models here.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="parser.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="unaryparser.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/unaryparser.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/parser_concepts/unaryparser.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,202 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>UnaryParser</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../parser_concepts.html" title="Parser Concepts">
+<link rel="prev" href="primitiveparser.html" title="PrimitiveParser">
+<link rel="next" href="binaryparser.html" title="BinaryParser">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitiveparser.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binaryparser.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="UnaryParser">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.parser_concepts.unaryparser"></a><a class="link" href="unaryparser.html" title="UnaryParser">UnaryParser</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.parser_concepts.unaryparser.description"></a><h6>
+<a name="id635498"></a>
+ <a class="link" href="unaryparser.html#spirit.qi.reference.parser_concepts.unaryparser.description">Description</a>
+ </h6>
+
+ UnaryParser is a composite parser that has a single
+ subject. The UnaryParser may change the behavior of its subject following
+ the Delegate Design Pattern.
+ 
+<a name="spirit.qi.reference.parser_concepts.unaryparser.refinement_of"></a><h6>
+<a name="id635523"></a>
+ <a class="link" href="unaryparser.html#spirit.qi.reference.parser_concepts.unaryparser.refinement_of">Refinement
+ of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">p</code></dt>
+<dd>
+ A UnaryParser.
+ </dd>
+<dt><code class="computeroutput">P</code></dt>
+<dd>
+ A UnaryParser type.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.parser_concepts.unaryparser.valid_expressions"></a><h6>
+<a name="id635602"></a>
+ <a class="link" href="unaryparser.html#spirit.qi.reference.parser_concepts.unaryparser.valid_expressions">Valid
+ Expressions</a>
+ </h6>
+
+ In addition to the requirements defined in <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>, for any UnaryParser
+ the following must be met:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+<th>
+ 
+ Return type
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+ <code class="computeroutput">p.subject</code>
+ 
+ </td>
+<td>
+ 
+ Subject parser.
+ 
+ </td>
+<td>
+ 
+ <a class="link" href="parser.html" title="Parser"><code class="computeroutput">Parser</code></a>
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<a name="spirit.qi.reference.parser_concepts.unaryparser.type_expressions"></a><h6>
+<a name="id635716"></a>
+ <a class="link" href="unaryparser.html#spirit.qi.reference.parser_concepts.unaryparser.type_expressions">Type
+ Expressions</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">P::subject_type</code>
+ 
+ </td>
+<td>
+ 
+ The subject parser type.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">traits::is_unary_parser<P>::type</code>
+ 
+ </td>
+<td>
+ 
+ Metafunction that evaluates to <code class="computeroutput">mpl::true_</code>
+ if a certain type, <code class="computeroutput">P</code>
+ is a UnaryParser, <code class="computeroutput">mpl::false_</code>
+ otherwise (See <a href="../../../../../../../../libs/mpl/doc/refmanual/integral-constant.html" target="_top">MPL
+ Boolean Constant</a>).
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.parser_concepts.unaryparser.invariants"></a><h6>
+<a name="id635884"></a>
+ <a class="link" href="unaryparser.html#spirit.qi.reference.parser_concepts.unaryparser.invariants">Invariants</a>
+ </h6>
+
+ For any UnaryParser, <code class="computeroutput">P</code>,
+ the following invariant always holds:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+<code class="computeroutput">traits::is_parser<P::subject_type>::type</code> evaluates to <code class="computeroutput">mpl::true_</code>
+</li></ul></div>
+<a name="spirit.qi.reference.parser_concepts.unaryparser.models"></a><h6>
+<a name="id635969"></a>
+ <a class="link" href="unaryparser.html#spirit.qi.reference.parser_concepts.unaryparser.models">Models</a>
+ </h6>
+
+ FIXME Add links to models of UnaryParser
+ concept
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="primitiveparser.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../parser_concepts.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="binaryparser.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/string.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/string.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,62 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>String</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="operator/sequential_or.html" title="Sequential Or (a || b)">
+<link rel="next" href="string/string.html" title="String (string, lit)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="operator/sequential_or.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string/string.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="String">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.reference.string"></a><a class="link" href="string.html" title="String">String</a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt> String (string, lit)</dt>
+<dt> Symbols (symbols)</dt>
+</dl></div>
+
+ This module includes parsers for strings. Currently, this module includes
+ the literal and string parsers and the symbol table.
+ 
+<a name="spirit.qi.reference.string.module_header"></a><h6>
+<a name="id703877"></a>
+ <a class="link" href="string.html#spirit.qi.reference.string.module_header">Module Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/string.hpp>
+#include <boost/spirit/include/qi_string.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../structure/include.html" title="Include">Include Structure</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="operator/sequential_or.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="string/string.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/string/string.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/string/string.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,351 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>String (string, lit)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../string.html" title="String">
+<link rel="prev" href="../string.html" title="String">
+<link rel="next" href="symbols.html" title="Symbols (symbols)">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="symbols.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="String (string, lit)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.string.string"></a><a class="link" href="string.html" title="String (string, lit)"> String (<code class="computeroutput">string</code>, <code class="computeroutput">lit</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.string.string.description"></a><h6>
+<a name="id703975"></a>
+ <a class="link" href="string.html#spirit.qi.reference.string.string.description">Description</a>
+ </h6>
+
+ The <code class="computeroutput">string</code> parser matches
+ a string of characters. The <code class="computeroutput">string</code>
+ parser is an implicit lexeme: the <code class="computeroutput">skip</code>
+ parser is not applied in between characters of the string. The <code class="computeroutput">string</code> parser has an assocaiated <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>. This is needed when doing basic operations
+ such as inhibiting case sensitivity. Examples:
+ 
+<pre class="programlisting">string("Hello")
+string(L"Hello")
+string(s) // s is a std::string
+</pre>
+
+ <code class="computeroutput">lit</code>, like <code class="computeroutput">string</code>, also matches a string of characters.
+ The main difference is that <code class="computeroutput">lit</code>
+ does not synthesize an attribute. A plain string like <code class="computeroutput">"hello"</code>
+ or a <code class="computeroutput">std::basic_string</code> is equivalent to a <code class="computeroutput">lit</code>. Examples:
+ 
+<pre class="programlisting">"Hello"
+lit("Hello")
+lit(L"Hello")
+lit(s) // s is a std::string
+</pre>
+<a name="spirit.qi.reference.string.string.header"></a><h6>
+<a name="id705981"></a>
+ <a class="link" href="string.html#spirit.qi.reference.string.string.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/string/lit.hpp>
+#include <boost/spirit/include/qi_lit.hpp>
+</pre>
+<a name="spirit.qi.reference.string.string.namespace"></a><h6>
+<a name="id706047"></a>
+ <a class="link" href="string.html#spirit.qi.reference.string.string.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::lit // alias:
+ boost::spirit::qi::lit</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">ns::string</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+
+ In the table above, <code class="computeroutput">ns</code>
+ is a <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ 
+<a name="spirit.qi.reference.string.string.model_of"></a><h6>
+<a name="id706166"></a>
+ <a class="link" href="string.html#spirit.qi.reference.string.string.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">s</code></dt>
+<dd>
+ A <a class="link" href="../basics.html#spirit.qi.reference.basics.string">String</a>
+ or a __lazyargument_ that evaluates
+ to a <a class="link" href="../basics.html#spirit.qi.reference.basics.string">String</a>.
+ </dd>
+<dt><code class="computeroutput">ns</code></dt>
+<dd>
+ A <a class="link" href="../basics.html#spirit.qi.reference.basics.character_encoding_namespace">Character
+ Encoding Namespace</a>.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.string.string.expression_semantics"></a><h6>
+<a name="id706262"></a>
+ <a class="link" href="string.html#spirit.qi.reference.string.string.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">s</code>
+ 
+ </td>
+<td>
+ 
+ Create string parser from a string, <code class="computeroutput">s</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(s)</code>
+ 
+ </td>
+<td>
+ 
+ Create a string parser from a string, <code class="computeroutput">s</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::string(s)</code>
+ 
+ </td>
+<td>
+ 
+ Create a string parser with <code class="computeroutput">ns</code>
+ encoding from a string, <code class="computeroutput">s</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.string.string.attributes"></a><h6>
+<a name="id706454"></a>
+ <a class="link" href="string.html#spirit.qi.reference.string.string.attributes">Attributes</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Attribute
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">s</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lit(s)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ns::string(s)</code>
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">std::basic_string<T></code>
+ where <code class="computeroutput">T</code> is the
+ underlying character type of <code class="computeroutput">s</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.string.string.complexity"></a><h6>
+<a name="id706657"></a>
+ <a class="link" href="string.html#spirit.qi.reference.string.string.complexity">Complexity</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(N)
+ 
+
+ 
+</blockquote></div>
+
+ where <code class="computeroutput">N</code> is the number
+ of characters in the string to be parsed.
+ 
+<a name="spirit.qi.reference.string.string.example"></a><h6>
+<a name="id706692"></a>
+ <a class="link" href="string.html#spirit.qi.reference.string.string.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::lit;
+using boost::spirit::ascii::string;
+</pre>
+
+ 
+
+ 
+
+ Basic literals:
+ 
+
+ 
+
+
+
+<pre class="programlisting">test_parser("boost", "boost"); // plain literal
+test_parser("boost", lit("boost")); // explicit literal
+test_parser("boost", string("boost")); // ascii::string
+</pre>
+
+ 
+
+ 
+
+ From a <code class="computeroutput">std::string</code>
+ 
+
+ 
+
+
+
+<pre class="programlisting">std::string s("boost");
+test_parser("boost", s); // direct
+test_parser("boost", lit(s)); // explicit
+test_parser("boost", string(s)); // ascii::string
+</pre>
+
+ 
+
+ 
+
+ Lazy strings using Phoenix
+ 
+
+ 
+
+
+
+<pre class="programlisting">namespace phx = boost::phoenix;
+test_parser("boost", phx::val("boost")); // direct
+test_parser("boost", lit(phx::val("boost"))); // explicit
+test_parser("boost", string(phx::val("boost"))); // ascii::string
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="symbols.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/reference/string/symbols.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/reference/string/symbols.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,624 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Symbols (symbols)</title>
+<link rel="stylesheet" href="../../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../string.html" title="String">
+<link rel="prev" href="string.html" title="String (string, lit)">
+<link rel="next" href="../../../karma.html" title="Karma - Writing Generators">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../karma.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Symbols (symbols)">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="spirit.qi.reference.string.symbols"></a><a class="link" href="symbols.html" title="Symbols (symbols)"> Symbols (<code class="computeroutput">symbols</code>)</a>
+</h5></div></div></div>
+<a name="spirit.qi.reference.string.symbols.description"></a><h6>
+<a name="id707262"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.description">Description</a>
+ </h6>
+
+ This class <code class="computeroutput">symbols</code> implements
+ a symbol table: an associative container (or map) of key-value pairs
+ where the keys are strings. The <code class="computeroutput">symbols</code>
+ class can work efficiently with 8, 16, 32 and even 64 bit characters.
+ 
+
+ Traditionally, symbol table management is maintained seperately outside
+ the grammar through semantic actions. Contrary to standard practice,
+ the Spirit symbol table class symbols is-a parser. An instance of which
+ may be used anywhere in the grammar specification. It is an example of
+ a dynamic parser. A dynamic parser is characterized by its ability to
+ modify its behavior at run time. Initially, an empty symbols object matches
+ nothing. At any time, symbols may be added, thus, dynamically altering
+ its behavior.
+ 
+<a name="spirit.qi.reference.string.symbols.header"></a><h6>
+<a name="id707296"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.header">Header</a>
+ </h6>
+<pre class="programlisting">// forwards to <boost/spirit/home/qi/string/symbols.hpp>
+#include <boost/spirit/include/qi_symbols.hpp>
+</pre>
+
+ Also, see <a class="link" href="../../../structure/include.html" title="Include">Include Structure</a>.
+ 
+<a name="spirit.qi.reference.string.symbols.namespace"></a><h6>
+<a name="id707371"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.namespace">Namespace</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<thead><tr><th>
+ 
+ Name
+ 
+ </th></tr></thead>
+<tbody>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::qi::symbols</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::qi::tst</code>
+ 
+ </td></tr>
+<tr><td>
+ 
+ <code class="computeroutput">boost::spirit::qi::tst_map</code>
+ 
+ </td></tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.string.symbols.synopsis"></a><h6>
+<a name="id707530"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.synopsis">Synopsis</a>
+ </h6>
+<pre class="programlisting">template <typename Char, typename T, typename Lookup>
+struct symbols;
+</pre>
+<a name="spirit.qi.reference.string.symbols.template_parameters"></a><h6>
+<a name="id707608"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.template_parameters">Template
+ parameters</a>
+ </h6>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Parameter
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+<th>
+ 
+ Default
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Char</code>
+ 
+ </td>
+<td>
+ 
+ The character type of the symbol strings.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">char</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">T</code>
+ 
+ </td>
+<td>
+ 
+ The data type associated with each symbol.
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">unused_type</code>
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Lookup</code>
+ 
+ </td>
+<td>
+ 
+ The symbol search implementation
+ 
+ </td>
+<td>
+ 
+ <code class="computeroutput">tst<Char,
+ T></code>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.string.symbols.model_of"></a><h6>
+<a name="id707792"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.model_of">Model of</a>
+ </h6>
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>
+ 
+
+ 
+</blockquote></div>
+<div class="variablelist" title="Notation">
+Notation
+<dl>
+<dt><code class="computeroutput">Sym</code></dt>
+<dd>
+ A <code class="computeroutput">symbols</code> type.
+ </dd>
+<dt><code class="computeroutput">Char</code></dt>
+<dd>
+ A character type.
+ </dd>
+<dt><code class="computeroutput">T</code></dt>
+<dd>
+ A data type.
+ </dd>
+<dt><code class="computeroutput">sym</code>,
+ <code class="computeroutput">sym2</code></dt>
+<dd>
+ <code class="computeroutput">symbols</code> objects.
+ </dd>
+<dt><code class="computeroutput">sseq</code></dt>
+<dd>
+ An STL container
+ of strings.
+ </dd>
+<dt><code class="computeroutput">dseq</code></dt>
+<dd>
+ An STL container
+ of data with <code class="computeroutput">value_type</code>
+ <code class="computeroutput">T</code>.
+ </dd>
+<dt><code class="computeroutput">s1</code>...<code class="computeroutput">sN</code></dt>
+<dd>
+ A <a class="link" href="../basics.html#spirit.qi.reference.basics.string">String</a>.
+ </dd>
+<dt><code class="computeroutput">d1</code>...<code class="computeroutput">dN</code></dt>
+<dd>
+ Objects of type <code class="computeroutput">T</code>.
+ </dd>
+<dt><code class="computeroutput">f</code></dt>
+<dd>
+ A callable function or function object.
+ </dd>
+</dl>
+</div>
+<a name="spirit.qi.reference.string.symbols.expression_semantics"></a><h6>
+<a name="id708067"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.expression_semantics">Expression
+ Semantics</a>
+ </h6>
+
+ Semantics of an expression is defined only where it differs from, or
+ is not defined in <a class="link" href="../parser_concepts/primitiveparser.html" title="PrimitiveParser"><code class="computeroutput">PrimitiveParser</code></a>.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Expression
+ 
+ </th>
+<th>
+ 
+ Semantics
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Sym()</code>
+ 
+ </td>
+<td>
+ 
+ Construct an empty symbols.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Sym(sym)</code>
+ 
+ </td>
+<td>
+ 
+ Copy construct a symbols from <code class="computeroutput">sym2</code>
+ (Another <code class="computeroutput">symbols</code>
+ object).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Sym(sseq)</code>
+ 
+ </td>
+<td>
+ 
+ Construct symbols from <code class="computeroutput">sseq</code>
+ (An STL container
+ of strings).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">Sym(sseq,
+ dseq)</code>
+ 
+ </td>
+<td>
+ 
+ Construct symbols from <code class="computeroutput">sseq</code>
+ and <code class="computeroutput">dseq</code> (An
+ STL container
+ of strings and an STL
+ container of data with <code class="computeroutput">value_type</code>
+ <code class="computeroutput">T</code>).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym =
+ sym</code>
+ 
+ </td>
+<td>
+ 
+ Assign <code class="computeroutput">sym2</code> to
+ <code class="computeroutput">sym</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym =
+ s1,
+ s2,...
+ sN</code>
+ 
+ </td>
+<td>
+ 
+ Assigns one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) to <code class="computeroutput">sym</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym +=
+ s1,
+ s2,...
+ sN</code>
+ 
+ </td>
+<td>
+ 
+ Adds one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) to <code class="computeroutput">sym</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym.add(s1)(s2)...(sN)</code>
+ 
+ </td>
+<td>
+ 
+ Adds one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) to <code class="computeroutput">sym</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym.add(s1,
+ d1)(s2,
+ d2)...(sN,
+ dN)</code>
+ 
+ </td>
+<td>
+ 
+ Adds one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) with associated data (<code class="computeroutput">d1</code>...<code class="computeroutput">dN</code>)
+ to <code class="computeroutput">sym</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym -=
+ s1,
+ s2,...
+ sN</code>
+ 
+ </td>
+<td>
+ 
+ Remove one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) from <code class="computeroutput">sym</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym.remove(s1)(s2)...(sN)</code>
+ 
+ </td>
+<td>
+ 
+ Remove one or more symbols (<code class="computeroutput">s1</code>...<code class="computeroutput">sN</code>) from <code class="computeroutput">sym</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym.clear()</code>
+ 
+ </td>
+<td>
+ 
+ Erase all of the symbols in <code class="computeroutput">sym</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym.at(s)</code>
+ 
+ </td>
+<td>
+ 
+ Returns a reference to the object associated with symbol, <code class="computeroutput">s</code>. If <code class="computeroutput">sym</code>
+ does not already contain such an object, <code class="computeroutput">at</code>
+ inserts the default object <code class="computeroutput">T()</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym.find(s)</code>
+ 
+ </td>
+<td>
+ 
+ Returns a pointer to the object associated with symbol, <code class="computeroutput">s</code>. If <code class="computeroutput">sym</code>
+ does not already contain such an object, <code class="computeroutput">find</code>
+ returns a null pointer.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">sym.for_each(f)</code>
+ 
+ </td>
+<td>
+ 
+ For each symbol in <code class="computeroutput">sym</code>,
+ <code class="computeroutput">s</code>, a <code class="computeroutput">std::basic_string<Char></code>
+ with associated data, <code class="computeroutput">d</code>,
+ an object of type <code class="computeroutput">T</code>,
+ invoke <code class="computeroutput">f(s,
+ d)</code>.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.reference.string.symbols.attributes"></a><h6>
+<a name="id709177"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.attributes">Attributes</a>
+ </h6>
+
+ The attribute of <code class="computeroutput">symbol<Char, T></code> is <code class="computeroutput">T</code>.
+ 
+<a name="spirit.qi.reference.string.symbols.complexity"></a><h6>
+<a name="id709228"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.complexity">Complexity</a>
+ </h6>
+
+ The default implementation uses a Ternary Search Tree (TST) with complexity:
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(log n+k)
+ 
+
+ 
+</blockquote></div>
+
+ Where k is the length of the string to be searched and in a TST with
+ n strings.
+ 
+
+ TSTs are faster than hashing for many typical search problems especially
+ when the search interface is iterator based. TSTs are many times faster
+ than hash tables for unsuccessful searches since mismatches are discovered
+ earlier after examining only a few characters. Hash tables always examine
+ an entire key when searching.
+ 
+
+ An alternative implementation uses a hybrid hash-map front end (for the
+ first character) plus a TST: <code class="computeroutput">tst_map</code>.
+ This gives us a complexity of
+ 
+<div class="blockquote"><blockquote class="blockquote">
+
+ 
+
+ O(1 + log n+k-1)
+ 
+
+ 
+</blockquote></div>
+
+ This is found to be significantly faster than plain TST, albeit with
+ a bit more memory usage requirements (each slot in the hash-map is a
+ TST node). If you require a lot of symbols to be searched, use the <code class="computeroutput">tst_map</code> implementation. This can be
+ done by using <code class="computeroutput">tst_map</code>
+ as the third template parameter to the symbols class:
+ 
+<pre class="programlisting">symbols<Char, T, tst_map<Char, T> > sym;
+</pre>
+<a name="spirit.qi.reference.string.symbols.example"></a><h6>
+<a name="id709367"></a>
+ <a class="link" href="symbols.html#spirit.qi.reference.string.symbols.example">Example</a>
+ </h6>
+
+ Some using declarations:
+ 
+
+ 
+
+
+
+<pre class="programlisting">using boost::spirit::qi::symbols;
+</pre>
+
+ 
+
+ 
+
+ Symbols with data:
+ 
+
+ 
+
+
+
+<pre class="programlisting">symbols<char, int> sym;
+
+sym.add
+ ("Apple", 1)
+ ("Banana", 2)
+ ("Orange", 3)
+;
+
+int i;
+test_parser_attr("Banana", sym, i);
+std::cout << i << std::endl;
+</pre>
+
+ 
+
+ 
+
+ When <code class="computeroutput">symbols</code> is used
+ for case-insensitive parsing (in a <a class="link" href="../directive/no_case.html" title="Inhibiting Case Sensitivity (no_case[])"><code class="computeroutput">no_case</code></a> directive), added symbol
+ strings should be in lowercase. Symbol strings containing one or more
+ uppercase characters will not match any input when symbols is used in
+ a <code class="computeroutput">no_case</code> directive.
+ 
+
+ 
+
+
+
+<pre class="programlisting">symbols<char, int> sym;
+
+sym.add
+ ("apple", 1) // symbol strings are added in lowercase...
+ ("banana", 2)
+ ("orange", 3)
+;
+
+int i;
+// ...because sym is used for case-insensitive parsing
+test_parser_attr("Apple", no_case[ sym ], i);
+std::cout << i << std::endl;
+test_parser_attr("ORANGE", no_case[ sym ], i);
+std::cout << i << std::endl;
+</pre>
+
+ 
+
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="string.html"><img src="../../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../string.html"><img src="../../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../../../karma.html"><img src="../../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,65 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Tutorials</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../qi.html" title="Qi - Writing Parsers">
+<link rel="prev" href="../qi.html" title="Qi - Writing Parsers">
+<link rel="next" href="tutorials/quick_start.html" title="Quick Start">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../qi.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/quick_start.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Tutorials">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.qi.tutorials"></a><a class="link" href="tutorials.html" title="Tutorials">Tutorials</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt>Quick Start</dt>
+<dt>Warming up</dt>
+<dt>Semantic Actions</dt>
+<dt><a href="tutorials/complex___our_first_complex_parser.html">Complex
+ - Our first complex parser</a></dt>
+<dt><a href="tutorials/sum___adding_numbers.html">Sum - adding
+ numbers</a></dt>
+<dt><a href="tutorials/number_list___stuffing_numbers_into_a_std__vector.html">Number
+ List - stuffing numbers into a std::vector</a></dt>
+<dt><a href="tutorials/number_list_redux___list_syntax.html">Number
+ List Redux - list syntax</a></dt>
+<dt><a href="tutorials/number_list_attribute___one_more__with_style.html">Number
+ List Attribute - one more, with style</a></dt>
+<dt>Roman Numerals</dt>
+<dt><a href="tutorials/employee___parsing_into_structs.html">Employee
+ - Parsing into structs</a></dt>
+<dt>Mini XML - ASTs!</dt>
+<dt><a href="tutorials/mini_xml___error_handling.html">Mini
+ XML - Error Handling</a></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../qi.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../qi.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tutorials/quick_start.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/complex___our_first_complex_parser.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/complex___our_first_complex_parser.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,147 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Complex - Our first complex parser</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="semantic_actions.html" title="Semantic Actions">
+<link rel="next" href="sum___adding_numbers.html" title="Sum - adding numbers">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="sum___adding_numbers.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Complex - Our first complex parser">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.complex___our_first_complex_parser"></a><a class="link" href="complex___our_first_complex_parser.html" title="Complex - Our first complex parser">Complex
+ - Our first complex parser</a>
+</h4></div></div></div>
+
+ Well, not really a complex parser, but a parser that parses complex numbers.
+ This time, we're using Phoenix
+ to do the semantic actions.
+ 
+
+ Here's a simple parser expression for complex numbers:
+ 
+<pre class="programlisting"> '(' >> double_ >> -(',' >> double_) >> ')'
+| double_
+</pre>
+
+ What's new? Well, we have:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Alternates: e.g. <code class="computeroutput">a |
+ b</code>. Try <code class="computeroutput">a</code>
+ first. If it succeeds, good. If not, try the next alternative, <code class="computeroutput">b</code>.
+ </li>
+<li class="listitem">
+ Optionals: e.g. -p. Match the parser p zero or one time.
+ </li>
+</ol></div>
+
+ The complex parser presented above reads as:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ One or two real number in parantheses, separated by comma (the second
+ number is optional)
+ </li>
+<li class="listitem">
+OR a single real number.
+ </li>
+</ul></div>
+
+ This parser can parse complex numbers of the form:
+ 
+<pre class="programlisting">(123.45, 987.65)
+(123.45)
+123.45
+</pre>
+
+ Here goes, this time with actions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">namespace client
+{
+ template <typename Iterator>
+ bool parse_complex(Iterator first, Iterator last, std::complex<double>& c)
+ {
+ using boost::spirit::qi::double_;
+ using boost::spirit::qi::_1;
+ using boost::spirit::qi::phrase_parse;
+ using boost::spirit::ascii::space;
+ using boost::phoenix::ref;
+
+ double rN = 0.0;
+ double iN = 0.0;
+ bool r = phrase_parse(first, last,
+
+ // Begin grammar
+ (
+ '(' >> double_[ref(rN) = _1]
+ >> -(',' >> double_[ref(iN) = _1]) >> ')'
+ | double_[ref(rN) = _1]
+ ),
+ // End grammar
+
+ space);
+
+ if (!r || first != last) // fail if we did not get a full match
+ return false;
+ c = std::complex<double>(rN, iN);
+ return r;
+ }
+}
+</pre>
+
+ 
+
+ 
+
+ The full cpp file for this example can be found here: ../../example/qi/complex_number.cpp
+ 
+
+ The <code class="computeroutput">double_</code> parser attaches
+ this action:
+ 
+<pre class="programlisting">ref(n) = _1
+</pre>
+
+ This assigns the parsed result (actually, the attribute of <code class="computeroutput">double_</code>) to n. <code class="computeroutput">ref(n)</code>
+ tells Phoenix that <code class="computeroutput">n</code> is
+ a mutable reference. <code class="computeroutput">_1</code>
+ is a Phoenix placeholder for the parsed result attribute.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="sum___adding_numbers.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/employee___parsing_into_structs.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/employee___parsing_into_structs.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,435 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Employee - Parsing into structs</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="roman_numerals.html" title="Roman Numerals">
+<link rel="next" href="mini_xml___asts_.html" title="Mini XML - ASTs!">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="roman_numerals.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="mini_xml___asts_.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Employee - Parsing into structs">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.employee___parsing_into_structs"></a><a class="link" href="employee___parsing_into_structs.html" title="Employee - Parsing into structs">Employee
+ - Parsing into structs</a>
+</h4></div></div></div>
+
+ It's a common question in the <a href="http://www.nabble.com/The-Spirit-Parser-Library-f3430.html" target="_top">Spirit
+ General List</a>: how do I parse and place the results into a C++ struct?
+ Of course, at this point, you already know various ways to do it, using
+ semantic actions. There are many ways to skin a cat. Spirit2, being fully
+ attributed, makes it even easier. The next example demonstrates some features
+ of Spirit2 that makes this easy. In the process, you'll learn about:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ More about attributes
+ </li>
+<li class="listitem">
+ Auto rules
+ </li>
+<li class="listitem">
+ Some more built-in parsers
+ </li>
+<li class="listitem">
+ Directives
+ </li>
+</ul></div>
+
+ First, let's create a struct representing an employee:
+ 
+
+ 
+
+
+
+<pre class="programlisting">struct employee
+{
+ int age;
+ std::string surname;
+ std::string forename;
+ double salary;
+};
+</pre>
+
+ 
+
+ 
+
+ Then, we need to tell Boost.Fusion
+ about our employee struct to make it a first- class fusion citizen. If
+ you don't know fusion yet, it is a Boost
+ library for working with heterogenous collections of data, commonly referred
+ to as tuples. Spirit uses fusion extensively as part of its infrastructure.
+ 
+
+ In fusion's view, a struct is just a form of a tuple. You can adapt any
+ struct to be a fully conforming fusion tuple:
+ 
+
+ 
+
+
+
+<pre class="programlisting">BOOST_FUSION_ADAPT_STRUCT(
+ client::employee,
+ (int, age)
+ (std::string, surname)
+ (std::string, forename)
+ (double, salary)
+)
+</pre>
+
+ 
+
+ 
+
+ Now we'll write a parser for our employee. Inputs will be of the form:
+ 
+<pre class="programlisting">employee{ age, "surname", "forename", salary }
+</pre>
+
+ Here goes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+struct employee_parser : qi::grammar<Iterator, employee(), ascii::space_type>
+{
+ employee_parser() : employee_parser::base_type(start)
+ {
+ using qi::int_;
+ using qi::lit;
+ using qi::double_;
+ using qi::lexeme;
+ using ascii::char_;
+
+ quoted_string %= lexeme['"' >> +(char_ - '"') >> '"'];
+
+ start %=
+ lit("employee")
+ >> '{'
+ >> int_ >> ','
+ >> quoted_string >> ','
+ >> quoted_string >> ','
+ >> double_
+ >> '}'
+ ;
+ }
+
+ qi::rule<Iterator, std::string(), ascii::space_type> quoted_string;
+ qi::rule<Iterator, employee(), ascii::space_type> start;
+};
+</pre>
+
+ 
+
+ 
+
+ The full cpp file for this example can be found here: ../../example/qi/employee.cpp
+ 
+
+ Let's walk through this one step at a time (not necessarily from top to
+ bottom).
+ 
+<pre class="programlisting">template <typename Iterator>
+struct employee_parser : grammar<Iterator, employee(), space_type>
+</pre>
+
+ <code class="computeroutput">employee_parser</code> is a grammar.
+ Like before, we make it a template so that we can reuse it for different
+ iterator types. The grammar's signature is:
+ 
+<pre class="programlisting">employee()
+</pre>
+
+ meaning, the parser generates employee structs. <code class="computeroutput">employee_parser</code>
+ skips white spaces using <code class="computeroutput">space_type</code>
+ as its skip parser.
+ 
+<pre class="programlisting">employee_parser() : employee_parser::base_type(start)
+</pre>
+
+ Initializes the base class.
+ 
+<pre class="programlisting">rule<Iterator, std::string(), space_type> quoted_string;
+rule<Iterator, employee(), space_type> start;
+</pre>
+
+ Declares two rules: <code class="computeroutput">quoted_string</code>
+ and <code class="computeroutput">start</code>. <code class="computeroutput">start</code> has the same template parameters
+ as the grammar itself. <code class="computeroutput">quoted_string</code>
+ has a <code class="computeroutput">std::string</code> attribute.
+ 
+<a name="spirit.qi.tutorials.employee___parsing_into_structs.lexeme"></a><h6>
+<a name="id610657"></a>
+ <a class="link" href="employee___parsing_into_structs.html#spirit.qi.tutorials.employee___parsing_into_structs.lexeme">Lexeme</a>
+ </h6>
+<pre class="programlisting">lexeme['"' >> +(char_ - '"') >> '"'];
+</pre>
+
+ <code class="computeroutput">lexeme</code> inhibits space skipping
+ from the open brace to the closing brace. The expression parses quoted
+ strings.
+ 
+<pre class="programlisting">+(char_ - '"')
+</pre>
+
+ parses one or more chars, except the double quote. It stops when it sees
+ a double quote.
+ 
+<a name="spirit.qi.tutorials.employee___parsing_into_structs.difference"></a><h6>
+<a name="id610770"></a>
+ <a class="link" href="employee___parsing_into_structs.html#spirit.qi.tutorials.employee___parsing_into_structs.difference">Difference</a>
+ </h6>
+
+ The expression:
+ 
+<pre class="programlisting">a - b
+</pre>
+
+ parses <code class="computeroutput">a</code> but not <code class="computeroutput">b</code>. Its attribute is just <code class="computeroutput">A</code>, the attribute of <code class="computeroutput">a</code>.
+ <code class="computeroutput">b</code>'s attribute is ignored.
+ Hence, the attribute of:
+ 
+<pre class="programlisting">char_ - '"'
+</pre>
+
+ is just <code class="computeroutput">char</code>.
+ 
+<a name="spirit.qi.tutorials.employee___parsing_into_structs.plus"></a><h6>
+<a name="id610878"></a>
+ <a class="link" href="employee___parsing_into_structs.html#spirit.qi.tutorials.employee___parsing_into_structs.plus">Plus</a>
+ </h6>
+<pre class="programlisting">+a
+</pre>
+
+ is the close kin of the kleene star we got so used to in our tutorial.
+ Like it's kin, the kleene star, its attribute is a <code class="computeroutput">std::vector<A></code> where <code class="computeroutput">A</code>
+ is the attribute of <code class="computeroutput">a</code>.
+ So, putting all these together, the attribute of
+ 
+<pre class="programlisting">+(char_ - '"')
+</pre>
+
+ is then:
+ 
+<pre class="programlisting">std::vector<char>
+</pre>
+<a name="spirit.qi.tutorials.employee___parsing_into_structs.sequence_attribute"></a><h6>
+<a name="id611004"></a>
+ <a class="link" href="employee___parsing_into_structs.html#spirit.qi.tutorials.employee___parsing_into_structs.sequence_attribute">Sequence
+ Attribute</a>
+ </h6>
+
+ Now what's the attribute of
+ 
+<pre class="programlisting">'"' >> +(char_ - '"') >> '"'
+</pre>
+
+ ?
+ 
+
+ Well, typically, the attribute of:
+ 
+<pre class="programlisting">a >> b >> c
+</pre>
+
+ is:
+ 
+<pre class="programlisting">fusion::vector<A, B, C>
+</pre>
+
+ where <code class="computeroutput">A</code> is the attribute
+ of <code class="computeroutput">a</code>, <code class="computeroutput">B</code>
+ is the attribute of <code class="computeroutput">b</code> and
+ <code class="computeroutput">C</code> is the attribute of
+ <code class="computeroutput">c</code>. What is <code class="computeroutput">fusion::vector</code>? - a tuple.
+ 
+<div class="note" title="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">
+ If you don't know what I am talking about, see: <a href="http://tinyurl.com/6xun4j" target="_top">Fusion
+ Vector</a>. It might be a good idea to have a look into Boost.Fusion
+ at this point. You'll definitely see more of it in the coming pages.
+ </td></tr>
+</table></div>
+<a name="spirit.qi.tutorials.employee___parsing_into_structs.attribute_collapsing"></a><h6>
+<a name="id611226"></a>
+ <a class="link" href="employee___parsing_into_structs.html#spirit.qi.tutorials.employee___parsing_into_structs.attribute_collapsing">Attribute
+ Collapsing</a>
+ </h6>
+
+ Some parsers, especially those very little literal parsers you see, like
+ <code class="computeroutput">'"'</code>, do not have attributes.
+ 
+
+ Nodes without attributes are disregarded. In a sequence, like above, all
+ nodes with no attributes are filtered out of the <code class="computeroutput">fusion:vector</code>.
+ So, since <code class="computeroutput">'"'</code> has no attribute,
+ and <code class="computeroutput">+(char_
+ - '"')</code> has a <code class="computeroutput">std::vector<char></code> attribute, the whole expression's attribute
+ should have been:
+ 
+<pre class="programlisting">fusion::vector<std::vector<char> >
+</pre>
+
+ But wait, there's one more collapsing rule: If after the attribute is a
+ single element <code class="computeroutput">fusion::vector</code>, The element is stripped naked
+ from its container. So, to make a long story short, the attribute of the
+ expression:
+ 
+<pre class="programlisting">'"' >> +(char_ - '"') >> '"'
+</pre>
+
+ is:
+ 
+<pre class="programlisting">std::vector<char>
+</pre>
+<a name="spirit.qi.tutorials.employee___parsing_into_structs.auto_rules"></a><h6>
+<a name="id611465"></a>
+ <a class="link" href="employee___parsing_into_structs.html#spirit.qi.tutorials.employee___parsing_into_structs.auto_rules">Auto
+ Rules</a>
+ </h6>
+
+ It is typical to see rules like:
+ 
+<pre class="programlisting">r = p[_val = _1];
+</pre>
+
+ If you have a rule definition like above where the attribute of the RHS
+ (right hand side) of the rule is compatibe with the attribute of the LHS
+ (left hand side), then you can rewrite it as:
+ 
+<pre class="programlisting">r %= p;
+</pre>
+
+ The attribute of <code class="computeroutput">p</code> automatically
+ uses the attribute of <code class="computeroutput">r</code>.
+ 
+
+ So, going back to our <code class="computeroutput">quoted_string</code>
+ rule:
+ 
+<pre class="programlisting">quoted_string %= lexeme['"' >> +(char_ - '"') >> '"'];
+</pre>
+
+ is a simplified version of:
+ 
+<pre class="programlisting">quoted_string = lexeme['"' >> +(char_ - '"') >> '"'][val_ = _1];
+</pre>
+
+ The attribute of the <code class="computeroutput">quoted_string</code>
+ rule: <code class="computeroutput">std::string</code> is compatible
+ with the attribute of the RHS: <code class="computeroutput">std::vector<char></code>. The RHS extracts the parsed attribute
+ directly into the rule's attribute, in-situ.
+ 
+<a name="spirit.qi.tutorials.employee___parsing_into_structs.finally"></a><h6>
+<a name="id612194"></a>
+ <a class="link" href="employee___parsing_into_structs.html#spirit.qi.tutorials.employee___parsing_into_structs.finally">Finally</a>
+ </h6>
+
+ We're down to one rule, the start rule:
+ 
+<pre class="programlisting">start %=
+ lit("employee")
+ >> '{'
+ >> int_ >> ','
+ >> quoted_string >> ','
+ >> quoted_string >> ','
+ >> double_
+ >> '}'
+ ;
+</pre>
+
+ Applying our collapsing rules above, the RHS has an attribute of:
+ 
+<pre class="programlisting">fusion::vector<int, std::string, std::string, double>
+</pre>
+
+ These nodes do not have an attribute:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem"><code class="computeroutput">lit("employee")</code></li>
+<li class="listitem"><code class="computeroutput">'{'</code></li>
+<li class="listitem"><code class="computeroutput">'}'</code></li>
+</ul></div>
+<div class="note" title="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">
+ In case you are wondering, <code class="computeroutput">lit("employee")</code> is the same as "employee".
+ We had to wrap it inside <code class="computeroutput">lit</code>
+ because immediately after it is <code class="computeroutput">>>
+ '{'</code>. You can't right-shift a <code class="computeroutput">char[]</code>
+ and a <code class="computeroutput">char</code> - you know, C++
+ syntax rules.
+ </td></tr>
+</table></div>
+
+ Recall that the attribute of <code class="computeroutput">start</code>
+ is the <code class="computeroutput">employee</code> struct:
+ 
+
+ 
+
+
+
+<pre class="programlisting">struct employee
+{
+ int age;
+ std::string surname;
+ std::string forename;
+ double salary;
+};
+</pre>
+
+ 
+
+ 
+
+ Now everything is clear, right? The <code class="computeroutput">struct
+ employee</code> IS
+ compatible with <code class="computeroutput">fusion::vector<int, std::string, std::string, double></code>. So, the RHS of <code class="computeroutput">start</code>
+ uses start's attribute (a <code class="computeroutput">struct
+ employee</code>) in-situ when it does
+ its work.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="roman_numerals.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="mini_xml___asts_.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/mini_xml___asts_.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/mini_xml___asts_.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,521 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Mini XML - ASTs!</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="employee___parsing_into_structs.html" title="Employee - Parsing into structs">
+<link rel="next" href="mini_xml___error_handling.html" title="Mini XML - Error Handling">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="employee___parsing_into_structs.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="mini_xml___error_handling.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Mini XML - ASTs!">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.mini_xml___asts_"></a><a class="link" href="mini_xml___asts_.html" title="Mini XML - ASTs!">Mini XML - ASTs!</a>
+</h4></div></div></div>
+
+ Stop and think about it... We've come very close to generating an AST in
+ our last example. We parsed a single structure and generated an in-memory
+ representation of it in the form of a struct: the <code class="computeroutput">struct
+ employee</code>. If we changed the implementation
+ to parse one or more employees, the result would be a <code class="computeroutput">std::vector<employee></code>. We can go on and add more hierarchy:
+ teams, departments, corporations. Then we'll have an AST representation
+ of it all.
+ 
+
+ In this example (actually two examples), we'll now explore parsers how
+ to create ASTs. We will parse a minimalistic XML like language and compile
+ the results into our data structures in the form of a tree.
+ 
+
+ Along the way, we'll see new features:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Inherited attributes
+ </li>
+<li class="listitem">
+ Variant attributes
+ </li>
+<li class="listitem">
+ Local Variables
+ </li>
+<li class="listitem">
+ Not Predicate
+ </li>
+<li class="listitem">
+ Lazy Lit
+ </li>
+</ul></div>
+
+ The full cpp files for these examples can be found here: ../../example/qi/mini_xml1.cpp
+ and here: ../../example/qi/mini_xml2.cpp
+ 
+
+ There are a couple of sample toy-xml files in: ../../example/qi/mini_xml_samples
+ for testing purposes. "4.toyxml" has an error in it.
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.first_cut"></a><h6>
+<a name="id612842"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.first_cut">First Cut</a>
+ </h6>
+
+ Without further delay, here's the first version of the XML grammar:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+struct mini_xml_grammar : qi::grammar<Iterator, mini_xml(), ascii::space_type>
+{
+ mini_xml_grammar() : mini_xml_grammar::base_type(xml)
+ {
+ using qi::lit;
+ using qi::lexeme;
+ using ascii::char_;
+ using ascii::string;
+ using namespace qi::labels;
+
+ using phoenix::at_c;
+ using phoenix::push_back;
+
+ text = lexeme[+(char_ - '<') [_val += _1]];
+ node = (xml | text) [_val = _1];
+
+ start_tag =
+ '<'
+ >> !lit('/')
+ >> lexeme[+(char_ - '>') [_val += _1]]
+ >> '>'
+ ;
+
+ end_tag =
+ "</"
+ >> string(_r1)
+ >> '>'
+ ;
+
+ xml =
+ start_tag [at_c<0>(_val) = _1]
+ >> *node [push_back(at_c<1>(_val), _1)]
+ >> end_tag(at_c<0>(_val))
+ ;
+ }
+
+ qi::rule<Iterator, mini_xml(), ascii::space_type> xml;
+ qi::rule<Iterator, mini_xml_node(), ascii::space_type> node;
+ qi::rule<Iterator, std::string(), ascii::space_type> text;
+ qi::rule<Iterator, std::string(), ascii::space_type> start_tag;
+ qi::rule<Iterator, void(std::string), ascii::space_type> end_tag;
+};
+</pre>
+
+ 
+
+ 
+
+ Going bottom up, let's examine the <code class="computeroutput">text</code>
+ rule:
+ 
+<pre class="programlisting">rule<Iterator, std::string(), space_type> text;
+</pre>
+
+ and its definition:
+ 
+<pre class="programlisting">text = lexeme[+(char_ - '<') [_val += _1]];
+</pre>
+
+ The semantic action collects the chars and appends them (via +=) to the
+ <code class="computeroutput">std::string</code> attribute of the rule (represented
+ by the placeholder <code class="computeroutput">_val</code>).
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.alternates"></a><h6>
+<a name="id614023"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.alternates">Alternates</a>
+ </h6>
+<pre class="programlisting">rule<Iterator, mini_xml_node(), space_type> node;
+</pre>
+
+ and its definition:
+ 
+<pre class="programlisting">node = (xml | text) [_val = _1];
+</pre>
+
+ We'll see what a <code class="computeroutput">mini_xml_node</code>
+ structure later. Looking at the rule definition, we see some alternation
+ goiing on here. An xml <code class="computeroutput">node</code>
+ is either an <code class="computeroutput">xml</code> OR <code class="computeroutput">text</code>. Hmmm... hold on to that thought...
+ 
+<pre class="programlisting">rule<Iterator, std::string(), space_type> start_tag;
+</pre>
+
+ Again, with an attribute of <code class="computeroutput">std::string</code>.
+ Then, it's definition:
+ 
+<pre class="programlisting">start_tag =
+ '<'
+ >> !char_('/')
+ >> lexeme[+(char_ - '>') [_val += _1]]
+ >> '>'
+;
+</pre>
+<a name="spirit.qi.tutorials.mini_xml___asts_.not_predicate"></a><h6>
+<a name="id615447"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.not_predicate">Not
+ Predicate</a>
+ </h6>
+
+ <code class="computeroutput">start_tag</code> is similar to
+ the <code class="computeroutput">text</code> rule apart from
+ the added <code class="computeroutput">'<'</code> and <code class="computeroutput">'>'</code>. But wait, to make sure that the <code class="computeroutput">start_tag</code> does not parse <code class="computeroutput">end_tag</code>s too, we add: <code class="computeroutput">!char_('/')</code>. This
+ is a "Not Predicate":
+ 
+<pre class="programlisting">!p
+</pre>
+
+ It will try the parser, <code class="computeroutput">p</code>.
+ If it is successful, fail, otherwise, pass. In other words, it negates
+ the result of <code class="computeroutput">p</code>. Like the
+ <code class="computeroutput">eps</code>, it does not consume
+ any input though. It will always rewind the iterator position to where
+ it was upon entry. So, the expression:
+ 
+<pre class="programlisting">!char_('/')
+</pre>
+
+ basically says: we should not have a <code class="computeroutput">'/'</code>
+ at this point.
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.inherited_attribute"></a><h6>
+<a name="id615602"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.inherited_attribute">Inherited
+ Attribute</a>
+ </h6>
+
+ The <code class="computeroutput">end_tag</code>:
+ 
+<pre class="programlisting">rule<Iterator, void(std::string), space_type> end_tag;
+</pre>
+
+ Ohh! Now we see an inherited attribute there: <code class="computeroutput">std::string</code>.
+ The <code class="computeroutput">end_tag</code> does not have
+ a synthesized attribute. Let's see its definition:
+ 
+<pre class="programlisting">end_tag =
+ "</"
+ >> lit(_r1)
+ >> '>'
+;
+</pre>
+
+ <code class="computeroutput">_r1</code> is yet another Phoenix placeholder for
+ the 1st inherited attribute (we have only one, use <code class="computeroutput">_r2</code>,
+ <code class="computeroutput">_r3</code>, etc. if you have more).
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.a_lazy_lit"></a><h6>
+<a name="id615797"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.a_lazy_lit">A Lazy
+ Lit</a>
+ </h6>
+
+ Check out how we used <code class="computeroutput">lit</code>
+ here, this time, not with a literal string, but with the value of the 1st
+ inherited attribute, which is specified as <code class="computeroutput">std::string</code>
+ in our rule declaration.
+ 
+
+ Finally, our <code class="computeroutput">xml</code> rule:
+ 
+<pre class="programlisting">rule<Iterator, mini_xml(), space_type> xml;
+</pre>
+
+ <code class="computeroutput">mini_xml</code> is our attribute
+ here. We'll see later what it is. Let's see its definition:
+ 
+<pre class="programlisting">xml =
+ start_tag [at_c<0>(_val) = _1]
+ >> *node [push_back(at_c<1>(_val), _1)]
+ >> end_tag(at_c<0>(_val))
+;
+</pre>
+
+ Those who know Boost.Fusion
+ now will notice <code class="computeroutput">at_c<0></code> and
+ <code class="computeroutput">at_c<1></code>. This
+ gives us a hint that <code class="computeroutput">mini_xml</code>
+ is a sort of a tuple - a fusion sequence. <code class="computeroutput">at_c<N></code> here is a lazy version of the tuple
+ accessors, provided by Phoenix.
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.how_it_all_works"></a><h6>
+<a name="id616128"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.how_it_all_works">How
+ it all works</a>
+ </h6>
+
+ So, what's happening?
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Upon parsing <code class="computeroutput">start_tag</code>,
+ the parsed start-tag string is placed in <code class="computeroutput">at_c<0>(_val)</code>.
+ </li>
+<li class="listitem">
+ Then we parse zero or more <code class="computeroutput">node</code>s.
+ At each step, we <code class="computeroutput">push_back</code>
+ the result into <code class="computeroutput">at_c<1>(_val)</code>.
+ </li>
+<li class="listitem">
+ Finally, we parse the <code class="computeroutput">end_tag</code>
+ giving it an inherited attribute: <code class="computeroutput">at_c<0>(_val)</code>.
+ This is the string we obtained from the <code class="computeroutput">start_tag</code>.
+ Investigate <code class="computeroutput">end_tag</code> above.
+ It will fail to parse if it gets something different from what we got
+ from the <code class="computeroutput">start_tag</code>. This
+ ensures that our tags are balanced.
+ </li>
+</ol></div>
+
+ To give the last item some more light, what happens is this:
+ 
+<pre class="programlisting">end_tag(at_c<0>(_val))
+</pre>
+
+ calls:
+ 
+<pre class="programlisting">end_tag =
+ "</"
+ >> lit(_r1)
+ >> '>'
+;
+</pre>
+
+ passing in <code class="computeroutput">at_c<0>(_val)</code>, the string from start tag. This is referred
+ to in the <code class="computeroutput">end_tag</code> body
+ as <code class="computeroutput">_r1</code>.
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.the_structures"></a><h6>
+<a name="id616424"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.the_structures">The
+ Structures</a>
+ </h6>
+
+ Let's see our structures. It will definitely be hierarchical: xml is hierarchical.
+ It will also be recursive: xml is recursive.
+ 
+
+ 
+
+
+
+<pre class="programlisting">struct mini_xml;
+
+typedef
+ boost::variant<
+ boost::recursive_wrapper<mini_xml>
+ , std::string
+ >
+mini_xml_node;
+
+struct mini_xml
+{
+ std::string name; // tag name
+ std::vector<mini_xml_node> children; // children
+};
+</pre>
+
+ 
+
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.of_alternates_and_variants"></a><h6>
+<a name="id616620"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.of_alternates_and_variants">Of
+ Alternates and Variants</a>
+ </h6>
+
+ So that's how a <code class="computeroutput">mini_xml_node</code>
+ looks like. We had a hint that it is either a <code class="computeroutput">string</code>
+ or a <code class="computeroutput">mini_xml</code>. For this,
+ we use Boost.Variant.
+ <code class="computeroutput">boost::recursive_wrapper</code> wraps <code class="computeroutput">mini_xml</code>, making it a recursive data
+ structure.
+ 
+
+ Yep, you got that right: the attribute of an alternate:
+ 
+<pre class="programlisting">a | b
+</pre>
+
+ is a
+ 
+<pre class="programlisting">boost::variant<A, B>
+</pre>
+
+ where <code class="computeroutput">A</code> is the attribute
+ of <code class="computeroutput">a</code> and <code class="computeroutput">B</code> is the attribute of <code class="computeroutput">b</code>.
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.adapting_structs_again"></a><h6>
+<a name="id616784"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.adapting_structs_again">Adapting
+ structs again</a>
+ </h6>
+
+ <code class="computeroutput">mini_xml</code> is no brainier.
+ It is a plain ol' struct. But as we've seen in our employee example, we
+ can adapt that to be a Boost.Fusion
+ sequence:
+ 
+
+ 
+
+
+
+<pre class="programlisting">BOOST_FUSION_ADAPT_STRUCT(
+ client::mini_xml,
+ (std::string, name)
+ (std::vector<client::mini_xml_node>, children)
+)
+</pre>
+
+ 
+
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.one_more_take"></a><h6>
+<a name="id616925"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.one_more_take">One
+ More Take</a>
+ </h6>
+
+ Here's another version. The AST structure remains the same, but this time,
+ you'll see that we make use of auto-rules making the grammar semantic-action-
+ less. Here it is:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+struct mini_xml_grammar
+ : qi::grammar<Iterator, mini_xml(), qi::locals<std::string>, ascii::space_type>
+{
+ mini_xml_grammar()
+ : mini_xml_grammar::base_type(xml)
+ {
+ using qi::lit;
+ using qi::lexeme;
+ using ascii::char_;
+ using ascii::string;
+ using namespace qi::labels;
+
+ text %= lexeme[+(char_ - '<')];
+ node %= xml | text;
+
+ start_tag %=
+ '<'
+ >> !lit('/')
+ >> lexeme[+(char_ - '>')]
+ >> '>'
+ ;
+
+ end_tag =
+ "</"
+ >> string(_r1)
+ >> '>'
+ ;
+
+ xml %=
+ start_tag[_a = _1]
+ >> *node
+ >> end_tag(_a)
+ ;
+ }
+
+ qi::rule<Iterator, mini_xml(), qi::locals<std::string>, ascii::space_type> xml;
+ qi::rule<Iterator, mini_xml_node(), ascii::space_type> node;
+ qi::rule<Iterator, std::string(), ascii::space_type> text;
+ qi::rule<Iterator, std::string(), ascii::space_type> start_tag;
+ qi::rule<Iterator, void(std::string), ascii::space_type> end_tag;
+};
+</pre>
+
+ 
+
+ 
+
+ This one shouldn't be any more difficult to understand after going through
+ the first xml parser example. The rules are almost the same, except that,
+ we got rid of semantic actions and used auto-rules (see the employee example
+ if you missed that). There are a couple of new stuff, though. It's all
+ in the <code class="computeroutput">xml</code> rule:
+ 
+<a name="spirit.qi.tutorials.mini_xml___asts_.local_variables"></a><h6>
+<a name="id618387"></a>
+ <a class="link" href="mini_xml___asts_.html#spirit.qi.tutorials.mini_xml___asts_.local_variables">Local
+ Variables</a>
+ </h6>
+<pre class="programlisting">rule<Iterator, mini_xml(), locals<std::string>, space_type> xml;
+</pre>
+
+ Wow, we have four template parameters now. What's that <code class="computeroutput">locals</code>
+ guy doing there? Well, it declares that the rule <code class="computeroutput">xml</code>
+ will have one local variable: a <code class="computeroutput">string</code>.
+ Let's see how this is used in action:
+ 
+<pre class="programlisting">xml %=
+ start_tag[_a = _1]
+ >> *node
+ >> end_tag(_a)
+;
+</pre>
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Upon parsing <code class="computeroutput">start_tag</code>,
+ the parsed start-tag string is placed in the local variable specified
+ by (yet another) Phoenix
+ placeholder: <code class="computeroutput">_a</code>. We have
+ only one local variable. If we had more, these are designated by <code class="computeroutput">_b</code>..<code class="computeroutput">_z</code>.
+ </li>
+<li class="listitem">
+ Then we parse zero or more <code class="computeroutput">node</code>s.
+ </li>
+<li class="listitem">
+ Finally, we parse the <code class="computeroutput">end_tag</code>
+ giving it an inherited attribute: <code class="computeroutput">_a</code>,
+ our local variable.
+ </li>
+</ol></div>
+
+ There are no actions involved in stuffing data into our <code class="computeroutput">xml</code>
+ attribute. It's all taken cared of thatnks to the auto-rule.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="employee___parsing_into_structs.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="mini_xml___error_handling.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/mini_xml___error_handling.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/mini_xml___error_handling.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,301 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Mini XML - Error Handling</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="mini_xml___asts_.html" title="Mini XML - ASTs!">
+<link rel="next" href="../quick_reference.html" title="Quick Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="mini_xml___asts_.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Mini XML - Error Handling">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.mini_xml___error_handling"></a><a class="link" href="mini_xml___error_handling.html" title="Mini XML - Error Handling">Mini
+ XML - Error Handling</a>
+</h4></div></div></div>
+
+ A parser will not be complete without error handling. Spirit2 provides
+ some facilities to make it easy to adapt a grammar for error handling.
+ We'll wrap up the Qi tutorial with another version of the mini xml parser,
+ this time, with error handling.
+ 
+
+ ../../example/qi/mini_xml1.cpp
+ and here: ../../example/qi/mini_xml2.cpp
+ 
+
+ Here's the grammar:
+ 
+
+ What's new?
+ 
+<a name="spirit.qi.tutorials.mini_xml___error_handling.readable_names"></a><h6>
+<a name="id618692"></a>
+ <a class="link" href="mini_xml___error_handling.html#spirit.qi.tutorials.mini_xml___error_handling.readable_names">Readable
+ Names</a>
+ </h6>
+
+ First, when we call the base class, we give the grammar a name:
+ 
+<pre class="programlisting">: mini_xml_grammar::base_type(xml, "xml")
+</pre>
+
+ Then, we name all our rules:
+ 
+<pre class="programlisting">xml.name("xml");
+node.name("node");
+text.name("text");
+start_tag.name("start_tag");
+end_tag.name("end_tag");
+</pre>
+<a name="spirit.qi.tutorials.mini_xml___error_handling.on_error"></a><h6>
+<a name="id618872"></a>
+ <a class="link" href="mini_xml___error_handling.html#spirit.qi.tutorials.mini_xml___error_handling.on_error">On
+ Error</a>
+ </h6>
+
+ <code class="computeroutput">on_error</code> declares our error
+ handler:
+ 
+<pre class="programlisting">on_error<Action>(rule, handler)
+</pre>
+
+ This will specify what we will do when we get an error. We will print out
+ an error message using phoenix:
+ 
+<pre class="programlisting">on_error<fail>
+(
+ xml
+ , std::cout
+ << val("Error! Expecting ")
+ << _4 // what failed?
+ << val(" here: \"")
+ << construct<std::string>(_3, _2) // iterators to error-pos, end
+ << val("\"")
+ << std::endl
+);
+</pre>
+
+ we choose to <code class="computeroutput">fail</code> in our
+ example for the <code class="computeroutput">Action</code>:
+ Quit and fail. Return a no_match (false). It can be one of:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ <code class="computeroutput">Action</code>
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ fail
+ 
+ </td>
+<td>
+ 
+ Quit and fail. Return a no_match.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ retry
+ 
+ </td>
+<td>
+ 
+ Attempt error recovery, possibly moving the iterator position.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ accept
+ 
+ </td>
+<td>
+ 
+ Force success, moving the iterator position appropriately.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ rethrow
+ 
+ </td>
+<td>
+ 
+ Rethrows the error.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+
+ <code class="computeroutput">rule</code> is the rule we attach
+ the handler to. In our case, we are attaching to the <code class="computeroutput">xml</code>
+ rule.
+ 
+
+ <code class="computeroutput">handler</code> is the actual error
+ handling function. It expects 4 arguments:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Arg
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ first
+ 
+ </td>
+<td>
+ 
+ The position of the iterator when the rule with the handler was
+ entered.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ last
+ 
+ </td>
+<td>
+ 
+ The end of input.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ error-pos
+ 
+ </td>
+<td>
+ 
+ The actual position of the iterator where the error occurred.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ what
+ 
+ </td>
+<td>
+ 
+ What failed: a string decribing the failure.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="spirit.qi.tutorials.mini_xml___error_handling.expectation_points"></a><h6>
+<a name="id619380"></a>
+ <a class="link" href="mini_xml___error_handling.html#spirit.qi.tutorials.mini_xml___error_handling.expectation_points">Expectation
+ Points</a>
+ </h6>
+
+ You might not have noticed it, but some of our expressions changed from
+ using the <code class="computeroutput">>></code> to <code class="computeroutput">></code>. Look, for example:
+ 
+<pre class="programlisting">end_tag =
+ "</"
+ > lit(_r1)
+ > '>'
+;
+</pre>
+
+ What is it? It's the expectation operator. You will
+ have some "deterministic points" in the grammar. Those are the
+ places where backtracking cannot occur.
+ For our example above, when you get a <code class="computeroutput">"</"</code>,
+ you definitely must see a valid end-tag label next. It should be the one
+ you got from the start-tag. After that, you definitely must have a <code class="computeroutput">'>'</code> next. Otherwise, there is no point in
+ proceeding forward and trying other branches, regardless where they are.
+ The input is definitely erroneous. When this happens, an expectation_failure
+ exception is thrown. Somewhere outward, the error handler will catch the
+ exception.
+ 
+
+ Try building the parser: ../../example/qi/mini_xml2.cpp.
+ You can find some examples in: ../../example/qi/mini_xml_samples
+ for testing purposes. "4.toyxml" has an error in it:
+ 
+<pre class="programlisting"><foo><bar></foo></bar>
+</pre>
+
+ Running the example with this gives you:
+ 
+<pre class="programlisting">Error! Expecting "bar" here: "foo></bar>"
+Error! Expecting end_tag here: "<bar></foo></bar>"
+-------------------------
+Parsing failed
+-------------------------
+</pre>
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="mini_xml___asts_.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../quick_reference.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/number_list___stuffing_numbers_into_a_std__vector.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/number_list___stuffing_numbers_into_a_std__vector.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,104 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Number List - stuffing numbers into a std::vector</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="sum___adding_numbers.html" title="Sum - adding numbers">
+<link rel="next" href="number_list_redux___list_syntax.html" title="Number List Redux - list syntax">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="sum___adding_numbers.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="number_list_redux___list_syntax.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Number List - stuffing numbers into a std::vector">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.number_list___stuffing_numbers_into_a_std__vector"></a><a class="link" href="number_list___stuffing_numbers_into_a_std__vector.html" title="Number List - stuffing numbers into a std::vector">Number
+ List - stuffing numbers into a std::vector</a>
+</h4></div></div></div>
+
+ This sample demontrates a parser for a comma separated list of numbers.
+ The numbers are inserted in a vector using phoenix.
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+bool parse_numbers(Iterator first, Iterator last, std::vector<double>& v)
+{
+ using qi::double_;
+ using qi::phrase_parse;
+ using qi::_1;
+ using ascii::space;
+ using phoenix::push_back;
+ using phoenix::ref;
+
+ bool r = phrase_parse(first, last,
+
+ // Begin grammar
+ (
+ double_[push_back(ref(v), _1)]
+ >> *(',' >> double_[push_back(ref(v), _1)])
+ )
+ ,
+ // End grammar
+
+ space);
+
+ if (first != last) // fail if we did not get a full match
+ return false;
+ return r;
+}
+</pre>
+
+ 
+
+ 
+
+ The full cpp file for this example can be found here: ../../example/qi/num_list2.cpp
+ 
+
+ This, again, is the same parser as before. This time, instead of summing
+ up the numbers, we stuff them in a <code class="computeroutput">std::vector</code>.
+ <code class="computeroutput">push_back</code> is supplied by
+ Phoenix. The expression:
+ 
+<pre class="programlisting">push_back(ref(v), _1)
+</pre>
+
+ appends the parsed number. Like before, <code class="computeroutput">_1</code>
+ is a Phoenix placeholder
+ for the parsed result attribute. Also, like before, <code class="computeroutput">ref(v)</code>
+ tells Phoenix that
+ <code class="computeroutput">v</code>, the <code class="computeroutput">std::vector</code>,
+ is a mutable reference.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="sum___adding_numbers.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="number_list_redux___list_syntax.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/number_list_attribute___one_more__with_style.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/number_list_attribute___one_more__with_style.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,130 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Number List Attribute - one more, with style</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="number_list_redux___list_syntax.html" title="Number List Redux - list syntax">
+<link rel="next" href="roman_numerals.html" title="Roman Numerals">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="number_list_redux___list_syntax.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="roman_numerals.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Number List Attribute - one more, with style">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.number_list_attribute___one_more__with_style"></a><a class="link" href="number_list_attribute___one_more__with_style.html" title="Number List Attribute - one more, with style">Number
+ List Attribute - one more, with style</a>
+</h4></div></div></div>
+
+ You've seen that the <code class="computeroutput">double_</code>
+ parser has a <code class="computeroutput">double</code> attribute.
+ All parsers have an attribute, even complex parsers, those that are composed
+ from primitives using operators, like the list parser, also have an attribute.
+ It so happens that the the attribute of a list parser:
+ 
+<pre class="programlisting">p % d
+</pre>
+
+ is a <code class="computeroutput">std::vector</code> of the attribute of <code class="computeroutput">p</code>. So, for our parser:
+ 
+<pre class="programlisting">double_ % ','
+</pre>
+
+ we'll have an attribute of:
+ 
+<pre class="programlisting">std::vector<double>
+</pre>
+
+ So, what does this give us? Well, we can simply pass in a <code class="computeroutput">std::vector<double></code>
+ to our number list parser and it will happily churn out our result in our
+ vector. For that to happen, we'll use a variation of the <code class="computeroutput">phrase_parse</code> with an additional argument:
+ the parser's attribute:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ An iterator pointing to the start of the input
+ </li>
+<li class="listitem">
+ An iterator pointing to one past the end of the input
+ </li>
+<li class="listitem">
+ The parser object
+ </li>
+<li class="listitem">
+ The parser's attribute
+ </li>
+<li class="listitem">
+ Another parser called the skip parser
+ </li>
+</ol></div>
+
+ So, our parser now is further simplified to:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+bool parse_numbers(Iterator first, Iterator last, std::vector<double>& v)
+{
+ using qi::double_;
+ using qi::phrase_parse;
+ using qi::_1;
+ using ascii::space;
+
+ bool r = phrase_parse(first, last,
+
+ // Begin grammar
+ (
+ double_ % ','
+ )
+ ,
+ // End grammar
+
+ space, v);
+
+ if (first != last) // fail if we did not get a full match
+ return false;
+ return r;
+}
+</pre>
+
+ 
+
+ 
+
+ The full cpp file for this example can be found here: ../../example/qi/num_list4.cpp
+ 
+
+ Hey, no more actions!!! Now we're entering
+ the realm of attribute grammars. Cool eh?
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="number_list_redux___list_syntax.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="roman_numerals.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/number_list_redux___list_syntax.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/number_list_redux___list_syntax.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,102 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Number List Redux - list syntax</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="number_list___stuffing_numbers_into_a_std__vector.html" title="Number List - stuffing numbers into a std::vector">
+<link rel="next" href="number_list_attribute___one_more__with_style.html" title="Number List Attribute - one more, with style">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="number_list___stuffing_numbers_into_a_std__vector.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="number_list_attribute___one_more__with_style.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Number List Redux - list syntax">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.number_list_redux___list_syntax"></a><a class="link" href="number_list_redux___list_syntax.html" title="Number List Redux - list syntax">Number
+ List Redux - list syntax</a>
+</h4></div></div></div>
+
+ So far, we've been using the syntax:
+ 
+<pre class="programlisting">double_ >> *(',' >> double_)
+</pre>
+
+ to parse a comma-delimited list of numbers. Such lists are common in parsing
+ and Spirit provides a simpler shortcut for them. The expression above can
+ be simplified to:
+ 
+<pre class="programlisting">double_ % ','
+</pre>
+
+ read as: a list of doubles separated by <code class="computeroutput">','</code>.
+ 
+
+ This sample, again a variation of our previous example, demonstrates just
+ that:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+bool parse_numbers(Iterator first, Iterator last, std::vector<double>& v)
+{
+ using qi::double_;
+ using qi::phrase_parse;
+ using qi::_1;
+ using ascii::space;
+ using phoenix::push_back;
+ using phoenix::ref;
+
+ bool r = phrase_parse(first, last,
+
+ // Begin grammar
+ (
+ double_[push_back(ref(v), _1)] % ','
+ )
+ ,
+ // End grammar
+
+ space);
+
+ if (first != last) // fail if we did not get a full match
+ return false;
+ return r;
+}
+</pre>
+
+ 
+
+ 
+
+ The full cpp file for this example can be found here: ../../example/qi/num_list3.cpp
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="number_list___stuffing_numbers_into_a_std__vector.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="number_list_attribute___one_more__with_style.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/quick_start.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/quick_start.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,83 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Quick Start</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="../tutorials.html" title="Tutorials">
+<link rel="next" href="warming_up.html" title="Warming up">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../tutorials.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="warming_up.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Quick Start">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.quick_start"></a><a class="link" href="quick_start.html" title="Quick Start">Quick Start</a>
+</h4></div></div></div>
+<a name="spirit.qi.tutorials.quick_start.why_would_you_want_to_use_spirit_qi_"></a><h6>
+<a name="id596970"></a>
+ <a class="link" href="quick_start.html#spirit.qi.tutorials.quick_start.why_would_you_want_to_use_spirit_qi_">Why
+ would you want to use Spirit.Qi?</a>
+ </h6>
+
+ Spirit.Qi is designed to be a practical parsing tool. The ability to generate
+ a fully-working parser from a formal EBNF specification inlined in C++
+ significantly reduces development time. Programmers typically approach
+ parsing using ad hoc hacks with primitive tools such as scanf. Even regular-expression
+ libraries (such as boost regex) or scanners (such as Boost tokenizer) do
+ not scale well when we need to write more elaborate parsers. Attempting
+ to write even a moderately-complex parser using these tools leads to code
+ that is hard to understand and maintain.
+ 
+
+ One prime objective is to make the tool easy to use. When one thinks of
+ a parser generator, the usual reaction is "it must be big and complex
+ with a steep learning curve." Not so. Spirit is designed to be fully
+ scalable. The library is structured in layers. This permits learning on
+ an as-needed basis, after only learning the minimal core and basic concepts.
+ 
+
+ For development simplicity and ease in deployment, the entire library consists
+ of only header files, with no libraries to link against or build. Just
+ put the spirit distribution in your include path, compile and run. Code
+ size? -very tight -essentially comparable to hand written recursive descent
+ code.
+ 
+
+ Our tutorials will walk you through the simplest Spirit examples, incrementally
+ building on top of the earlier examples as we expose more and more features
+ and techniques. We will try to be as gentle as possible with the learning
+ curve. We will present the tutorials in a cookbook style approach. This
+ style of presentation is based on our BoostCon '07 and BoostCon '08 slides.
+ 
+
+ Have fun!
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../tutorials.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="warming_up.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/roman_numerals.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/roman_numerals.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,418 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Roman Numerals</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="number_list_attribute___one_more__with_style.html" title="Number List Attribute - one more, with style">
+<link rel="next" href="employee___parsing_into_structs.html" title="Employee - Parsing into structs">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="number_list_attribute___one_more__with_style.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="employee___parsing_into_structs.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Roman Numerals">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.roman_numerals"></a><a class="link" href="roman_numerals.html" title="Roman Numerals">Roman Numerals</a>
+</h4></div></div></div>
+
+ This example demonstrates:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ symbol table
+ </li>
+<li class="listitem">
+ rule
+ </li>
+<li class="listitem">
+ grammar
+ </li>
+</ul></div>
+<a name="spirit.qi.tutorials.roman_numerals.symbol_table"></a><h6>
+<a name="id604954"></a>
+ <a class="link" href="roman_numerals.html#spirit.qi.tutorials.roman_numerals.symbol_table">Symbol
+ Table</a>
+ </h6>
+
+ The symbol table holds a dictionary of symbols where each symbol is a sequence
+ of characters (a <code class="computeroutput">char</code>, <code class="computeroutput">wchar_t</code>, <code class="computeroutput">int</code>,
+ enumeration etc.) . The template class, parameterized by the character
+ type, can work efficiently with 8, 16, 32 and even 64 bit characters. Mutable
+ data of type T is associated with each symbol.
+ 
+
+ Traditionally, symbol table management is maintained seperately outside
+ the BNF grammar through semantic actions. Contrary to standard practice,
+ the Spirit symbol table class symbols is-a parser. An object of which may
+ be used anywhere in the EBNF grammar specification. It is an example of
+ a dynamic parser. A dynamic parser is characterized by its ability to modify
+ its behavior at run time. Initially, an empty symbols object matches nothing.
+ At any time, symbols may be added or removed, thus, dynamically altering
+ its behavior.
+ 
+
+ Each entry in a symbol table has an associated mutable data slot. In this
+ regard, one can view the symbol table as an associative container (or map)
+ of key-value pairs where the keys are strings.
+ 
+
+ The symbols class expects two template parameters. The first parameter
+ specifies the character type of the symbols. The second specifies the data
+ type associated with each symbol: its attribute.
+ 
+
+ Here's a parser for roman hundreds (100..900) using the symbol table. Keep
+ in mind that the data associated with each slot is the parser's attribute
+ (which is passed to attached semantic actions).
+ 
+
+ 
+
+
+
+<pre class="programlisting">struct hundreds_ : qi::symbols<char, unsigned>
+{
+ hundreds_()
+ {
+ add
+ ("C" , 100)
+ ("CC" , 200)
+ ("CCC" , 300)
+ ("CD" , 400)
+ ("D" , 500)
+ ("DC" , 600)
+ ("DCC" , 700)
+ ("DCCC" , 800)
+ ("CM" , 900)
+ ;
+ }
+
+} hundreds;
+</pre>
+
+ 
+
+ 
+
+ Here's a parser for roman tens (10..90):
+ 
+
+ 
+
+
+
+<pre class="programlisting">struct tens_ : qi::symbols<char, unsigned>
+{
+ tens_()
+ {
+ add
+ ("X" , 10)
+ ("XX" , 20)
+ ("XXX" , 30)
+ ("XL" , 40)
+ ("L" , 50)
+ ("LX" , 60)
+ ("LXX" , 70)
+ ("LXXX" , 80)
+ ("XC" , 90)
+ ;
+ }
+
+} tens;
+</pre>
+
+ 
+
+ 
+
+ and, finally, for ones (1..9):
+ 
+
+ 
+
+
+
+<pre class="programlisting">struct ones_ : qi::symbols<char, unsigned>
+{
+ ones_()
+ {
+ add
+ ("I" , 1)
+ ("II" , 2)
+ ("III" , 3)
+ ("IV" , 4)
+ ("V" , 5)
+ ("VI" , 6)
+ ("VII" , 7)
+ ("VIII" , 8)
+ ("IX" , 9)
+ ;
+ }
+
+} ones;
+</pre>
+
+ 
+
+ 
+
+ Now we can use <code class="computeroutput">hundreds</code>,
+ <code class="computeroutput">tens</code> and <code class="computeroutput">ones</code> anywhere in our parser expressions.
+ They are all parsers.
+ 
+<a name="spirit.qi.tutorials.roman_numerals.rules"></a><h6>
+<a name="id605934"></a>
+ <a class="link" href="roman_numerals.html#spirit.qi.tutorials.roman_numerals.rules">Rules</a>
+ </h6>
+
+ Up until now, we've been inlining our parser expressions, passing them
+ directly to the <code class="computeroutput">phrase_parse</code>
+ function. The expression evaluates into a temporary, unnamed parser which
+ is passed into the <code class="computeroutput">phrase_parse</code>
+ function, used, and then destroyed. This is fine for small parsers. When
+ the expressions get complicated, you'd want to break the expressions into
+ smaller easier to understand pieces, name them, and refer to them from
+ other parser expressions by name.
+ 
+
+ A parser expression can be assigned to, what is called, a "rule".
+ There are various ways to declare rules. The simplest form is:
+ 
+<pre class="programlisting">rule<Iterator> r;
+</pre>
+
+ At the very least, the rule needs to know the iterator type it will be
+ working on. This rule cannot be used with <code class="computeroutput">phrase_parse</code>.
+ It can only be used with the <code class="computeroutput">parse</code>
+ function -- a version that does not do white space skipping (does not have
+ the skipper argument). If you want to have it skip white spaces, you need
+ to pass in the type skip parser, as in the next form:
+ 
+<pre class="programlisting">rule<Iterator, Skipper> r;
+</pre>
+
+ Example:
+ 
+<pre class="programlisting">rule<std::string::iterator, space_type> r;
+</pre>
+
+ This type of rule can be used for both <code class="computeroutput">phrase_parse</code>
+ and <code class="computeroutput">parse</code>.
+ 
+
+ For our next example, there's one more rule form you should know about:
+ 
+<pre class="programlisting">rule<Iterator, Signature> r;
+</pre>
+
+ or
+ 
+<pre class="programlisting">rule<Iterator, Signature, Skipper> r;
+</pre>
+<div class="tip" title="Tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top">
+ All rule template arguments after Iterator can be supplied in any order.
+ </td></tr>
+</table></div>
+
+ The Signature specifies the attributes of the rule. You've seen that our
+ parsers can have an attribute. Recall that the <code class="computeroutput">double_</code>
+ parser has an attribute of <code class="computeroutput">double</code>.
+ To be precise, these are synthesized attributes. The
+ parser "synthesizes" the attribute value. Think of them as function
+ return values.
+ 
+
+ There's another type of attribute called "inherited" attribute.
+ We won't need them for now, but it's good that you be aware of such attributes.
+ You can think of them as function arguments. And, rightly so, the rule
+ signature is a function signature of the form:
+ 
+<pre class="programlisting">result(argN, argN,..., argN)
+</pre>
+
+ After having declared a rule, you can now assign any parser expression
+ to it. Example:
+ 
+<pre class="programlisting">r = double_ >> *(',' >> double_);
+</pre>
+<a name="spirit.qi.tutorials.roman_numerals.grammars"></a><h6>
+<a name="id606327"></a>
+ <a class="link" href="roman_numerals.html#spirit.qi.tutorials.roman_numerals.grammars">Grammars</a>
+ </h6>
+
+ A grammar encapsulates one or more rules. It has the same template parameters
+ as the rule. You declare a grammar by:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ deriving a struct (or class) from the <code class="computeroutput">grammar</code>
+ class template
+ </li>
+<li class="listitem">
+ declare one or more rules as member variables
+ </li>
+<li class="listitem">
+ initialize the base grammar class by giving it the start rule (its the
+ first rule that gets called when the grammar starts parsing)
+ </li>
+<li class="listitem">
+ initialize your rules in your constructor
+ </li>
+</ol></div>
+
+ The roman numeral grammar is a very nice and simple example of a grammar:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+struct roman : qi::grammar<Iterator, unsigned()>
+{
+ roman() : roman::base_type(start)
+ {
+ using qi::eps;
+ using qi::lit;
+ using qi::_val;
+ using qi::_1;
+ using ascii::char_;
+
+ start = eps [_val = 0] >>
+ (
+ +lit('M') [_val += 1000]
+ || hundreds [_val += _1]
+ || tens [_val += _1]
+ || ones [_val += _1]
+ )
+ ;
+ }
+
+ qi::rule<Iterator, unsigned()> start;
+};
+</pre>
+
+ 
+
+ 
+
+ Things to take notice of:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The grammar and start rule signature is <code class="computeroutput">unsigned()</code>. It has a synthesized attribute (return
+ value) of type <code class="computeroutput">unsigned</code>
+ with no inherited attributes (arguments).
+ </li>
+<li class="listitem">
+ We did not specify a skip-parser. We don't want to skip in between the
+ numerals.
+ </li>
+<li class="listitem">
+<code class="computeroutput">roman::base_type</code> is a typedef for <code class="computeroutput">grammar<Iterator,
+ unsigned()></code>.
+ If <code class="computeroutput">roman</code> was not a template,
+ you can simply write: base_type(start)
+ </li>
+<li class="listitem">
+ But it's best to make your grammar templates, so that they can be reused
+ for different iterator types.
+ </li>
+<li class="listitem">
+<code class="computeroutput">_val</code> is another Phoenix placeholder representing
+ the rule's synthesized attribute.
+ </li>
+<li class="listitem">
+<code class="computeroutput">eps</code> is a special spirit
+ parser that consumes no input but is always successful. We use it to
+ initialize <code class="computeroutput">_val</code>, the
+ rule's synthesized attribute, to zero before anything else. The actual
+ parser starts at <code class="computeroutput">+char_('M')</code>,
+ parsing roman thousands. Using <code class="computeroutput">eps</code>
+ this way is good for doing pre and post initializations.
+ </li>
+<li class="listitem">
+ The expression <code class="computeroutput">a ||
+ b</code> reads: match a or b and in
+ sequence. That is, if both <code class="computeroutput">a</code>
+ and <code class="computeroutput">b</code> match, it must
+ be in sequence; this is equivalent to <code class="computeroutput">a
+ >> -b | b</code>, but more efficient.
+ </li>
+</ul></div>
+<a name="spirit.qi.tutorials.roman_numerals.let_s_parse_"></a><h6>
+<a name="id607054"></a>
+ <a class="link" href="roman_numerals.html#spirit.qi.tutorials.roman_numerals.let_s_parse_">Let's Parse!</a>
+ </h6>
+
+ 
+
+
+
+<pre class="programlisting">bool r = parse(iter, end, roman_parser, result);
+
+if (r && iter == end)
+{
+ std::cout << "-------------------------\n";
+ std::cout << "Parsing succeeded\n";
+ std::cout << "result = " << result << std::endl;
+ std::cout << "-------------------------\n";
+}
+else
+{
+ std::string rest(iter, end);
+ std::cout << "-------------------------\n";
+ std::cout << "Parsing failed\n";
+ std::cout << "stopped at: \": " << rest << "\"\n";
+ std::cout << "-------------------------\n";
+}
+</pre>
+
+ 
+
+ 
+
+ <code class="computeroutput">roman_parser</code> is an object
+ of type <code class="computeroutput">roman</code> -our roman
+ numeral parser. This time around, we are using the no-skipping version
+ of the parse functions. We do not want to skip any spaces! We are also
+ passing in an attribute, <code class="computeroutput">unsigned
+ result</code>, which will receive the
+ parsed value.
+ 
+
+ The full cpp file for this example can be found here: ../../example/qi/roman.cpp
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="number_list_attribute___one_more__with_style.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="employee___parsing_into_structs.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/semantic_actions.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/semantic_actions.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,262 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Semantic Actions</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="warming_up.html" title="Warming up">
+<link rel="next" href="complex___our_first_complex_parser.html" title="Complex - Our first complex parser">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="warming_up.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="complex___our_first_complex_parser.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Semantic Actions">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.semantic_actions"></a><a class="link" href="semantic_actions.html" title="Semantic Actions">Semantic Actions</a>
+</h4></div></div></div>
+
+ Our parser above is really nothing but a recognizer. It answers the question
+ "did the input match our grammar?", but it does not do anything
+ other than that. It does not extract any information from what was parsed.
+ For example, whenever we parse a real number, we wish to store the parsed
+ number after a successful match.
+ 
+
+ Enter Semantic actions. Semantic actions may be attached to any point in
+ the grammar specification. These actions are C++ functions or function
+ objects that are called whenever a part of the parser successfully recognizes
+ a portion of the input. Say you have a parser <code class="computeroutput">P</code>,
+ and a C++ function <code class="computeroutput">F</code>, you
+ can make the parser call <code class="computeroutput">F</code>
+ whenever it matches an input by attaching <code class="computeroutput">F</code>:
+ 
+<pre class="programlisting">P[F]
+</pre>
+
+ The expression above links <code class="computeroutput">F</code>
+ to the parser, <code class="computeroutput">P</code>.
+ 
+
+ The function/function object signature depends on the type of the parser
+ to which it is attached. The parser <code class="computeroutput">double_</code>
+ passes the parsed number. Thus, if we were to attach a function <code class="computeroutput">F</code> to <code class="computeroutput">double_</code>,
+ we need <code class="computeroutput">F</code> to be declared
+ as:
+ 
+<pre class="programlisting">void F(double n);
+</pre>
+
+ There are actually 2 more arguments being passed (the parser context and
+ a reference to a boolean 'hit' parameter). We don't need these, for now,
+ but we'll see more on these other arguments later. Spirit.Qi allows us
+ to bind a single argument function, like above. The other arguments are
+ simply ignored.
+ 
+
+ Presented are various ways to attach semantic actions:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Using plain function pointer
+ </li>
+<li class="listitem">
+ Using simple function object
+ </li>
+<li class="listitem">
+ Using Boost.Bind with
+ a plain function
+ </li>
+<li class="listitem">
+ Using Boost.Bind with
+ a member function
+ </li>
+<li class="listitem">
+ Using Boost.Lambda
+</li>
+</ul></div>
+
+ Given:
+ 
+
+ 
+
+
+
+<pre class="programlisting">namespace client
+{
+ namespace qi = boost::spirit::qi;
+
+ // A plain function
+ void print(int const& i)
+ {
+ std::cout << i << std::endl;
+ }
+
+ // A member function
+ struct writer
+ {
+ void print(int const& i) const
+ {
+ std::cout << i << std::endl;
+ }
+ };
+
+ // A function object
+ struct print_action
+ {
+ void operator()(int const& i, qi::unused_type, qi::unused_type) const
+ {
+ std::cout << i << std::endl;
+ }
+ };
+}
+</pre>
+
+ 
+
+ 
+
+ Take note that with function objects, we need to have an <code class="computeroutput">operator()</code>
+ with 3 arguments. Since we don't care about the other two, we can use
+ <code class="computeroutput">unused_type</code> for these.
+ We'll see more of <code class="computeroutput">unused_type</code>
+ elsewhere. Get used to it. <code class="computeroutput">unused_type</code>
+ is a Spirit supplied support class.
+ 
+
+ All examples parse inputs of the form:
+ 
+<pre class="programlisting">"{integer}"
+</pre>
+
+ An integer inside the curly braces.
+ 
+
+ The first example shows how to attach a plain function:
+ 
+
+ 
+
+
+
+<pre class="programlisting">parse(first, last, '{' >> int_[&print] >> '}');
+</pre>
+
+ 
+
+ 
+
+ What's new? Well <code class="computeroutput">int_</code> is
+ the sibbling of <code class="computeroutput">double_</code>.
+ I'm sure you can guess what this parser does.
+ 
+
+ The next example shows how to attach a simple function object:
+ 
+
+ 
+
+
+
+<pre class="programlisting">parse(first, last, '{' >> int_[print_action()] >> '}');
+</pre>
+
+ 
+
+ 
+
+ We can use Boost.Bind
+ to 'bind' member functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">writer w;
+parse(first, last, '{' >> int_[boost::bind(&writer::print, &w, _1)] >> '}');
+</pre>
+
+ 
+
+ 
+
+ Likewise, we can also use Boost.Bind
+ to 'bind' plain functions:
+ 
+
+ 
+
+
+
+<pre class="programlisting">parse(first, last, '{' >> int_[boost::bind(&print, _1)] >> '}');
+</pre>
+
+ 
+
+ 
+
+ Yep, we can also use Boost.Lambda:
+ 
+
+ 
+
+
+
+<pre class="programlisting">parse(first, last, '{' >> int_[std::cout << _1 << '\n'] >> '}');
+</pre>
+
+ 
+
+ 
+
+ There are more ways to bind semantic action functions, but the examples
+ above are the most common. Attaching semantic actions is the first hurdle
+ one has to tackle when getting started with parsing with Spirit. Familiarize
+ yourself with this task and get intimate with the tools behind it such
+ as Boost.Bind and Boost.Lambda.
+ 
+
+ The examples above can be found here: ../../example/qi/actions.cpp
+ 
+<a name="spirit.qi.tutorials.semantic_actions.phoenix"></a><h6>
+<a name="id600408"></a>
+ <a class="link" href="semantic_actions.html#spirit.qi.tutorials.semantic_actions.phoenix">Phoenix</a>
+ </h6>
+
+ Phoenix, a companion
+ library bundled with Spirit, is specifically suited for binding semantic
+ actions. It is like Boost.Lambda
+ in steroids, with special custom features that make it easy to integrate
+ semantic actions with Spirit. If your requirements go beyond simple to
+ moderate parsing, I suggest you use this library. Examples presented henceforth
+ shall be using the library exclusively
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="warming_up.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="complex___our_first_complex_parser.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/sum___adding_numbers.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/sum___adding_numbers.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,250 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Sum - adding numbers</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="complex___our_first_complex_parser.html" title="Complex - Our first complex parser">
+<link rel="next" href="number_list___stuffing_numbers_into_a_std__vector.html" title="Number List - stuffing numbers into a std::vector">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="complex___our_first_complex_parser.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="number_list___stuffing_numbers_into_a_std__vector.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Sum - adding numbers">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.sum___adding_numbers"></a><a class="link" href="sum___adding_numbers.html" title="Sum - adding numbers">Sum - adding
+ numbers</a>
+</h4></div></div></div>
+
+ Here's a parser that sums a comma-separated list of numbers.
+ 
+
+ Ok we've glossed over some details in our previous examples. First, our
+ includes:
+ 
+
+ 
+
+
+
+<pre class="programlisting">#include <boost/spirit/include/qi.hpp>
+#include <boost/spirit/include/phoenix_core.hpp>
+#include <boost/spirit/include/phoenix_operator.hpp>
+#include <iostream>
+#include <string>
+</pre>
+
+ 
+
+ 
+
+ Then some using directives:
+ 
+
+ 
+
+
+
+<pre class="programlisting">namespace qi = boost::spirit::qi;
+namespace ascii = boost::spirit::ascii;
+namespace phoenix = boost::phoenix;
+
+using qi::double_;
+using qi::_1;
+using ascii::space;
+using phoenix::ref;
+</pre>
+
+ 
+
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Namespace
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ boost::phoenix
+ 
+ </td>
+<td>
+ 
+ All of phoenix
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ boost::spirit
+ 
+ </td>
+<td>
+ 
+ All of spirit
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ boost::spirit::qi
+ 
+ </td>
+<td>
+ 
+ All of spirit.qi
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ boost::spirit::ascii
+ 
+ </td>
+<td>
+ 
+ ASCII version of <code class="computeroutput">char_</code>
+ and all char related parsers. Other encodings are also provided
+ (e.g. also an ISO8859.1)
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ boost::spirit::arg_names
+ 
+ </td>
+<td>
+ 
+ Special phoenix placeholders for spirit
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<div class="note" title="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">
+ If you feel uneasy with using whole namespaces, feel free to qualify
+ your code, use namespace aliases, etc. For the purpose of this tutorial,
+ we will be presenting unqualified names for both Spirit and Phoenix.
+ No worries, we will always present the full working code, so you won't
+ get lost. In fact, all examples in this tutorial have a corresponding
+ cpp file that QuickBook (the documentation tool we are using) imports
+ in here as code snippets.
+ </td></tr>
+</table></div>
+
+ Now the actual parser:
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+bool adder(Iterator first, Iterator last, double& n)
+{
+ bool r = qi::phrase_parse(first, last,
+
+ // Begin grammar
+ (
+ double_[ref(n) = _1] >> *(',' >> double_[ref(n) += _1])
+ )
+ ,
+ // End grammar
+
+ space);
+
+ if (first != last) // fail if we did not get a full match
+ return false;
+ return r;
+}
+</pre>
+
+ 
+
+ 
+
+ The full cpp file for this example can be found here: ../../example/qi/sum.cpp
+ 
+
+ This is almost like our original numbers list example. We're incrementally
+ building on top of our examples. This time though, like in the complex
+ number example, we'll be adding the smarts. There's an accumulator (`double&
+ n) that adds the numbers parsed. On a successful parse, this number is
+ the sum of all the parsed numbers.
+ 
+
+ The first <code class="computeroutput">double_</code> parser
+ attaches this action:
+ 
+<pre class="programlisting">ref(n) = _1
+</pre>
+
+ This assigns the parsed result (actually, the attribute of <code class="computeroutput">double_</code>) to <code class="computeroutput">n</code>.
+ <code class="computeroutput">ref(n)</code> tells
+ Phoenix that <code class="computeroutput">n</code> is a mutable reference. <code class="computeroutput">_1</code> is a Phoenix
+ placeholder for the parsed result attribute.
+ 
+
+ The second <code class="computeroutput">double_</code> parser
+ attaches this action:
+ 
+<pre class="programlisting">ref(n) += _1
+</pre>
+
+ So, subsequent numbers add into <code class="computeroutput">n</code>.
+ 
+
+ That wasn't too bad, was it :-) ?
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="complex___our_first_complex_parser.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="number_list___stuffing_numbers_into_a_std__vector.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/qi/tutorials/warming_up.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/qi/tutorials/warming_up.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,295 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Warming up</title>
+<link rel="stylesheet" href="../../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../../index.html" title="Spirit 2.1">
+<link rel="up" href="../tutorials.html" title="Tutorials">
+<link rel="prev" href="quick_start.html" title="Quick Start">
+<link rel="next" href="semantic_actions.html" title="Semantic Actions">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_start.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Warming up">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="spirit.qi.tutorials.warming_up"></a><a class="link" href="warming_up.html" title="Warming up">Warming up</a>
+</h4></div></div></div>
+
+ We'll start by showing examples of parser expressions to give you a feel
+ on how to build parsers from the simplest parser, building up as we go.
+ 
+<a name="spirit.qi.tutorials.warming_up.trivial_example__1_parsing_a_number"></a><h6>
+<a name="id597016"></a>
+ <a class="link" href="warming_up.html#spirit.qi.tutorials.warming_up.trivial_example__1_parsing_a_number">Trivial
+ Example #1 Parsing a number</a>
+ </h6>
+
+ Create a parser that will parse a floating-point number.
+ 
+<pre class="programlisting">double_
+</pre>
+
+ (You've got to admit, that's trivial!) The above code actually generates
+ a Spirit floating point parser (a built-in parser). Spirit has many pre-defined
+ parsers and consistent naming conventions help you keep from going insane!
+ 
+<a name="spirit.qi.tutorials.warming_up.trivial_example__2_parsing_two_numbers"></a><h6>
+<a name="id597045"></a>
+ <a class="link" href="warming_up.html#spirit.qi.tutorials.warming_up.trivial_example__2_parsing_two_numbers">Trivial
+ Example #2 Parsing two numbers</a>
+ </h6>
+
+ Create a parser that will accept a line consisting of two floating-point
+ numbers.
+ 
+<pre class="programlisting">double_ >> double_
+</pre>
+
+ Here you see the familiar floating-point numeric parser <code class="computeroutput">double_</code>
+ used twice, once for each number. What's that <code class="computeroutput">>></code>
+ operator doing in there? Well, they had to be separated by something, and
+ this was chosen as the "followed by" sequence operator. The above
+ program creates a parser from two simpler parsers, glueing them together
+ with the sequence operator. The result is a parser that is a composition
+ of smaller parsers. Whitespace between numbers can implicitly be consumed
+ depending on how the parser is invoked (see below).
+ 
+<div class="note" title="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">
+ When we combine parsers, we end up with a "bigger" parser,
+ but it's still a parser. Parsers can get bigger and bigger, nesting more
+ and more, but whenever you glue two parsers together, you end up with
+ one bigger parser. This is an important concept.
+ </td></tr>
+</table></div>
+<a name="spirit.qi.tutorials.warming_up.trivial_example__3_parsing_one_or_more_numbers"></a><h6>
+<a name="id597106"></a>
+ <a class="link" href="warming_up.html#spirit.qi.tutorials.warming_up.trivial_example__3_parsing_one_or_more_numbers">Trivial
+ Example #3 Parsing one or more numbers</a>
+ </h6>
+
+ Create a parser that will accept zero or more floating-point numbers.
+ 
+<pre class="programlisting">*double_
+</pre>
+
+ This is like a regular-expression Kleene Star, though the syntax might
+ look a bit odd for a C++ programmer not used to seeing the <code class="computeroutput">*</code> operator overloaded like this. Actually,
+ if you know regular expressions it may look odd too since the star is before
+ the expression it modifies. C'est la vie. Blame it on the fact that we
+ must work with the syntax rules of C++.
+ 
+
+ Any expression that evaluates to a parser may be used with the Kleene Star.
+ Keep in mind, though, that due to C++ operator precedence rules you may
+ need to put the expression in parentheses for complex expressions. The
+ Kleene Star is also known as a Kleene Closure, but we call it the Star
+ in most places.
+ 
+<a name="spirit.qi.tutorials.warming_up.trivial_example__4_parsing_a_comma_delimited_list_of_numbers"></a><h6>
+<a name="id597150"></a>
+ <a class="link" href="warming_up.html#spirit.qi.tutorials.warming_up.trivial_example__4_parsing_a_comma_delimited_list_of_numbers">Trivial
+ Example #4 Parsing a comma-delimited list of numbers</a>
+ </h6>
+
+ This example will create a parser that accepts a comma-delimited list of
+ numbers.
+ 
+<pre class="programlisting">double_ >> *(char_(',') >> double_)
+</pre>
+
+ Notice <code class="computeroutput">char_(',')</code>. It is
+ a literal character parser that can recognize the comma <code class="computeroutput">','</code>.
+ In this case, the Kleene Star is modifying a more complex parser, namely,
+ the one generated by the expression:
+ 
+<pre class="programlisting">(char_(',') >> double_)
+</pre>
+
+ Note that this is a case where the parentheses are necessary. The Kleene
+ star encloses the complete expression above.
+ 
+<a name="spirit.qi.tutorials.warming_up.let_s_parse_"></a><h6>
+<a name="id597281"></a>
+ <a class="link" href="warming_up.html#spirit.qi.tutorials.warming_up.let_s_parse_">Let's Parse!</a>
+ </h6>
+
+ We're done with defining the parser. So the next step is now invoking this
+ parser to do its work. There are a couple of ways to do this. For now,
+ we will use the <code class="computeroutput">phrase_parse</code>
+ function. One overload of this function accepts four arguments:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ An iterator pointing to the start of the input
+ </li>
+<li class="listitem">
+ An iterator pointing to one past the end of the input
+ </li>
+<li class="listitem">
+ The parser object
+ </li>
+<li class="listitem">
+ Another parser called the skip parser
+ </li>
+</ol></div>
+
+ In our example, we wish to skip spaces and tabs. Another parser named
+ <code class="computeroutput">space</code> is included in Spirit's
+ repertoire of predefined parsers. It is a very simple parser that simply
+ recognizes whitespace. We will use <code class="computeroutput">space</code>
+ as our skip parser. The skip parser is the one responsible for skipping
+ characters in between parser elements such as the <code class="computeroutput">double_</code>
+ and <code class="computeroutput">char_</code>.
+ 
+
+ Ok, so now let's parse!
+ 
+
+ 
+
+
+
+<pre class="programlisting">template <typename Iterator>
+bool parse_numbers(Iterator first, Iterator last)
+{
+ using qi::double_;
+ using qi::phrase_parse;
+ using ascii::space;
+
+ bool r = phrase_parse(
+ first, <a class="co" name="spirit0co" href="warming_up.html#spirit0"><img src="../../../../../../../doc/src/images/callouts/1.png" alt="1" border="0"></a>
+ last, <a class="co" name="spirit1co" href="warming_up.html#spirit1"><img src="../../../../../../../doc/src/images/callouts/2.png" alt="2" border="0"></a>
+ double_ >> *(',' >> double_), <a class="co" name="spirit2co" href="warming_up.html#spirit2"><img src="../../../../../../../doc/src/images/callouts/3.png" alt="3" border="0"></a>
+ space <a class="co" name="spirit3co" href="warming_up.html#spirit3"><img src="../../../../../../../doc/src/images/callouts/4.png" alt="4" border="0"></a>
+ );
+ if (first != last) // fail if we did not get a full match
+ return false;
+ return r;
+}
+</pre>
+
+ 
+
+ 
+
+ 
+<div class="calloutlist"><table border="0" summary="Callout list">
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit0"></a> </td>
+<td valign="top" align="left"> start iterator </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit1"></a> </td>
+<td valign="top" align="left"> end iterator </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit2"></a> </td>
+<td valign="top" align="left"> the parser </td>
+</tr>
+<tr>
+<td width="5%" valign="top" align="left"><a name="spirit3"></a> </td>
+<td valign="top" align="left"> the skip-parser </td>
+</tr>
+</table></div>
+
+ 
+
+ 
+
+ The parse function returns <code class="computeroutput">true</code>
+ or <code class="computeroutput">false</code> depending on the
+ result of the parse. The first iterator is passed by reference. On a successful
+ parse, this iterator is repositioned to the rightmost position consumed
+ by the parser. If this becomes equal to str.end(), then we have a full
+ match. If not, then we have a partial match. A partial match happens when
+ the parser is only able to parse a portion of the input.
+ 
+
+ Note that we inlined the parser directly in the call to parse. Upon calling
+ parse, the expression evaluates into a temporary, unnamed parser which
+ is passed into the parse() function, used, and then destroyed.
+ 
+
+ Here, we opted to make the parser generic by making it a template, parameterized
+ by the iterator type. By doing so, it can take in data coming from any
+ STL conforming sequence as long as the iterators conform to a forward iterator.
+ 
+
+ You can find the full cpp file here: ../../example/qi/num_list1.cpp
+ 
+<div class="note" title="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">
+
+ <code class="computeroutput">char</code> and <code class="computeroutput">wchar_t</code>
+ operands
+ 
+
+ The careful reader may notice that the parser expression has <code class="computeroutput">','</code> instead of <code class="computeroutput">char_(',')</code>
+ as the previous examples did. This is ok due to C++ syntax rules of conversion.
+ There are <code class="computeroutput">>></code> operators
+ that are overloaded to accept a <code class="computeroutput">char</code>
+ or <code class="computeroutput">wchar_t</code> argument on its
+ left or right (but not both). An operator may be overloaded if at least
+ one of its parameters is a user-defined type. In this case, the <code class="computeroutput">double_</code> is the 2nd argument to <code class="computeroutput">operator>></code>,
+ and so the proper overload of <code class="computeroutput">>></code>
+ is used, converting <code class="computeroutput">','</code> into
+ a character literal parser.
+ 
+
+ The problem with omiting the <code class="computeroutput">char_</code>
+ should be obvious: <code class="computeroutput">'a' >>
+ 'b'</code> is not a spirit parser, it is
+ a numeric expression, right-shifting the ASCII (or another encoding)
+ value of <code class="computeroutput">'a'</code> by the ASCII value
+ of <code class="computeroutput">'b'</code>. However, both <code class="computeroutput">char_('a') >>
+ 'b'</code> and <code class="computeroutput">'a'
+ >> char_('b')</code>
+ are Spirit sequence parsers for the letter <code class="computeroutput">'a'</code>
+ followed by <code class="computeroutput">'b'</code>. You'll get
+ used to it, sooner or later.
+ 
+</td></tr>
+</table></div>
+
+ Finally, take note that we test for a full match (i.e. the parser fully
+ parsed the input) by checking if the first iterator, after parsing, is
+ equal to the end iterator. You may strike out this part if partial matches
+ are to be allowed.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="quick_start.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../tutorials.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="semantic_actions.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/references.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/references.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,491 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>References</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="acknowledgments.html" title="Acknowledgments">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="acknowledgments.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a>
+</div>
+<div class="section" title="References">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.references"></a><a class="link" href="references.html" title="References">References</a>
+</h2></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ 
+ </th>
+<th>
+ 
+ Authors
+ 
+ </th>
+<th>
+ 
+ Title, Publisher/link, Date Published
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ 1.
+ 
+ </td>
+<td>
+ 
+ Todd Veldhuizen
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.extreme.indiana.edu/%7Etveldhui/papers/Expression-Templates/exprtmpl.html" target="_top">"Expression
+ Templates"</a>. C++ Report, June 1995.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 2.
+ 
+ </td>
+<td>
+ 
+ Peter Naur (ed.)
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.masswerk.at/algol60/report.htm" target="_top">"Report
+ on the Algorithmic Language ALGOL 60"</a>. CACM, May 1960.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 3.
+ 
+ </td>
+<td>
+ 
+ ISO/IEC
+ 
+ </td>
+<td>
+ 
+ "ISO-EBNF",
+ ISO/IEC 14977: 1996(E).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 4.
+ 
+ </td>
+<td>
+ 
+ Richard J.Botting, Ph.D.
+ 
+ </td>
+<td>
+ 
+ "XBNF"
+ (citing Leu-Weiner, 1973). California State University, San Bernardino,
+ 1998.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 5.
+ 
+ </td>
+<td>
+ 
+ James Coplien.
+ 
+ </td>
+<td>
+ 
+ "Curiously Recurring Template Pattern". C++ Report, Feb.
+ 1995.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 6.
+ 
+ </td>
+<td>
+ 
+ Thierry Geraud and Alexandre Duret-Lutz
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.coldewey.com/europlop2000/papers/geraud%2Bduret.zip" target="_top">Generic
+ Programming Redesign of Patterns</a> Proceedings of the 5th European
+ Conference on Pattern Languages of Programs(EuroPLoP'2000) Irsee, Germany,
+ July 2000.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 7.
+ 
+ </td>
+<td>
+ 
+ Geoffrey Furnish
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.adtmag.com/joop/carticle.aspx?ID=627" target="_top">"Disambiguated
+ Glommable Expression Templates Reintroduced"</a> C++ Report,
+ May 2000
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 8.
+ 
+ </td>
+<td>
+ 
+ Erich Gamma, Richard Helm, Ralph Jhonson, and John Vlissides
+ 
+ </td>
+<td>
+ 
+ Design Patterns, Elements of Reusable Object-Oriented Software. Addison-Wesley,
+ 1995.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 9.
+ 
+ </td>
+<td>
+ 
+ Alfred V. Aho, Revi Sethi, Feffrey D. Ulman
+ 
+ </td>
+<td>
+ 
+ Compilers, Principles, Techniques and Tools Addison-Wesley, June 1987.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 10.
+ 
+ </td>
+<td>
+ 
+ Dick Grune and Ceriel Jacobs
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.cs.vu.nl/%7Edick/PTAPG.html" target="_top">Parsing Techniques:
+ A Practical Guide.</a> Ellis Horwood Ltd.: West Sussex, England,
+ 1990. (electronic copy, 1998).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 11.
+ 
+ </td>
+<td>
+ 
+ T. J. Parr, H. G. Dietz, and W. E. Cohen
+ 
+ </td>
+<td>
+ 
+ <a href="http://citeseer.ist.psu.edu/6885.html" target="_top">PCCTS Reference
+ Manual (Version 1.00)</a>. School of Electrical Engineering, Purdue
+ University, West Lafayette, August 1991.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 12.
+ 
+ </td>
+<td>
+ 
+ Adrian Johnstone and Elizabeth Scott.
+ 
+ </td>
+<td>
+ 
+ <a href="ftp://ftp.cs.rhul.ac.uk/pub/rdp" target="_top">RDP, A Recursive Descent
+ Compiler Compiler</a>. Technical Report CSD TR 97 25, Dept. of
+ Computer Science, Egham, Surrey, England, Dec. 20, 1997.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 13.
+ 
+ </td>
+<td>
+ 
+ Adrian Johnstone
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.cs.rhul.ac.uk/research/languages/projects/lookahead_backtrack.shtml" target="_top">Languages
+ and Architectures, Parser generators with backtrack or extended lookahead
+ capability</a> Department of Computer Science, Royal Holloway,
+ University of London, Egham, Surrey, England
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 14.
+ 
+ </td>
+<td>
+ 
+ Damian Conway
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.csse.monash.edu.au/%7Edamian/papers/#Embedded_Input_Parsing_for_C" target="_top">Parsing
+ with C++ Classes</a>. ACM SIGPLAN Notices, 29:1, 1994.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 15.
+ 
+ </td>
+<td>
+ 
+ Joel de Guzman
+ 
+ </td>
+<td>
+ 
+ <a href="http://spirit.sourceforge.net/distrib/spirit_1_8_5/libs/spirit/index.html" target="_top">"Spirit
+ Version 1.8"</a>, 1998-2003.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 16.
+ 
+ </td>
+<td>
+ 
+ S. Doaitse Swierstra and Luc Duponcheel
+ 
+ </td>
+<td>
+ 
+ <a href="http://citeseer.ist.psu.edu/448665.html" target="_top">Deterministic,
+ Error-Correcting Combinator Parsers</a> Dept. of Computer Science,
+ Utrecht University P.O.Box 80.089, 3508 TB Utrecht, The Netherland
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 17.
+ 
+ </td>
+<td>
+ 
+ Bjarne Stroustrup
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.research.att.com/%7Ebs/whitespace98.pdf" target="_top">Generalizing
+ Overloading for C++2000</a> Overload, Issue 25. April 1, 1998.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 18.
+ 
+ </td>
+<td>
+ 
+ Dr. John Maddock
+ 
+ </td>
+<td>
+ 
+ Regex++ Documentation
+ http://www.boost.org/libs/regex/index.htm
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 19.
+ 
+ </td>
+<td>
+ 
+ Anonymous Edited by Graham Hutton
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.cs.nott.ac.uk/~gmh//faq.html" target="_top">Frequently Asked
+ Questions for comp.lang.functional</a>. Edited by Graham Hutton,
+ University of Nottingham.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 20.
+ 
+ </td>
+<td>
+ 
+ Hewlett-Packard
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.sgi.com/tech/stl/" target="_top">Standard Template Library
+ Programmer's Guide.</a>, Hewlett-Packard Company, 1994
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 21.
+ 
+ </td>
+<td>
+ 
+ Boost Libraries
+ 
+ </td>
+<td>
+ 
+ Boost Libraries Documentation.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 22.
+ 
+ </td>
+<td>
+ 
+ Brian McNamara and Yannis Smaragdakis
+ 
+ </td>
+<td>
+ 
+ <a href="http://www.cc.gatech.edu/~yannis/fc++/" target="_top">FC++:Functional
+ Programming in C++</a>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ 23.
+ 
+ </td>
+<td>
+ 
+ Todd Veldhuizen
+ 
+ </td>
+<td>
+ 
+ <a href="ftp://ftp.cs.indiana.edu/pub/techreports/TR542.pdf" target="_top">Techniques
+ for Scientic C++.</a>
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="acknowledgments.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/repository.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/repository.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,52 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Spirit Repository</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="notes/style_guide.html" title="Style Guide">
+<link rel="next" href="acknowledgments.html" title="Acknowledgments">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="notes/style_guide.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="acknowledgments.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Spirit Repository">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.repository"></a><a class="link" href="repository.html" title="Spirit Repository"> Spirit Repository</a>
+</h2></div></div></div>
+
+ The Spirit repository is
+ a community effort collecting different reusable components (primitives, directives,
+ grammars, etc.) for Spirit.Qi parsers and Spirit.Karma
+ generators. All components in the repository have been peer reviewed or discussed
+ on the <a href="http://www.nabble.com/The-Spirit-Parser-Library-f3430.html" target="_top">Spirit
+ General List</a>. For more information about the repository see here.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="notes/style_guide.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="acknowledgments.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/structure.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/structure.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,45 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Structure</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="introduction.html" title="Introduction">
+<link rel="next" href="structure/include.html" title="Include">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="introduction.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="structure/include.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Structure">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.structure"></a><a class="link" href="structure.html" title="Structure">Structure</a>
+</h2></div></div></div>
+<div class="toc"><dl><dt>Include</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="introduction.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="structure/include.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/structure/include.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/structure/include.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,226 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Include</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../structure.html" title="Structure">
+<link rel="prev" href="../structure.html" title="Structure">
+<link rel="next" href="../abstracts.html" title="Abstracts">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../structure.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../structure.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../abstracts.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Include">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.structure.include"></a><a class="link" href="include.html" title="Include">Include</a>
+</h3></div></div></div>
+
+ Spirit is a header file only library. There are no libraries to link to.
+ This section documents the structure of the Spirit headers.
+ 
+
+ Spirit contains five sub-libraries plus a 'support' module where common support
+ classes are placed:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Classic
+ </li>
+<li class="listitem">
+ Qi
+ </li>
+<li class="listitem">
+ Karma
+ </li>
+<li class="listitem">
+ Lex
+ </li>
+<li class="listitem">
+ Phoenix
+ </li>
+<li class="listitem">
+ Support
+ </li>
+</ul></div>
+
+ The top spirit directory is:
+ 
+<pre class="programlisting">BOOST_ROOT/boost/spirit
+</pre>
+
+ Currently, the directory contains:
+ 
+<pre class="programlisting">[actor] [attribute] [core] [dynamic]
+[debug] [error_handling][home] [include]
+[iterator] [meta] [phoenix] [symbols]
+[tree] [utility]
+</pre>
+
+ These include some old v1.8 directories that are now depracated. These are:
+ actor, attribute, core, dynamic, debug, error_handling, iterator, meta, phoenix,
+ symbols, tree and utility. There is no guarantee that these directories will
+ still be present in future versions of Spirit. We only keep them for backward
+ compatibility. Please be warned.
+ 
+
+ Each directory (except include and home) have a corresponding header file
+ that contains forwarding includes of each relevant include file that the
+ directory contains. For example, there exists a <boost/spirit/actor.hpp>
+ header file which includes all the relevant files from the boost/spiritactor
+ directory.
+ 
+
+ To distinguish between Spirit versions, you can inspect the version file:
+ 
+<pre class="programlisting"><boost/spirit/version.hpp>
+</pre>
+
+ using the preprocessor define
+ 
+<pre class="programlisting">SPIRIT_VERSION
+</pre>
+
+ It is a hex number where the first two digits determine the major version
+ while the last two digits determine the minor version. For example:
+ 
+<pre class="programlisting">#define SPIRIT_VERSION 0x2010 // version 2.1
+</pre>
+
+ The include directory at:
+ 
+<pre class="programlisting">BOOST_ROOT/boost/spirit/include
+</pre>
+
+ is a special flat directory that contains all the spirit headers. To accomodate
+ the flat structure, the headers are prefixed with the sub-library name:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ classic_
+ </li>
+<li class="listitem">
+ karma_
+ </li>
+<li class="listitem">
+ lex_
+ </li>
+<li class="listitem">
+ phoenix1_
+ </li>
+<li class="listitem">
+ phoenix_
+ </li>
+<li class="listitem">
+ qi_
+ </li>
+<li class="listitem">
+ support_
+ </li>
+</ul></div>
+
+ For example, if you used to include <boost/spirit/actor.hpp>, which
+ is now a deprecated header, you should instead include <boost/spirit/include/classic_actor.hpp>
+ 
+
+ If you want to simply include the main sub-library name, then you can include:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ <boost/spirit/include/classic.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/include/karma.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/include/lex.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/include/phoenix1.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/include/phoenix.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/include/qi.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/include/support.hpp>
+ </li>
+</ul></div>
+
+ The home directory:
+ 
+<pre class="programlisting">BOOST_ROOT/boost/spirit/home
+</pre>
+
+ is the real home of spirit. It is the place where the
+ various sub-libraries actually exist. The home directory contains:
+ 
+<pre class="programlisting">[classic] [karma] [lex]
+[phoenix] [qi] [support]
+</pre>
+
+ As usual, these directories have their corresponding include files:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ <boost/spirit/home/classic.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/home/karma.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/home/lex.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/home/phoenix.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/home/qi.hpp>
+ </li>
+<li class="listitem">
+ <boost/spirit/home/support.hpp>
+ </li>
+</ul></div>
+
+ The various sub-libraries include files can be found in each sub-directory
+ containing the particular sub-library. The include structure of a sub-library
+ is covered in its documentation. For consistency, each library follows the
+ same scheme as above.
+ 
+
+ To keep it simple, you should use the flat include directory at boost/spirit/include.
+ 
+
+ For some additional information about the rationale you might want to have
+ a look at the FAQ entry <a class="link" href="../faq.html#spirit.faq.i_m_very_confused_about_the_header_hell_in_my_boost_spirit_directory__what_s_all_this_about_">Header
+ Hell</a>.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../structure.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../structure.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../abstracts.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/support.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/support.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,45 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Supporting libraries</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="lex/reference/tokendef.html" title="TokenDef Class">
+<link rel="next" href="support/multi_pass.html" title="The multi pass iterator">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lex/reference/tokendef.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="support/multi_pass.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="Supporting libraries">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.support"></a><a class="link" href="support.html" title="Supporting libraries"> Supporting libraries</a>
+</h2></div></div></div>
+<div class="toc"><dl><dt> The multi pass iterator</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="lex/reference/tokendef.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="support/multi_pass.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/support/multi_pass.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/support/multi_pass.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,1084 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>The multi pass iterator</title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../../index.html" title="Spirit 2.1">
+<link rel="up" href="../support.html" title="Supporting libraries">
+<link rel="prev" href="../support.html" title="Supporting libraries">
+<link rel="next" href="../faq.html" title="Spirit FAQ">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../support.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../support.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../faq.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="The multi pass iterator">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="spirit.support.multi_pass"></a><a class="link" href="multi_pass.html" title="The multi pass iterator"> The multi pass iterator</a>
+</h3></div></div></div>
+
+ Backtracking in Spirit.Qi requires the use of the following
+ types of iterator: forward, bidirectional, or random access. Because of backtracking,
+ input iterators cannot be used. Therefore, the standard library classes
+ <code class="computeroutput">std::istreambuf_iterator</code> and <code class="computeroutput">std::istream_iterator</code>,
+ that fall under the category of input iterators, cannot be used. Another
+ input iterator that is of interest is one that wraps a lexer, such as LEX.
+ 
+<div class="note" title="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">
+ In general, Spirit.Qi generates recursive descent
+ parser which require backtracking parsers by design. For this reason we
+ need to provide at least forward iterators to any of Spirit.Qi's
+ API functions. This is not an absolute requirement though. In the future,
+ we shall see more deterministic parsers that require no more than 1 character
+ (token) of lookahead. Such parsers allow us to use input iterators such
+ as the <code class="computeroutput">std::istream_iterator</code> as is.
+ </td></tr>
+</table></div>
+
+ Backtracking can be implemented only if we are allowed to save an iterator
+ position, i.e. making a copy of the current iterator. Unfortunately, with
+ an input iterator, there is no way to do so, and thus input iterators will
+ not work with backtracking in Spirit.Qi. One solution
+ to this problem is to simply load all the data to be parsed into a container,
+ such as a vector or deque, and then pass the begin and end of the container
+ to Spirit.Qi. This method can be too memory intensive
+ for certain applications, which is why the <code class="computeroutput">multi_pass</code>
+ iterator was created.
+ 
+<a name="spirit.support.multi_pass.using_the_multi_pass"></a><h5>
+<a name="id879744"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.using_the_multi_pass">Using the
+ multi_pass</a>
+ </h5>
+
+ The <code class="computeroutput">multi_pass</code> iterator will
+ convert any input iterator into a forward iterator suitable for use with
+ Spirit.Qi. <code class="computeroutput">multi_pass</code>
+ will buffer data when needed and will discard the buffer when its contents
+ is not needed anymore. This happens either if only one copy of the iterator
+ exists or if no backtracking can occur.
+ 
+
+ A grammar must be designed with care if the <code class="computeroutput">multi_pass</code>
+ iterator is used. Any rule that may need to backtrack, such as one that contains
+ an alternative, will cause data to be buffered. The rules that are optimal
+ to use are repetition constructs (as kleene and plus).
+ 
+
+ Sequences of the form <code class="computeroutput">a >> b</code>
+ will buffer data as well. This is different from the behaviour of Spirit.Classic
+ but for a good reason. Sequences need to reset the current iterator to its
+ initial state if one of the components of a seqeunce fails to match. To compensate
+ for this behaviour we added functionality to the <code class="computeroutput">expect</code>
+ parsers (i.e. constructs like <code class="computeroutput">a
+ > b</code>).
+ Expectation points introduce deterministic points into the grammar ensuring
+ no backtracking can occur if they match. For this reason we clear the buffers
+ of any multi_pass iterator on each expectation point, ensuring minimal buffer
+ content even for large grammars.
+ 
+<div class="important" title="Important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+
+ If you use an error handler in conjunction with the <code class="computeroutput">expect</code>
+ parser while utilizing a <code class="computeroutput">multi_pass</code>
+ iterator and you intend to use the error handler to force a <code class="computeroutput">retry</code> or a <code class="computeroutput">fail</code>
+ (see the description of error handlers - FIXME:
+ insert link), then you need to instantiate the error handler using <code class="computeroutput">retry</code> or <code class="computeroutput">fail</code>,
+ for instance:
+
+<pre class="programlisting">rule r<iterator_type> r;
+on_error<retry>(r, std::cout << phoenix::val("Error!"));
+</pre>
+
+ If you fail to do so the resulting code will trigger an assert statement
+ at runtime.
+ 
+</td></tr>
+</table></div>
+
+ Any rule that repeats, such as kleene_star (<code class="computeroutput">*a</code>) or positive such as (<code class="computeroutput">+a</code>), will only buffer the data for the current
+ repetition.
+ 
+
+ In typical grammars, ambiguity and therefore lookahead is often localized.
+ In fact, many well designed languages are fully deterministic and require
+ no lookahead at all. Peeking at the first character from the input will immediately
+ determine the alternative branch to take. Yet, even with highly ambiguous
+ grammars, alternatives are often of the form <code class="computeroutput">*(a | b
+ | c | d)</code>.
+ The input iterator moves on and is never stuck at the beginning. Let's look
+ at a Pascal snippet for example:
+ 
+<pre class="programlisting">program =
+ programHeading >> block >> '.'
+ ;
+
+block =
+ *( labelDeclarationPart
+ | constantDefinitionPart
+ | typeDefinitionPart
+ | variableDeclarationPart
+ | procedureAndFunctionDeclarationPart
+ )
+ >> statementPart
+ ;
+</pre>
+
+ Notice the alternatives inside the Kleene star in the rule block . The rule
+ gobbles the input in a linear manner and throws away the past history with
+ each iteration. As this is fully deterministic LL(1) grammar, each failed
+ alternative only has to peek 1 character (token). The alternative that consumes
+ more than 1 character (token) is definitely a winner. After which, the Kleene
+ star moves on to the next.
+ 
+
+ Now, after the lecture on the features to be careful with when using <code class="computeroutput">multi_pass</code>, you may think that <code class="computeroutput">multi_pass</code> is way too restrictive to use.
+ That's not the case. If your grammar is deterministic, you can make use of
+ the <code class="computeroutput">flush_multi_pass</code> pseudo
+ parser in your grammar to ensure that data is not buffered when unnecessary
+ (<code class="computeroutput">flush_multi_pass</code> is available
+ from the Spirit.Qi parser Repository).
+ 
+
+ Here we present a minimal example showing a minimal use case. The <code class="computeroutput">multi_pass</code> iterator is highly configurable,
+ but the default policies have been chosen so that its easily usable with
+ input iterators such as <code class="computeroutput">std::istreambuf_iterator</code>.
+ For the complete source code of this example please refer to multi_pass.cpp.
+ 
+
+ 
+
+
+
+<pre class="programlisting">int main()
+{
+ namespace spirit = boost::spirit;
+ using spirit::ascii::space;
+ using spirit::ascii::char_;
+ using spirit::qi::double_;
+ using spirit::qi::eol;
+
+ std::ifstream in("multi_pass.txt"); // we get our input from this file
+ if (!in.is_open()) {
+ std::cout << "Could not open input file: 'multi_pass.txt'" << std::endl;
+ return -1;
+ }
+
+ typedef std::istreambuf_iterator<char> base_iterator_type;
+ spirit::multi_pass<base_iterator_type> first =
+ spirit::make_default_multi_pass(base_iterator_type(in));
+
+ std::vector<double> v;
+ bool result = spirit::qi::phrase_parse(first
+ , spirit::make_default_multi_pass(base_iterator_type())
+ , double_ >> *(',' >> double_) // recognize list of doubles
+ , space | '#' >> *(char_ - eol) >> eol // comment skipper
+ , v); // data read from file
+
+ if (!result) {
+ std::cout << "Failed parsing input file!" << std::endl;
+ return -2;
+ }
+
+ std::cout << "Successfully parsed input file!" << std::endl;
+ return 0;
+}
+</pre>
+
+ 
+
+ 
+<a name="spirit.support.multi_pass.using_the_flush_multi_pass_parser"></a><h5>
+<a name="id882666"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.using_the_flush_multi_pass_parser">Using
+ the flush_multi_pass parser</a>
+ </h5>
+
+ The Spirit Repository
+ contains the <code class="computeroutput">flush_multi_pass</code>
+ parser component. This is usable in conjunction with the <code class="computeroutput">multi_pass</code>
+ iterator to minimize the buffering. It allows to insert explicit synchronization
+ points into your grammar where it is safe to clear any stored input as it
+ is ensured that no backtracking can occur at this point anymore.
+ 
+
+ When the <code class="computeroutput">flush_multi_pass</code>
+ parser is used with <code class="computeroutput">multi_pass</code>,
+ it will call <code class="computeroutput">multi_pass::clear_queue()</code>.
+ This will cause any buffered data to be erased. This also will invalidate
+ all other copies of multi_pass and they should not be used. If they are,
+ an <code class="computeroutput">boost::illegal_backtracking</code> exception will be
+ thrown.
+ 
+<a name="spirit.support.multi_pass.the_multi_pass_policies"></a><h5>
+<a name="id882760"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.the_multi_pass_policies">The multi_pass
+ Policies</a>
+ </h5>
+
+ The <code class="computeroutput">multi_pass</code> iterator is
+ a templated class configurable using policies. The description of <code class="computeroutput">multi_pass</code> above is how it was originally
+ implemented (before it used policies), and is the default configuration now.
+ But, <code class="computeroutput">multi_pass</code> is capable
+ of much more. Because of the open-ended nature of policies, you can write
+ your own policy to make <code class="computeroutput">multi_pass</code>
+ behave in a way that we never before imagined.
+ 
+
+ The multi_pass class has two template parameters:
+ 
+<div class="variablelist" title="The multi_pass template parameters">
+The multi_pass template parameters
+<dl>
+<dt>Input</dt>
+<dd>
+ The type multi_pass uses to acquire it's input. This is typically an
+ input iterator, or functor.
+ </dd>
+<dt>Policies</dt>
+<dd>
+ The combined policies to use to create an instance of a multi_pass iterator.
+ This combined policy type is described below
+ </dd>
+</dl>
+</div>
+
+ It is possible to implement all of the required functionality of the combinded
+ policy in a single class. But it has shown to be more convenient to split
+ this into four different groups of functions, i.e. four separate, but well
+ coordinated policies. For this reason the <code class="computeroutput">multi_pass</code>
+ library implements a template <code class="computeroutput">iterator_policies::default_policy</code>
+ allowing to combine several different policies, each implementing one of
+ the functionality groups:
+ 
+<div class="table">
+<a name="id882866"></a>Table 11. Policies needed for default_policy template
+<div class="table-contents"><table class="table" summary="Policies needed for default_policy template">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Template Parameter
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">OwnershipPolicy</code>
+ 
+ </td>
+<td>
+ 
+ This policy determines how <code class="computeroutput">multi_pass</code>
+ deals with it's shared components.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">CheckingPolicy</code>
+ 
+ </td>
+<td>
+ 
+ This policy determines how checking for invalid iterators is done.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">InputPolicy</code>
+ 
+ </td>
+<td>
+ 
+ A class that defines how <code class="computeroutput">multi_pass</code>
+ acquires its input. The <code class="computeroutput">InputPolicy</code>
+ is parameterized by the <code class="computeroutput">Input</code>
+ template parameter to the <code class="computeroutput">multi_pass</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">StoragePolicy</code>
+ 
+ </td>
+<td>
+ 
+ The buffering scheme used by <code class="computeroutput">multi_pass</code>
+ is determined and managed by the StoragePolicy.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ 
+ The <code class="computeroutput">multi_pass</code> library contains
+ several predefined policy implementations for each of the policy types as
+ described above. First we will describe those predefined types. Afterwards
+ we will give some guidelines how you can write your own policy implementations.
+ 
+<a name="spirit.support.multi_pass.predefined_policies"></a><h5>
+<a name="id883058"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.predefined_policies">Predefined
+ policies</a>
+ </h5>
+
+ All predefined <code class="computeroutput">multi_pass</code>
+ policies are defined in the namespace <code class="computeroutput">boost::spirit::iterator_policies</code>.
+ 
+<div class="table">
+<a name="id883100"></a>Table 12. Predefined policy classes
+<div class="table-contents"><table class="table" summary="Predefined policy classes">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Class name
+ 
+ </th>
+<th>
+ 
+ Description
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ InputPolicy classes
+ 
+ </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">input_iterator</code>
+ 
+ </td>
+<td>
+ 
+ This policy directs <code class="computeroutput">multi_pass</code>
+ to read from an input iterator of type <code class="computeroutput">Input</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">lex_input</code>
+ 
+ </td>
+<td>
+ 
+ This policy obtains it's input by calling yylex(), which would typically
+ be provided by a scanner generated by Flex.
+ If you use this policy your code must link against a Flex
+ generated scanner.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">functor_input</code>
+ 
+ </td>
+<td>
+ 
+ This input policy obtains it's data by calling a functor of type <code class="computeroutput">Input</code>. The functor must meet certain
+ requirements. It must have a typedef called <code class="computeroutput">result_type</code>
+ which should be the type returned from <code class="computeroutput">operator()</code>. Also, since an input policy needs
+ a way to determine when the end of input has been reached, the functor
+ must contain a static variable named <code class="computeroutput">eof</code>
+ which is comparable to a variable of <code class="computeroutput">result_type</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">split_functor_input</code>
+ 
+ </td>
+<td>
+ 
+ This is essentially the same as the <code class="computeroutput">functor_input</code>
+ policy except that the (user supplied) funtion object exposes separate
+ <code class="computeroutput">unique</code> and <code class="computeroutput">shared</code> sub classes, allowing to integrate
+ the functors unique data members with the <code class="computeroutput">multi_pass</code> data items held by each
+ instance and its shared data members will be integrated
+ with the <code class="computeroutput">multi_pass</code>
+ members shared by all copies.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ OwnershipPolicy classes
+ 
+ </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">ref_counted</code>
+ 
+ </td>
+<td>
+ 
+ This class uses a reference counting scheme. The <code class="computeroutput">multi_pass</code>
+ will delete it's shared components when the count reaches zero.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">first_owner</code>
+ 
+ </td>
+<td>
+ 
+ When this policy is used, the first <code class="computeroutput">multi_pass</code>
+ created will be the one that deletes the shared data. Each copy will
+ not take ownership of the shared data. This works well for Spirit,
+ since no dynamic allocation of iterators is done. All copies are made
+ on the stack, so the original iterator has the longest lifespan.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ CheckingPolicy classes
+ 
+ </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">no_check</code>
+ 
+ </td>
+<td>
+ 
+ This policy does no checking at all.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">buf_id_check</code>
+ 
+ </td>
+<td>
+ 
+ This policy keeps around a buffer id, or a buffer age. Every time
+ <code class="computeroutput">clear_queue()</code>
+ is called on a <code class="computeroutput">multi_pass</code>
+ iterator, it is possible that all other iterators become invalid. When
+ <code class="computeroutput">clear_queue()</code>
+ is called, <code class="computeroutput">buf_id_check</code>
+ increments the buffer id. When an iterator is dereferenced, this policy
+ checks that the buffer id of the iterator matches the shared buffer
+ id. This policy is most effective when used together with the <code class="computeroutput">split_std_deque</code> StoragePolicy. It
+ should not be used with the <code class="computeroutput">fixed_size_queue</code>
+ StoragePolicy, because it will not detect iterator dereferences that
+ are out of range.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ full_check
+ 
+ </td>
+<td>
+ 
+ This policy has not been implemented yet. When it is, it will keep
+ track of all iterators and make sure that they are all valid. This
+ will be mostly useful for debugging purposes as it will incur significant
+ overhead.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ StoragePolicy classes
+ 
+ </td>
+<td class="auto-generated"> </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">split_std_deque</code>
+ 
+ </td>
+<td>
+ 
+ Despite its name this policy keeps all buffered data in a <code class="computeroutput">std::vector</code>. All data is stored as long
+ as there is more than one iterator. Once the iterator count goes down
+ to one, and the queue is no longer needed, it is cleared, freeing up
+ memory. The queue can also be forcibly cleared by calling <code class="computeroutput">multi_pass::clear_queue()</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">fixed_size_queue<N></code>
+ 
+ </td>
+<td>
+ 
+ This policy keeps a circular buffer that is size <code class="computeroutput">N+1</code> and
+ stores <code class="computeroutput">N</code> elements.
+ <code class="computeroutput">fixed_size_queue</code> is
+ a template with a <code class="computeroutput">std::size_t</code>
+ parameter that specified the queue size. It is your responsibility
+ to ensure that <code class="computeroutput">N</code> is
+ big enough for your parser. Whenever the foremost iterator is incremented,
+ the last character of the buffer is automatically erased. Currently
+ there is no way to tell if an iterator is trailing too far behind and
+ has become invalid. No dynamic allocation is done by this policy during
+ normal iterator operation, only on initial construction. The memory
+ usage of this <code class="computeroutput">StoragePolicy</code>
+ is set at <code class="computeroutput">N+1</code> bytes, unlike <code class="computeroutput">split_std_deque</code>,
+ which is unbounded.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+ <a name="spirit.support.multi_pass.combinations__how_to_specify_your_own_custom_multi_pass"></a><h5>
+<a name="id885154"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.combinations__how_to_specify_your_own_custom_multi_pass">Combinations:
+ How to specify your own custom multi_pass</a>
+ </h5>
+
+ The beauty of policy based designs is that you can mix and match policies
+ to create your own custom iterator by selecting the policies you want. Here's
+ an example of how to specify a custom <code class="computeroutput">multi_pass</code>
+ that wraps an <code class="computeroutput">std::istream_iterator<char></code>,
+ and is slightly more efficient than the default <code class="computeroutput">multi_pass</code>
+ (as generated by the <code class="computeroutput">make_default_multi_pass()</code> API function) because it uses the <code class="computeroutput">iterator_policies::first_owner</code> OwnershipPolicy and the <code class="computeroutput">iterator_policies::no_check</code> CheckingPolicy:
+ 
+<pre class="programlisting">typedef multi_pass<
+ std::istream_iterator<char>
+ , iterator_policies::default_policy<
+ iterator_policies::first_owner
+ , iterator_policies::no_check
+ , iterator_policies::input_iterator
+ , iterator_policies::split_std_deque
+ >
+> first_owner_multi_pass_type;
+</pre>
+
+ The default template parameters for <code class="computeroutput">iterator_policies::default_policy</code>
+ are:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+<code class="computeroutput">iterator_policies::ref_counted</code> OwnershipPolicy
+ </li>
+<li class="listitem">
+<code class="computeroutput">iterator_policies::no_check</code> CheckingPolicy, if <code class="computeroutput">BOOST_SPIRIT_DEBUG</code> is defined: <code class="computeroutput">iterator_policies::buf_id_check</code> CheckingPolicy
+ </li>
+<li class="listitem">
+<code class="computeroutput">iterator_policies::input_iterator</code> InputPolicy, and
+ </li>
+<li class="listitem">
+<code class="computeroutput">iterator_policies::split_std_deque</code> StoragePolicy.
+ </li>
+</ul></div>
+
+ So if you use <code class="computeroutput">multi_pass<std::istream_iterator<char>
+ ></code> you will get those pre-defined
+ behaviors while wrapping an <code class="computeroutput">std::istream_iterator<char></code>.
+ 
+<a name="spirit.support.multi_pass.dealing_with_constant_look_ahead"></a><h5>
+<a name="id885576"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.dealing_with_constant_look_ahead">Dealing
+ with constant look ahead</a>
+ </h5>
+
+ There is one other pre-defined class called <code class="computeroutput">look_ahead</code>.
+ The class <code class="computeroutput">look_ahead</code> is another
+ predefine <code class="computeroutput">multi_pass</code> iterator
+ type. It has two template parameters: <code class="computeroutput">Input</code>,
+ the type of the input iterator to wrap, and a <code class="computeroutput">std::size_t N</code>, which specifies the size of the buffer
+ to the <code class="computeroutput">fixed_size_queue</code> policy.
+ While the default multi_pass configuration is designed for safey, <code class="computeroutput">look_ahead</code> is designed for speed. <code class="computeroutput">look_ahead</code> is derived from a multi_pass
+ with the following policies: <code class="computeroutput">input_iterator</code>
+ InputPolicy, <code class="computeroutput">first_owner</code>
+ OwnershipPolicy, <code class="computeroutput">no_check</code>
+ CheckingPolicy, and <code class="computeroutput">fixed_size_queue<N></code>
+ StoragePolicy.
+ 
+<a name="spirit.support.multi_pass.how_to_write_a_functor_for_use_with_the__code__phrase_role__identifier__functor_input__phrase___code__inputpolicy"></a><h5>
+<a name="id885708"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.how_to_write_a_functor_for_use_with_the__code__phrase_role__identifier__functor_input__phrase___code__inputpolicy">How
+ to write a functor for use with the <code class="computeroutput">functor_input</code>
+ InputPolicy</a>
+ </h5>
+
+ If you want to use the <code class="computeroutput">functor_input</code>
+ InputPolicy, you can write your own function object that will supply the
+ input to <code class="computeroutput">multi_pass</code>. The
+ function object must satisfy several requirements. It must have a typedef
+ <code class="computeroutput">result_type</code> which specifies
+ the return type of its <code class="computeroutput">operator()</code>. This is standard practice in the STL.
+ Also, it must supply a static variable called eof which is compared against
+ to know whether the input has reached the end. Last but not least the function
+ object must be default constructible. Here is an example:
+ 
+<pre class="programlisting">// define the function object
+class iterate_a2m
+{
+public:
+ typedef char result_type;
+
+ iterate_a2m() : c('A') {}
+ iterate_a2m(char c) : c_(c) {}
+
+ result_type operator()() const
+ {
+ if (c_ == 'M')
+ return eof;
+ return c_++;
+ }
+
+ static result_type eof;
+
+private:
+ char c_;
+};
+
+iterate_a2m::result_type iterate_a2m::eof = iterate_a2m::result_type('\0');
+
+// create two iterators using the define function object, one of which is
+// an end iterator
+typedef multi_pass<my_functor
+ , iterator_policies::functor_input
+ , iterator_policies::first_owner
+ , iterator_policies::no_check
+ , iterator_policies::split_std_deque>
+functor_multi_pass_type;
+
+functor_multi_pass_type first = functor_multi_pass_t(my_functor());
+functor_multi_pass_type last;
+
+// use the iterators: this will print "ABCDEFGHIJKL"
+while (first != last) {
+ std::cout << *first;
+ ++first;
+}
+</pre>
+<a name="spirit.support.multi_pass.how_to_write_policies_for_use_with_multi_pass"></a><h5>
+<a name="id886295"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.how_to_write_policies_for_use_with_multi_pass">How
+ to write policies for use with multi_pass</a>
+ </h5>
+
+ All policies to be used with the <code class="computeroutput">default_policy</code>
+ template need to have two embedded classes: <code class="computeroutput">unique</code>
+ and <code class="computeroutput">shared</code>. The <code class="computeroutput">unique</code> class needs to implement all required
+ functions for a particular policy type. In addition it may hold all member
+ data items being unique for a particular instance of
+ a <code class="computeroutput">multi_pass</code> (hence the name).
+ The <code class="computeroutput">shared</code> class does not
+ expose any member functions (except sometimes a constructor), but it may
+ hold all member data items to be shared between all
+ copies of a particular <code class="computeroutput">multi_pass</code>.
+ 
+<a name="spirit.support.multi_pass.inputpolicy"></a><h5>
+<a name="id886369"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.inputpolicy">InputPolicy</a>
+ </h5>
+
+ An <code class="computeroutput">InputPolicy</code> must have
+ the following interface:
+ 
+<pre class="programlisting">struct input_policy
+{
+ // Input is the same type used as the first template parameter
+ // while instantiating the multi_pass
+ template <typename Input>
+ struct unique
+ {
+ // these typedef's will be exposed as the multi_pass iterator
+ // properties
+ typedef __unspecified_type__ value_type;
+ typedef __unspecified_type__ difference_type;
+ typedef __unspecified_type__ distance_type;
+ typedef __unspecified_type__ pointer;
+ typedef __unspecified_type__ reference;
+
+ unique() {}
+ explicit unique(Input) {}
+
+ // destroy is called whenever the last copy of a multi_pass is
+ // destructed (ownership_policy::release() returned true)
+ //
+ // mp: is a reference to the whole multi_pass instance
+ template <typename MultiPass>
+ static void destroy(MultiPass& mp);
+
+ // swap is called by multi_pass::swap()
+ void swap(unique&);
+
+ // advance_input is called whenever the next input character/token
+ // should be fetched.
+ //
+ // mp: is a reference to the whole multi_pass instance
+ // t: is a reference where the next character/token should be
+ // stored
+ //
+ // This method is expected to return the parameter t
+ template <typename MultiPass>
+ static value_type& advance_input(MultiPass& mp, value_type& t);
+
+ // input_at_eof is called to test whether this instance is a
+ // end of input iterator.
+ //
+ // mp: is a reference to the whole multi_pass instance
+ // t: is the current token
+ //
+ // This method is expected to return true if the end of input is
+ // reached. It is often used in the implementation of the function
+ // storage_policy::is_eof.
+ template <typename MultiPass>
+ static bool input_at_eof(MultiPass const& mp, value_type const& t);
+
+ // input_is_valid is called to verify if the parameter t represents
+ // a valid input character/token
+ //
+ // mp: is a reference to the whole multi_pass instance
+ // t: is the character/token to test for validity
+ //
+ // This method is expected to return true if the parameter t
+ // represents a valid character/token.
+ template <typename MultiPass>
+ static bool input_is_valid(MultiPass const& mp, value_type const& t);
+ };
+
+ // Input is the same type used as the first template parameter
+ // while instantiating the multi_pass
+ template <typename Input>
+ struct shared
+ {
+ explicit shared(Input) {}
+ };
+};
+</pre>
+
+ It is possible to derive the struct <code class="computeroutput">unique</code>
+ from the type <code class="computeroutput">boost::spirit::detail::default_input_policy</code>. This type implements
+ a minimal sufficient interface for some of the required functions, simplifying
+ the task of writing a new input policy.
+ 
+
+ This class may implement a function <code class="computeroutput">destroy()</code> being called during destruction of the
+ last copy of a <code class="computeroutput">multi_pass</code>.
+ This function should be used to free any of the shared data items the policy
+ might have allocated during construction of its <code class="computeroutput">shared</code>
+ part. Because of the way <code class="computeroutput">multi_pass</code>
+ is implemented any allocated data members in <code class="computeroutput">shared</code>
+ should not be deep copied in a copy
+ constructor of <code class="computeroutput">shared</code>.
+ 
+<a name="spirit.support.multi_pass.ownershippolicy"></a><h5>
+<a name="id887459"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.ownershippolicy">OwnershipPolicy</a>
+ </h5>
+
+ The <code class="computeroutput">OwnershipPolicy</code> must
+ have the following interface:
+ 
+<pre class="programlisting">struct ownership_policy
+{
+ struct unique
+ {
+ // destroy is called whenever the last copy of a multi_pass is
+ // destructed (ownership_policy::release() returned true)
+ //
+ // mp: is a reference to the whole multi_pass instance
+ template <typename MultiPass>
+ static void destroy(MultiPass& mp);
+
+ // swap is called by multi_pass::swap()
+ void swap(unique&);
+
+ // clone is called whenever a multi_pass is copied
+ //
+ // mp: is a reference to the whole multi_pass instance
+ template <typename MultiPass>
+ static void clone(MultiPass& mp);
+
+ // release is called whenever a multi_pass is destroyed
+ //
+ // mp: is a reference to the whole multi_pass instance
+ //
+ // The method is expected to return true if the destructed
+ // instance is the last copy of a particular multi_pass.
+ template <typename MultiPass>
+ static bool release(MultiPass& mp);
+
+ // is_unique is called to test whether this instance is the only
+ // existing copy of a particular multi_pass
+ //
+ // mp: is a reference to the whole multi_pass instance
+ //
+ // The method is expected to return true if this instance is unique
+ // (no other copies of this multi_pass exist).
+ template <typename MultiPass>
+ static bool is_unique(MultiPass const& mp);
+ };
+
+ struct shared {};
+};
+</pre>
+
+ It is possible to derive the struct <code class="computeroutput">unique</code>
+ from the type <code class="computeroutput">boost::spirit::detail::default_ownership_policy</code>. This type implements
+ a minimal sufficient interface for some of the required functions, simplifying
+ the task of writing a new ownership policy.
+ 
+
+ This class may implement a function <code class="computeroutput">destroy()</code> being called during destruction of the
+ last copy of a <code class="computeroutput">multi_pass</code>.
+ This function should be used to free any of the shared data items the policy
+ might have allocated during construction of its <code class="computeroutput">shared</code>
+ part. Because of the way <code class="computeroutput">multi_pass</code>
+ is implemented any allocated data members in <code class="computeroutput">shared</code>
+ should not be deep copied in a copy
+ constructor of <code class="computeroutput">shared</code>.
+ 
+<a name="spirit.support.multi_pass.checkingpolicy"></a><h5>
+<a name="id887993"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.checkingpolicy">CheckingPolicy</a>
+ </h5>
+
+ The <code class="computeroutput">CheckingPolicy</code> must have
+ the following interface:
+ 
+<pre class="programlisting">struct checking_policy
+{
+ struct unique
+ {
+ // swap is called by multi_pass::swap()
+ void swap(unique&);
+
+ // destroy is called whenever the last copy of a multi_pass is
+ // destructed (ownership_policy::release() returned true)
+ //
+ // mp: is a reference to the whole multi_pass instance
+ template <typename MultiPass>
+ static void destroy(MultiPass& mp);
+
+ // check is called before the multi_pass is dereferenced or
+ // incremented.
+ //
+ // mp: is a reference to the whole multi_pass instance
+ //
+ // This method is expected to make sure the multi_pass instance is
+ // still valid. If it is invalid an exception should be thrown.
+ template <typename MultiPass>
+ static void check(MultiPass const& mp);
+
+ // clear_queue is called whenever the function
+ // multi_pass::clear_queue is called on this instance
+ //
+ // mp: is a reference to the whole multi_pass instance
+ template <typename MultiPass>
+ static void clear_queue(MultiPass& mp);
+ };
+
+ struct shared {};
+};
+</pre>
+
+ It is possible to derive the struct <code class="computeroutput">unique</code>
+ from the type <code class="computeroutput">boost::spirit::detail::default_checking_policy</code>. This type implements
+ a minimal sufficient interface for some of the required functions, simplifying
+ the task of writing a new checking policy.
+ 
+
+ This class may implement a function <code class="computeroutput">destroy()</code> being called during destruction of the
+ last copy of a <code class="computeroutput">multi_pass</code>.
+ This function should be used to free any of the shared data items the policy
+ might have allocated during construction of its <code class="computeroutput">shared</code>
+ part. Because of the way <code class="computeroutput">multi_pass</code>
+ is implemented any allocated data members in <code class="computeroutput">shared</code>
+ should not be deep copied in a copy
+ constructor of <code class="computeroutput">shared</code>.
+ 
+<a name="spirit.support.multi_pass.storagepolicy"></a><h5>
+<a name="id888444"></a>
+ <a class="link" href="multi_pass.html#spirit.support.multi_pass.storagepolicy">StoragePolicy</a>
+ </h5>
+
+ A <code class="computeroutput">StoragePolicy</code> must have
+ the following interface:
+ 
+<pre class="programlisting">struct storage_policy
+{
+ // Value is the same type as typename MultiPass::value_type
+ template <typename Value>
+ struct unique
+ {
+ // destroy is called whenever the last copy of a multi_pass is
+ // destructed (ownership_policy::release() returned true)
+ //
+ // mp: is a reference to the whole multi_pass instance
+ template <typename MultiPass>
+ static void destroy(MultiPass& mp);
+
+ // swap is called by multi_pass::swap()
+ void swap(unique&);
+
+ // dereference is called whenever multi_pass::operator*() is invoked
+ //
+ // mp: is a reference to the whole multi_pass instance
+ //
+ // This function is expected to return a reference to the current
+ // character/token.
+ template <typename MultiPass>
+ static typename MultiPass::reference dereference(MultiPass const& mp);
+
+ // increment is called whenever multi_pass::operator++ is invoked
+ //
+ // mp: is a reference to the whole multi_pass instance
+ template <typename MultiPass>
+ static void increment(MultiPass& mp);
+
+ //
+ // mp: is a reference to the whole multi_pass instance
+ template <typename MultiPass>
+ static void clear_queue(MultiPass& mp);
+
+ // is_eof is called to test whether this instance is a end of input
+ // iterator.
+ //
+ // mp: is a reference to the whole multi_pass instance
+ //
+ // This method is expected to return true if the end of input is
+ // reached.
+ template <typename MultiPass>
+ static bool is_eof(MultiPass const& mp);
+
+ // less_than is called whenever multi_pass::operator==() is invoked
+ //
+ // mp: is a reference to the whole multi_pass instance
+ // rhs: is the multi_pass reference this instance is compared
+ // to
+ //
+ // This function is expected to return true if the current instance
+ // is eual to the right hand side multi_pass instance
+ template <typename MultiPass>
+ static bool equal_to(MultiPass const& mp, MultiPass const& rhs);
+
+ // less_than is called whenever multi_pass::operator<() is invoked
+ //
+ // mp: is a reference to the whole multi_pass instance
+ // rhs: is the multi_pass reference this instance is compared
+ // to
+ //
+ // This function is expected to return true if the current instance
+ // is less than the right hand side multi_pass instance
+ template <typename MultiPass>
+ static bool less_than(MultiPass const& mp, MultiPass const& rhs);
+ };
+
+ // Value is the same type as typename MultiPass::value_type
+ template <typename Value>
+ struct shared {};
+};
+</pre>
+
+ It is possible to derive the struct <code class="computeroutput">unique</code>
+ from the type <code class="computeroutput">boost::spirit::detail::default_storage_policy</code>. This type implements
+ a minimal sufficient interface for some of the required functions, simplifying
+ the task of writing a new storage policy.
+ 
+
+ This class may implement a function <code class="computeroutput">destroy()</code> being called during destruction of the
+ last copy of a <code class="computeroutput">multi_pass</code>.
+ This function should be used to free any of the shared data items the policy
+ might have allocated during construction of its <code class="computeroutput">shared</code>
+ part. Because of the way <code class="computeroutput">multi_pass</code>
+ is implemented any allocated data members in <code class="computeroutput">shared</code>
+ should not be deep copied in a copy
+ constructor of <code class="computeroutput">shared</code>.
+ 
+
+ Generally, a <code class="computeroutput">StoragePolicy</code>
+ is the trickiest policy to implement. You should study and understand the
+ existing <code class="computeroutput">StoragePolicy</code> classes
+ before you try and write your own.
+ 
+</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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../support.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../support.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../faq.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: branches/release/libs/spirit/doc/html/spirit/what_s_new.html
==============================================================================
--- (empty file)
+++ branches/release/libs/spirit/doc/html/spirit/what_s_new.html 2009-09-14 12:51:35 EDT (Mon, 14 Sep 2009)
@@ -0,0 +1,314 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>What's New</title>
+<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
+<link rel="home" href="../index.html" title="Spirit 2.1">
+<link rel="up" href="../index.html" title="Spirit 2.1">
+<link rel="prev" href="preface.html" title="Preface">
+<link rel="next" href="introduction.html" title="Introduction">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="preface.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="introduction.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" title="What's New">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="spirit.what_s_new"></a><a class="link" href="what_s_new.html" title="What's New">What's New</a>
+</h2></div></div></div>
+<a name="spirit.what_s_new.spirit_classic"></a><h4>
+<a name="id586602"></a>
+ <a class="link" href="what_s_new.html#spirit.what_s_new.spirit_classic">Spirit Classic</a>
+ </h4>
+
+ The Spirit V1.8.x code base has been integrated with Spirit V2. It is now called
+ Spirit.Classic.
+ Since the directory structure has changed (the Spirit Classic headers are now
+ moved to the $BOOST_ROOT/boost/spirit/home/classic directory), we created forwarding headers allowing existing applications
+ to compile without any change. However, these forwarding headers are deprecated,
+ which will result in corresponding warnings generated for each of the headers
+ starting with Boost V1.38. The forwarding headers are expected to be removed
+ in the future.
+ 
+
+ The recommended way of using Spirit Classic now is to include header files
+ from the directory $BOOST_ROOT/boost/spirit/include. All Spirit Classic headers in this directory have a 'classic_'
+ prefixed to their name. For example the include
+ 
+<pre class="programlisting">#include <boost/spirit/core/core.hpp>
+</pre>
+
+ now should be written as:
+ 
+<pre class="programlisting">#include <boost/spirit/include/classic_core.hpp>
+</pre>
+
+ To avoid namespace conflicts with the new Spirit V2 library we moved Spirit
+ Classic into the namespace <code class="computeroutput">boost::spirit::classic</code>.
+ All references to the former namespace <code class="computeroutput">boost::spirit</code>
+ need to be adjusted as soon as the header names are corrected as described
+ above. As an alternative you can define the preprocessor constant <code class="computeroutput">BOOST_SPIRIT_USE_OLD_NAMESPACE</code>, which will
+ force the Spirit Classic code to be in the namespace <code class="computeroutput">boost::spirit</code>
+ as before. This is not recommended, though, as it may result in naming clashes.
+ 
+
+ The change of the namespace will be automatically deactivated whenever the
+ deprecated include files are being used. This ensures full backwards compatibility
+ for existing applications.
+ 
+<a name="spirit.what_s_new.spirit_v2_1"></a><h4>
+<a name="id586795"></a>
+ <a class="link" href="what_s_new.html#spirit.what_s_new.spirit_v2_1">Spirit V2.1</a>
+ </h4>
+<a name="spirit.what_s_new.what_s_changed_in__emphasis_spirit_qi__emphasis__and__emphasis_spirit_karma__emphasis__from_v2_0__boost_v1_37_0__to_2_x__boost_v1_41_0_"></a><h4>
+<a name="id586808"></a>
+ <a class="link" href="what_s_new.html#spirit.what_s_new.what_s_changed_in__emphasis_spirit_qi__emphasis__and__emphasis_spirit_karma__emphasis__from_v2_0__boost_v1_37_0__to_2_x__boost_v1_41_0_">What's
+ changed in Spirit.Qi and Spirit.Karma
+ from V2.0 (Boost V1.37.0) to 2.x (Boost V1.41.0)</a>
+ </h4>
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+Spirit is now based on
+ the newest version of Boost.Proto
+</li>
+<li class="listitem">
+<code class="computeroutput">qi::phrase_parse</code>, <code class="computeroutput">qi::phrase_format</code>
+ now post-skip by default.
+ </li>
+<li class="listitem">
+<code class="computeroutput">karma::generate_delimited</code> and <code class="computeroutput">karma::format_delimited</code>
+ now don't do pre- delimiting by default.
+ </li>
+<li class="listitem">
+ Changed parameter sequence of <code class="computeroutput">qi::phrase_parse</code>,
+ <code class="computeroutput">qi::phrase_match</code>, <code class="computeroutput">karma::generate_delimited</code>,
+ and <code class="computeroutput">match_delimited</code>. The
+ attribute is now always the last parameter.
+ </li>
+<li class="listitem">
+ Added new overloads of those functions allowing to explicitly specify the
+ post-skipping and pre-delimiting behavior.
+ </li>
+<li class="listitem">
+ Added multi attribute API functions
+ </li>
+<li class="listitem">
+ Removed <code class="computeroutput">grammar_def<></code>
+</li>
+<li class="listitem">
+ Removed functions <code class="computeroutput">make_parser()</code> and <code class="computeroutput">make_generator()</code>
+</li>
+<li class="listitem">
+ Removed <code class="computeroutput">qi::none</code> and <code class="computeroutput">karma::none</code>
+</li>
+<li class="listitem">
+ Sequences and lists now accept a standard container as their attribute
+ </li>
+<li class="listitem">
+ The string placeholder terminal now can take other strings as its parameter
+ (i.e. std::string)
+ </li>
+<li class="listitem">
+ All terminals taking literals now accept a (lazy) function object as well
+ </li>
+<li class="listitem">
+ All placeholders for terminals and directives (such as <code class="computeroutput">int_</code>,
+ <code class="computeroutput">double_</code>, <code class="computeroutput">verbatim</code>,
+ etc.) were previously defined in the namespace <code class="computeroutput">boost::spirit</code>
+ only. Now these are additionally imported into the namespaces <code class="computeroutput">spirit::qi</code>, <code class="computeroutput">spirit::karma</code>,
+ and <code class="computeroutput">spirit::lex</code> (if they are supported by the corresponding
+ sub-library).
+ </li>
+<li class="listitem">
+ The terminal placeholders <code class="computeroutput">char_</code>
+ and <code class="computeroutput">string</code> are not defined
+ in the namespace <code class="computeroutput">boost::spirit</code> anymore as they have been moved
+ to the character set namespaces, allowing to do proper character set handling
+ based on the used namespace (as <code class="computeroutput">spirit::ascii</code>,
+ etc.)
+ </li>
+<li class="listitem">
+ The <code class="computeroutput">uint</code>, <code class="computeroutput">ushort</code>,
+ <code class="computeroutput">ulong</code>, and <code class="computeroutput">byte</code> terminal placeholders have been renamed
+ to <code class="computeroutput">uint_</code>, <code class="computeroutput">ushort_</code>,
+ <code class="computeroutput">ulong_</code>, and <code class="computeroutput">byte_</code>.
+ </li>
+<li class="listitem">
+<code class="computeroutput">qi::skip[]</code>
+ now re-enables outer skipper if used inside <code class="computeroutput">lexeme[]</code>
+</li>
+<li class="listitem">
+ Added <code class="computeroutput">karma::maxwidth[]</code>
+ directive
+ </li>
+<li class="listitem">
+ Added <code class="computeroutput">karma::omit[]</code>
+ directive (see <a class="link" href="karma/reference/directive/omit.html" title="Consume Attribute (omit[])"><code class="computeroutput">omit[a]</code></a>)
+ </li>
+<li class="listitem">
+ Added <code class="computeroutput">karma::buffer[]</code>
+ directive (see <a class="link" href="karma/reference/directive/buffer.html" title="Temporary Output Buffering (buffer[])"><code class="computeroutput">buffer[a]</code></a>)
+ </li>
+<li class="listitem">
+<code class="computeroutput">karma::delimit[]</code>
+ now re-enables outer delimiter if used inside <code class="computeroutput">verbatim[]</code>
+</li>
+<li class="listitem">
+ karma: added and-predicate (<code class="computeroutput">operator&()</code>) and not-predicate (<code class="computeroutput">operator!()</code>)
+ </li>
+<li class="listitem">
+ karma: changed semantics of <code class="computeroutput">char_()</code>, <code class="computeroutput">string()</code>, <code class="computeroutput">int_()</code> et.al., and <code class="computeroutput">double_()</code> et.al.: all of these generators now always
+ expose an attribute. If they do not have an associate attribute, they generate
+ their immediate literal. If they have an associated attribute, the generators
+ first test if the attribute value is equal to the immediate literal. They
+ fail not while generating anything if those are not equal. Otherwise they
+ generate their immediate literal. For more information see for instance
+ <a class="link" href="karma/reference/numeric/signed_int.html" title="Signed Integer Number Generators (int_, etc.)"><code class="computeroutput">int_</code></a>.
+ </li>
+<li class="listitem">
+<code class="computeroutput">karma::lit()</code> can
+ now be used to generate integer and floating point numbers
+ </li>
+<li class="listitem">
+<code class="computeroutput">qi::rule</code> and <code class="computeroutput">karma::rule</code>
+ now can be directly initialzed using their copy constructor. I.e. this works
+ now: <code class="computeroutput">qi::rule<...>
+ r = ...some parser...;</code>.The
+ semantics of this initalization are equivalent to initializing them using
+ <code class="computeroutput">operator%=()</code>
+ (auto attribute propagation is enabled).
+ </li>
+</ul></div>
+<a name="spirit.what_s_new.what_s_changed_in__emphasis_spirit_lex__emphasis__from_v2_0__boost_v1_37_0__to_2_x__boost_v1_41_0_"></a><h4>
+<a name="id590381"></a>
+ <a class="link" href="what_s_new.html#spirit.what_s_new.what_s_changed_in__emphasis_spirit_lex__emphasis__from_v2_0__boost_v1_37_0__to_2_x__boost_v1_41_0_">What's
+ changed in Spirit.Lex from V2.0 (Boost V1.37.0) to 2.x
+ (Boost V1.41.0)</a>
+ </h4>
+
+ Here is a list of changes in Spirit.Lex since version
+ 2.0. Spirit.Lex 2.x is a complete rewrite of the Spirit.Lex
+ distributed with Boost V1.37. As all parts of the Spirit
+ library it is usable either standalone or in conjunction with the other parts.
+ Spirit.Lex now uses the infrastructure provided by Spirit version 2.1.
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The lex::lexer_def class has been renamed to lex::lexer, while the original
+ class lex::lexer does not exist anymore. This simplifies the creation of
+ lexers.
+ </li>
+<li class="listitem">
+ The lex::lexer class does not have the function <code class="computeroutput">def(Self&
+ self)</code>
+ anymore, token definitions can be added to the lexer at any time, usually
+ in the constructor of the user defined lexer class:
+<pre class="programlisting">template <typename Lexer>
+struct example_tokens : lex::lexer<Lexer>
+{
+ example_lexer()
+ {
+ // your token definitions here
+ this->self = ...
+ }
+};
+</pre>
+</li>
+<li class="listitem">
+ The new lexer class now can be directly used, their is no need anymore to
+ wrap it using the <code class="computeroutput">make_lexer()</code> template as before. Therefore the function
+ <code class="computeroutput">make_lexer()</code>
+ has been removed.
+ </li>
+<li class="listitem">
+ The <code class="computeroutput">lex::tokenize_and_parse()</code>
+ and <code class="computeroutput">lex::tokenize_and_phrase_parse()</code>
+ functions have been changed to match the parameter sequence as implemented
+ by the <code class="computeroutput">qi::parse()</code>
+ and <code class="computeroutput">qi::phrase_parse()</code>
+ functions. Both take a possibly arbitrary number of attribute arguments as
+ its last parameters (well, the number of attributes is limited by the macro
+ <code class="computeroutput">SPIRIT_ARGUMENTS_LIMIT</code>, which
+ defaults to <code class="computeroutput">PHOENIX_LIMIT</code>).
+ </li>
+<li class="listitem">
+ The <code class="computeroutput">lex::lexertl_lexer</code>, and <code class="computeroutput">lex::lexertl_token</code>
+ classes have been moved to the <code class="computeroutput">lex::lexertl</code>
+ namespace and the names have been changed to <code class="computeroutput">lex::lexertl::lexer</code>,
+ <code class="computeroutput">lex::lexertl::token</code> (the same applies to the <code class="computeroutput">lex::lexert_actor_lexer</code>,
+ and the <code class="computeroutput">static_lexertl_*</code>
+ family of types).
+ </li>
+<li class="listitem">
+ The class <code class="computeroutput">lex::lexertl_token_set</code> has been removed alltogether
+ as its complete functionality is available from the lexer class.
+ </li>
+<li class="listitem">
+ The Spirit.Lex library has been updated to use the newest
+ version of Ben Hansons Lexertl
+ lexer construction library (Boost review pending).
+ </li>
+<li class="listitem">
+ The <code class="computeroutput">lex::lexer<Lexer></code>
+ template constructor now takes an optional parameter specifying the <code class="computeroutput">match_flags</code> to be used for table generation.
+ Currently, there are the following flags available:
+<pre class="programlisting">match_flags::match_default, // no flags
+match_flags::match_not_dot_newline, // the regex '.' doesn't match newlines
+match_flags::match_icase // all matching operations are case insensitive
+</pre>
+ If no parameter is passed to the constructor, <code class="computeroutput">match_flags::match_default</code>
+ is used, i.e. the <code class="computeroutput">.</code> matches
+ newlines and matching is case sensitive.
+ </li>
+<li class="listitem">
+ The <code class="computeroutput">char_()</code>
+ and <code class="computeroutput">string()</code>
+ placeholders can now be used for token definitions as a replacement for
+ <code class="computeroutput">token_def</code>, although it is
+ still possible to use the latter.
+ </li>
+<li class="listitem">
+ Lexer semantic actions now have to conform to a changed interface (see <a class="link" href="lex/abstracts/lexer_semantic_actions.html" title="Lexer Semantic Actions">Lexer Semantic Actions</a>
+ for details).
+ </li>
+<li class="listitem">
+ Added placeholder symbols usable from the inside of lexer semantic actions
+ while using Phoenix: _start, _end, _eoi, _state, _val, and _pass (see <a class="link" href="lex/abstracts/lexer_semantic_actions.html" title="Lexer Semantic Actions">Lexer Semantic Actions</a>
+ for more details).
+ </li>
+<li class="listitem">
+ Added (lazy) support functions usable from the inside of lexer semantic actions
+ while using Phoenix: <code class="computeroutput">lex::more()</code>, <code class="computeroutput">lex::less()</code>, and <code class="computeroutput">lex::lookahead()</code> (see <a class="link" href="lex/abstracts/lexer_semantic_actions.html" title="Lexer Semantic Actions">Lexer
+ Semantic Actions</a> for more details).
+ </li>
+<li class="listitem">
+ Removed <code class="computeroutput">lex::omitted</code> in favor of <code class="computeroutput">lex::omit</code>
+ to unify the overall interface.
+ </li>
+</ul></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 © 2001-2009 Joel
+ de Guzman, Hartmut Kaiser
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="preface.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="introduction.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Date view	Thread view	Subject view	Author view

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