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