ISPN-4364 Add documentation for Entry Retriever

* Added documentation for retriever
* Also made sure that filter package is public as it should be

https://issues.jboss.org/browse/ISPN-4364
IMO, replace ```OOM``` by ```out of memory```