added a lot of examples to docu and documented data(nose)
added docu for function 'barycenter' and prefixed some strictly internal functions with '.' to avoid them getting exported to user space