Fix .demote() in regards to .query_raw()

If the dev has specified .query_raw(), that should cause EU to ignore
*all* things that modify the query clause of the search including
.query(), .demote() and .boost().

This fixes that, updates the test and updates the docs. While I was doing
that I fleshed out the docs for .boost() and .demote().

r?