"David G. Johnston" <david.g.johns...@gmail.com> writes: > There is an implied "anything else not noted here should be taken as > literal token to type, or a variable, as context dictates" [1] - and since > () isn't mentioned... > I'd probably rather make that implied part explicit and avoid mentioning > parentheses explicitly.
+1. I mean, if we have to say this for parentheses, what about commas, dashes, etc? > I would suggest moving the Tcl parenthetical to its own sentence. The > percentage of readers who will notice or care about Tcl synopses is > probably close to zero, and they are likely to be familiar enough to not > need our preface to enlighten them. Maybe time to drop the Tcl reference altogether? I like that language, but I fear it's next door to dead, so it certainly doesn't need to be mentioned outside the pltcl docs. regards, tom lane