Hi Russ,
- Table of Contents is at wrong end.
I don't have clues how to tell `makeinfo' to put it where it belongs. I noticed now that there's the same problem in the HTML version, caused again by `makeinfo'. Any suggestion?
- Suggest changing " aString: String " to " S: String "
Not really. First of all, according the the GPCS (short for GNU Pascal Coding Standards) "S: String" should be "s: String". (Of course nobody can force anyone to apply the GPCS, they are just advice.) Secondly, "aString" is the result of a rule we haven't yet defined. It's the only one which hasn't been defined yet. If you grep for "FIXME" you'll find just one instance of it and you can read what it's about. I'll save you the grep which is hard for a printed copy. :-))
: In object oriented code (especially often in constructors), there is : often the need to have a parameter correspond to an object field : (e.g., to pass a value with which to initialize the field). Since : both can't be called the same, the field should have the ``natural'' : name since it's usually used in more routines, and the parameter : name should be ``mangled''. FIXME: We haven't found a really : satisfactory rule for mangling yet (some use ``a'' as a prefix), and : if you have any good idea, let us know.
You have 2 lines that are 100 cols in length.
I fixed those lines. I also tried to solve the problem for the lines of code by choosing another appropriate example from the GPC sources which doesn't need such long lines.
Thanks,
Nick