updating docs, tracking down test warnings