Re: [q-lang-users] Q 7.1 RC3 available

[John C. <co...@cc...>]

Albert Graef scripsit:

> John, I think you said you have some more corrections for the manual, 
> could you please send them to me? Thanks.

These notes reflect the info version distributed in the 7.1rc3 tarball.

First of all, the PDF and HTML manuals available from the home page are
still 6.2; they should be updated with each release.

Global note: "s.t." is another of those mysterious germanophone English
abbreviations unknown to native speakers.  All of them in the manual
should become "so that" except the one in 12.17.3, where "such that"
reads better.

Global note: for "we remark" use simply "note", in the imperative.
There are many instances of this in the manual.  There are also "we
also remark" and "we finally remark" which should be "also note" and
"finally note".

Don't forget to update the discussion of lambdas in 2.2 not to mention
lambda.q and the combinators.

In the discussion of normal forms in 2.4, it is claimed that lists are
always in normal form, whereas of course a list is in normal form iff
its members are: [1+2, 3+4] is not in normal form.

In 3, for "In difference to Prolog" read "Unlike in Prolog".  In "The
reserved words of the Q language are", move "are" to after the
parentheses.

In 4, in "the module identifier is derived automatically as" read simply
"the module identifier is automatically".

In 5, for "The Q language admits" read "The Q language allows", which
is less old-fashioned.  "It is enforced that" is unnatural; use "the
compiler enforces".

In 7.1, for "no such thing like" read "no exact equivalent of" or
something like that.

In 7.3, for "You can count on that" read "You can count on it that".

In 7.4, in "Local definitions also act as additional conditions in that",
omit "in that" and use a semicolon after "conditions".  Immediately after,
for "repeatedly refers" read "refers repeatedly".

In 7.6, for "redices" read "redexes".  ("Redeces" is not unknown, but
"redexes" is definitely the preferred form.)

In 7.7, in "The Q interpreter generates a runtime error in such cases"
for "in such cases" read "if it does not", for clarity.

In 7.10, for "misses an assigment operation" read "lacks an assignment
operation."

I have not reviewed chapters 10-12 or any appendix except C.

-- 
John Cowan    co...@cc...    http://ccil.org/~cowan
Objective consideration of contemporary phenomena compel the conclusion
that optimum or inadequate performance in the trend of competitive
activities exhibits no tendency to be commensurate with innate capacity,
but that a considerable element of the unpredictable must invariably be
taken into account. --Ecclesiastes 9:11, Orwell/Brown version