View mode: basic / threaded / horizontal-split · Log in · Help
February 01, 2004
A few nits against the manual...
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
Re: A few nits against the manual...
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
Re: A few nits against the manual...
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
Re: [bug] A few nits against the manual...
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/
Top | Discussion index | About this forum | D home