From cff2ee9d6c30afba4fe6cf64b3d65080372f8a5d Mon Sep 17 00:00:00 2001
From: Adam Wulkiewicz <adam.wulkiewicz@gmail.com>
Date: Wed, 11 Feb 2015 20:29:47 +0100
Subject: [PATCH] [util] Add comments about the BOOST_GEOMETRY_CONDITION()
 implementation.

---
 include/boost/geometry/util/condition.hpp | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/include/boost/geometry/util/condition.hpp b/include/boost/geometry/util/condition.hpp
index 870c9940e..aea4ad3ad 100644
--- a/include/boost/geometry/util/condition.hpp
+++ b/include/boost/geometry/util/condition.hpp
@@ -15,11 +15,21 @@
 #include <boost/config.hpp>
 
 
+// The macro defined in this file allows to suppress the MSVC
+// compiler warning C4127: conditional expression is constant
+
 #ifdef BOOST_MSVC
 
+// NOTE: The code commented out below contains an alternative implementation
+// of a macro using a free function. It was left here in case if in the future
+// version of MSVC for the code currently used in the macro implementation
+// the warning was generated.
+
+//#ifndef DOXYGEN_NO_DETAIL
 //namespace boost { namespace geometry { namespace detail {
 //BOOST_FORCEINLINE bool condition(bool const b) { return b; }
 //}}} // boost::geometry::detail
+//#endif // DOXYGEN_NO_DETAIL
 //#define BOOST_GEOMETRY_CONDITION(CONDITION) boost::geometry::detail::condition(CONDITION)
 
 #define BOOST_GEOMETRY_CONDITION(CONDITION) ((void)0, (CONDITION))