on 23/1/02 9:21 PM, Jeanne A. E. DeVoto at [EMAIL PROTECTED] wrote:
>> I think it would be helpful if somewhere in the documentation there was a
>> reference for the references... er, that is, a definition of field
>> reference, stack reference etc.
>
> Take a look at "About object types and object references" in the
> Encyclopedia. I think that will tell you what you're looking for. (There
> isn't an example for a substack of a stack, but I'll add one.)
I did look at this, and it's useful stuff (though it doesn't give any clue
about referring to substacks, or stacks in other files); but my point was
that it's more of an introduction than an actual reference.
Whereas in the excellent dictionary you give both a reference to the syntax,
covering all the legal options, for example:
there is a {object | window | file filePath | folder folderPath}
and some examples, eg
there is a card button 1 -- evaluates to true if any card buttons
if there is a card ID 3445 then go card ID 3445
put (there is a file it) into fileIsThere
In the "About object types and object references" topic, you give quite a
few examples; but (unless I missed it) don't ever give an exhaustive
reference to the syntax of a legal object reference, a legal card reference,
a legal stack reference, etc.
Eg the HC help stacks includes a list of the legal ways to refer to a card:
recent card
back
forth
card id <posInteger> [of bkgnd ]
card <text> [of bkgnd ] -- name
card <posInteger> [of bkgnd ] -- number
<ordinal> card [of bkgnd ]
<position> card [of bkgnd ]
<ordinal> marked card
<position> marked card
marked card <posInteger>
(and of course 'bkgnd' in the list is hot to a similar list of all the legal
ways to refer to a background). (A couple of those I had no idea about -
forth!?!? )
Something similar for controls, cards, stacks, et al in Revolution would
ensure that there was at least one place where one could eventually figure
out the full syntax for however bizarre a construction one wanted, rather
than relying on finding an example.
Ben Rubinstein | Email: [EMAIL PROTECTED]
Cognitive Applications Ltd | Phone: +44 (0)1273-821600
http://www.cogapp.com | Fax : +44 (0)1273-728866
_______________________________________________
improve-revolution mailing list
[EMAIL PROTECTED]
http://lists.runrev.com/mailman/listinfo/improve-revolution
