Coding Thread, BAD dotNet docs in Coding and Web Development; This is really a FFS! but makes more sense here.
A MSDN dotNet 2 reference talks about a 5 second ...
8th November 2007, 12:58 AM #1
BAD dotNet docs
This is really a FFS! but makes more sense here.
A MSDN dotNet 2 reference talks about a 5 second interval and says "[X] will be lost", whereas the dotNet 3 version talks about a 6 second interval and says "[X] will be delayed". The difference between them will make or break any typical program using this bit of the APIs.
The calls they are talking about live in the same DLL and that's exactly the same dotNet 2 DLL regardless of whether you have dotNet 2 or dotNet 3 installed (dotNet 3 essentially being dotNet 2 plus some new libraries).
Maybe if 65535 people all hold hands and chant "It is a dotNet 3 DLL!" for long enough they'll move a few electrons and it it will work as documented in the dotNet3 description. Dunno..
Then I found someone who actually tested their code and accidentally proved the dotNet 2 take on the matter, which means a lot of smug example code on blogs and the like is broken.
And then you meet a incomprehensible MSDN description of some number you need to play with.. and all the code I found out there took it at face value.. that to derive Y from 32-bit number X you mask the top two bits.. when in fact X is definitely a 64-bit number and to get Y you mask the top 32 bits.
 Reminds me of the 27 "expert" blogs and columns I found on getting started with 2K8 beta 3 Server Core with exactly the same, but absolutely broken netsh command line. I suppose they either stole or were handed the recipe by MS, despite clearly suggesting to us gullible readers that they had personally gone through and sweated over the process.
IDG Tech News
10th November 2007, 03:54 PM #2
Re: BAD dotNet docs
You can do this all day... on some collection MSDN says it's not immutable (=mutable=might change while you're trying to do things with it) so you should NOT iterate it with a for loop.
The code examples below that advice iterate it with a for loop.
By contink in forum Scripts
Last Post: 7th May 2009, 01:22 AM
By wadeeuk in forum How do you do....it?
Last Post: 14th November 2007, 12:00 AM
Last Post: 6th September 2007, 01:53 PM
By Ste_Harve in forum Windows
Last Post: 30th August 2007, 01:32 PM
By mattx in forum Windows
Last Post: 4th July 2007, 11:39 AM
Users Browsing this Thread
There are currently 1 users browsing this thread. (0 members and 1 guests)