A couple of corrections for the Gentoo Metadata documentation. A .diff follows.
Created attachment 96171 [details, diff] hb-guide-metadata.xml.diff
Fixed in CVS, thanks. Not sure what the second hunk of your patch was about, looked like a typo to me so I didn't change that.
Uhm, it was not a typo. AFAIK, in XML, '<' and '>' in places other than tags are illegal; '<' and '>' should be used instead. This is what the docs say too, if I am not mistaken. But to have HTML to display '<' and '>' properly in the guide, one needs to use the HTML entity of '&', thus '&lt;' and '&gt;'. Otherwise '<', '>' are rendered back to '<', '>' in HTML.
Fixed -- I didn't notice the example was one of XML, thanks for the explanation :)
He he, thanks for noticing, fixing & explaining :) Only & and < need an entity. We often use > to be safe and balance <, but > would work fine. " and ' are almost never required, except when mixed inside an attribute. I changed some " to " and used sources.g.o in a link FYI, I took this opportunity to add the <version> and <date> tags. They were meant to become compulsory a long time ago and it's about time someone took care of this.
Oh OK. It's just that the example was inconsistent with the paragraph above it that said "use < and > instead of < and >". Anyhow, glad to contribute.