more javadocs... also fixed a few typos...