[Issue 4551] D2 Language Docs: http://www.digitalmars.com/d/2.0/arrays.html

[d-bugmail at puremagic.com]

http://d.puremagic.com/issues/show_bug.cgi?id=4551



--- Comment #2 from Andrej Mitrovic <andrej.mitrovich at gmail.com> 2010-08-05 15:57:04 PDT ---
Thanks for the review, Steven.

I see what you mean by "doesn't have to be a complete program". But this should
be stated somewhere. In many cases trying to compile these incomplete examples
will not give out any sensible error message, primarily because of the
unfriendly linker (which, as Andrei stated, likes to write error messages in
it's own language - Klingon).

I'm sure there will be plenty of newbies trying out the examples and getting
that WTF moment when they get the errors back. So either the examples have to
be full, or the docs should have a visible statement where it states that these
code fragments are only showcase examples, and can't be compiled in their
current state. Would that be fair?

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------