You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-user@db.apache.org by Stanley Bradbury <St...@gmail.com> on 2006/03/24 00:06:40 UTC
[WWD] Chap 3 and 4 submitted for review
I've submitted Chapters 1 and 2 of the Work With Derby [WWD] document
for feedback.
The latest revision of Working With Derby has been posted to Jira. It
can be downloaded using:
http://issues.apache.org/jira/secure/attachment/12324531/WWDpdfNjava0323.zip
This contains the newly completed chapters 3 and 4. Please focus first
on the initial review of these chapters. The PDF file and related JAVA
code are contained in the file: WWDpdfNjava0323.zip
The revisions of chapters 1 and 2 are also included. This is their
second review since restructuring the scope of the project and contain
modifications based on information from the first review. Please review
and comment on these revisions as time allows.
Format Change Note:
Chapters 1 - 4 contain a structural change to the Basic Activity Format
proposed. Feedback received (i.e. 'I keep jumping back and forth')
indicated that the Basic Activity Format (Item 1 on the 'Feedback
Requested' list) was not the best way to present this material. The new
format has the descriptive text interspersed with the command and
output examples. The new activity format is step description followed
by example then the next-step description followed by example, etc.
Some other changes that have been made besides correcting typOs and
syntax errors:
A short section describing each activity was added to Ch 1.
The toursDB.sql script with the anticipated path has replaced
'something.sql' as the script that is loaded in Activity 1.
References to 10.1 were updated to 10.2
The introduction is now warmer and more inviting. If you can think of
other eloquent words I might add, please let me know (I do not stand out
when it comes to being eloquent).
The introduction of shutdown=true was moved to Activity 3.
Responses to commands (aka output) is italicized to help differentiate
user input from output in the examples - for long command sequences
(e.g. running WwdEmbedded) the input is in bold.
Computer malfunction (was Re: [WWD] Chap 3 and 4 submitted for review)
Posted by "Jean T. Anderson" <jt...@bristowhill.com>.
yeradis wrote:
...
> because it do nothing, simple dont work, my windows do what he want :-p
...
> i'm investigating my windows if my windows is seek ...
...
It does sound like your computer might be sick (infected), Yeradis.
I did a quick search for "free antivirus software" and came up with these:
http://www.free-av.com/
http://free.grisoft.com/freeweb.php/doc/2/
Ff course, one should always be careful about downloading any free
software, but it's a good idea to run antivirus software.
regards,
-jean
p.s. The "..." is like the "SNIP" you noticed in Stan's email. It's a
way to respond to just the parts of a post you want to, and shorten the
post to make it easy for everyone to quickly read.
Re: [WWD] Chap 3 and 4 submitted for review
Posted by yeradis <ye...@gmail.com>.
Hi Stanley thanks for your sugerence
thatsss the problem
in windows starting from windows 2kx the console shell is cmd.exe
in 2k3 too i follow all steps and my windows tell me 'fuck you' jajajaaja
:-p
because it do nothing, simple dont work, my windows do what he want :-p
the SET command for the command promt of the console work since
version 6.2of msdos if my mind is no broken ;-)
i supposed when i read the derby reference that eill work but not work :-(
i use the derby because i named Yeradis :-p (i said this for dont use other
words that might be offensive :-p )
i use it like you read because i used other way a little hard way compared
with the suggested in the setup of derby
i'm investigating my windows if my windows is seek i will kill him :-p ;-)
and bill gates too for give me a sekk version of windows :-p
thanks stanley for your words and yours work
an observation : is no a bit complicated the new desing of the new chapter??
, i mean the new that using the external file , i mean switchinf from a side
to another, can be incrusted , put the code in the same doc ??? a lines of
what you write
for example
1 #include iostream.h
2 void main (void)
3{
4 cout << "Hello world";
5}
2 - the main function is needed in all programs , here ocurrs the execution
of the code
...
4 - here we send a message to the console output and the it is printed on
the screen
i refer to this , with the code inside document, i saw the code and it is a
lot of lines
but i think that can be included only the lines that your are interested in
show and explain
and attach the entire code in an Anexo or appendix , i dont know how is
called this section in english books , articles sorry
i hope that you can understandme with a tried to say :-(
thanks again stanley and follow this great jod your are doing
On 3/27/06, Stanley Bradbury <St...@gmail.com> wrote:
>
> yeradis wrote:
>
> > hi stanley , GREAT JOB
> >
> > there is a problem (i think is a problem maibe not) but
> > in ALL documents i had read said the same way to configure the derby
> > engine on windows
> > and say
> >
> > On Windows platforms:
> > -------------------------------------------
> > set DERBY_HOME=C:\derby
> > md DERBYDBS
> > cd DERBYDBS
> > copy %DERBY_HOME%\demo\scripts\toursDB.sql .
> >
> >
> > the command SET for me on windows dont work on any way
> > maibe my windows is guilty, i have windows 2003 enterprise edition
> > and dont handle the console command very well , i dont know , but i
> > tried to setup parameters on windows using the way that is described
> > in all documents and no one work for me
> > i want to think is my windows that has a problem
> >
> > i can use derby because i go directly to the derby database and use
> > all frome there
> >
> > for example if i want to go to use IJ i point my console path to
> > C:\DB-Derby-10.1.2.1-bin\frameworks\embedded\bin
> >
> > i mean
> >
> > c:\>cd DB-Derby-10.1.2.1-bin\frameworks\embedded\bin
> >
> > and use it
> >
> > if i want to use the derby to test some options i say to me JBuilder ,
> > that the derby driver is a library required by my project
> >
> > i'm was working on the solution to try to fix this problem of the
> > setup for me and to comunicate how i fixed , but i cant in this
> > momento there is a problem with a system i built and the problem is
> > with core of the operating system :-(
> >
> > very well stanley i think is very good your job
> >
> > and Jeff Levitt
> > you have the rigth on some of your topic , but stanley is writing
> > listening the opinion from people like us you and me jeff, and others
> > course
> >
> > maibe how now , tomorrow stanley found a new way to write that is
> > accesible to all us and change the format of the book he is writing
> >
> > jeff --> i think the answer is that it is a document for users who are
> > more advanced, and so I think we could skip some of the more basic
> > descriptions of what the code is doing. We should focus more on the
> > Derby-specific steps
> >
> > i think you have true but not in all
> > yes is true that can have more adanced skills
> >
> > but i think the work that stanley is doing MUST BE FOR EVERY BODY i
> > dont think what stanley think sorry to speak by me
> > but i think mus be for beginners users to advanced users , increasing
> > the percent of skills
> > i need to have points for beginners and for for medium user and for
> > advanced users
> >
> > and if you are an advanced user just skip the part you think is to
> > obvious to you and go to the point that is from your interest
> >
> > stanley i think you must give your opinion of what is the orientation
> > of your work wtih your write
> >
> > from beginner , medium , advanced ???
> >
> > jeff is true that stanley need found the BEST format for what he is
> > writing
> >
> > but if he want and i thinks yes , he will listen our all opinions and
> > the decide waht to do
> >
> > stanley here you have my hand and mind if you want and opinion
> >
> > thanks again stanley for your job
> >
> > and sorry for my english people
> >
> ... S N I P ...
> HI Yeradis -
>
> I checked some Win2K3 docs online and they list the SET command as being
> available like on the other Windows OS so I am wondering if what you are
> using (you refer to it as the 'console command') is a different
> environment from a CMD.EXE shell which supports the commands
> documented. Start a command shell by Clicking on 'Start / Run' then
> type 'cmd.exe' in the dialog box and click 'OK'. This should start a
> shell that will support the commands documented in the WWD document.
> There should be help for CMD.EXE in the Windows Help.
>
> Please let me know if this resolves your problem.
>
>
>
>
Re: [WWD] Chap 3 and 4 submitted for review
Posted by Stanley Bradbury <St...@gmail.com>.
yeradis wrote:
> hi stanley , GREAT JOB
>
> there is a problem (i think is a problem maibe not) but
> in ALL documents i had read said the same way to configure the derby
> engine on windows
> and say
>
> On Windows platforms:
> -------------------------------------------
> set DERBY_HOME=C:\derby
> md DERBYDBS
> cd DERBYDBS
> copy %DERBY_HOME%\demo\scripts\toursDB.sql .
>
>
> the command SET for me on windows dont work on any way
> maibe my windows is guilty, i have windows 2003 enterprise edition
> and dont handle the console command very well , i dont know , but i
> tried to setup parameters on windows using the way that is described
> in all documents and no one work for me
> i want to think is my windows that has a problem
>
> i can use derby because i go directly to the derby database and use
> all frome there
>
> for example if i want to go to use IJ i point my console path to
> C:\DB-Derby-10.1.2.1-bin\frameworks\embedded\bin
>
> i mean
>
> c:\>cd DB-Derby-10.1.2.1-bin\frameworks\embedded\bin
>
> and use it
>
> if i want to use the derby to test some options i say to me JBuilder ,
> that the derby driver is a library required by my project
>
> i'm was working on the solution to try to fix this problem of the
> setup for me and to comunicate how i fixed , but i cant in this
> momento there is a problem with a system i built and the problem is
> with core of the operating system :-(
>
> very well stanley i think is very good your job
>
> and Jeff Levitt
> you have the rigth on some of your topic , but stanley is writing
> listening the opinion from people like us you and me jeff, and others
> course
>
> maibe how now , tomorrow stanley found a new way to write that is
> accesible to all us and change the format of the book he is writing
>
> jeff --> i think the answer is that it is a document for users who are
> more advanced, and so I think we could skip some of the more basic
> descriptions of what the code is doing. We should focus more on the
> Derby-specific steps
>
> i think you have true but not in all
> yes is true that can have more adanced skills
>
> but i think the work that stanley is doing MUST BE FOR EVERY BODY i
> dont think what stanley think sorry to speak by me
> but i think mus be for beginners users to advanced users , increasing
> the percent of skills
> i need to have points for beginners and for for medium user and for
> advanced users
>
> and if you are an advanced user just skip the part you think is to
> obvious to you and go to the point that is from your interest
>
> stanley i think you must give your opinion of what is the orientation
> of your work wtih your write
>
> from beginner , medium , advanced ???
>
> jeff is true that stanley need found the BEST format for what he is
> writing
>
> but if he want and i thinks yes , he will listen our all opinions and
> the decide waht to do
>
> stanley here you have my hand and mind if you want and opinion
>
> thanks again stanley for your job
>
> and sorry for my english people
>
... S N I P ...
HI Yeradis -
I checked some Win2K3 docs online and they list the SET command as being
available like on the other Windows OS so I am wondering if what you are
using (you refer to it as the 'console command') is a different
environment from a CMD.EXE shell which supports the commands
documented. Start a command shell by Clicking on 'Start / Run' then
type 'cmd.exe' in the dialog box and click 'OK'. This should start a
shell that will support the commands documented in the WWD document.
There should be help for CMD.EXE in the Windows Help.
Please let me know if this resolves your problem.
Re: [WWD] Chap 3 and 4 submitted for review
Posted by yeradis <ye...@gmail.com>.
ah , ok Jeff
the problem is that in other forum i express with no intention to offend
anybody
but my little english and the way i join the words offend to they
and i try to explain that here , no is my intention to offend anybody
the problem is with my english :-(
really the problem is there ae many languages in my head :-(
and i need a better database to store all that information :-P
and i think like you , stanley will catch our feedbacks and will do
something really helpfull to all us
we do not need to aprove what he does , be he will be not free about
criteria on what is he doing :-p
sorry stanley you know that when we do something not only for us , the other
people always will give what they think
i think this is the best
this is a mark that say that our work is appreciated in some way ;-)
thanks to you Jeff and thanks for you to0 Stanley
On 3/24/06, Jeff Levitt <de...@mylevita.com> wrote:
>
> No worries, Yeradis, this is a forum where opinions
> are expressed freely, and I know Stan will take your
> opinion and mine into account and write a guide that
> all of us will approve. The more feedback the better,
> and my comments were meant to start a discussion, so
> thank you for carrying it on.
>
> Jeff
>
> --- yeradis <ye...@gmail.com> wrote:
>
> > sorry if my words seem to crude that no was my
> > intention really
> > sotty
> > the problem is that my litttle english sometime dont
> > have other words to
> > write waht i think
> > Jeff sorry to you too
> >
> > and sorry to everybody really
> >
> > Yeradis P. Barbosa Marrero
> >
> > On 3/24/06, yeradis <ye...@gmail.com> wrote:
> > >
> > > hi stanley , GREAT JOB
> > >
> > > there is a problem (i think is a problem maibe
> > not) but
> > > in ALL documents i had read said the same way to
> > configure the derby
> > > engine on windows
> > > and say
> > >
> > > On Windows platforms:
> > > -------------------------------------------
> > > set DERBY_HOME=C:\derby
> > > md DERBYDBS
> > > cd DERBYDBS
> > > copy %DERBY_HOME%\demo\scripts\toursDB.sql .
> > >
> > >
> > > the command SET for me on windows dont work on any
> > way
> > > maibe my windows is guilty, i have windows 2003
> > enterprise edition
> > > and dont handle the console command very well , i
> > dont know , but i tried
> > > to setup parameters on windows using the way that
> > is described in all
> > > documents and no one work for me
> > > i want to think is my windows that has a problem
> > >
> > > i can use derby because i go directly to the derby
> > database and use all
> > > frome there
> > >
> > > for example if i want to go to use IJ i point my
> > console path to C:\DB-
> > > Derby-10.1.2.1-bin\frameworks\embedded\bin
> > >
> > > i mean
> > >
> > > c:\>cd
> > DB-Derby-10.1.2.1-bin\frameworks\embedded\bin
> > >
> > > and use it
> > >
> > > if i want to use the derby to test some options i
> > say to me JBuilder ,
> > > that the derby driver is a library required by my
> > project
> > >
> > > i'm was working on the solution to try to fix this
> > problem of the setup
> > > for me and to comunicate how i fixed , but i cant
> > in this momento there is a
> > > problem with a system i built and the problem is
> > with core of the operating
> > > system :-(
> > >
> > > very well stanley i think is very good your job
> > >
> > > and Jeff Levitt
> > > you have the rigth on some of your topic , but
> > stanley is writing
> > > listening the opinion from people like us you and
> > me jeff, and others course
> > >
> > > maibe how now , tomorrow stanley found a new way
> > to write that is
> > > accesible to all us and change the format of the
> > book he is writing
> > >
> > > jeff --> i think the answer is that it is a
> > document for users who are
> > > more advanced, and so I think we could skip some
> > of the more basic
> > >
> > > descriptions of what the code is doing. We should
> > focus more on the
> > > Derby-specific steps
> > >
> > > i think you have true but not in all
> > > yes is true that can have more adanced skills
> > >
> > > but i think the work that stanley is doing MUST BE
> > FOR EVERY BODY i dont
> > > think what stanley think sorry to speak by me
> > > but i think mus be for beginners users to advanced
> > users , increasing the
> > > percent of skills
> > > i need to have points for beginners and for for
> > medium user and for
> > > advanced users
> > >
> > > and if you are an advanced user just skip the part
> > you think is to obvious
> > > to you and go to the point that is from your
> > interest
> > >
> > > stanley i think you must give your opinion of what
> > is the orientation of
> > > your work wtih your write
> > >
> > > from beginner , medium , advanced ???
> > >
> > > jeff is true that stanley need found the BEST
> > format for what he is
> > > writing
> > >
> > > but if he want and i thinks yes , he will listen
> > our all opinions and the
> > > decide waht to do
> > >
> > > stanley here you have my hand and mind if you want
> > and opinion
> > >
> > > thanks again stanley for your job
> > >
> > > and sorry for my english people
> > >
> > >
> > > On 3/23/06, Stanley Bradbury
> > <St...@gmail.com> wrote:
> > > >
> > > > Susan Cline wrote:
> > > >
> > > > >--- Stanley Bradbury < Stan.Bradbury@gmail.com>
> > wrote:
> > > > >
> > > > >
> > > > >
> > > > >>I've submitted Chapters 1 and 2 of the Work
> > With Derby [WWD] document
> > > > >>for feedback.
> > > > >>The latest revision of Working With Derby has
> > been posted to Jira. It
> > > >
> > > > >>can be downloaded using:
> > > > >>
> > > >
> >
> >>
> http://issues.apache.org/jira/secure/attachment/12324531/WWDpdfNjava0323.zip
> > > >
> > > > >>
> > > > >>This contains the newly completed chapters 3
> > and 4. Please focus
> > > > first
> > > > >>on the initial review of these chapters. The
> > PDF file and related
> > > > JAVA
> > > > >>code are contained in the file:
> > WWDpdfNjava0323.zip
> > > > >>
> > > > >>
> > > > >
> > > > >[ snip ]
> > > > >
> > > > >I unzipped the file and looked at the PDF, but
> > I do not see a chapter
> > > > 4. I see an Intro,
> > > > >Activity 1, Activity 2 and Activity 3. Do
> > chapters 3 and 4 correspond
> > > > to Activity 2 and Activity
> > > > >3?
> > > > >
> > > > >I like the Activity 3 example. One suggestion
> > would be is to check the
> > > > command line parameter
> > > > >to make sure it is not over 32 characters. I
> > "made a wish" for
> > > > something that was over
> > > > >32 characters and got a stack trace that was
> > not too user friendly.
> > > > >
> > > > >It might be nice for new derby users (and if
> > they happened to be new to
> > > > Java too) to
> > > > >get a usage message instead of a stack trace if
> > they made this same
> > > > error.
> > > > >
> > > > >Thanks,
> > > > >
> > > > >Susan
> > > > >
> > > > >
> > > > >
> > > > Hi Susan -
> > > > Sorry, I thought DITA would label chapters
> > *OOPS* - what I submitted is
> > > > the next two sections (sections 3 and 4) that
> > correspond
> === message truncated ===
>
>
Re: [WWD] Chap 3 and 4 submitted for review
Posted by Jeff Levitt <de...@mylevita.com>.
No worries, Yeradis, this is a forum where opinions
are expressed freely, and I know Stan will take your
opinion and mine into account and write a guide that
all of us will approve. The more feedback the better,
and my comments were meant to start a discussion, so
thank you for carrying it on.
Jeff
--- yeradis <ye...@gmail.com> wrote:
> sorry if my words seem to crude that no was my
> intention really
> sotty
> the problem is that my litttle english sometime dont
> have other words to
> write waht i think
> Jeff sorry to you too
>
> and sorry to everybody really
>
> Yeradis P. Barbosa Marrero
>
> On 3/24/06, yeradis <ye...@gmail.com> wrote:
> >
> > hi stanley , GREAT JOB
> >
> > there is a problem (i think is a problem maibe
> not) but
> > in ALL documents i had read said the same way to
> configure the derby
> > engine on windows
> > and say
> >
> > On Windows platforms:
> > -------------------------------------------
> > set DERBY_HOME=C:\derby
> > md DERBYDBS
> > cd DERBYDBS
> > copy %DERBY_HOME%\demo\scripts\toursDB.sql .
> >
> >
> > the command SET for me on windows dont work on any
> way
> > maibe my windows is guilty, i have windows 2003
> enterprise edition
> > and dont handle the console command very well , i
> dont know , but i tried
> > to setup parameters on windows using the way that
> is described in all
> > documents and no one work for me
> > i want to think is my windows that has a problem
> >
> > i can use derby because i go directly to the derby
> database and use all
> > frome there
> >
> > for example if i want to go to use IJ i point my
> console path to C:\DB-
> > Derby-10.1.2.1-bin\frameworks\embedded\bin
> >
> > i mean
> >
> > c:\>cd
> DB-Derby-10.1.2.1-bin\frameworks\embedded\bin
> >
> > and use it
> >
> > if i want to use the derby to test some options i
> say to me JBuilder ,
> > that the derby driver is a library required by my
> project
> >
> > i'm was working on the solution to try to fix this
> problem of the setup
> > for me and to comunicate how i fixed , but i cant
> in this momento there is a
> > problem with a system i built and the problem is
> with core of the operating
> > system :-(
> >
> > very well stanley i think is very good your job
> >
> > and Jeff Levitt
> > you have the rigth on some of your topic , but
> stanley is writing
> > listening the opinion from people like us you and
> me jeff, and others course
> >
> > maibe how now , tomorrow stanley found a new way
> to write that is
> > accesible to all us and change the format of the
> book he is writing
> >
> > jeff --> i think the answer is that it is a
> document for users who are
> > more advanced, and so I think we could skip some
> of the more basic
> >
> > descriptions of what the code is doing. We should
> focus more on the
> > Derby-specific steps
> >
> > i think you have true but not in all
> > yes is true that can have more adanced skills
> >
> > but i think the work that stanley is doing MUST BE
> FOR EVERY BODY i dont
> > think what stanley think sorry to speak by me
> > but i think mus be for beginners users to advanced
> users , increasing the
> > percent of skills
> > i need to have points for beginners and for for
> medium user and for
> > advanced users
> >
> > and if you are an advanced user just skip the part
> you think is to obvious
> > to you and go to the point that is from your
> interest
> >
> > stanley i think you must give your opinion of what
> is the orientation of
> > your work wtih your write
> >
> > from beginner , medium , advanced ???
> >
> > jeff is true that stanley need found the BEST
> format for what he is
> > writing
> >
> > but if he want and i thinks yes , he will listen
> our all opinions and the
> > decide waht to do
> >
> > stanley here you have my hand and mind if you want
> and opinion
> >
> > thanks again stanley for your job
> >
> > and sorry for my english people
> >
> >
> > On 3/23/06, Stanley Bradbury
> <St...@gmail.com> wrote:
> > >
> > > Susan Cline wrote:
> > >
> > > >--- Stanley Bradbury < Stan.Bradbury@gmail.com>
> wrote:
> > > >
> > > >
> > > >
> > > >>I've submitted Chapters 1 and 2 of the Work
> With Derby [WWD] document
> > > >>for feedback.
> > > >>The latest revision of Working With Derby has
> been posted to Jira. It
> > >
> > > >>can be downloaded using:
> > > >>
> > >
>
>>http://issues.apache.org/jira/secure/attachment/12324531/WWDpdfNjava0323.zip
> > >
> > > >>
> > > >>This contains the newly completed chapters 3
> and 4. Please focus
> > > first
> > > >>on the initial review of these chapters. The
> PDF file and related
> > > JAVA
> > > >>code are contained in the file:
> WWDpdfNjava0323.zip
> > > >>
> > > >>
> > > >
> > > >[ snip ]
> > > >
> > > >I unzipped the file and looked at the PDF, but
> I do not see a chapter
> > > 4. I see an Intro,
> > > >Activity 1, Activity 2 and Activity 3. Do
> chapters 3 and 4 correspond
> > > to Activity 2 and Activity
> > > >3?
> > > >
> > > >I like the Activity 3 example. One suggestion
> would be is to check the
> > > command line parameter
> > > >to make sure it is not over 32 characters. I
> "made a wish" for
> > > something that was over
> > > >32 characters and got a stack trace that was
> not too user friendly.
> > > >
> > > >It might be nice for new derby users (and if
> they happened to be new to
> > > Java too) to
> > > >get a usage message instead of a stack trace if
> they made this same
> > > error.
> > > >
> > > >Thanks,
> > > >
> > > >Susan
> > > >
> > > >
> > > >
> > > Hi Susan -
> > > Sorry, I thought DITA would label chapters
> *OOPS* - what I submitted is
> > > the next two sections (sections 3 and 4) that
> correspond
=== message truncated ===
Re: [WWD] Chap 3 and 4 submitted for review
Posted by yeradis <ye...@gmail.com>.
sorry if my words seem to crude that no was my intention really
sotty
the problem is that my litttle english sometime dont have other words to
write waht i think
Jeff sorry to you too
and sorry to everybody really
Yeradis P. Barbosa Marrero
On 3/24/06, yeradis <ye...@gmail.com> wrote:
>
> hi stanley , GREAT JOB
>
> there is a problem (i think is a problem maibe not) but
> in ALL documents i had read said the same way to configure the derby
> engine on windows
> and say
>
> On Windows platforms:
> -------------------------------------------
> set DERBY_HOME=C:\derby
> md DERBYDBS
> cd DERBYDBS
> copy %DERBY_HOME%\demo\scripts\toursDB.sql .
>
>
> the command SET for me on windows dont work on any way
> maibe my windows is guilty, i have windows 2003 enterprise edition
> and dont handle the console command very well , i dont know , but i tried
> to setup parameters on windows using the way that is described in all
> documents and no one work for me
> i want to think is my windows that has a problem
>
> i can use derby because i go directly to the derby database and use all
> frome there
>
> for example if i want to go to use IJ i point my console path to C:\DB-
> Derby-10.1.2.1-bin\frameworks\embedded\bin
>
> i mean
>
> c:\>cd DB-Derby-10.1.2.1-bin\frameworks\embedded\bin
>
> and use it
>
> if i want to use the derby to test some options i say to me JBuilder ,
> that the derby driver is a library required by my project
>
> i'm was working on the solution to try to fix this problem of the setup
> for me and to comunicate how i fixed , but i cant in this momento there is a
> problem with a system i built and the problem is with core of the operating
> system :-(
>
> very well stanley i think is very good your job
>
> and Jeff Levitt
> you have the rigth on some of your topic , but stanley is writing
> listening the opinion from people like us you and me jeff, and others course
>
> maibe how now , tomorrow stanley found a new way to write that is
> accesible to all us and change the format of the book he is writing
>
> jeff --> i think the answer is that it is a document for users who are
> more advanced, and so I think we could skip some of the more basic
>
> descriptions of what the code is doing. We should focus more on the
> Derby-specific steps
>
> i think you have true but not in all
> yes is true that can have more adanced skills
>
> but i think the work that stanley is doing MUST BE FOR EVERY BODY i dont
> think what stanley think sorry to speak by me
> but i think mus be for beginners users to advanced users , increasing the
> percent of skills
> i need to have points for beginners and for for medium user and for
> advanced users
>
> and if you are an advanced user just skip the part you think is to obvious
> to you and go to the point that is from your interest
>
> stanley i think you must give your opinion of what is the orientation of
> your work wtih your write
>
> from beginner , medium , advanced ???
>
> jeff is true that stanley need found the BEST format for what he is
> writing
>
> but if he want and i thinks yes , he will listen our all opinions and the
> decide waht to do
>
> stanley here you have my hand and mind if you want and opinion
>
> thanks again stanley for your job
>
> and sorry for my english people
>
>
> On 3/23/06, Stanley Bradbury <St...@gmail.com> wrote:
> >
> > Susan Cline wrote:
> >
> > >--- Stanley Bradbury < Stan.Bradbury@gmail.com> wrote:
> > >
> > >
> > >
> > >>I've submitted Chapters 1 and 2 of the Work With Derby [WWD] document
> > >>for feedback.
> > >>The latest revision of Working With Derby has been posted to Jira. It
> >
> > >>can be downloaded using:
> > >>
> > >>http://issues.apache.org/jira/secure/attachment/12324531/WWDpdfNjava0323.zip
> >
> > >>
> > >>This contains the newly completed chapters 3 and 4. Please focus
> > first
> > >>on the initial review of these chapters. The PDF file and related
> > JAVA
> > >>code are contained in the file: WWDpdfNjava0323.zip
> > >>
> > >>
> > >
> > >[ snip ]
> > >
> > >I unzipped the file and looked at the PDF, but I do not see a chapter
> > 4. I see an Intro,
> > >Activity 1, Activity 2 and Activity 3. Do chapters 3 and 4 correspond
> > to Activity 2 and Activity
> > >3?
> > >
> > >I like the Activity 3 example. One suggestion would be is to check the
> > command line parameter
> > >to make sure it is not over 32 characters. I "made a wish" for
> > something that was over
> > >32 characters and got a stack trace that was not too user friendly.
> > >
> > >It might be nice for new derby users (and if they happened to be new to
> > Java too) to
> > >get a usage message instead of a stack trace if they made this same
> > error.
> > >
> > >Thanks,
> > >
> > >Susan
> > >
> > >
> > >
> > Hi Susan -
> > Sorry, I thought DITA would label chapters *OOPS* - what I submitted is
> > the next two sections (sections 3 and 4) that correspond to Activities 2
> >
> > and 3. Sorry for the confusion - still getting use to PDFs and DITA.
> > And thanks for the suggested integrity check (32 chars or less) - I will
> > add it.
> >
> >
> >
> >
>
Re: [WWD] Chap 3 and 4 submitted for review
Posted by yeradis <ye...@gmail.com>.
hi stanley , GREAT JOB
there is a problem (i think is a problem maibe not) but
in ALL documents i had read said the same way to configure the derby engine
on windows
and say
On Windows platforms:
-------------------------------------------
set DERBY_HOME=C:\derby
md DERBYDBS
cd DERBYDBS
copy %DERBY_HOME%\demo\scripts\toursDB.sql .
the command SET for me on windows dont work on any way
maibe my windows is guilty, i have windows 2003 enterprise edition
and dont handle the console command very well , i dont know , but i tried to
setup parameters on windows using the way that is described in all documents
and no one work for me
i want to think is my windows that has a problem
i can use derby because i go directly to the derby database and use all
frome there
for example if i want to go to use IJ i point my console path to C:\DB-
Derby-10.1.2.1-bin\frameworks\embedded\bin
i mean
c:\>cd DB-Derby-10.1.2.1-bin\frameworks\embedded\bin
and use it
if i want to use the derby to test some options i say to me JBuilder , that
the derby driver is a library required by my project
i'm was working on the solution to try to fix this problem of the setup for
me and to comunicate how i fixed , but i cant in this momento there is a
problem with a system i built and the problem is with core of the operating
system :-(
very well stanley i think is very good your job
and Jeff Levitt
you have the rigth on some of your topic , but stanley is writing listening
the opinion from people like us you and me jeff, and others course
maibe how now , tomorrow stanley found a new way to write that is accesible
to all us and change the format of the book he is writing
jeff --> i think the answer is that it is a document for users who are more
advanced, and so I think we could skip some of the more basic
descriptions of what the code is doing. We should focus more on the
Derby-specific steps
i think you have true but not in all
yes is true that can have more adanced skills
but i think the work that stanley is doing MUST BE FOR EVERY BODY i dont
think what stanley think sorry to speak by me
but i think mus be for beginners users to advanced users , increasing the
percent of skills
i need to have points for beginners and for for medium user and for advanced
users
and if you are an advanced user just skip the part you think is to obvious
to you and go to the point that is from your interest
stanley i think you must give your opinion of what is the orientation of
your work wtih your write
from beginner , medium , advanced ???
jeff is true that stanley need found the BEST format for what he is writing
but if he want and i thinks yes , he will listen our all opinions and the
decide waht to do
stanley here you have my hand and mind if you want and opinion
thanks again stanley for your job
and sorry for my english people
On 3/23/06, Stanley Bradbury <St...@gmail.com> wrote:
>
> Susan Cline wrote:
>
> >--- Stanley Bradbury <St...@gmail.com> wrote:
> >
> >
> >
> >>I've submitted Chapters 1 and 2 of the Work With Derby [WWD] document
> >>for feedback.
> >>The latest revision of Working With Derby has been posted to Jira. It
> >>can be downloaded using:
> >>
> >>
> http://issues.apache.org/jira/secure/attachment/12324531/WWDpdfNjava0323.zip
> >>
> >>This contains the newly completed chapters 3 and 4. Please focus first
> >>on the initial review of these chapters. The PDF file and related JAVA
> >>code are contained in the file: WWDpdfNjava0323.zip
> >>
> >>
> >
> >[ snip ]
> >
> >I unzipped the file and looked at the PDF, but I do not see a chapter
> 4. I see an Intro,
> >Activity 1, Activity 2 and Activity 3. Do chapters 3 and 4 correspond to
> Activity 2 and Activity
> >3?
> >
> >I like the Activity 3 example. One suggestion would be is to check the
> command line parameter
> >to make sure it is not over 32 characters. I "made a wish" for something
> that was over
> >32 characters and got a stack trace that was not too user friendly.
> >
> >It might be nice for new derby users (and if they happened to be new to
> Java too) to
> >get a usage message instead of a stack trace if they made this same
> error.
> >
> >Thanks,
> >
> >Susan
> >
> >
> >
> Hi Susan -
> Sorry, I thought DITA would label chapters *OOPS* - what I submitted is
> the next two sections (sections 3 and 4) that correspond to Activities 2
> and 3. Sorry for the confusion - still getting use to PDFs and DITA.
> And thanks for the suggested integrity check (32 chars or less) - I will
> add it.
>
>
>
>
Re: [WWD] Chap 3 and 4 submitted for review
Posted by Stanley Bradbury <St...@gmail.com>.
Susan Cline wrote:
>--- Stanley Bradbury <St...@gmail.com> wrote:
>
>
>
>>I've submitted Chapters 1 and 2 of the Work With Derby [WWD] document
>>for feedback.
>>The latest revision of Working With Derby has been posted to Jira. It
>>can be downloaded using:
>>
>>http://issues.apache.org/jira/secure/attachment/12324531/WWDpdfNjava0323.zip
>>
>>This contains the newly completed chapters 3 and 4. Please focus first
>>on the initial review of these chapters. The PDF file and related JAVA
>>code are contained in the file: WWDpdfNjava0323.zip
>>
>>
>
>[ snip ]
>
>I unzipped the file and looked at the PDF, but I do not see a chapter 4. I see an Intro,
>Activity 1, Activity 2 and Activity 3. Do chapters 3 and 4 correspond to Activity 2 and Activity
>3?
>
>I like the Activity 3 example. One suggestion would be is to check the command line parameter
>to make sure it is not over 32 characters. I "made a wish" for something that was over
>32 characters and got a stack trace that was not too user friendly.
>
>It might be nice for new derby users (and if they happened to be new to Java too) to
>get a usage message instead of a stack trace if they made this same error.
>
>Thanks,
>
>Susan
>
>
>
Hi Susan -
Sorry, I thought DITA would label chapters *OOPS* - what I submitted is
the next two sections (sections 3 and 4) that correspond to Activities 2
and 3. Sorry for the confusion - still getting use to PDFs and DITA.
And thanks for the suggested integrity check (32 chars or less) - I will
add it.
Re: [WWD] Chap 3 and 4 submitted for review
Posted by yeradis <ye...@gmail.com>.
thanks jhon by your words about the meaning of SNIP
On 3/28/06, John Embretsen <Jo...@sun.com> wrote:
>
> yeradis wrote:
>
> > wich one is the meaning of ---- SNIP - -----
>
> Usually the word "snip" in e-mail messages means that the author of the
> message has deleted a part of the e-mail he is quoting (replying to), most
> likely because he or she does not think the deleted text was relevant or
> necessary to include in the reply.
>
> This is helpful because it indicates that something has been cut away,
> while
> the "snipping" itself helps keeping the e-mail thread less cluttered
> (confusing, disorganized) and more to the point.
>
>
> --
> John
>
>
Re: [WWD] Chap 3 and 4 submitted for review
Posted by John Embretsen <Jo...@Sun.COM>.
yeradis wrote:
> wich one is the meaning of ---- SNIP - -----
Usually the word "snip" in e-mail messages means that the author of the
message has deleted a part of the e-mail he is quoting (replying to), most
likely because he or she does not think the deleted text was relevant or
necessary to include in the reply.
This is helpful because it indicates that something has been cut away, while
the "snipping" itself helps keeping the e-mail thread less cluttered
(confusing, disorganized) and more to the point.
--
John
Re: [WWD] Chap 3 and 4 submitted for review
Posted by yeradis <ye...@gmail.com>.
wich one is the meaning of ---- SNIP - -----
On 3/27/06, Stanley Bradbury <St...@gmail.com> wrote:
>
> Jeff Levitt wrote:
>
> ---- SNIP - -----
>
> > Once again, great writing Stan!
>
> >I have several fundamental problems with the format of
> >the twwdactivity3.dita topic that describes the
> >program code.
> >
> >1. The first is the line numbers problem. I know it
> >seems good to give specific line numbers, but one
> >change to the code throws off the line numbers in the
> >entire program file, as well as the references to them
> >in the doc. This problem is the same problem Derby
> >has in the doc with referencing page numbers in the
> >PDF, and that is why it isnt done at all. Page
> >numbers change, and it is too hard to search for all
> >of the references to them. It is better to have links
> >that dynamically change. For this specific problem, I
> >recommend we remove references to line numbers, and
> >also remove the Line numbers in the comments in the
> >code. We can then simply reference the title of the
> >specific code section used in the comment.
> >
> >2. This problem is sort of related to the previous
> >one. I think we need to have more codeblocks in the
> >doc. Instead of saying "The next line does this, and
> >then the program does this and that etc.", it should
> >be more specific. There are some places where this is
> >done, but others where it isnt done enough.
> >Basically, I think we should say "The code does
> >something: <codeblock> Code lifted directly from the
> >program and pasted here</codeblock> Then the code
> >checks for blah: <another codeblock> etc.
> >Showing specific lines in the doc helps the user more
> >directly.
> >
> >3. This topic is created as a task, but I dont think
> >it is a task, I've been trying to think of what it
> >would be (reference or concept), and I think I have
> >settled on it being a reference topic. A task would
> >define something the user would DO, ie. Do this, then
> >do this, etc. But we are really just describing code
> >here, we arent telling the user to do anything. Thus,
> >it should not be a task topic. I can help you with
> >rewriting this if you'd like the help, but either way
> >I think it needs to be changed, because I think it
> >will be more understandable as a reference topic. So
> >it should be rwwdactivity3.dita, and of course you
> >should modify the reference to it in the ditamap file.
> >
> >I think this file needs a little bit more work. I can
> >help you with all this. I can even do all this work,
> >I just wanted to see what other people think before
> >working on it. I also would question how much of this
> >is useful to the user. Fundamentally, we are
> >describing what the code does in this program, but
> >what will the audience be like? Are they beginners
> >who have never seen code before? If so, then this
> >might be too complex for them. But if they are
> >advanced, then maybe describing DO and WHILE loops is
> >a little too basic for them. So the conclusion is
> >that this topic does not talk to either a beginner or
> >an expert; in other words, there is no one that this
> >speaks to. I think the answer is that it is a
> >document for users who are more advanced, and so I
> >think we could skip some of the more basic
> >descriptions of what the code is doing. We should
> >focus more on the Derby-specific steps (connecting,
> >inserting, shutting down, etc.), rather than non-Derby
> >specific stuff (like WHILE and DO loops, printing
> >output, etc.) Obviously this is a topic for
> >discussion. What do you all think?
> >
> >
> >
> >
> Hi Jeff -
>
> Thanks for the thoughtful and informative feedback.
> Regarding Line numbers: Unless someone strongly objects I think I will
> change the 'Line' references. They were meant to be used as section
> titles (hence they are included in the code comments where they need to
> be regardless of the actual line number in the file). It was easier to
> create titles based on the Line number displayed in my editor than to
> think up something more descriptive, but it is misleading. Do you
> think the section titles should be descriptive of the code or would it
> be OK just to use words that have no meaning outside of the being
> referred to in the document (e.g. use color names like: RED, BLUE, etc.)?
>
> Regarding more codeblocks: I'm fine with adding more codeblocks. I was
> trying to keep code duplication to a minimum but will happily add more
> to areas that seem unclear. Would you suggest the blocks of code you
> think would be most helpful? The one that pops to mind is the
> SQLExceptionPrint code.
>
> Regarding the DITA document type. I think you are correct - I really
> did not consider the document type and still don't understand the
> trade-off between them but certainly the only 'task' in
> twwdactivity3.dita is the
> writing of it - : ) I will let you know if I have any questions
> regarding changing this to a reference type.
>
> And thanks for raising the issue of level of detail. Like the inclusion
> of more codeblocks in the document this was a judgment call and I do
> want feedback in that regard. To answer you question about the audience
> I had envisioned someone with rudimentary programing experience but
> possibly not with JAVA and certainly not with JDBC. Thus, I annotated
> the purpose of each major code section and construct but did not cover
> the programming details or syntax. The exception is the JDBC calls for
> which I included copies of code within the document. Like with the
> codeblocks I am happy to add more detail in describing the code where
> needed. Please let me know what areas require better coverage.
>
>
Re: [WWD] Chap 3 and 4 submitted for review
Posted by Stanley Bradbury <St...@gmail.com>.
Jeff Levitt wrote:
---- SNIP - -----
> Once again, great writing Stan!
>I have several fundamental problems with the format of
>the twwdactivity3.dita topic that describes the
>program code.
>
>1. The first is the line numbers problem. I know it
>seems good to give specific line numbers, but one
>change to the code throws off the line numbers in the
>entire program file, as well as the references to them
>in the doc. This problem is the same problem Derby
>has in the doc with referencing page numbers in the
>PDF, and that is why it isnt done at all. Page
>numbers change, and it is too hard to search for all
>of the references to them. It is better to have links
>that dynamically change. For this specific problem, I
>recommend we remove references to line numbers, and
>also remove the Line numbers in the comments in the
>code. We can then simply reference the title of the
>specific code section used in the comment.
>
>2. This problem is sort of related to the previous
>one. I think we need to have more codeblocks in the
>doc. Instead of saying "The next line does this, and
>then the program does this and that etc.", it should
>be more specific. There are some places where this is
>done, but others where it isnt done enough.
>Basically, I think we should say "The code does
>something: <codeblock> Code lifted directly from the
>program and pasted here</codeblock> Then the code
>checks for blah: <another codeblock> etc.
>Showing specific lines in the doc helps the user more
>directly.
>
>3. This topic is created as a task, but I dont think
>it is a task, I've been trying to think of what it
>would be (reference or concept), and I think I have
>settled on it being a reference topic. A task would
>define something the user would DO, ie. Do this, then
>do this, etc. But we are really just describing code
>here, we arent telling the user to do anything. Thus,
>it should not be a task topic. I can help you with
>rewriting this if you'd like the help, but either way
>I think it needs to be changed, because I think it
>will be more understandable as a reference topic. So
>it should be rwwdactivity3.dita, and of course you
>should modify the reference to it in the ditamap file.
>
>I think this file needs a little bit more work. I can
>help you with all this. I can even do all this work,
>I just wanted to see what other people think before
>working on it. I also would question how much of this
>is useful to the user. Fundamentally, we are
>describing what the code does in this program, but
>what will the audience be like? Are they beginners
>who have never seen code before? If so, then this
>might be too complex for them. But if they are
>advanced, then maybe describing DO and WHILE loops is
>a little too basic for them. So the conclusion is
>that this topic does not talk to either a beginner or
>an expert; in other words, there is no one that this
>speaks to. I think the answer is that it is a
>document for users who are more advanced, and so I
>think we could skip some of the more basic
>descriptions of what the code is doing. We should
>focus more on the Derby-specific steps (connecting,
>inserting, shutting down, etc.), rather than non-Derby
>specific stuff (like WHILE and DO loops, printing
>output, etc.) Obviously this is a topic for
>discussion. What do you all think?
>
>
>
>
Hi Jeff -
Thanks for the thoughtful and informative feedback.
Regarding Line numbers: Unless someone strongly objects I think I will
change the 'Line' references. They were meant to be used as section
titles (hence they are included in the code comments where they need to
be regardless of the actual line number in the file). It was easier to
create titles based on the Line number displayed in my editor than to
think up something more descriptive, but it is misleading. Do you
think the section titles should be descriptive of the code or would it
be OK just to use words that have no meaning outside of the being
referred to in the document (e.g. use color names like: RED, BLUE, etc.)?
Regarding more codeblocks: I'm fine with adding more codeblocks. I was
trying to keep code duplication to a minimum but will happily add more
to areas that seem unclear. Would you suggest the blocks of code you
think would be most helpful? The one that pops to mind is the
SQLExceptionPrint code.
Regarding the DITA document type. I think you are correct - I really
did not consider the document type and still don't understand the
trade-off between them but certainly the only 'task' in
twwdactivity3.dita is the
writing of it - : ) I will let you know if I have any questions
regarding changing this to a reference type.
And thanks for raising the issue of level of detail. Like the inclusion
of more codeblocks in the document this was a judgment call and I do
want feedback in that regard. To answer you question about the audience
I had envisioned someone with rudimentary programing experience but
possibly not with JAVA and certainly not with JDBC. Thus, I annotated
the purpose of each major code section and construct but did not cover
the programming details or syntax. The exception is the JDBC calls for
which I included copies of code within the document. Like with the
codeblocks I am happy to add more detail in describing the code where
needed. Please let me know what areas require better coverage.
Re: [WWD] Chap 3 and 4 submitted for review
Posted by Jeff Levitt <de...@mylevita.com>.
--- Susan Cline <ho...@pacbell.net> wrote:
> --- Stanley Bradbury <St...@gmail.com>
> wrote:
>
> > I've submitted Chapters 1 and 2 of the Work With
> Derby [WWD] document
> > for feedback.
> > The latest revision of Working With Derby has been
> posted to Jira. It
> > can be downloaded using:
> >
> >
>
http://issues.apache.org/jira/secure/attachment/12324531/WWDpdfNjava0323.zip
> >
> > This contains the newly completed chapters 3 and
> 4. Please focus first
> > on the initial review of these chapters. The PDF
> file and related JAVA
> > code are contained in the file:
> WWDpdfNjava0323.zip
>
> [ snip ]
>
> I unzipped the file and looked at the PDF, but I do
> not see a chapter 4. I see an Intro,
> Activity 1, Activity 2 and Activity 3. Do chapters
> 3 and 4 correspond to Activity 2 and Activity
> 3?
>
> I like the Activity 3 example. One suggestion would
> be is to check the command line parameter
> to make sure it is not over 32 characters. I "made
> a wish" for something that was over
> 32 characters and got a stack trace that was not too
> user friendly.
>
> It might be nice for new derby users (and if they
> happened to be new to Java too) to
> get a usage message instead of a stack trace if they
> made this same error.
>
> Thanks,
>
> Susan
Once again, great writing Stan!
I have several fundamental problems with the format of
the twwdactivity3.dita topic that describes the
program code.
1. The first is the line numbers problem. I know it
seems good to give specific line numbers, but one
change to the code throws off the line numbers in the
entire program file, as well as the references to them
in the doc. This problem is the same problem Derby
has in the doc with referencing page numbers in the
PDF, and that is why it isnt done at all. Page
numbers change, and it is too hard to search for all
of the references to them. It is better to have links
that dynamically change. For this specific problem, I
recommend we remove references to line numbers, and
also remove the Line numbers in the comments in the
code. We can then simply reference the title of the
specific code section used in the comment.
2. This problem is sort of related to the previous
one. I think we need to have more codeblocks in the
doc. Instead of saying "The next line does this, and
then the program does this and that etc.", it should
be more specific. There are some places where this is
done, but others where it isnt done enough.
Basically, I think we should say "The code does
something: <codeblock> Code lifted directly from the
program and pasted here</codeblock> Then the code
checks for blah: <another codeblock> etc.
Showing specific lines in the doc helps the user more
directly.
3. This topic is created as a task, but I dont think
it is a task, I've been trying to think of what it
would be (reference or concept), and I think I have
settled on it being a reference topic. A task would
define something the user would DO, ie. Do this, then
do this, etc. But we are really just describing code
here, we arent telling the user to do anything. Thus,
it should not be a task topic. I can help you with
rewriting this if you'd like the help, but either way
I think it needs to be changed, because I think it
will be more understandable as a reference topic. So
it should be rwwdactivity3.dita, and of course you
should modify the reference to it in the ditamap file.
I think this file needs a little bit more work. I can
help you with all this. I can even do all this work,
I just wanted to see what other people think before
working on it. I also would question how much of this
is useful to the user. Fundamentally, we are
describing what the code does in this program, but
what will the audience be like? Are they beginners
who have never seen code before? If so, then this
might be too complex for them. But if they are
advanced, then maybe describing DO and WHILE loops is
a little too basic for them. So the conclusion is
that this topic does not talk to either a beginner or
an expert; in other words, there is no one that this
speaks to. I think the answer is that it is a
document for users who are more advanced, and so I
think we could skip some of the more basic
descriptions of what the code is doing. We should
focus more on the Derby-specific steps (connecting,
inserting, shutting down, etc.), rather than non-Derby
specific stuff (like WHILE and DO loops, printing
output, etc.) Obviously this is a topic for
discussion. What do you all think?
Re: [WWD] Chap 3 and 4 submitted for review
Posted by Susan Cline <ho...@pacbell.net>.
--- Stanley Bradbury <St...@gmail.com> wrote:
> I've submitted Chapters 1 and 2 of the Work With Derby [WWD] document
> for feedback.
> The latest revision of Working With Derby has been posted to Jira. It
> can be downloaded using:
>
> http://issues.apache.org/jira/secure/attachment/12324531/WWDpdfNjava0323.zip
>
> This contains the newly completed chapters 3 and 4. Please focus first
> on the initial review of these chapters. The PDF file and related JAVA
> code are contained in the file: WWDpdfNjava0323.zip
[ snip ]
I unzipped the file and looked at the PDF, but I do not see a chapter 4. I see an Intro,
Activity 1, Activity 2 and Activity 3. Do chapters 3 and 4 correspond to Activity 2 and Activity
3?
I like the Activity 3 example. One suggestion would be is to check the command line parameter
to make sure it is not over 32 characters. I "made a wish" for something that was over
32 characters and got a stack trace that was not too user friendly.
It might be nice for new derby users (and if they happened to be new to Java too) to
get a usage message instead of a stack trace if they made this same error.
Thanks,
Susan