corrected initialisation.  Added readme notes.