Developer's guide issues
------------------------
Key: DERBY-425
URL: http://issues.apache.org/jira/browse/DERBY-425
Project: Derby
Type: Task
Components: Documentation
Environment: all
Reporter: Jeff Levitt
Priority: Minor
Fix For: 10.2.0.0
Some general comments:
1. SQL tips starts at page 94 of the document, but table of content lists it
starting at page 93.
2. At each page of this document, you might want to add guide name and main
section name at the footer of the page so that it is easier to see which guide
and which section the page belongs to.
3. These are comments by Susan concerning some of the graphics in the
Developer's Guide. To fix these, I think we need someone who knows something
about graphics and has the authoring tools available to do something like this.
Page: http://incubator.apache.org/derby/docs/devguide/cdevconcepts16400.html
The color of the arrows and in one instance the length of the bars in these
examples is incorrect.
Figure 1:
The arrow on the time line should be yellow, not orange.
The arrow under the text 'Transactions are never aborted ...', should be
orange, and
not yellow. So in effect, the colors of the arrows is exactly opposite to what
it
should be.
Figure 2:
Again, the color of the arrows is exactly in reverse. The first arrow should be
yellow, the second arrow should be orange.
Figure 3:
The color of the arrows is incorrect, but the length of the bars are incorrect.
Since locksWaitTimeout is at 50 seconds, it should be smaller in length then the
deadlockTimeout bar, which is 60 seconds.
So the picture should look something like this:
|locksWaitTimeout= 50 |
__
| deadlockTimeout = 60 | \/ No deadlock ....
I've been waiting 50 seconds
Abort me (I'll try again later).
__
\/ (orange)
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
