Am Sun, 26 Aug 2012 15:43:48 +0200 schrieb Johannes Pfau <nos...@example.com>:
> Am Sun, 26 Aug 2012 13:19:35 +0300 > schrieb Manu <turkey...@gmail.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? > > > > OK, I'll fix this if std.digest is accepted into phobos. Seems some people would rather want to keep auto in the examples. I'm not sure what to do about this. I never used auto return types, so the return type can be looked up in the documentation but it's of course not obvious by just reading the examples.