diff --git a/dlib/smart_pointers.h b/dlib/smart_pointers.h
index 4560e55e1..905e88b15 100644
--- a/dlib/smart_pointers.h
+++ b/dlib/smart_pointers.h
@@ -3,14 +3,12 @@
 #ifndef DLIB_SMART_POINTERs_H_
 #define DLIB_SMART_POINTERs_H_ 
 
-// This is legacy smart pointer code that will likely to stop working under default
-// compiler flags when C++17 becomes the default standard in the compilers.
-// Please consider migrating your code to contemporary smart pointers from C++
-// standard library. The warning below will help to detect if the deprecated code
-// was included from library's clients.
+// This is legacy smart pointer code that will likely stop working under default compiler
+// flags when C++17 becomes the default standard in compilers.  Please consider migrating
+// your code to new smart pointers from C++ standard library. 
 #if (defined(__GNUC__) && ((__GNUC__ >= 4 && __GNUC_MINOR__ >= 8) || (__GNUC__ > 4))) || \
   (defined(__clang__) && ((__clang_major__ >= 3 && __clang_minor__ >= 4)))
-#pragma GCC warning "smart_pointers.h is included which will fail to compile under C++17"
+#pragma GCC warning "smart_pointers.h is included. This code will fail to compile under C++17"
 #endif
 
 #include <memory>