When I run javadoc on my source, I get the following message for every hibernate xdoclet tag:

"@hibernate.xxx is an unknown tag".

FYI, the hibernate tags work fine when using a hibernatedoclet ant task to generate *.hbm.xml files.

What is going on here?

Are you using Ant or Maven?

Here's something from an ant file that's doing the javadoc for me, it gets ride of all the @hibernate.component or @hibernate.property etc problems, but it does miss the @hibernate.one-to-many, javadocs seems to get upset over the hyphens

<target name="javadoc" depends="prepare">
<javadoc packagenames="*"
sourcepath="${java.src.dir}"
defaultexcludes="yes"
destdir="${javadoc.dest.dir}"
author="true"
stylesheetfile="${basedir}/javadocs.css"
version="true"
use="true"
verbose="no"
breakiterator="true"
classpathref="compile.classpath"
private="true"
windowtitle="CCG Version 1 API">
<doctitle><![CDATA[<h1>Test</h1>]]></doctitle>
<bottom><![CDATA[<i>Copyright © 2004 CCG Corp. All Rights Reserved.</i>]]></bottom>
<tag name="to.do" scope="all" description="To do:" />
<tag name="hibernate.property" enabled="true"/>
<tag name="hibernate.id" enabled="true"/>
<tag name="hibernate.class" enabled="true" description="&lt;br/&gt;Persistent Hibernate Class."/>
<tag name="hibernate.component" enabled="true" description="&lt;br/&gt;Hibernate Component." />
<tag name="hibernate.set" enabled="true" description="&lt;br/&gt;Hibernate Set Descriptor." />
<tag name="hibernate.set" enabled="true" description="&lt;br/&gt;Hibernate Set Descriptor." />
<tag name="hibernate.collection-key" enabled="true" description="&lt;br/&gt;Column carrying the unique foreign relation id." />
<tag name="hibernate.one-to-many" enabled="true" description="&lt;br/&gt;Defining the 'one' side of the many-to-one" />
<tag name="hibernate.many-to-one" enabled="true" description="&lt;br/&gt;Defining the 'many' side of the many-to-one" />
<link href="http://java.sun.com/j2se/1.4.2/docs/api"/>
<link href="http://www.springframework.org/docs/api"/>
</javadoc>
</target>