Clarifications. New example.

Clarified the documentation, the comments, the examples, and added a
fire example.
!!! Changed signature of the particle spawn for more convenient
spawning !!!