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

Kim Haase commented on DERBY-3169:
----------------------------------

Thanks for the okay on the changes, Narayanan. 

I agree that something should probably be done about documenting unlogged 
operations. The current version of the backup file you mention, 
http://db.apache.org/derby/docs/dev/adminguide/cadminhubbkup01.html, describes 
two unlogged operations. How many more are there? If these are the only ones, 
we could leave the documentation where it is and refer people to this topic. 

Ideally, though, we should have a separate topic for the list of unlogged 
operations, especially if there are more to describe -- if you could file a 
JIRA issue, that would be great. There are a few possible places to put it:

Under the topic 
http://db.apache.org/derby/docs/dev/adminguide/tadminlogfile.html in the Admin 
Guide. This is under "Derby Network Server advanced topics", though. The 
unlogged operations list would probably apply to both the embedded and Network 
Server modes.

Under the topic http://db.apache.org/derby/docs/dev/devguide/cdevdvlp25889.html 
in the Developer's Guide. This, however, is under "Derby embedded basics" -- so 
it has the same problem as the other topic.

I wouldn't put it under cadminhubbkup01.html, because that's nested about 5 
deep already. And it's too advanced a topic for the Getting Started guide even 
if that guide had a topic about the log already (it doesn't).

So anything we did would probably involve a bit of rethinking and reorganizing 
somewhere.


> Add documentation for replication
> ---------------------------------
>
>                 Key: DERBY-3169
>                 URL: https://issues.apache.org/jira/browse/DERBY-3169
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.4.0.0
>            Reporter: Jørgen Løland
>            Assignee: Kim Haase
>             Fix For: 10.4.0.0
>
>         Attachments: cadminreplicstartrun.html, DERBY-3169-2.diff, 
> DERBY-3169-2.stat, DERBY-3169-2.zip, DERBY-3169-3.diff, DERBY-3169-3.stat, 
> DERBY-3169-3.zip, DERBY-3169-4.diff, DERBY-3169-4.zip, DERBY-3169-5.diff, 
> DERBY-3169-5.zip, DERBY-3169-6.diff, DERBY-3169-7.diff, DERBY-3169.diff, 
> DERBY-3169.stat, DERBY-3169.zip, rrefattribstartmaster.html, 
> rrefattribstartmaster.html
>
>


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

Reply via email to