Return-Path: Delivered-To: apmail-db-derby-dev-archive@www.apache.org Received: (qmail 26258 invoked from network); 20 Apr 2010 14:29:14 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 20 Apr 2010 14:29:14 -0000 Received: (qmail 88599 invoked by uid 500); 20 Apr 2010 14:29:14 -0000 Delivered-To: apmail-db-derby-dev-archive@db.apache.org Received: (qmail 88578 invoked by uid 500); 20 Apr 2010 14:29:14 -0000 Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: Delivered-To: mailing list derby-dev@db.apache.org Received: (qmail 88571 invoked by uid 99); 20 Apr 2010 14:29:14 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 20 Apr 2010 14:29:14 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.22] (HELO thor.apache.org) (140.211.11.22) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 20 Apr 2010 14:29:11 +0000 Received: from thor (localhost [127.0.0.1]) by thor.apache.org (8.13.8+Sun/8.13.8) with ESMTP id o3KESone013111 for ; Tue, 20 Apr 2010 14:28:50 GMT Message-ID: <8723207.88741271773729999.JavaMail.jira@thor> Date: Tue, 20 Apr 2010 10:28:49 -0400 (EDT) From: "Chris Dolan (JIRA)" To: derby-dev@db.apache.org Subject: [jira] Created: (DERBY-4622) Specify "database:" URL prefix in documentation MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 X-Virus-Checked: Checked by ClamAV on apache.org Specify "database:" URL prefix in documentation ----------------------------------------------- Key: DERBY-4622 URL: https://issues.apache.org/jira/browse/DERBY-4622 Project: Derby Issue Type: Bug Components: Documentation Reporter: Chris Dolan Priority: Trivial The tutorial step titled "Activity 3: Run a JDBC program using the embedded driver" at the following URL (http://db.apache.org/derby/docs/10.4/getstart/getstart-single.html#tgsactivity3_Setup) recommends this syntax for specifying a directory-based datasource: String connectionURL = "jdbc:derby:" + dbName + ";create=true"; For Windows users who need to specify an absolute path to the database, this is a problem because the connection interprets "c:/path/to/db" as non-existent protocol "c" and a database name of "/path/to/db". Better documentation would be explicitly specify the protocol: String connectionURL = "jdbc:derby:directory:" + dbName + ";create=true"; (this would have saved me about a day of troubleshooting...) -- This message is automatically generated by JIRA. - You can reply to this email to add a comment to the issue online.