db-derby-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Susan Cline <home4...@pacbell.net>
Subject Re: [WWD] Chap 1 and 2 (v 1.1) submitted for review
Date Tue, 07 Mar 2006 23:59:15 GMT
--- Stanley Bradbury <Stan.Bradbury@gmail.com> wrote:

[snip]
> >>I've submitted Chapters 1 and 2 of the Work With Derby [WWD] document
> >>for feedback.  These sections are based on the version 1.1 proposal
> >>submitted last week.  You can download the formatted PDF document for
> >>review and comment using the following URL.
> >>
> >>http://issues.apache.org/jira/secure/attachment/12323814/workingwithderby0306.pdf

[snip]

> >(4) pdf page 6 (printed page 4), step 8 shows the "shutdown=true"
> >command. Since Activity 1 shows embedded use and "exit" in an embedded
> >environment automatically performs that shutdown=true
> >(http://db.apache.org/derby/docs/dev/tools/rtoolsijcomref33358.html), I
> >wonder if you could delay showing that syntax and the error that gets
> >produced until the next activity with the client driver.
> >
> >  
> >
>  >>> You are correct that this could be introduced in activity 3 (JDBC 
> with the embedded driver). There are two reasons I chose to place the 
> topic here:
> 1) It is a counter point to the item in the 'Summary' of the next 
> activity,  outline point:
>    >>  Best practice - shutdown the server do not shutdown the database 
> from a client
> 2) I believe that introducing concepts a few at a time across the 
> activities is better than creating a 'dense' topic by lumping everything 
> into one activity (in this case Activity3).
>  >>> I am leaning towards deferring introducing 'shutdown' until 
> Activity 3 since IJ does properly automate the process.  The recent 
> revision of WWD does take advantage of the automations provided by 
> derbygo.jar and IJ.  I would like to hear some other opinions on this if 
> we are to keep the document as-is.
> 

Hi Stan,

I think it would be nice to defer the shutdown=true to Activity 3.  It would make the output
for
Activity Sequence 1 look a little bit cleaner and be a little bit kinder, gentler, introduction
to
Derby :-)

Susan

Mime
View raw message