Received: from barry.xythos.com (h-64-105-36-191.SNVACAID.covad.net
	[64.105.36.191])
	by postgresql.org (8.11.3/8.11.4) with ESMTP id fA64MSq94651
	for <pgsql-jdbc@postgresql.org>; Mon, 5 Nov 2001 23:22:33 -0500 (EST)
	(envelope-from barry@xythos.com)
Received: from xythos.com (localhost.localdomain [127.0.0.1])
	by barry.xythos.com (8.11.6/8.11.6) with ESMTP id fA657hZ01985;
	Mon, 5 Nov 2001 21:07:43 -0800
Message-ID: <3BE7701F.9080606@xythos.com>
Date: Mon, 05 Nov 2001 21:07:43 -0800
From: Barry Lind <barry@xythos.com>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.5) Gecko/20011012
X-Accept-Language: en-us
MIME-Version: 1.0
To: Peter Eisentraut <peter_e@gmx.net>
CC: pgsql-jdbc@postgresql.org
Subject: Re: Documentation PostgreSQL-specific JDBC methods
References: <Pine.LNX.4.30.0111051752210.617-100000@peter.localdomain>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
X-Archive-Number: 200111/61
X-Sequence-Number: 2258

Peter,

Yes I agree.  When you suggest putting an 'external link', what do you 
mean by external?  Does external mean a link to jdbc.postgresql.org web 
site where the javadoc would be hosted, or a link to some html javadoc 
generated files that are part of the distribution?

thanks,
--Barry

Peter Eisentraut wrote:

> The Programmer's Guide section 8.6 documents PostgreSQL-specific
> extensions to the JDBC standard, such as the large object and the fastpath
> interfaces.  Right now most of this is just one big monospaced environment
> with ASCII markup.  I've tried to convert some of this to real DocBook
> markup in the past, but this process was just tiresome because the
> structure of the documentation could not be rendered very well in DocBook.
> 
> I think this could probably be done better by generating this material
> directly with Javadoc and putting an external link in the DocBook-based
> documentation.
> 
> Comments?
> 
>