README.md
In AsioHeaders: 'Asio' C++ Header Files

This package provides R with access to Asio header files. Asio provides a cross-platform C++ library for network and low-level I/O programming. It is also included in Boost -- but requires linking when used as part of Boost. This standalone version of Asio is a header-only C++ library which can be used without linking (just like our BH package with parts of Boost).

By providing the Asio library in this package, we offer a more efficient distribution system for CRAN as replication of this code in the sources of other packages is avoided.

To use it, simply add it to the LinkingTo: field in the DESCRIPTION field of your R package---and the R package infrastructure tools will then know how to set include flags correctly on all architectures supported by R.

The RcppAsioExample package provides a simple illustration and example of using this package. Use it to both assert your compiler and setup are working correctly, and possibly extend your work from. Generally speaking, only a LinkingTo: AsioHeaders should be needed, plus on Windows only a very simply link instruction in src/Makevars.win.

See the BH package for related (and also header-only) libraries from Boost.

The issue tracker can be used for bug reports or feature requests.

Dirk Eddelbuettel

This package is provided under the same license as Asio and Boost, the BSL-1.0