added documentation for machine interface