harmonize api as proposed by dodo
Merge pull request #14 from chris-rock/harmonize2

harmonize api as proposed by dodo