Return-Path: 
 <derby-commits-return-16432-apmail-db-derby-commits-archive=db.apache.org@db.apache.org>
X-Original-To: apmail-db-derby-commits-archive@www.apache.org
Delivered-To: apmail-db-derby-commits-archive@www.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id 34418D458
	for <apmail-db-derby-commits-archive@www.apache.org>;
 Fri, 25 Jan 2013 19:56:19 +0000 (UTC)
Received: (qmail 38998 invoked by uid 500); 25 Jan 2013 19:56:19 -0000
Delivered-To: apmail-db-derby-commits-archive@db.apache.org
Received: (qmail 38973 invoked by uid 500); 25 Jan 2013 19:56:19 -0000
Mailing-List: contact derby-commits-help@db.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:derby-commits-help@db.apache.org>
list-unsubscribe: <mailto:derby-commits-unsubscribe@db.apache.org>
List-Post: <mailto:derby-commits@db.apache.org>
Reply-To: "Derby Development" <derby-dev@db.apache.org>
List-Id: <derby-commits.db.apache.org>
Delivered-To: mailing list derby-commits@db.apache.org
Received: (qmail 38965 invoked by uid 99); 25 Jan 2013 19:56:19 -0000
Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 25 Jan 2013 19:56:19 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=5.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 25 Jan 2013 19:56:16 +0000
Received: from eris.apache.org (localhost [127.0.0.1])
	by eris.apache.org (Postfix) with ESMTP id 0D8A32388ABA;
	Fri, 25 Jan 2013 19:55:56 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1438673 - in /db/derby/docs/trunk/src/ref:
 crefproper22250.dita
 refderby.ditamap rrefproperdatadictversion.dita
Date: Fri, 25 Jan 2013 19:55:55 -0000
To: derby-commits@db.apache.org
From: chaase3@apache.org
X-Mailer: svnmailer-1.0.8-patched
Message-Id: <20130125195556.0D8A32388ABA@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: chaase3
Date: Fri Jan 25 19:55:55 2013
New Revision: 1438673

URL: http://svn.apache.org/viewvc?rev=1438673&view=rev
Log:
DERBY-4259  Document database property for determining database format version

Added new Reference Manual topic, modified another topic and map file.

Patch: DERBY-4259-3.diff

Added:
    db/derby/docs/trunk/src/ref/rrefproperdatadictversion.dita   (with props)
Modified:
    db/derby/docs/trunk/src/ref/crefproper22250.dita
    db/derby/docs/trunk/src/ref/refderby.ditamap

Modified: db/derby/docs/trunk/src/ref/crefproper22250.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/crefproper22250.dita?rev=1438673&r1=1438672&r2=1438673&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/crefproper22250.dita (original)
+++ db/derby/docs/trunk/src/ref/crefproper22250.dita Fri Jan 25 19:55:55 2013
@@ -373,6 +373,11 @@ about when changes to the property are d
 <entry colname="2">S, D</entry>
 <entry colname="3">Dynamic</entry>
 </row>
+<row>
+<entry colname="1"><i><xref href="rrefproperdatadictversion.dita#rrefproperdatadictversion">DataDictionaryVersion</xref></i></entry>
+<entry colname="2">D</entry>
+<entry colname="3">Neither; value can be retrieved, but not set</entry>
+</row>
 </tbody>
 </tgroup>
 </table>

Modified: db/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/refderby.ditamap?rev=1438673&r1=1438672&r2=1438673&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ db/derby/docs/trunk/src/ref/refderby.ditamap Fri Jan 25 19:55:55 2013
@@ -1304,6 +1304,7 @@ URL syntax"></topicref>
 <topicref href="rrefproper27355.dita" navtitle="derby.user.UserName">
 <topicref href="rrefpropercachedn.dita" navtitle="Caching user DNs"></topicref>
 </topicref>
+<topicref href="rrefproperdatadictversion.dita" navtitle="DataDictionaryVersion"></topicref>
 </topicref>
 </topicref>
 <topicref collection-type="family" href="rrefjta16677.dita" navtitle="J2EE Compliance: Java Transaction API and javax.sql Interfaces">

Added: db/derby/docs/trunk/src/ref/rrefproperdatadictversion.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperdatadictversion.dita?rev=1438673&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperdatadictversion.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproperdatadictversion.dita Fri Jan 25 19:55:55 2013
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproperdatadictversion">
+<title>DataDictionaryVersion</title>
+<prolog><metadata>
+<keywords><indexterm>DataDictionaryVersion property</indexterm>
+<indexterm>database-wide properties<indexterm>retrieving database version</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Shows the version of the on-disk data in the database. This is the first two
+(major and minor) numbers in a
+<ph conref="../conrefs.dita#prod/productshortname"></ph> release identifier. For
+newly created databases, this is the release identifier of the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> engine jar used to
+create the database. For hard-upgraded databases, this is the release identifier
+of the Derby engine jar used to hard-upgrade the database.</p>
+<p>You can retrieve the value of this property by using the
+<xref href="rrefgetdbpropfunc.dita#rrefgetdbpropfunc"></xref>, but you cannot
+change it.</p>
+</section>
+<refsyn><title>Syntax</title>
+<codeblock><b>-- database-level property
+VALUES SYSCS_UTIL.SYSCS_GET_DATABASE_PROPERTY('DataDictionaryVersion')
+</b></codeblock>
+</refsyn>
+<example><title>Example</title>
+<codeblock>ij> <b>connect 'jdbc:derby:firstdb';</b>
+ij> <b>VALUES SYSCS_UTIL.SYSCS_GET_DATABASE_PROPERTY('DataDictionaryVersion');</b>
+<systemoutput>1                                                                                                                               
+-----------------------------------------------------------------------
+10.10                                                                                                                           
+
+1 row selected</systemoutput>
+</codeblock>
+</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefproperdatadictversion.dita
------------------------------------------------------------------------------
    svn:eol-style = native