db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rick Hillegas <Richard.Hille...@Sun.COM>
Subject Re: JDBC4 documentation, was: [jira] Commented: (DERBY-1079) Build javadoc under jdk 1.6
Date Tue, 09 May 2006 19:46:41 GMT
Thanks, Andrew. I think I'm beginning to track what you're proposing. 
Your directory structure is very similar to what's in my patch for 1079, 
except for the following:

o the subdirectory names are a little different under the javadoc directory
o I put the index.html in the javadoc directory rather than at the top
o your proposed index.html is more capable than what I wrote

Here's what's in the patch:

...
javadoc
  jdbc3
  jdbc4
  index.html
...

Is the following then a fair summary of your patch comment:

o I will remove my index.html from the patch
o At your leisure, you can create a more capable, top level index.html 
and wrestle with the release machinery to get it into our release 
distributions

Hope I'm not talking at cross-purposes still.

Thanks,
-Rick




Andrew McIntyre wrote:

> On 5/9/06, Rick Hillegas <Richard.Hillegas@sun.com> wrote:
>
>> Hi Andrew,
>>
>> I don't think I understand your proposal. Do you want 10.2 to contain
>> two bundles of documentation with a high level html page that switches
>> between the two:
>>
>> 1) A bundle of user guides and javadoc for JDBC3 and
>>
>> 2) A separate bundle of user guides and javadoc for JDBC4?
>
>
> No, just:
>
> demo
> docs
>  html
>  pdf
> frameworks
> javadoc
>  publishedapi3.0
>  publishedapi4.0
> lib
> index.html
>
> and index.html has the links into the 3.0 and 4.0 javadocs, as well as
> pointers to the various manuals, the same ones we have today. And, now
> that I'm thinking of it, also into the demo html files as well. So, a
> master index.html for the distribution.
>
> andrew



Mime
View raw message