passing all tests; fixed non-trivial warnings related to documentation