Announcement Announcement Module
No announcement yet.
Multiline tag description in xdoclet? Page Title Module
Move Remove Collapse
Conversation Detail Module
  • Filter
  • Time
  • Show
Clear All
new posts

  • Multiline tag description in xdoclet?

    Since xdoclet1 seems to be all but dead (too bad) I have been playing around
    with xdoclet2. One of the problems that I am running into is handling
    hibernate queries.

    In xdoc1 I have code like:

    * @hibernate.class
    * ...
    * @hibernate.query
    * name = "some_long_query"
    * query = "from SomeClass c where
    * c.someParam1 = :some_value and
    * c.someParam2 = :some_value2 and
    * c.someParam3 = :some_value3"

    When I use this same code with xdoc2 it blows up. I believe the problem is
    that xdoc2 can't handle multiline values like xdoc1 could. Is there a
    work-around for this? Our coding standard requires lines no longer than 80
    characters. Besides, it makes the code a whole hell of a lot easier to read
    if you can split the query string up sanely.

    Any ideas?

  • #2
    Currently using xDoclet2 and Hibernate3. I have not tried to use multiline tag attributes and not going to switch back to xDoclet1.x
    However, as I can see from CodeHaus bag tracking, there is an issue here related to the problem described above. They have some work-around for something which is called QDox. I tried to use escaped new lines in attribute value as they recommend - it doesn't work for Xdoclet2 hibernate pluging.