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
maybe you can split this note in two and put a warning for the not supported ```remove()``` to make it more visible.