You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Laura Stewart (JIRA)" <de...@db.apache.org> on 2006/09/12 22:38:23 UTC

[jira] Commented: (DERBY-1820) In the reference manual the description of backupDir arugument for all the backup procedures is incorrect.

    [ http://issues.apache.org/jira/browse/DERBY-1820?page=comments#action_12434265 ] 
            
Laura Stewart commented on DERBY-1820:
--------------------------------------

I have a question about some of the wording in the updated description:

1. The word"against" seems odd here.  Can something else be used, like " Relative paths are resolved based on the
current user directory of the database engine, not based on the derby home directory."

2. Is "Relative path names" and "absolute path names" correct?  It seems to me that we can drop the word "names".  I believe that "directory paths" are understood without saying that they are "names".

3. "... current user directory of the database engine" is a phrase that might be misleading.  Does this mean"
a) The directory that the current user is using in the database engine
b) The directory called "current user" that is in the database engine
c) The directory in the database engine that the current user is using

Do we need to qualify this phrase with "of the database engine" ???


> In the reference manual the description of backupDir arugument for all the backup procedures is incorrect.
> ----------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-1820
>                 URL: http://issues.apache.org/jira/browse/DERBY-1820
>             Project: Derby
>          Issue Type: Bug
>            Reporter: Suresh Thalamati
>         Assigned To: Laura Stewart
>
> In the refence manual, the description of backupDir argument for 
> all the backup procedures is incorrect. 
> current description:
> BACKUPDIR
>     An input argument of type VARCHAR(32672) that specifies the full system
>     path to the database directory to be backed up.
> it should be :
> BACKUPDIR
>     An input argument of type VARCHAR(32672) that specifies the path to a
>     directory, where the backup should be stored. Relative path names are 
>     resolved against the current user directory of the database engine, 
>     not to the derby home directory. To avoid confusion, it is better 
>     to use the absolute path name. 
> Above change is needed  for the following backup procedures:
> 1)SYSCS_UTIL.SYSCS_BACKUP_DATABASE
>  http://db.apache.org/derby/docs/dev/ref/rrefbackupdbproc.html
>  
> 2)SYSCS_UTIL.SYSCS_BACKUP_DATABASE_NOWAIT 
> http://db.apache.org/derby/docs/dev/ref/rrefbackupdbnowaitproc.html
> 3) SYSCS_UTIL.SYSCS_BACKUP_DATABASE_AND_ENABLE_LOG_ARCHIVE_MODE
> http://db.apache.org/derby/docs/dev/ref/rrefbackupdbenablelogproc.html
> 4) SYSCS_UTIL.SYSCS_BACKUP_DATABASE_AND_ENABLE_LOG_ARCHIVE_MODE_NOWAIT
> http://db.apache.org/derby/docs/dev/ref/rrefbackupdbenablelognowaitproc.html
> ---
> It would be great  if   some one with doc expertize  can fix this for  10.2. 
> Thanks
> -suresh

-- 
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