documentation updated, fixes with unicode issues