update to the language reference
added documentation to some scripts