Subject: [Boost-commit] svn:boost r52677 - trunk/libs/spirit/doc
From: hartmut.kaiser_at_[hidden]
Date: 2009-04-30 12:06:52
Author: hkaiser
Date: 2009-04-30 12:06:52 EDT (Thu, 30 Apr 2009)
New Revision: 52677
URL: http://svn.boost.org/trac/boost/changeset/52677
Log:
Spirit: Updated what's new section to cover version 2.1
Text files modified:
trunk/libs/spirit/doc/spirit2.qbk | 4
trunk/libs/spirit/doc/what_s_new.qbk | 93 +++++++++++++++++++++++++++++++++++++++
2 files changed, 94 insertions(+), 3 deletions(-)
Modified: trunk/libs/spirit/doc/spirit2.qbk
==============================================================================
--- trunk/libs/spirit/doc/spirit2.qbk (original)
+++ trunk/libs/spirit/doc/spirit2.qbk 2009-04-30 12:06:52 EDT (Thu, 30 Apr 2009)
@@ -29,8 +29,6 @@
[def __phoenix2__ [@../../phoenix/doc/html/index.html Phoenix2]]
[def __fusion__ [@http://spirit.sourceforge.net/dl_more/fusion_v2/libs/fusion/doc/html/index.html Fusion]]
[def __mpl__ [@http://www.boost.org/libs/mpl/index.html MPL]]
-[def __boost_tuples__ [@http://www.boost.org/libs/tuple/index.html Boost.Tuples]]
-[def __boost_proto__ -Boost.Proto-]
[def __boost__ [@http://www.boost.org/ Boost]]
[def __boost_tools__ [@http://www.boost.org/tools/index.html Boost Tools]]
[def __spirit_list__ [@https://lists.sourceforge.net/lists/listinfo/spirit-general Spirit Mailing List]]
@@ -54,6 +52,8 @@
[def __boost_iterator_range__ [@http://www.boost.org/libs/range/doc/utility_class.html#iter_range `boost::iterator_range<>`]]
[def __boost_bind__ [@http://www.boost.org/libs/bind/index.html Boost.Bind]]
[def __boost_lambda__ [@http://www.boost.org/libs/lambda/index.html Boost.Lambda]]
+[def __boost_tuples__ [@http://www.boost.org/libs/tuple/index.html Boost.Tuples]]
+[def __boost_proto__ [@http://www.boost.org/doc/libs/1_38_0/doc/html/proto.html Boost.Proto]]
[def __classic__ /Spirit.Classic/]
Modified: trunk/libs/spirit/doc/what_s_new.qbk
==============================================================================
--- trunk/libs/spirit/doc/what_s_new.qbk (original)
+++ trunk/libs/spirit/doc/what_s_new.qbk 2009-04-30 12:06:52 EDT (Thu, 30 Apr 2009)
@@ -1,5 +1,5 @@
[/==============================================================================
- Copyright (C) 2001-2008 Joel de Guzman
+ Copyright (C) 2001-2009 Joel de Guzman
Copyright (C) 2001-2009 Hartmut Kaiser
Distributed under the Boost Software License, Version 1.0. (See accompanying
@@ -41,5 +41,96 @@
deprecated include files are being used. This ensures full backwards
compatibility for existing applications.
+[heading Spirit V2.1]
+
+[heading What's changed in __qi__ and __karma__ from V2.0 to 2.x]
+
+* __spirit__ is now based on the newest version of __boost_proto__
+* qi::phrase_parse, qi::phrase_format now post-skip by default.
+* karma::generate_delimited and karma::format_delimited now don't do pre-
+ delimiting by default.
+* Changed parameter sequence of qi::phrase_parse, qi::phrase_match,
+ karma::generate_delimited, and match_delimited. The attribute is now the last
+ parameter.
+* Added new overloads of those functions allowing to explicitely specify the
+ post-skipping and pre-delimiting behavior.
+* multi attribute API functions
+* removed grammar_def<>
+* removed functions make_parser() and make_generator()
+* removed qi::none and karma::none
+* sequences and lists now accept a standard container as its attribute
+* The string placeholder terminal now can take other strings as its parameter
+ (i.e. std::string)
+* all terminals taking literals now accept a (lazy) function object as well
+* All placeholders for terminals and directives (such as int_, double_,
+ verbatim, etc.) were previously defined in the namespace boost::spirit
+ only. Now these are additionally imported into the namespaces
+ spirit::qi, spirit::karma, and spirit::lex (if they are supported by
+ the corresponding sub-library.
+* The terminal placeholders char_ and string are not defined in the
+ namespace boost::spirit anymore as they have been moved to the
+ character set namespaces, allowing to do proper character set
+ handling based on the used namespace (as spirit::ascii, etc.)
+* The uint, ushort, ulong, and byte terminal placeholders have been renamed to
+ uint_, ushort_, ulong_, and byte_.
+* qi: skip[] now re-enables outer skipper if used inside lexeme[]
+* karma: maxwidth[] directive
+* karma: delimit[] now re-enables outer delimiter if used inside verbatim[]
+* karma: added and-predicate (operator&()) and not-predicate (operator!())
+
+
+[heading What's changed in __lex__ from V2.0 to 2.x]
+
+Here is a list of changes in __lex__ since version 2.0. __lex__ 2.x is a
+complete rewrite of the original __lex__ distributed. As all parts of the
+__spirit__ library it is usable either standalone or in conjunction with the
+other parts. __lex__ now uses the infrastructure provided by __spirit__ version
+2.1.
+
+* 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.
+* The lex::lexer class does not have the function `def(Self& self)` anymore,
+ token definitions can be added to the lexer at any time, usually in the
+ constructor of the user defined lexer class:
+
+ template <typename Lexer>
+ struct example_tokens : lex::lexer<Lexer>
+ {
+ example_lexer()
+ {
+ // your token definitions here
+ this->self = ...
+ }
+ };
+* The new lexer class now can be directly used, their is no need anymore to
+ wrap it using the `make_lexer()` template as before. Therefor the function
+ `make_lexer()` has been removed.
+* The `lex::tokenize_and_parse()` and `lex::tokenize_and_phrase_parse()` functions
+ have been changed to match the parameter sequence as implemented by the
+ `qi::parse()` and `qi::phrase_parse()` functions.
+ Both take a possibly arbitrary number of attribute arguments as its last
+ parameters (well, the number of attributes is limited by the macro
+ `SPIRIT_ARGUMENTS_LIMIT`, which defaults to `PHOENIX_LIMIT`).
+* The `lex::lexertl_lexer`, `lex::lexertl_token_set`, and `lex::lexertl_token`
+ classes has been moved to the `lex::lexertl` namespace and the names have been
+ changed to `lex::lexertl::lexer`, `lex::lexertl::token_set`, `lex::lexertl::token`
+ (the same applies to the `lex::lexert_actor_lexer`, and the `static_lexertl_*`
+ family of types).
+* The __lexer__ library has been updated to use the newest version of Ben
+ Hansons __lexertl__ lexer construction library (Boost review pending).
+* The `lex::lexer<Lexer>` template constructor now takes an optional parameter
+ specifying the `match_flags` to be used for table generation. Currently, there
+ are the following flags available:
+
+ 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
+
+ If no parameter is passed to the constructor, `match_flags::match_default` is
+ used, i.e. the '.' matches newlines and matching is case sensitive.
+* Now the `char_()` and `string()` placeholders can be used for token
+ definitions as a replacement for `token_def<>(...)`, although it is still
+ possible to use the latter one.
[endsect]