www.digitalmars.com         C & C++   DMDScript  

D - A few nits against the manual...

reply larry cowan <larry_member pathlink.com> writes:
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!
Feb 01 2004
parent reply J C Calvarese <jcc7 cox.net> writes:
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/
Feb 01 2004
next sibling parent J C Calvarese <jcc7 cox.net> writes:
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/
Feb 01 2004
prev sibling parent J C Calvarese <jcc7 cox.net> writes:
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/
Feb 01 2004