Improve scaladoc comments and clean up API for Slick 2.1.

- Lots of new and improved doc comments.

- Deprecate Query.where and restrict Query.filter and Query.filterNot
  to only accept Columns. Desugaring of for-comprehensions will always
  generate calls to withFilter which still allows plain Booleans.

Review by @cvogt