pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Peter Mount <peter@retep.org.uk>
To: Peter Eisentraut <peter_e@gmx.net>
To: pgsql-docs@postgresql.org
Cc: pgsql-jdbc@postgresql.org
Subject: Re: Java class documentation
Date: Sat, 24 Feb 2001 17:47:00 +0000
Message-ID: <5.0.2.1.0.20010224174419.009f8ba0@mail.retep.org.uk> (raw)
In-Reply-To: <Pine.LNX.4.30.0102222159580.1923-100000@peter.localdomain>

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/




view thread (7+ messages)  latest in thread

Message-ID: <5.0.2.1.0.20010224174419.009f8ba0@mail.retep.org.uk>
Permalink:  ../5.0.2.1.0.20010224174419.009f8ba0@mail.retep.org.uk/
Also on:    postgresql.org/message-id/5.0.2.1.0.20010224174419.009f8ba0@mail.retep.org.uk

 · 

reply

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 from your mail client; the link fills in
  the headers below: reply via email
  Some clients, webmail especially, drop In-Reply-To and References from
  a link, and the reply then starts a new thread: use the mbox below.

  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.20010224174419.009f8ba0@mail.retep.org.uk>
  References: <Pine.LNX.4.30.0102222159580.1923-100000@peter.localdomain> <5.0.2.1.0.20010224174419.009f8ba0@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