Received: from mail.retep.org.uk ([216.126.85.184]) by mail.postgresql.org (8.11.1/8.11.1) with ESMTP id f1OHmpx87697; Sat, 24 Feb 2001 12:48:51 -0500 (EST) (envelope-from peter@retep.org.uk) Received: from heather.retep.org.uk ([193.113.117.105]) (authenticated) by mail.retep.org.uk (8.11.1/8.11.1) with ESMTP id f1OHmhR87692; Sat, 24 Feb 2001 12:48:44 -0500 (EST) (envelope-from peter@retep.org.uk) Message-Id: <5.0.2.1.0.20010224174419.009f8ba0@mail.retep.org.uk> X-Sender: peter@mail.retep.org.uk X-Mailer: QUALCOMM Windows Eudora Version 5.0.2 Date: Sat, 24 Feb 2001 17:47:00 +0000 To: Peter Eisentraut , From: Peter Mount Subject: Re: Java class documentation Cc: In-Reply-To: Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii"; format=flowed X-Archive-Number: 200102/140 X-Sequence-Number: 400 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@gmx.net http://yi.org/peter-e/