fixed typo in DESCRIPTION, finally added README test from DESCRIPTION and edited/expanded

Author: eddelbuettel

DESCRIPTION

@@ -1,6 +1,6 @@
 Package: Rcpp
 Title: Seamless R and C++ Integration
-Version: 0.10.6.3
+Version: 0.10.6.4
 Date: 2013-11-14
 Authors@R: c(
     person("Dirk", "Eddelbuettel", role = c("aut", "cre"), email = "edd@debian.org" ),
@@ -60,4 +60,4 @@ VignetteBuilder: highlight
 URL: http://www.rcpp.org, http://dirk.eddelbuettel.com/code/rcpp.html, https://github.com/RcppCore/Rcpp
 License: GPL (>= 2)
 BugReports: https://github.com/RcppCore/Rcpp/issues
-MailingList: Please send questions and comments regarding Rcpp to rcpp-devel@lists.r-forge.r-project.or
+MailingList: Please send questions and comments regarding Rcpp to rcpp-devel@lists.r-forge.r-project.org

README.md

@@ -1,4 +1,54 @@
-Rcpp
-====
+Rcpp: Seamless R and C++ Integration
+====================================
 
 [![Build Status](https://travis-ci.org/RcppCore/Rcpp.png)](https://travis-ci.org/RcppCore/Rcpp)
+
+The Rcpp package provides R functions as well as a C++ library
+which facilitate the integration of R and C++
+
+R data types (`SEXP`) are matched to C++ objects in a class hierarchy.  All R
+types are supported (vectors, functions, environment, etc ...)  and each
+type is mapped to a dedicated class. For example, numeric vectors are
+represented as instances of the Rcpp::NumericVector class, environments are
+represented as instances of Rcpp::Environment, functions are represented as
+Rcpp::Function, etc ... 
+The
+[Rcpp-introduction](http://cran.r-project.org/web/packages/Rcpp/vignettes/Rcpp-introduction.pdf)
+vignette (also published as [in JSS in 2011](http://www.jstatsoft.org/v40/i08/)) provides a good
+entry point to Rcpp, as does the [Rcpp website](http://www.rcpp.org) and the
+[Rcpp page](http://dirk.eddelbuettel.com/code/rcpp.html).
+
+Conversion from C++ to R and back is driven by the templates `Rcpp::wrap` 
+and `Rcpp::as` which are highly flexible and extensible, as documented
+in the [Rcpp-extending](http://cran.r-project.org/web/packages/Rcpp/vignettes/Rcpp-extending.pdf) vignette.
+
+Rcpp also provides Rcpp modules, a framework that allows exposing 
+C++ functions and classes to the R level. The [Rcpp-modules]((http://cran.r-project.org/web/packages/Rcpp/vignettes/Rcpp-modules.pdf) vignette
+details the current set of features of Rcpp-modules. 
+
+Rcpp includes a concept called Rcpp sugar that brings many R functions
+into C++. Sugar takes advantage of lazy evaluation and expression templates
+to achieve great performance while exposing a syntax that is much nicer
+to use than the equivalent low-level loop code. The [Rcpp-sugar]((http://cran.r-project.org/web/packages/Rcpp/vignettes/Rcpp-sugar.pdf)
+gives an overview of the feature.
+
+Rcpp attributes provide a high-level syntax for declaring C++
+functions as callable from R and automatically generating the code
+required to invoke them.  Attributes are intended to facilitate both
+interactive use of C++ within R sessions as well as to support R
+package development. Attributes are built on top of Rcpp modules and
+their implementation is based on previous work in the inline package.
+See the [Rcpp-atttributes]((http://cran.r-project.org/web/packages/Rcpp/vignettes/Rcpp-attributes.pdf) vignettes for more details. 
+
+Many examples are included, and over 800 unit tests in over 400 unit
+test functions provide additional usage examples.
+
+An earlier version of Rcpp, containing what we now call the 'classic Rcpp
+API' was written during 2005 and 2006 by Dominick Samperi.  This code has
+been factored out of Rcpp into the package RcppClassic, and it is still
+available for code relying on the older interface. New development should 
+always use this Rcpp package instead.
+
+Additional documentation is available via the [JSS paper](http://www.jstatsoft.org/v40/i08/) by Eddelbuettel and
+Francois (2011, JSS) paper and the [book](http://www.rcpp.org/book) by Eddelbuettel (2013, Springer); 
+see 'citation("Rcpp")' for details.