Re: Java class documentation

From: Peter Mount <peter(at)retep(dot)org(dot)uk>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>, <pgsql-docs(at)postgresql(dot)org>
Cc: <pgsql-jdbc(at)postgresql(dot)org>
Subject: Re: Java class documentation
Date: 2001-02-24 17:47:00
Message-ID: 5.0.2.1.0.20010224174419.009f8ba0@mail.retep.org.uk
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-jdbc

At 22:07 22/02/01 +0100, Peter Eisentraut wrote:
>I've started to finish up the not-marked-up-yet parts of the JDBC
>documentation, but most of this seems to have once been generated by
>javadoc, and I feel like it is probably a wasted effort to try to manually
>convert this to DocBook.

Actually I was waiting until 7.1 was out before rewriting the jdbc docs
from scratch (so much has changed since those were written).

>AFAIK, there is currently no Javadoc to DocBook converter available. This
>might be a worthwhile project, though.
>
>Could we for now remove the formal class documentation from the DocBook
>source, while keeping the narrative parts, and instead point people to the
>JavaDoc? Could we make prebuild class documentation in HTML available to
>users, maybe where the jars are downloaded?

Already a work in progress. You might be duplicating work already being
done for the jdbc site.

Peter

>--
>Peter Eisentraut peter_e(at)gmx(dot)net http://yi.org/peter-e/

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Mount 2001-02-24 18:03:03 Re: Java class documentation
Previous Message Survey-Admin@ATT-CustomerSat.com 2001-02-24 17:13:25 flowchart 404

Browse pgsql-jdbc by date

  From Date Subject
Next Message Peter Mount 2001-02-24 18:03:03 Re: Java class documentation
Previous Message Peter Mount 2001-02-24 17:43:41 Re: Fw: jdbc.postgresql.org/docs/