documentation, added to philasys list
tidying up
looking for exceptions in new coding