XDoclet Overview News and Status Download/Installation Using XDoclet Best Practices FAQ License Ant Task Reference <ejbdoclet .. /> <webdoclet .. /> <hibernatedoclet .. /> <mockdoclet .. /> <jdodoclet .. /> <jmxdoclet .. /> <doclet .. /> Tag Reference apache (@soap @struts) bea (@weblogic) borland (@bes) caucho (@resin) ejb (@ejb @dao) exolab (@castor) hp (@hpas) hibernate (@hibernate) ibm (@websphere) java (@javabean) jboss (@jboss) jdo (@jdo) jmx (@jmx) macromedia (@jrun) mockobjects (@mock) mvcsoft (@mvcsoft) mx4j (@mx4j) objectweb (@jonas) oracle (@oc4j) orion (@orion) pramati (@pramati) sybase (@easerver) web (@web @jsp) webwork (@webwork) xdoclet (@xdoclet @doc) Feature Documentation Using Value Objects Advanced Maven Plug-in Merge Points Log4J Configuration IDE Integration Migration from EJBDoclet Ant 1.5 Troubleshooting Community Feedback Resources Tools Development Developer Guide Javadoc (API) Template Language (*.xdt) XJavaDoc Site Project Documentation Front Page Project Info Project Reports Development Process | ### Feedback #### Support First, you should know that many people ask us about things that aren't really related to XDoclet. Would you ask your IDE manufacturer why how to specify an EJB finder query? Hopefully not. You shouldn't ask us either. There are better forums for that. We receive an astonishing amount of support requests, and handling them can be a big burden. One of the reasons we receive so many requests is that many people don't bother to figure out what their problem relates to. Just because XDoclet can generate for example JBoss deployment descriptors, it doesn't necessarily mean we can be held responsible for generation of incorrect code. More importantly, we might not even know how to help you with JBoss . If you have successfully managed to run XDoclet and generate files, but you think there is something wrong with the generated files, there can be many causes for this. Possible causes are (with decreasing probability): You have incorrect tags in your Java class. Missing tags, bad parameters, tags in wrong places etc. Please consult the Tag Reference carefully. Examining the samples is also helpful. You have incorrect subtasks and parameters in your build script. Please consult the Ant Task Reference carefully. Examining the samples' build file is also helpful. You have bad classpath settings. Make sure the classpath you pass to the taskdef you're using to define an XDoclet task in your ant script contains all the jar files in the lib directory, and all the jar files containing the classes on which your tagged classes depend (struts.jar, ejb.jar, servlet.jar, etc.) You have found a bug (see below). #### Issues If you believe you found a bug in XDoclet, or you would like to see a new feature implemented, please follow these guidelines: Verify that the issue isn't reported before (search for previously posted issues). Chances are the issue is already reported and fixed in CVS. If it is, please try the CVS version and see if that works for you. Search the mailing lists and see if anything is written about it ( xdoclet-user on Geocrawler , xdoclet-devel on Geocrawler ). If you do not find anything, please report the issue , and include a detailed description on how to reproduce it. Filing improvements (patches) is the preferred way to get bugs fixed quickly. #### QUICK HOWTO: Reporting issues in JIRA Some people find it difficult to log issues (bugs, feature requests, patches) in JIRA. Here is a quick howto: Go to http://opensource.atlassian.com/projects/xdoclet/ . If you haven't got an account in this JIRA system, create one by following the "Signup" link. Then log in. Follow the "New Issue" link at the top of the page. Select the project (XDoclet, XJavaDoc...). NOTE: Issues for XDoclet 2 should be reported in the seperate XDoclet 2 project. Select the issue type: Bug: You have discovered some incorrect behavior in the software. New Feature: You'd like to see some new feature. Task: You want to record "something to do" for the developers. Improvement: You want to contribute with some code. Maybe a bugfix (also known as patch). Click the "Next >>" button. Fill in as much info as you can on this page. Click the "Create" button.