Additions and clarifications to tutorial 1.
Referential data types may need to be declared.

And other small fixes.
Merge pull request #1107 from ReneSac/devel

Additions and clarifications to tutorial 1.