[jira] [Comment Edited] (DERBY-6462) Provide more information about database name and path syntax

["Dag H. Wanvik (JIRA)" <ji...@apache.org>]

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

Dag H. Wanvik edited comment on DERBY-6462 at 2/28/14 11:04 AM:
----------------------------------------------------------------

THanks, Kim. 

* devguide/cdevdvlp40350.dita:
{quote}
"The database path must not contain a colon (:), except after the
drive name in a Windows path. The path separator in the connection URL
is / (forward slash), as in the standard file:/ or file:/// URL
protocol. (You can specify one forward slash or three, but not two.)"
{quote}
This is a bit misleading, perhaps. We do not allow a standard URL file
syntax in the connect statement it seems. 
{code}
ij> connect 'jdbc:derby:file:/tmp/foo';
ERROR 08001: No suitable driver found for jdbc:derby:file:/tmp/foo
{code}
Perhaps the original
reference to forward slash was to explain for Windows users why a
forward, not backward slash is required, using analogy to the URL
syntax.  In the policy files, however, the URL syntax is supported
(not parsed by Derby, but by the Java run-time).

I suggest removing ", as in ....".


was (Author: dagw):
THanks, Kim. 

* devguide/cdevdvlp40350.dita:

"The database path must not contain a colon (:), except after the
drive name in a Windows path. The path separator in the connection URL
is / (forward slash), as in the standard file:/ or file:/// URL
protocol. (You can specify one forward slash or three, but not two.)"

This is a bit misleading, perhaps. We do not allow a standard URL file
syntax in the connect statement it seems. 

ij> connect 'jdbc:derby:file:/tmp/foo';
ERROR 08001: No suitable driver found for jdbc:derby:file:/tmp/foo

Perhaps the original
reference to forward slash was to explain for Windows users why a
forward, not backward slash is required, using analogy to the URL
syntax.  In the policy files, however, the URL syntax is supported
(not parsed by Derby, but by the Java run-time).

I suggest removing ", as in ....".

> Provide more information about database name and path syntax
> ------------------------------------------------------------
>
>                 Key: DERBY-6462
>                 URL: https://issues.apache.org/jira/browse/DERBY-6462
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.11.0.0
>            Reporter: Dag H. Wanvik
>            Assignee: Kim Haase
>         Attachments: DERBY-6462-2.diff, DERBY-6462-2.stat, DERBY-6462-2.zip, DERBY-6462.diff, DERBY-6462.stat, DERBY-6462.zip
>
>
> Except for initial Windows drive letters (e.g. K:/derby), colons break Derby.
> Windows can't have colons in directory of file names, so this is a Unix issue.
> [http://msdn.microsoft.com/en-us/library/aa365247%28VS.85%29.aspx#file_and_directory_names]



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)