On Sunday, 26 August 2012 at 10:32:37 UTC, Mike James wrote:
"Manu" <turkey...@gmail.com> wrote in message
news:mailman.1410.1345976415.31962.digitalmar...@puremagic.com...
Looks good, though one thing annoys me as always throughout the
D docs, liberal use of auto can make them very difficult to
understand.
auto result = hash.finish();From the examples where this
appears, I have absolutely no idea what 'result' could possibly
be and what I can do with it, and you're forcing me to go and
dig further for that information (waste of time).
Surely there would be no harm in just writing the type there
for clarity?
<rant>
I'd personally like to see auto abolished, or at least heavily
discouraged for the sake of clarity from code examples
throughout the docs. I'm constantly having to chase up what
auto's may resolve to when reading examples >_<
You may argue this demonstrated un-idiomatic code, and my
trouble is due to inexperience; I ask, who is most likely to be
reading docs?
On 26 August 2012 04:54, Oleg Kuporosov
<oleg.kuporo...@gmail.com> wrote:
Yes
---
Oleg
+1.
The documentation should be there for clarity.
-=mike=-
+2
As a very inexperienced D user, I find the use of auto in the
documentation frustrating too.
Cheers,
Craig