[OCF] proposal for improving the ra-api-1.dtd

[Huang Zhen]

Hello,

I am working on the GUI management tool for Linux-HA release 2.
When I deal with the ra-api-1.dtd, I feel we can add some fields to improve it.
1. Add "longdesc" and "shortdesc" to resource-agent. The description of resource agent itself will be put here.
2. Add "required" to parameter. if it's 1, the parameter is required.
3. Add "expert_level" to parameter. if it's 0, the parameter will be showed to all user in GUI client.
    If expert_level is 1, the parameter will be showed only for the user with expert level 1. And so on.
    The GUI will let user choose his/her expert level.

Any suggestions?
Thank you very much!

The revised DTD:

<?xml version="1.0" ?>

<!ELEMENT resource-agent (version,longdesc+,shortdesc+,parameters,actions,special) >
<!ATTLIST resource-agent
	name	CDATA	#REQUIRED
	version CDATA   #IMPLIED>

<!ELEMENT version (#PCDATA)>

<!ELEMENT parameters (parameter*)>

<!ELEMENT actions (action*)>

<!ELEMENT parameter (longdesc+,shortdesc+,content)>
<!ATTLIST parameter
	name	CDATA	#REQUIRED
	unique	(1|0)	"0"
	required (1|0)  "0"
	expert_level (0|1|2|3) "0">

<!ELEMENT longdesc ANY>
<!ATTLIST longdesc
	lang	NMTOKEN	#IMPLIED>

<!ELEMENT shortdesc ANY>
<!ATTLIST shortdesc
	lang	NMTOKEN	#IMPLIED>

<!ELEMENT content EMPTY>
<!ATTLIST content
	type	(string|integer|boolean)	#REQUIRED
	default CDATA	#IMPLIED>

<!ELEMENT action EMPTY>
<!ATTLIST action
	name	(start|stop|recover|status|reload|meta-data|verify-all)	#REQUIRED
	timeout		CDATA	#REQUIRED
	interval 	CDATA	#IMPLIED
	start-delay 	CDATA	#IMPLIED
	depth		CDATA	#IMPLIED>

<!ELEMENT special ANY>
<!ATTLIST special
	tag	CDATA	#REQUIRED>



-- 
Best Regards,
Huang Zhen
Linux Technology Center
IBM China Development Lab, Beijing
Telno: (8610)82782244-2845