Vote for the new std.hash (oops, std.digest)

Craig Dillabaugh cdillaba at cg.scs.carleton.ca
Sun Aug 26 05:35:16 PDT 2012


On Sunday, 26 August 2012 at 10:32:37 UTC, Mike James wrote:
>
> "Manu" <turkeyman at gmail.com> wrote in message 
> news:mailman.1410.1345976415.31962.digitalmars-d at 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.Kuporosov at 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




More information about the Digitalmars-d mailing list