Return-Path: 
 <derby-dev-return-15487-apmail-db-derby-dev-archive=db.apache.org@db.apache.org>
Delivered-To: apmail-db-derby-dev-archive@www.apache.org
Received: (qmail 76676 invoked from network); 22 Feb 2006 16:31:38 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 22 Feb 2006 16:31:38 -0000
Received: (qmail 67402 invoked by uid 500); 22 Feb 2006 16:31:37 -0000
Delivered-To: apmail-db-derby-dev-archive@db.apache.org
Received: (qmail 67361 invoked by uid 500); 22 Feb 2006 16:31:37 -0000
Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:derby-dev-help@db.apache.org>
List-Unsubscribe: <mailto:derby-dev-unsubscribe@db.apache.org>
List-Post: <mailto:derby-dev@db.apache.org>
List-Id: <derby-dev.db.apache.org>
Reply-To: <derby-dev@db.apache.org>
Delivered-To: mailing list derby-dev@db.apache.org
Received: (qmail 67352 invoked by uid 99); 22 Feb 2006 16:31:37 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 22 Feb 2006 08:31:36 -0800
X-ASF-Spam-Status: No, hits=0.0 required=10.0
	tests=
X-Spam-Check-By: apache.org
Received-SPF: pass (asf.osuosl.org: local policy)
Received: from [143.43.222.207] (HELO mail.wiu.edu) (143.43.222.207)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 22 Feb 2006 08:31:36 -0800
Received: from scanner0.wiu.edu (scanner0 [143.43.222.140])
	by mail.wiu.edu (8.9.3/8.9.3) with SMTP id KAA24224
	for <derby-dev@db.apache.org>; Wed, 22 Feb 2006 10:31:34 -0600 (CST)
Received: from smtp1.wiu.edu ([143.43.222.60])
 by scanner0.wiu.edu (SAVSMTP 3.1.1.32) with SMTP id M2006022210292131875
 for <derby-dev@db.apache.org>; Wed, 22 Feb 2006 10:29:21 -0600
Received: from [143.43.202.21] (scott.mprojects.wiu.edu [143.43.202.21])
	(authenticated bits=0)
	by smtp1.wiu.edu (8.13.4/8.13.4) with ESMTP id k1MGVCwO023346
	for <derby-dev@db.apache.org>; Wed, 22 Feb 2006 10:31:13 -0600 (CST)
Message-ID: <43FC91CA.6060704@wiu.edu>
Date: Wed, 22 Feb 2006 10:31:06 -0600
From: scott hutinger <S-Hutinger@wiu.edu>
User-Agent: Thunderbird 1.5 (X11/20051201)
MIME-Version: 1.0
To: derby-dev@db.apache.org
Subject: Re: [doc] Derby DITA documentation source DTD declarations
References: <20060216210424.77963.qmail@web81611.mail.mud.yahoo.com>
 <43F4EA8F.3080202@bristowhill.com>
In-Reply-To: <43F4EA8F.3080202@bristowhill.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

BTW, I started looking at the DITA-OT 1.2 beta, which has some hooks in 
it to make life a bit easier.  I didn't get very far in looking at it 
yet; but think Jeff must know that 1.2 should have the different 
declarations.  I'll continue to investigate the changes to OT1.2 etc...

scott

Jean T. Anderson wrote:
> Jeff Levitt wrote:
>   
>> Hi all,
>>
>> I noticed that in the DITA doc source files that we
>> have DTD declarations at the top that look like this:
>>
>> <!DOCTYPE reference PUBLIC "-//IBM//DTD DITA
>> Reference//EN"
>>  "../dtd/reference.dtd">
>>
>> Note that the declarations have the word "IBM" in
>> them.  This is because they are based on an old DTD
>> that DITA used before it was contributed to the open
>> source OASIS foundation.  Currently, the correct OASIS
>> DTD declaration looks like this:
>>
>> <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA
>> Reference//EN"
>>  "reference.dtd">
>>
>> While I dont see any problems with the old IBM
>> declaration right now, we will miss out on features in
>> the future if we dont migrate to the new OASIS
>> declaration.  We could do a search and replace, but
>> we'd have to be sure to do it correctly.  I dont think
>> this is a crucial requirement right now, so
>> alternatively I suggest that as doc contributors
>> submit patches to doc code, they should change the
>> declaration to the files they change as they go.  It
>> wont hurt anything to have different DTD declarations
>> in different files, and this solution allows us to
>> continue to work on the files without having to commit
>> time and resources to a migration.
>>     
>
> I think the phased "change as you go" approach you suggest is fine.
>
>   
>> If no one has any problems with this, I'll begin
>> submitting patches with the new declaration.  Also, is
>> there some place we can make this directive
>> moreprominent so future contributors will see it?  Any
>> suggestions?
>>     
>
> how about documenting it here?
>
>    http://db.apache.org/derby/manuals/dita.html
>
> If you want to provide a patch for that page, I'll be happy to apply it.
>
> -jean
>
>
>   
>> Of course, if someone wants to make a script that
>> fixes the problem, that's alright too.  It would
>> require changing the word "IBM" in the declaration to
>> "OASIS", and the "../" before the concept.dtd,
>> reference.dtd, and task.dtd to be removed.
>>
>> Jeff
>>
>>
>>     
>
>