diff --git a/winsup/w32api/ChangeLog b/winsup/w32api/ChangeLog
index 404a8c382..d265c234e 100644
--- a/winsup/w32api/ChangeLog
+++ b/winsup/w32api/ChangeLog
@@ -1,3 +1,9 @@
+2002-09-07  Earnie Boyd  <earnie@users.sf.net>
+
+	* include/windef.h (WINVER): Add documentation.
+	(_WIN32_WINNT): Ditto.
+	Special thanks to Paul Schmidt <paul@tricattechnologies.com>
+
 2002-09-06  Danny Smith  <dannysmith@users.sourceforge.net>
 
 	* lib/Makefile.in (TEST_OPTIONS): Define WINVER to 0x0666.
diff --git a/winsup/w32api/include/windef.h b/winsup/w32api/include/windef.h
index 00900c0d0..2f703bdc5 100644
--- a/winsup/w32api/include/windef.h
+++ b/winsup/w32api/include/windef.h
@@ -10,9 +10,20 @@ extern "C" {
 
 #ifndef WINVER
 #define WINVER 0x0400
+/*
+ * If you need Win32 API features newer the Win95 and WinNT then you must
+ * define WINVER before including windows.h or any other method of including
+ * the windef.h header.
+ */
 #endif
 #ifndef _WIN32_WINNT
 #define _WIN32_WINNT WINVER
+/*
+ * There may be the need to define _WIN32_WINNT to a value different from
+ * the value of WINVER.  I don't have any example of why you would do that.
+ * However, if you must then define _WIN32_WINNT to the value required before
+ * including windows.h or any other method of including the windef.h header.
+ */
 #endif
 #ifndef WIN32
 #define WIN32