Re: Occupant Combat, Redux

[Jim Kingdon <kingdon at panix dot com>]

>   * Give an example of an atom versus a list containing an atom versus a
> list containing multiple atoms.

This would help.

Reword the sentence "GDL resembles Lisp, but instead of defining
functions" to say something like "GDL syntax allows you to include
numbers, strings, lists, and the like.  For those who know lisp, it
uses a similar syntax, but lisp knowledge is not needed to write or
read GDL".

Change "`Dotted pairs'' are not allowed." to "There is nothing similar
to the ``dotted pairs'' of lisp (and if you don't know what that is,
it means you don't need to worry about it).

Explain "Anything that is not a list is an @dfn{atom}." better.  It
isn't strictly true (it doesn't mean comments, for example).  Maybe
"an atom is a symbol, a number, or a string" is closer to the truth.

Reword the rest of this paragraph to nuke the word "forms" (it is
defined, but only later).

Put an example at the start.  Put more examples throughout (especially
in the "Lexical Elements" section and the discussion of
interpolation-list in the next section).

There might be others (a really good reviewer would be someone who was
trying to figure it out for the first time, without any knowledge of
lisp), but those are a good start.

Your other two suggestions also look OK to me.