Improve documentation of Document::setPageTextSelection()

Summary:
Improve the documentation of Document::setPageTextSelection()
and PagePrivate::setTextSelections(). Also mention which argument
will be deleted.

Test Plan: Check doxygen output

Reviewers: Okular, aacid

Reviewed By: Okular, aacid

Subscribers: okular-devel

Tags: Okular

Differential Revision: https://phabricator.kde.org/D21069