removed obsolete note and added some more example for usage.  also set the locale to utf8