Document that $^O in Win32 is a bit lacking in details.

p4raw-id: //depot/perl@17044

diff --git a/pod/perlvar.pod b/pod/perlvar.pod
index ae72617..07ee0db 100644 (file)
--- a/pod/perlvar.pod
+++ b/pod/perlvar.pod
@@ -1003,6 +1003,12 @@ built, as determined during the configuration process.  The value
 is identical to C<$Config{'osname'}>.  See also L<Config> and the 
 B<-V> command-line switch documented in L<perlrun>.
 
+In Windows platforms the $^O is not very helpful since it is always
+MSWin32 (or MSWin64, when applicable), it doesn't tell the difference
+between 95/98/ME/NT/2000/XP/CE.  Use Win32::GetOSVersion() (see L<perlport>)
+and other means (like for example the presence/absence of some files) to
+distinguish those.
+
 =item ${^OPEN}
 
 An internal variable used by PerlIO.  A string in two parts, separated