Docs enhancements

Include deprecated methods in the Javadocs and add a legend to the supported formats table.  Requested by @manics and @hflynn.