add hierarchy documentation and prune irrelevant BtdiggSearchResult members

* rebased on current upstream master
* added documentation of search classes hierarchy
* changed type of BtdiggItem.files and BtdiggItem.reqs from long to int
* wrapped deserialization of BtdiggResponse in a try-catch