Added a test for compatibility of boost::distance between Range and Iterator.

This functionality is used in core Boost components, so it is preferable
to test it in Boost.Iterator, even if it's already tested in Boost.Range,
to discover problems as early as possible.

The test verifies that boost::distance implemented in Boost.Range can invoke
boost::distance in Boost.Iterator (i.e. the function lookup succeeds).

test/Jamfile.v2

@@ -60,6 +60,7 @@ test-suite iterator
     [ run advance_test.cpp ]
     [ run distance_test.cpp ]
     [ compile adl_test.cpp ]
+    [ compile range_distance_compat_test.cpp ]
 
     [ run shared_iterator_test.cpp ]
 ;