Throughout much of the documentation client scripts are provided for:
query(), every ref to ‘q.’ and the error handling code.
However, this isn’t apparent when first encountering the documentation …
You are right that this is definitely not obvious.
You can keep the q’s in the shell and it works fine.
If there was something like ‘pure FQL’ I would omit the .q though. But I assume Freeross is mainly interested in having doc examples without the error handling code in that case.
Correct. To a new user like myself, having to chop up the example code from the outset creates a doubt about whether I’m using the example documentation correctly.