Sarah,
To avoid the all those escaped HTML entities, such as > in the AI
instance document for <manifest_text>, I'd suggest 2 alternatives:
- put the manifest text in a separate document and having only its
pathname or URL in the AI instance document, or
- copy the schemas for the different manifest_text DOCTYPEs into the
configuration.dtd. Having multiple copies of schema definitions is a
maintenance hazard long term, but more friendly than requiring the user
to escape the HTML entities properly. Another benefit is that the
manifest_text can be validated along with the AI instance document.
Consider writing the schema so that required and optional elements of
"slice attribute: action" go with the action, so that the associated
elements are either required, optional, or prohibited based on the action.
Instead of having this:
slice attribute: action – one of create,delete, preserve, use_existing
slice attribute: name
element: size
size attribute: val – required
size attribute: size-units – required
size attribute: start_sector – optional
do this:
slice attribute: action = create
slice attribute: name - required
element: size
size attribute: val – required
size attribute: size-units – required
size attribute: start_sector – optional
slice attribute: action = delete
slice attribute: name - required
slice attribute: action = use_existing
etc.
The advantage of this method is that DTD validation would then catch
improper usage per action. There would be just a little more code, but
more precise DTD validation.
William
On 06/ 2/10 01:49 AM, Sarah Jelinek wrote:
Hi All,
A redesign effort has been under way for both the AI/DC schemas, and
as a result the manifests themselves. The documents listed below are
the first draft of the redesign proposal.
The documents are located in the caiman-doc repository both the .odt
and .pdf version of the AI/DC Schema and Manifest Redesign document.
You can get the docs here:
ssh://[email protected]/hg/caiman/caiman-docs
by pulling a clone.
I have also posted both versions on the opensolaris.org caiman project
page:
http://hub.opensolaris.org/bin/download/Project+caiman/WebHome/aidcmanifest.odt
http://hub.opensolaris.org/bin/download/Project+caiman/WebHome/aidcmanifest.pdf
Please send your feedback to the alias by 6/22/10.
If you plan to provide a review, please email me privately so I can
keep track of those who want to participate in the review. If you need
more time please let me know when you think you can complete the review.
As always, thank you for your time and attention.
Regards,
sarah
_______________________________________________
caiman-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/caiman-discuss
_______________________________________________
caiman-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/caiman-discuss
