pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedDocumentation PostgreSQL-specific JDBC methods
3+ messages / 2 participants
[nested] [flat]
* Documentation PostgreSQL-specific JDBC methods
@ 2001-11-05 20:05 Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 3+ messages in thread
From: Peter Eisentraut @ 2001-11-05 20:05 UTC (permalink / raw)
To: pgsql-jdbc@postgresql.org
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?
--
Peter Eisentraut peter_e@gmx.net http://funkturm.homeip.net/~peter
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Documentation PostgreSQL-specific JDBC methods
@ 2001-11-06 05:07 Barry Lind <barry@xythos.com>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 3+ messages in thread
From: Barry Lind @ 2001-11-06 05:07 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-jdbc@postgresql.org
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?
>
>
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Documentation PostgreSQL-specific JDBC methods
@ 2001-11-07 01:08 Peter Eisentraut <peter_e@gmx.net>
parent: Barry Lind <barry@xythos.com>
0 siblings, 0 replies; 3+ messages in thread
From: Peter Eisentraut @ 2001-11-07 01:08 UTC (permalink / raw)
To: Barry Lind <barry@xythos.com>; +Cc: pgsql-jdbc@postgresql.org
Barry Lind writes:
> 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?
The latter. (The "external link" would be external to the DocBook realm.)
The files could go under $(docdir)/html/javadoc. If someone wants to work
on this, you're welcome. Otherwise I might get to it sometime.
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2001-11-07 01:08 UTC | newest]
Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2001-11-05 20:05 Documentation PostgreSQL-specific JDBC methods Peter Eisentraut <peter_e@gmx.net>
2001-11-06 05:07 ` Barry Lind <barry@xythos.com>
2001-11-07 01:08 ` Peter Eisentraut <peter_e@gmx.net>
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