refactoring functions comments (once again...)
better doc/functions generation
adding examples