Thanks n7800, below is a copy of some of the notes I took last time I loked at the Language Reference. Maybe I am just being a nit picker (and I can be) but I consider the new user here. What do you think ?
----------------
5.4 Class or Static fields
In the demo code -
The first and fifth writeln() expect a string literal, however, are missing the inverted comma treatment. Obvious typo to someone with some experience, baffling to a newbie
(Pedantic) declaring a type 'cl' is inconsistent with best practice. TCl perhaps, better to use 'TObj' ?
Using a lowercase L mixed in with the numeral 1 makes it very hard to read with some fonts. TObj is far more readable.
5.5 Constructors and Destructors
Say "A constructor/destructor pair is required if the object uses virtual methods." However, no mention of how the programmer initiates that. Does it just happen because a constructor exits, is called or because it contains "inherited <something>" ?
5.6.1 Declaration
Has a small block of code demonstrating that fields can be declared after methods in a block, but, in fact, the field is declared before the method so, illustrates nothing.
5.6.2 Method invocation
Under "Abstract methods" we are told that Line 3 will generate a compile error. No idea where or what Line 3 is. Recreate the code the author is referring to, its "inherited Doit;" in the implementation of TChildDoIt, reading the text would never arrive there !. That line of code does not appear anywhere in "Abstract methods" heading. Where the 3 came from is anyone's guess.
and, just added
3.3.2 Record Types
9 Extended Records
Both sections could do with a mention that 4.4. Initialized Variables has an example of initializing a record.
And, while here, why "Extended Records" in the documentation. The switch to turn it on is {$modeswitch advancedrecords}. When spoken of in the forum, Extended Records gets 27 mentions. Advanced Records gets 215.
----------------
I had a ComSci lecturer once who said documentation should be like a good adult movie. Clear, well focused and leave absolutely nothing to the imagination.
Davo