At 8:41 AM -0700 5/25/00, Peter Scott wrote:
>Some years ago I got a code review of a C program I wrote. Two
>people were fairly novice programmers, one was an expert. When they
>got to the recursive descent parser the novices said, Whoa, what is
>this thing, explain? The other one said, It's just your standard
>RDP: first it does the left side, then it does the right side; next.
>Documentation and coding standards for that program would depend on
>which of those people was going to take it on.
I would normally include a comment to the effect that a "recursive
descent parser" was being used. If I am borrowing the algorithm from
a text, I like to give a citation. The novice can then (in theory :-)
look up the algorithm; the expert is simply reassured as to what is
going on...
-r
--
Rich Morin: [EMAIL PROTECTED], +1 650-873-7841, http://www.ptf.com/~rdm
Prime Time Freeware: [EMAIL PROTECTED], +1 408-433-9662, http://www.ptf.com
MacPerl: http://www.macperl.com, http://www.ptf.com/ptf/products/MPPE
MkLinux: http://www.mklinux.apple.com, http://www.ptf.com/ptf/products/MKLP
