Maintenance in adjoin

Simply make the documentation a DDoc'ed unittest.

Also make it take by auto-ref.