Return-Path: 
 <click-dev-return-1226-apmail-incubator-click-dev-archive=incubator.apache.org@incubator.apache.org>
Delivered-To: apmail-incubator-click-dev-archive@minotaur.apache.org
Received: (qmail 48782 invoked from network); 26 Oct 2009 01:43:22 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3)
  by minotaur.apache.org with SMTP; 26 Oct 2009 01:43:22 -0000
Received: (qmail 3967 invoked by uid 500); 26 Oct 2009 01:43:22 -0000
Delivered-To: apmail-incubator-click-dev-archive@incubator.apache.org
Received: (qmail 3927 invoked by uid 500); 26 Oct 2009 01:43:22 -0000
Mailing-List: contact click-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:click-dev-help@incubator.apache.org>
List-Unsubscribe: <mailto:click-dev-unsubscribe@incubator.apache.org>
List-Post: <mailto:click-dev@incubator.apache.org>
List-Id: <click-dev.incubator.apache.org>
Reply-To: click-dev@incubator.apache.org
Delivered-To: mailing list click-dev@incubator.apache.org
Received: (qmail 3918 invoked by uid 99); 26 Oct 2009 01:43:22 -0000
Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 26 Oct 2009 01:43:22 +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.140] (HELO brutus.apache.org) (140.211.11.140)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 26 Oct 2009 01:43:20 +0000
Received: from brutus (localhost [127.0.0.1])
	by brutus.apache.org (Postfix) with ESMTP id 640DE234C045
	for <click-dev@incubator.apache.org>; Sun, 25 Oct 2009 18:42:59 -0700 (PDT)
Message-ID: <891041974.1256521379394.JavaMail.jira@brutus>
Date: Mon, 26 Oct 2009 01:42:59 +0000 (UTC)
From: "hantsy bai (JIRA)" <jira@apache.org>
To: click-dev@incubator.apache.org
Subject: [jira] Created: (CLK-587) Define an official DTD DOCTYPE
 declaration in click.xml
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

Define an official DTD DOCTYPE declaration in click.xml
-------------------------------------------------------

                 Key: CLK-587
                 URL: https://issues.apache.org/jira/browse/CLK-587
             Project: Click
          Issue Type: Task
          Components: core
    Affects Versions: 2.1.0 RC1
            Reporter: hantsy bai


In a xml file, providing a dtd or schema declaration is not necessary but I think it is essential.
Currently the click.xml is lack of Dtd declaration header, like the following.

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE click-app PUBLIC
    "-//Apache Software Foundation//DTD Click Configuration 2.1//EN"
    "http://click.apache.org/dtds/click-2.1.dtd">

<click-app>
....
</click-app>

In the click.xml, providing a doctype declaration(the red section, it is just an example) is helpful for IDE. NetBeans IDE can use this declaration to determine if this file is a click configuration file, perform xml validation and provide basic code completion automatically ( The click for netbeans plugin provide basic code completion by the grammar api, and extra code completion is provided by Code completion api ,  eg. extra code completion for package, path and classname attribute value). 

Please publish an official dtd online in future version.


-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.