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