Add some more examples and enhance documentation

[t-b]

• http://info-igor.org/IgorMessages/2018/09/Info-Igor_2018-09_0011.html
• And also one for calling a function with arguments
• Enhance python example code, add also error checking
• Mention that checking return values is strongly encouraged

Make these prominent in the documentation