db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Knut Anders Hatlen (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-3879) Getting Started Guide has typo and version problems
Date Wed, 01 Oct 2008 15:33:44 GMT

    [ https://issues.apache.org/jira/browse/DERBY-3879?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12636064#action_12636064
] 

Knut Anders Hatlen commented on DERBY-3879:
-------------------------------------------

The patch looks good to me. Though many of the version numbers in the
getting started guide will still look outdated once we get a new
release out...

One minor comment:

+-  <ph conref="../conrefs.dita#vers/shortversionnumber"></ph>.2.0 - (689064):
instance a816c00e-011c-7658-a92a-fffff0cfee85

With this markup, the 10.5 docs will say 10.5.2.0, even if the first
10.5 release will have version 10.5.1.x, and the svn revision number
will not match the version number.

The same approach is also used in the existing source in
rtoolssysinfo1002629.dita, so the patch doesn't actually introduce
this problem. Now there's one more possibility for inconsistencies in
that file, since the names of the jar files in the sysinfo output are
hard coded as C:\db-derby-10.4.2.0-bin\lib\*.jar, whereas the Locale
Information section of the sysinfo output says
+         version: <ph conref="../conrefs.dita#vers/shortversionnumber"></ph>.2.0
- (689064)

> Getting Started Guide has typo and version problems
> ---------------------------------------------------
>
>                 Key: DERBY-3879
>                 URL: https://issues.apache.org/jira/browse/DERBY-3879
>             Project: Derby
>          Issue Type: Bug
>    Affects Versions: 10.4.2.0
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>         Attachments: DERBY-3879.diff, DERBY-3879.stat, DERBY-3879.zip
>
>
> Mamta Satoor noticed the following in reviewing the 10.4.2 release:
> Just spotted 2 documentation issues (very trivial) in Getting Started
> with Derby. By no means, the release has to stop for them because i
> think these 2 minor issues have been with the docs for probably all
> the doc releases.
> 1)In the section 'Setting the environment variables", Step 1, for
> Windows says set DERBY_HOME=c:\Derby_10.
> We should not have the . at the end
> 2)In many different sections of this doc, we are showing incorrect
> version of ij and Derby (I think they are all showing 10.2. we should
> fix them to show 10.4 since we are talking about Derby 10.4 release).
> One example of such a place in this doc is the section "Creating a
> Derby database and running SQL statements" shows how to run ij in UNIX
> and Windows and then it shows the output from ij displaying the ij
> version. The output of ij for the 2 operating system in this section
> shows to be running ij10.2 rather than 10.4 as shown below. We need to
> fix the version number of ij in this section
> UNIX (Korn Shell) java -jar $DERBY_HOME/lib/derbyrun.jar ij
> ij version 10.2
> Windows java -jar %DERBY_HOME%\lib\derbyrun.jar ij
> ij version 10.2

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message