#4 Generate task/subtask docs


We should tag tasks and subtasks with @tags and use
that to generate docs for subtasks.


  • Aslak Hellesřy

    Aslak Hellesřy - 2002-05-21
    • assigned_to: nobody --> rinkrank
  • Aslak Hellesřy

    Aslak Hellesřy - 2002-06-11
    • assigned_to: rinkrank --> nobody
    • priority: 5 --> 7
  • Aslak Hellesřy

    Aslak Hellesřy - 2002-06-11

    Logged In: YES

    The documentation of a task and a subtask is basically the
    same: We want to generate a HTML table with three columns
    la standard Ant task documentation: attribute name,
    description and required.

    attribute name can be derived from the method name. Ex:
    setFoo(String s) -> attribute name = foo

    description can be derived from the Javadoc comment.

    Required can be documented in a tag. I suggest we put
    @task.attribute required="Yes|No" on all setBlaBla methods
    in all Tasks and SubTasks.

    Then what we need is an XDoclet template that will generate
    the HTML docs based on the above rules. -And this must be
    invoked in modules-common.xml and also in
    xdoclet/core/build.xml (to document DocletTask which is not
    in modules).

    The class header javadoc can be used to extract the general
    blabla documentation.

    This approach should work equally well for Tasks and
    SubTasks, the template should also check for the presence
    of the @xdoclet:subtask tag. If it exists, we're dealing with
    subtask documentation generation, and based on that
    knowledge we can generate slightly different docs and include
    the information from the tag.

  • Mathias Bogaert

    Mathias Bogaert - 2002-06-11
    • assigned_to: nobody --> pathoss
  • Aslak Hellesřy

    Aslak Hellesřy - 2002-06-12
    • assigned_to: pathoss --> rinkrank
    • status: open --> open-fixed
  • Aslak Hellesřy

    Aslak Hellesřy - 2002-06-12

    Logged In: YES

    This is implemented now. The remaining work is only to make
    it look nice. A table with a dynamic right column would be

  • Andy Stevens

    Andy Stevens - 2004-12-22
    • status: open-fixed --> closed-fixed

Log in to post a comment.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.

No, thanks