added documentation on terminators etc.