Merge pull request #1462 from boostorg/readme_examples_addition

Adding explanation about BG examples in README and quick start

Author: vissarion

README.md

@@ -17,8 +17,8 @@ Boost.Geometry, part of collection of the [Boost C++ Libraries](http://github.co
 
 ### Directories
 
-* **doc** - QuickBook documentation sources
-* **example** - Boost.Geometry examples
+* **doc** - QuickBook documentation sources, containing embedded examples located in `doc/src/examples/`
+* **example** - Boost.Geometry standalone examples
 * **_extensions_** - examples and tests for the extensions - _develop branch_
 * **include** - the sourcecode of Boost.Geometry
 * **index** - examples and tests for the Spatial Index

doc/quickstart.qbk

@@ -15,6 +15,10 @@
 This Quick Start section shows some of the features of __boost_geometry__
 in the form of annotated, relatively simple, code snippets.
 
+For longer standalone tutorial-style programs, see the repository's `example/` directory;
+for smaller reference-oriented snippets used throughout the manual,
+see `doc/src/examples/`.
+
 The code below assumes that `boost/geometry.hpp` is included, and that `namespace 
 boost::geometry` is used. __boost_geometry__ is header only, so including 
 headerfiles is enough. There is no linking with any library necessary.