Passing multiple text arguments into Sikuli.

At least for version 1.0.1 this works already for the IDE:

- in the start-up splash screen you can enter in the parameter field:

-- test1 test2 test3

and in the IDE at script run the sys.argv contains the 3 strings beginning at 1

e.g.
for e in sys.argv[1:]: print e

will print
test1
test2
test3

Be aware: if a parameter string contains blanks, you currently have to mask them with an otherwise unused character, that you replace before using the parameter, because the parameter handling uses space as delimiter.
This will be easier in version 1.1

e.g. parameters
test#me#now test2

will give with
for e in sys.argv[1:]: print e.replace("#", " ")

test me now
test2

using from command line:

runIDE -r some_script.sikuli -- test1 test2

Should I use the type or print function to fill the text fields?

ie. with the third argument being a3:

sys.argv[1:]: type a3.replace("#"," ")

If i need returns in the entry I am guessing I will need to break each paragraph into separate arguments and press the return key in between them.

The documentation on the functions and their usage can be found in which base language?

ok, Sikuli script talks Python.

the above example was only, to check wether this works for you printing the contents to the message area.

To use the values, you have to assign them to variables or a list, that you the use with type.

e.g.
to get all supplied vars in a list and use them with type afterwards.

vars = [] # empty list
for e in sys.argv[1:]:
    vars.append( e.replace("#", " ") )

type(vars[3])
type(Key.ENTER)