Hi Folks,
how about the second version?
I think it would be practical to use consistent abbreviations in the documentation for the different dialects: SP= ISO Standard Pascal, EP=ISO Extended Pascal, BP= Borland Pascal, GNU.
miklos
_______________________ here_it_goes _____________
do
DESCRIPTION:
The "do" reserved word is used in combination with other Pascal key-words in many ways. Due to its diverse functionality no explanation is given here to avoid confusion. See the relevant reference sections for description and examples: for, while, with, to begin, to end.
STANDARDS: SP, EP, BP, GNU.
SEE ALSO: for, while, with, to begin, to end.
Hi!
According to Miklos Cserzo:
I think it would be practical to use consistent abbreviations in the documentation for the different dialects: SP= ISO Standard Pascal, EP=ISO Extended Pascal, BP= Borland Pascal, GNU.
Usually I am not a friend of abbreviations, but if there is a consensus that it makes the documentation more readable, I would agree to this and write some notes about these abbreviations for the introduction.
do
DESCRIPTION:
The "do" reserved word is used in combination with other Pascal key-words in many ways. Due to its diverse functionality no explanation is given here to avoid confusion.
This sounds perhaps too negative ...
See the relevant reference sections for description and examples: for, while, with, to begin, to end.
My suggestion:
The "do" reserved word is used in combination with other Pascal key-words in many ways. For descriptions and examples, see the relevant reference sections: for, while, with, to begin, to end.
STANDARDS: SP, EP, BP, GNU.
This might cause the impression that other dialects (VAX Pascal etc.) would not support `do'. My suggestion:
"do" is defined in ISO-7185 Standard Pascal and supported by all Pascal dialects we are aware of.
(Or (with abbreviations): "do" is defined in SP and ...)
Peter
Usually I am not a friend of abbreviations, but if there is a consensus that it makes the documentation more readable, I would agree to this and write some notes about these abbreviations for the introduction.
I think at this point it's irrelevant and there can be a search and kill done later if we need to. At any rate, the compatibility list is a *really* good idea. For anyone who knows Pascal at all, these abbreviations are fine.
| clavicle@niagara.com "The LORD is my strength and my | www.niagara.com/~clavicle song; he has become my salvation." | ICQ#13902938 Exodus 15:2b
-
Miklos Cserzo -
Paul Doerwald -
Peter Gerwinski