OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: classsynposis and java annotations


Hello,

I'm trying to add the new java annotation feature to my DocBook doclet
(dbdoclet), but I'm not sure what markup to use.
There are a couple of problems:

1. Using an annotation

Example:

Source
@Copyright("Michael Fuchs")
public String getVersion();

<methodsynopsis language="java">
  <modifier>@Copyright(value="Michael Fuchs")</modifier>
  <modifier>public</modifier>
  <type>String</type>
  <methodname>getVersion</methodname>
</methodsynopsis>

The annotation could marked as modifier, but I think this is not
satisfying.
Additionally the annotation should be rendered in a single line.

2. Defining an annotation

What about a tag ooannotation similar to ooclass, oointerface and
ooexception?


3. By the way, does anybody know if it is possible to generate a more
compact synopsis and get rid of all the blank lines?

public class Annotations {
// Public Constructors

  public Annotations();

// Public Methods

@Copyright(value="dbdoclet") @Todo(value="Update") public String
getRelease();


@Copyright(value="dbdoclet") public String getVersion();


public String toString();

}

Regards
Michael



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]