Adding field elements to a class

Hi, all.

I'm trying to write some documentation for some classes. However, I've
run into an issue when trying to add more <field> elements. Whenever I
do add a new <field> element, the field is shown, along with its short
description on the class page however it doesn't hyperlink to its
documentation entry (which *is* created - just not accessible easily).

Here is the field element I add:

<field id="gdk.gdkevent.field.state">
 <fieldname>state</fieldname>
 <fieldtype>int</fieldtype>
 <shortdesc> ... </shortdesc>
 <desc> ... </desc>
</field>

Is there anything else I should doing to have this fieldname
"registered"?

Thanks,
Mark.

P.S. I hope you don't mind me CC'ing you guys.