documents; add documentation for new variable attributes; bump copyright into 2009.
Waldemar Osuch for contributing the initial draft of the new documentation.