|Daniel Prager||Sep 26, 2002 7:48 pm|
|Michael Fitzgerald||Sep 27, 2002 10:34 am|
|Michael Fitzgerald||Sep 27, 2002 5:02 pm|
|Michael Fitzgerald||Sep 28, 2002 11:31 pm|
|Daniel Prager||Sep 29, 2002 6:41 pm|
|Eddie Robertsson||Sep 29, 2002 7:16 pm|
|Daniel Prager||Sep 29, 2002 8:37 pm|
|Rick Jelliffe||Sep 29, 2002 9:11 pm|
|Daniel Prager||Sep 29, 2002 9:41 pm|
|Rick Jelliffe||Sep 30, 2002 2:04 am|
|Yonekura Koji||Sep 30, 2002 3:28 am|
|Robert Koberg||Oct 7, 2002 11:05 am|
|didier demany||Oct 8, 2002 1:35 am|
|Robert Koberg||Oct 8, 2002 1:45 am|
|Robert Koberg||Oct 8, 2002 1:48 am|
|Kohsuke KAWAGUCHI||Oct 8, 2002 6:32 am|
|Robert Koberg||Oct 9, 2002 11:50 am|
|MURATA Makoto (FAMILY Given)||Oct 9, 2002 5:26 pm|
|Eddie Robertsson||Oct 14, 2002 4:24 pm|
|Robert Koberg||Dec 3, 2002 6:52 am|
|Michael Fitzgerald||Dec 3, 2002 8:43 am|
|James Clark||Dec 3, 2002 8:57 pm|
|Robert Koberg||Dec 4, 2002 3:09 am|
|Subject:||RE: [relax-ng-comment] annotations: am I straying too far?|
|From:||Robert Koberg (ro...@livestoryboard.com)|
|Date:||Dec 4, 2002 3:09:32 am|
Thanks Michael and James,
Makes perfect sense. It covers everthing I need.
-----Original Message----- From: James Clark [mailto:jj...@jclark.com] Sent: Tuesday, December 03, 2002 8:45 PM To: Robert Koberg; relax-ng Subject: Re: [relax-ng-comment] annotations: am I straying too far?
I use RNG Schemas to build property forms and drive WYSIWYG editing (I am loving it!). In so doing I am making up my own annotations for the GUI and for documentation.
That's exactly the way annotations are intended to be used.
The "RELAX NG DTD Compatibility Annotations" shows a limited set of options.
These are just some standard annotations you can use if you want and they meet your needs. They are not at all intended to be exhaustive.
I was wondering if there was an extensibility mechanism planned
The extensibility mechanism is in RELAX NG itself, rather than in RELAX NG DTD Compatibility. The latter takes advantage of the former.
For a simple example, I want to give a descriptive label and rollover description for attributes in a properties form:
<rng:define name="title.attr"> <rng:attribute name="title"> <a:attr label="Title"> <a:description>A text title</a:description> </a:attr> <rng:data type="token"/> </rng:attribute> </rng:define>
Am I going to be in trouble by doing this or is it a reasonable thing to do?
Also, why does the annotation need to be a child?
You can put your annotations anywhere you like (that is allowed by RELAX NG). However, it can make things difficult for applications that want to deal with RELAX NG generically and want to handle annotations if different annotations have a different relationship to the RELAX NG element that they semantically apply to (e.g. if some wrap and some are children). For example, the compact syntax works best if child annotation elements semantically apply to the parent RELAX NG element.
I would prefer to wrap some definitions in annotations so I can group them for documentation purposes.
That's fine, though you might consider putting the annotation as a child of an rng:div that wraps the definitions.