[OpenAjaxIDE] Schema and spec updated per decisions on Tuesday

[Rich Thompson]

I would as well ....

Rich 



From:
Bertrand Le Roy <Bertrand.Le.Roy at microsoft.com>
To:
Jon Ferraiolo/Menlo Park/IBM at IBMUS
Cc:
"ide at openajax.org" <ide at openajax.org>
Date:
09/19/2008 01:16 AM
Subject:
Re: [OpenAjaxIDE] Schema and spec updated per decisions on Tuesday



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


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 _______________________________________________
IDE mailing list
IDE at openajax.org
http://openajax.org/mailman/listinfo/ide



-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://openajax.org/pipermail/ide/attachments/20080919/92be9fbc/attachment.html 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/gif
Size: 105 bytes
Desc: not available
Url : http://openajax.org/pipermail/ide/attachments/20080919/92be9fbc/attachment.gif