The things you see in the documentation are called syntaxis. It is a way to descibe how the function must be used. And is actually a common, almost standard, way of writing how something must be used.
eg: If it states:
quote:
OnEvent_ContactSignin(
[string] Email
);
It means there is a function called
OnEvent_ContactSignin which has 1 parameter called
Email. The
Email parameter must be in the form of a
string.
'function', 'parameter', 'string', etc are all words and terms used in programming. Thus this has little todo with the documentations not being clear enough. Such terms should be known by he who wants to program something.
A function is something which is executed, it is a bunch of related code which in the end performs a certain action or manipulates something.
A parameter is something which can change and which is either given to the function as input to work with, or returned by the function as a result of that function.
A string is a type of variable, it is text. Besides a string you can also have integers (numbers), booleans (binary states indicating false or true), etc...
as for an example of:
quote:
OnEvent_ContactSignin(
[string] Email
);
[code]function OnEvent_ContactSignin(TheEmailParameter) {
Debug.Trace("The contact with the email " + TheEmailParameter + " has just signed in");
If (TheEmailParameter == "myfriendsemailaddress@mail.com") {
// this will be performed if the comparisson is correct, thus TRUE
Debug.Trace("The person who signed in is my friend")
} else {
// this will be performed if the comparisson is not correct, thus FALSE
Debug.Trace("I don't know the person who signed in ")
}
}
A boolean is a kind of variable which can only be two things: true or false. Or to put it in another way 1 or 0.
Booleans are used to compare things and to indicate if some comparisson is correct or not.
---------
Seeing your other thread too, I strongly suggest you read up on some basic beginners tutorials about programming (they exist in Dutch too, though every tutorial will use english terms as that is simply the common language for programming terms). You can find excellent books in the local library for instance which explains step by step the general basics about programming like what strings, parameters functions and booleans are.
If you go to your local library search a beginners book about general programming and a book about Jscript programming. You'll find them in the rayon with SISO code 525 to 528.
The reason why I say and suggest this is because it would be way too much to start explaining everything in detail in the proper way on a forum.
/ 
