On 17/6/04 3:11 pm, "Robert Tweed" <robert-lists@...> wrote:

> ... all openLingo scripts use me.xxxx to refer to properties so that
> those properties can be overridden in descendant objects while
> maintaining the correct behaviour.

Hi Robert,

That makes sense.

> - Do not comment indvidual lines or chunks of code unless absolutely
> necessary. In such cases, explain *why* the code is written the way it is,
> not *what* the code does, unless it really is not obvious what the code is
> doing by looking at it.

There are times when I would want to comment the *what* of an individual
line of code. For example, an Undo script may need to do several things,
such as altering a data structure, updating an interface in a MIAW and
updating an interface on the Stage. Each of these operations would need a
comment to distinguish it from the others, even if the operation itself only
required a single line of code.

> The openLingo naming convention is:
>
> - Names are always first-letter caps with the first word (or prefix) being
> all lowercase. Only exception is private globals...
> - Private globals begin with a double underscore and words are all
> lowercase, separated by underscores, e.g., __global_controller

Excuse my ignorance, but what is a "private global"?

Cheers,

James