[OpenAjaxIDE] Schema and spec updated per decisions on Tuesday

Bertrand Le Roy Bertrand.Le.Roy at microsoft.com
Thu Sep 18 22:13:56 PDT 2008


Well, the OpenAjax format won't be usable directly without some work or transform by either Aptana or Google as a drop-in replacement for their own formats, so I'd vote for self-consistency here.

From: Jon Ferraiolo [mailto:jferrai at us.ibm.com]
Sent: Thursday, September 18, 2008 9:43 PM
To: Bertrand Le Roy
Cc: ide at openajax.org
Subject: RE: [OpenAjaxIDE] Schema and spec updated per decisions on Tuesday


I'm not sure I have a great answer. First off, the original tag came from Aptana, and therefore there was some inertia with it. Strictly speaking, the term is correctly stated in English as two words (user agent), which would imply <userAgent>, butI doubt if many people would screen if it were used (incorrectly) as a compound word (useragent) in a document, which would result in <useragent>.

Here are the camel case tags that we have now:

<returnType>, <returnTypes>
<eventHandlerPatterns>, <addEventHandlerPattern>, <removeEventHandlerPattern>
<childProperties>
<aboutMe>
<directoryTitle>

We also have <messagebundle>, which we didn't camel case because we incorporated the feature as is from Google Gadgets.

We have several attributes that use camel case, but I'm too lazy to make a list.

I expect Aptana is the only implementer of <useragent> at this point.

Jon


[cid:image001.gif at 01C919DB.D708A510]Bertrand Le Roy <Bertrand.Le.Roy at microsoft.com>

Bertrand Le Roy <Bertrand.Le.Roy at microsoft.com>

09/18/2008 04:36 PM


To


Jon Ferraiolo/Menlo Park/IBM at IBMUS, "ide at openajax.org" <ide at openajax.org>


cc




Subject


RE: [OpenAjaxIDE] Schema and spec updated per decisions on Tuesday








Quick question: why is useragent not Camel-cased?

From: ide-bounces at openajax.org [mailto:ide-bounces at openajax.org] On Behalf Of Jon Ferraiolo
Sent: Thursday, September 18, 2008 10:06 AM
To: ide at openajax.org
Subject: [OpenAjaxIDE] Schema and spec updated per decisions on Tuesday

I made lots of minor changes to the language schema and corresponding minor changes to the spec to reflect what we decided at Tuesday's phone call.

As part of my process of updated the schema, I have finally got around to checking the schema into our SVN project at SourceForge so that people can see what schema changes were made with each revision. The base version was the schema definition before Tuesday's phone call. The first update to the SVN tree reflects the changes I made this week.

Here is a summary of the changes I made:

(a) The <returns> element is now <returnType>, with a corresponding plural element <returnTypes>

(b) 'datatype' is now required on <returnType>

(c) 'platform' is now required on <useragent>

(d) We now allow multiple plural elements (previously at most one was allowed). For example, you can now say:

<widget>
<properties name="propbag1"><property .../><property .../></properties>
<properties name="propbag2"><property .../><property .../></properties>
</widget>

and

<api>
<classes name="set1"><class .../><class .../></classes>
<classes name="set2"><class .../><class .../></classes>
</api>

and similarly for all of the plural elements that we have: aliases, ancestors, authors, categories, childProperties, classes, constructors, contents, enums, eventHandlerPatterns, events, examples, fields, icons, interfaces, javascripts, methods, mixes, mixins, namespaces, references, requires, returnTypes, topics

(e) There is now an optional 'name' attribute on the plural elements, and the plural elements can also have any of the descriptive elements (in particular., <title> as the localizable alternative to 'name')

(f) I fixed a schema bug where <enums> and <enum> weren't referenced from <api> element

If anyone sees any problems with the above, please speak up.

Jon
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://openajax.org/pipermail/ide/attachments/20080918/fb5bf336/attachment-0001.html 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.gif
Type: image/gif
Size: 105 bytes
Desc: image001.gif
Url : http://openajax.org/pipermail/ide/attachments/20080918/fb5bf336/attachment-0001.gif 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.png
Type: image/png
Size: 168 bytes
Desc: image002.png
Url : http://openajax.org/pipermail/ide/attachments/20080918/fb5bf336/attachment-0002.png 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image003.png
Type: image/png
Size: 166 bytes
Desc: image003.png
Url : http://openajax.org/pipermail/ide/attachments/20080918/fb5bf336/attachment-0003.png 


More information about the IDE mailing list