Thread overview
A few nits against the manual...
Feb 01, 2004
larry cowan
Feb 02, 2004
J C Calvarese
Feb 02, 2004
J C Calvarese
Re: [bug] A few nits against the manual...
Feb 02, 2004
J C Calvarese
February 01, 2004
p.42,ln.23  tabchar needed
p.60 can the examples have a bit more meat? the bones are showing...it is
unclear how or why to use them
p.91,ln.16  "A static constructor..." should be "destructor"
p.209,ln.4,5,6  "FLAG" should be "FLAGS"

Good quality manual!


February 02, 2004
First off, I think you're looking at an outdated PDF. I think you're looking at this file:
http://www.prowiki.org/upload/HelmutLeitner/D_Programming_Language_030418.pdf

(Maybe we can get Walter to provide the more recent version at http://www.digitalmars.com/d/intro.html.)

There's a newer PDF version that ssuukk has produced from Walter's D specification (http://www.digitalmars.com/drn-bin/wwwnews?D/22264).


larry cowan wrote:
> p.42,ln.23  tabchar needed
I can't find what you're referring to.  What text does it involve?

Is it somewhere around this?
.isnormal 	1 if not nan or infinity, 0 if
.digits 	number of digits of precision
.epsilon 	smallest increment
.mantissa 	number of bits in mantissa

Maybe the .isnormal description should be "1 if not nan or infinity, otherwise 0"


> p.60 can the examples have a bit more meat? the bones are showing...it is
> unclear how or why to use them
I agree some of this stuff is pretty terse. Since we're talking about a specification as opposed to a tutorial, I doubt we can get Walter to include a longer example in this spec.

Is there something in particular you're trying to understand?  Try posting a specific question on this newsgroup. Most inquiries get polite responses around here. I can explain some things such as an assert, but delegates and function literals are still a little over my head.


> p.91,ln.16  "A static constructor..." should be "destructor"
I agree.

Walter's version is wrong as well.
(http://www.digitalmars.com/d/class.html#staticdestructor)


> p.209,ln.4,5,6  "FLAG" should be "FLAGS"
Yes. Or change "flags |= FLAGS_X;" to "flags |= FLAG_X;"
http://www.digitalmars.com/d/pretod.html
> 
> Good quality manual!

-- 
Justin
http://jcc_7.tripod.com/d/
February 02, 2004
J C Calvarese wrote:

> First off, I think you're looking at an outdated PDF. I think you're looking at this file:
> http://www.prowiki.org/upload/HelmutLeitner/D_Programming_Language_030418.pdf 
> 
> 
> (Maybe we can get Walter to provide the more recent version at http://www.digitalmars.com/d/intro.html.)
Actually, I've uploaded the updated PDF to http://www.prowiki.org/wiki4d/wiki.cgi?LanguageSpecification, so Walter doesn't have to change the link.

> There's a newer PDF version that ssuukk has produced from Walter's D specification (http://www.digitalmars.com/drn-bin/wwwnews?D/22264).
That's the version that I uploaded to the Wiki.  (I've had trouble trying to download from the web interface.)

-- 
Justin
http://jcc_7.tripod.com/d/
February 02, 2004
J C Calvarese wrote:

> First off, I think you're looking at an outdated PDF. I think you're looking at this file:
> http://www.prowiki.org/upload/HelmutLeitner/D_Programming_Language_030418.pdf 
> 
> 
> (Maybe we can get Walter to provide the more recent version at http://www.digitalmars.com/d/intro.html.)
> 
> There's a newer PDF version that ssuukk has produced from Walter's D specification (http://www.digitalmars.com/drn-bin/wwwnews?D/22264).
> 
> 
> larry cowan wrote:
> 
>> p.42,ln.23  tabchar needed
> 
> I can't find what you're referring to.  What text does it involve?
Okay, I found it. I don't think I'm blind.

.maxExp	maximum exponent as power of 2 (?)

I guess I missed it because "exponent" still lines up with the rest of the column.

Yes, that looks like a good thing for Walter to fix.
(http://www.digitalmars.com/d/property.html)

-- 
Justin
http://jcc_7.tripod.com/d/