Please remove misleading examples from D's website
Mehrdad
wfunction at hotmail.com
Tue Nov 29 22:08:57 PST 2011
Please remove this from the home page:
// Automatic or explicit memory management
delete cl;
It is obviously not doing what it implies.
Similarly, please remove "Allocating Class Instances On The Stack" from
the memory.html page:
scope c = new C(); // c is allocated on the stack
These are _not_ simply problems with "keeping documentation up to date".
Sure, things change, and it's reasonable to expect delays. But these
have been up for a long enough time, and it is time that they be removed
-- otherwise they simply mislead the reader and claim that D has
capabilities which it doesn't actually have. (If there are substitutes
for these, they should be substituted instead. If not, or if there isn't
enough time to write their documentation yet, then such examples should
be completely removed from the website altogether. But keeping them
serves no purpose other than misleading the reader.)
Thanks!
More information about the Digitalmars-d
mailing list