I reported the lack of reference as a bug to Novell, since David Reveman the creator of Xgl and this plugin, works at Novell. He told me that a new major revision of the plugin will arrive in the future, and that proper docs and a reference client implementation will come with it.