giving an example in the docs of an alist with duplicates
adding a usage example
actually ensure the examples work!