Clean the recycle bin API to make it more usable

The recycle bin works with wiki-level index numbers for addressing restored documents, however, the API keeps asking for either (fullName, locale) String pairs or, some times even worse, XWikiDocument instances.

Most of the time this creates confusion and some times it can even block really basic usecases (like getting a deleted document by ID, without knowing the actual XWikiDocument to which it belongs, since you should find out after getting it). See some details at https://github.com/xwiki/xwiki-platform/commit/1d8e1172757a75cda44398820505dacf384e0a56#commitcomment-21860183

Since the API is very old and practice proved that asking for an XWikiDocument instance is not justified, an approach would be to deprecate the old signatures and expose simpler ones that are more clear and don`t get in the way of the API's user.