commented / javadoc-ed version of the tala project as it stood at the end