"Manu" <[email protected]> wrote in message 
news:[email protected]...
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 <[email protected]> wrote:


  Yes
  ---
  Oleg




+1.

The documentation should be there for clarity.

-=mike=-

Reply via email to