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, the externalizer should be removed. the example is to give an idea how the converter can be used and the externalizer is not important.