<HTML><HEAD></HEAD>
<BODY dir=ltr>
<DIV dir=ltr>
<DIV style="FONT-FAMILY: 'Calibri'; COLOR: #000000; FONT-SIZE: 12pt">
<DIV
style="FONT-STYLE: normal; DISPLAY: inline; FONT-FAMILY: 'Calibri'; COLOR: #000000; FONT-SIZE: small; FONT-WEIGHT: normal; TEXT-DECORATION: none">
<DIV> </DIV>
<DIV
style="BORDER-BOTTOM-COLOR: #000000; BORDER-LEFT: #000000 4px solid; BORDER-TOP-COLOR: #000000; PADDING-LEFT: 5px; BORDER-RIGHT-COLOR: #000000; MARGIN-LEFT: 5px">
<DIV style="DISPLAY: inline; FONT-FAMILY: ; COLOR: ; TEXT-DECORATION: ">
<DIV>"Manu" <turkeyman@gmail.com> wrote in message
news:mailman.1410.1345976415.31962.digitalmars-d@puremagic.com...</DIV></DIV></DIV>
<DIV
style="BORDER-BOTTOM-COLOR: #000000; BORDER-LEFT: #000000 4px solid; BORDER-TOP-COLOR: #000000; PADDING-LEFT: 5px; BORDER-RIGHT-COLOR: #000000; MARGIN-LEFT: 5px">
<DIV style="DISPLAY: inline; FONT-FAMILY: ; COLOR: ; TEXT-DECORATION: ">Looks
good, though one thing annoys me as always throughout the D docs, liberal use of
auto can make them very difficult to understand.
<DIV>
<DIV>
<DIV><PRE style="BORDER-BOTTOM: rgb(204,204,204) 1px solid; TEXT-ALIGN: justify; BORDER-LEFT: rgb(204,204,204) 1px solid; PADDING-BOTTOM: 1ex; BACKGROUND-COLOR: rgb(252,252,252); PADDING-LEFT: 1ex; WIDTH: auto; PADDING-RIGHT: 1ex; WORD-WRAP: break-word; WHITE-SPACE: pre-wrap; COLOR: ; MARGIN-LEFT: 42px; BORDER-TOP: rgb(204,204,204) 1px solid; BORDER-RIGHT: rgb(204,204,204) 1px solid; PADDING-TOP: 1ex" class=d_code><SPAN style="COLOR: " class=d_keyword><FONT color=#0000ff><FONT style="FONT-SIZE: 10.5pt">auto</FONT></FONT></SPAN><FONT style="FONT-SIZE: 10.5pt" color=#000066> result = hash.finish();</FONT></PRE>
<DIV>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).</DIV>
<DIV>Surely there would be no harm in just writing the type there for
clarity?</DIV>
<DIV></DIV>
<DIV><rant></DIV>
<DIV>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
>_<</DIV>
<DIV>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?<BR><BR><BR>
<DIV class=gmail_quote>On 26 August 2012 04:54, Oleg Kuporosov <SPAN
dir=ltr><<A href="mailto:Oleg.Kuporosov@gmail.com"
target=_blank>Oleg.Kuporosov@gmail.com</A>></SPAN> wrote:<BR>
<BLOCKQUOTE
style="BORDER-LEFT: #ccc 1px solid; MARGIN: 0px 0px 0px 0.8ex; PADDING-LEFT: 1ex"
class=gmail_quote><BR>Yes<BR>---<BR>Oleg<BR><BR></BLOCKQUOTE></DIV></DIV></DIV></DIV></DIV></DIV></DIV>
<DIV> </DIV>
<DIV> </DIV>
<DIV>+1.</DIV>
<DIV> </DIV>
<DIV>The documentation should be there for clarity.</DIV>
<DIV> </DIV>
<DIV>-=mike=-</DIV></DIV></DIV></DIV></BODY></HTML>