db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Bryan Pendleton (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DERBY-6845) Document the rawDBReader optional tool
Date Sat, 05 Dec 2015 03:32:11 GMT

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

Bryan Pendleton commented on DERBY-6845:
----------------------------------------

The new documentation looks very good to me.

I think you could perhaps structure it a bit more with some sub-headings so that it's not
just one long section.

But even without that, it reads clearly and and sets the process out in a very straightforward
 and clear manner.

Regarding this section:

     To run the rawDBReader tool, you must be signed on to the machine 
     where the corrupt database resides and your classpath must contain 
     derby.jar and derbyoptionaltools.jar.

Is it true that "healthydb" must also be on the same machine as the corruptDB?

(That is, everything is accessed using the embedded engine, and is local
to the machine you are on?)

Overall, I think this is excellent, particularly for the first release of the tool. If we
get further feedback from people who find themselves using the tool, we can improve the docs
some more in the future.

> Document the rawDBReader optional tool
> --------------------------------------
>
>                 Key: DERBY-6845
>                 URL: https://issues.apache.org/jira/browse/DERBY-6845
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.13.0.0
>            Reporter: Rick Hillegas
>            Assignee: Rick Hillegas
>         Attachments: derby-6845-01-aa-firstCut.diff, derby-6845-01-aa-firstCut.tar, derby-6845-01-ab-moreExplanation.diff,
derby-6845-01-ab-moreExplanation.tar
>
>
> Document the optional tool added by DERBY-6136.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message