cleaned up doc strings and commenting; removed one obsolete function; now check for empty titles and report as error