From: Peter Mount <peter@retep.org.uk>
To: lockhart@fourpalms.org, Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-docs@postgresql.org
Cc: pgsql-jdbc@postgresql.org
Subject: Re: Java class documentation
Date: Sat, 24 Feb 2001 18:03:03 +0000
Message-ID: <5.0.2.1.0.20010224174716.009fa910@mail.retep.org.uk> (raw)
In-Reply-To: <3A96891A.951CDCC8@alumni.caltech.edu>
References: <Pine.LNX.4.30.0102222159580.1923-100000@peter.localdomain>
At 16:00 23/02/01 +0000, Thomas Lockhart wrote:
> > 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?
>
>Works for me. Not sure if we have rules for building javadoc in our
>makefiles, but I'm sure it would be easy to add if necessary. Peter M,
>what do you think?
As I just replied to PeterE, I was waiting for 7.1 to be out before
rewriting the docs from scratch. I was waiting because of time restraints
and I didn't want to mess up the exiting docs, especially as I knew you
needed time before release with the docs static.
What I'm working on for the jdbc site is a set of API docs explaining the
PostgreSQL specific extensions, and a set of tutorials. The tutorials range
from the basic stuff (replacing the examples in the source), to writing
Servlets with PostgreSQL, EJB's, Corba etc.
Now a Javadoc->DocBook converter should be easy. In fact you can get
javadoc to do it for you using the Doclet API. Should be real easy to do.
Peter
> - Thomas
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: peter@retep.org.uk, peter_e@gmx.net, pgsql-jdbc@postgresql.org
Subject: Re: Java class documentation
In-Reply-To: <5.0.2.1.0.20010224174716.009fa910@mail.retep.org.uk>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox