general functional handling moved to separate namespace
examples updated
README updated