Update some documentation to make it clearer.  No bug, DONTBUILD