Fix and improve the SearchContext documentation

"but at most one search context per buffer can
highlight its search occurrences"

This limitation has been lifted, and the doc was not updated. Anyway it
is explained in more details in a next paragraph.