Fix warning and cleanup for BPath docs
Move BQuery docs into Haiku Book.

... removing the docs from the .cpp and .h files and cleaning up as usual.