I decided to encourage proper usage in the source xdocs, to use an xpointer attribute. A sitemap transformation appends it to the href attribute, to do it in Cocoon's old way. When this is fixed at Cocoon, then we can reverse this.
See https://issues.apache.org/jira/browse/FOR-1088 -David
