Added annotations, improved README.
Further improvements in API and README.