Announcement: OFBiz Mini-language Overhaul

[Adrian Crum-3]

Ofbiz's home-grown scripting language - Mini-language - is designed to
make application development fast and easy.

Recently, Mini-language was completely overhauled: the grammar was
updated based on suggestions from the developer community, source code
validation was added, and the scripting engine was optimized and made
more robust. Those changes result in a scripting language that is easier
to use and performs well.

New Mini-language features:

1. Improved grammar
(https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
2. New looping elements <break> and <continue>.
3. New <trace> element - provides detailed logging of script engine
behavior.
4. Script engine source code has been optimized to use less memory and
run faster (40% faster on trunk version).

The overhaul has been back-ported to the Release 12 branch.

The Mini-language overhaul represents three man-months of work and it
was sponsored by 1Tech Ltd (http://1tech.eu).

-Adrian

[Foo Shyn Chung]

Hurray!

As such i'll be able to port this into my application by updating the
framework/minilang component from release 12 branch?

Thanks
FooShyn

On Wed, Jul 11, 2012 at 2:08 PM, Adrian Crum <
[hidden email]> wrote:

> Ofbiz's home-grown scripting language - Mini-language - is designed to
> make application development fast and easy.
>
> Recently, Mini-language was completely overhauled: the grammar was updated
> based on suggestions from the developer community, source code validation
> was added, and the scripting engine was optimized and made more robust.
> Those changes result in a scripting language that is easier to use and
> performs well.
>
> New Mini-language features:
>
> 1. Improved grammar (https://cwiki.apache.org/**
> confluence/display/OFBADMIN/**Mini-language+Reference<https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference>
> ).
> 2. New looping elements <break> and <continue>.
> 3. New <trace> element - provides detailed logging of script engine
> behavior.
> 4. Script engine source code has been optimized to use less memory and run
> faster (40% faster on trunk version).
>
> The overhaul has been back-ported to the Release 12 branch.
>
> The Mini-language overhaul represents three man-months of work and it was
> sponsored by 1Tech Ltd (http://1tech.eu).
>
> -Adrian
>
>

[Adrian Crum-3]

You should update the entire project.

-Adrian

On 7/11/2012 7:16 AM, Foo Shyn Chung wrote:

> Hurray!
>
> As such i'll be able to port this into my application by updating the
> framework/minilang component from release 12 branch?
>
> Thanks
> FooShyn
>
> On Wed, Jul 11, 2012 at 2:08 PM, Adrian Crum <
> [hidden email]> wrote:
>
>> Ofbiz's home-grown scripting language - Mini-language - is designed to
>> make application development fast and easy.
>>
>> Recently, Mini-language was completely overhauled: the grammar was updated
>> based on suggestions from the developer community, source code validation
>> was added, and the scripting engine was optimized and made more robust.
>> Those changes result in a scripting language that is easier to use and
>> performs well.
>>
>> New Mini-language features:
>>
>> 1. Improved grammar (https://cwiki.apache.org/**
>> confluence/display/OFBADMIN/**Mini-language+Reference<https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference>
>> ).
>> 2. New looping elements <break> and <continue>.
>> 3. New <trace> element - provides detailed logging of script engine
>> behavior.
>> 4. Script engine source code has been optimized to use less memory and run
>> faster (40% faster on trunk version).
>>
>> The overhaul has been back-ported to the Release 12 branch.
>>
>> The Mini-language overhaul represents three man-months of work and it was
>> sponsored by 1Tech Ltd (http://1tech.eu).
>>
>> -Adrian
>>
>>

[Jacques Le Roux]

Great, thanks for the effort Adrian!

Jacques

From: "Adrian Crum" <[hidden email]>

> Ofbiz's home-grown scripting language - Mini-language - is designed to
> make application development fast and easy.
>
> Recently, Mini-language was completely overhauled: the grammar was
> updated based on suggestions from the developer community, source code
> validation was added, and the scripting engine was optimized and made
> more robust. Those changes result in a scripting language that is easier
> to use and performs well.
>
> New Mini-language features:
>
> 1. Improved grammar
> (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
> 2. New looping elements <break> and <continue>.
> 3. New <trace> element - provides detailed logging of script engine
> behavior.
> 4. Script engine source code has been optimized to use less memory and
> run faster (40% faster on trunk version).
>
> The overhaul has been back-ported to the Release 12 branch.
>
> The Mini-language overhaul represents three man-months of work and it
> was sponsored by 1Tech Ltd (http://1tech.eu).
>
> -Adrian
>

[Jacopo Cappellato-4]

Thank you Adrian.

Jacopo

On Jul 11, 2012, at 8:08 AM, Adrian Crum wrote:

> Ofbiz's home-grown scripting language - Mini-language - is designed to make application development fast and easy.
>
> Recently, Mini-language was completely overhauled: the grammar was updated based on suggestions from the developer community, source code validation was added, and the scripting engine was optimized and made more robust. Those changes result in a scripting language that is easier to use and performs well.
>
> New Mini-language features:
>
> 1. Improved grammar (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
> 2. New looping elements <break> and <continue>.
> 3. New <trace> element - provides detailed logging of script engine behavior.
> 4. Script engine source code has been optimized to use less memory and run faster (40% faster on trunk version).
>
> The overhaul has been back-ported to the Release 12 branch.
>
> The Mini-language overhaul represents three man-months of work and it was sponsored by 1Tech Ltd (http://1tech.eu).
>
> -Adrian
>

[Foo Shyn Chung]

Ok, thanks a lot!

Thanks
FooShyn

On Wed, Jul 11, 2012 at 2:18 PM, Adrian Crum <
[hidden email]> wrote:

> You should update the entire project.
>
> -Adrian
>
>
> On 7/11/2012 7:16 AM, Foo Shyn Chung wrote:
>
>> Hurray!
>>
>> As such i'll be able to port this into my application by updating the
>> framework/minilang component from release 12 branch?
>>
>> Thanks
>> FooShyn
>>
>> On Wed, Jul 11, 2012 at 2:08 PM, Adrian Crum <
>> adrian.crum@sandglass-**software.com <[hidden email]>>
>> wrote:
>>
>>  Ofbiz's home-grown scripting language - Mini-language - is designed to
>>> make application development fast and easy.
>>>
>>> Recently, Mini-language was completely overhauled: the grammar was
>>> updated
>>> based on suggestions from the developer community, source code validation
>>> was added, and the scripting engine was optimized and made more robust.
>>> Those changes result in a scripting language that is easier to use and
>>> performs well.
>>>
>>> New Mini-language features:
>>>
>>> 1. Improved grammar (https://cwiki.apache.org/**
>>> confluence/display/OFBADMIN/****Mini-language+Reference<https:**
>>> //cwiki.apache.org/confluence/**display/OFBADMIN/Mini-**
>>> language+Reference<https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference>
>>> >
>>>
>>> ).
>>> 2. New looping elements <break> and <continue>.
>>> 3. New <trace> element - provides detailed logging of script engine
>>> behavior.
>>> 4. Script engine source code has been optimized to use less memory and
>>> run
>>> faster (40% faster on trunk version).
>>>
>>> The overhaul has been back-ported to the Release 12 branch.
>>>
>>> The Mini-language overhaul represents three man-months of work and it was
>>> sponsored by 1Tech Ltd (http://1tech.eu).
>>>
>>> -Adrian
>>>
>>>
>>>
>
>

[Tom]

Adrian,

Very nice!

Just noticed that CheckoutServices.xml still references the old schema:
<simple-methods xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xsi:noNamespaceSchemaLocation="http://www.ofbiz.org/dtds/simple-methods.xsd">

Any reason?

Tom

[Adrian Crum-3]

I must have missed that one.

-Adrian

On 7/12/2012 2:19 PM, Tom wrote:

> Adrian,
>
> Very nice!
>
> Just noticed that CheckoutServices.xml still references the old schema:
> <simple-methods xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
>        
> xsi:noNamespaceSchemaLocation="http://www.ofbiz.org/dtds/simple-methods.xsd">
>
> Any reason?
>
> Tom
>
>
> --
> View this message in context: http://ofbiz.135035.n4.nabble.com/Announcement-OFBiz-Mini-language-Overhaul-tp4634682p4634750.html
> Sent from the OFBiz - User mailing list archive at Nabble.com.

[olivier.heintz Neogia.org]

Thank you Adrian,

Improved grammar is really more clear and very useful to use.

Le 11/07/2012 08:08, Adrian Crum a écrit :

> Ofbiz's home-grown scripting language - Mini-language - is designed to
> make application development fast and easy.
>
> Recently, Mini-language was completely overhauled: the grammar was
> updated based on suggestions from the developer community, source code
> validation was added, and the scripting engine was optimized and made
> more robust. Those changes result in a scripting language that is
> easier to use and performs well.
>
> New Mini-language features:
>
> 1. Improved grammar
> (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
> 2. New looping elements <break> and <continue>.
> 3. New <trace> element - provides detailed logging of script engine
> behavior.
> 4. Script engine source code has been optimized to use less memory and
> run faster (40% faster on trunk version).
>
> The overhaul has been back-ported to the Release 12 branch.
>
> The Mini-language overhaul represents three man-months of work and it
> was sponsored by 1Tech Ltd (http://1tech.eu).
>
> -Adrian
>
>

[Jacques Le Roux]

Adrian,

Thinking of it: could you please a deprecated warning at top of
https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide, mentionning date or better revision? Also explaining releases
previous to R12.04 are not affected

Thanks

Jacques

From: "Jacques Le Roux" <[hidden email]>

> Great, thanks for the effort Adrian!
>
> Jacques
>
> From: "Adrian Crum" <[hidden email]>
>> Ofbiz's home-grown scripting language - Mini-language - is designed to make application development fast and easy.
>>
>> Recently, Mini-language was completely overhauled: the grammar was updated based on suggestions from the developer community,
>> source code validation was added, and the scripting engine was optimized and made more robust. Those changes result in a
>> scripting language that is easier to use and performs well.
>>
>> New Mini-language features:
>>
>> 1. Improved grammar (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>> 2. New looping elements <break> and <continue>.
>> 3. New <trace> element - provides detailed logging of script engine behavior.
>> 4. Script engine source code has been optimized to use less memory and run faster (40% faster on trunk version).
>>
>> The overhaul has been back-ported to the Release 12 branch.
>>
>> The Mini-language overhaul represents three man-months of work and it was sponsored by 1Tech Ltd (http://1tech.eu).
>>
>> -Adrian
>>

[Jacques Le Roux]

OK done

Jacques

From: "Jacques Le Roux" <[hidden email]>

> Adrian,
>
> Thinking of it: could you please a deprecated warning at top of
> https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide, mentionning date or better revision? Also explaining
> releases previous to R12.04 are not affected
>
> Thanks
>
> Jacques
>
> From: "Jacques Le Roux" <[hidden email]>
>> Great, thanks for the effort Adrian!
>>
>> Jacques
>>
>> From: "Adrian Crum" <[hidden email]>
>>> Ofbiz's home-grown scripting language - Mini-language - is designed to make application development fast and easy.
>>>
>>> Recently, Mini-language was completely overhauled: the grammar was updated based on suggestions from the developer community,
>>> source code validation was added, and the scripting engine was optimized and made more robust. Those changes result in a
>>> scripting language that is easier to use and performs well.
>>>
>>> New Mini-language features:
>>>
>>> 1. Improved grammar (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>>> 2. New looping elements <break> and <continue>.
>>> 3. New <trace> element - provides detailed logging of script engine behavior.
>>> 4. Script engine source code has been optimized to use less memory and run faster (40% faster on trunk version).
>>>
>>> The overhaul has been back-ported to the Release 12 branch.
>>>
>>> The Mini-language overhaul represents three man-months of work and it was sponsored by 1Tech Ltd (http://1tech.eu).
>>>
>>> -Adrian
>>>

[Adrian Crum-3]

I was planning on updating that document.

-Adrian

On 7/15/2012 11:30 AM, Jacques Le Roux wrote:

> OK done
>
> Jacques
>
> From: "Jacques Le Roux" <[hidden email]>
>> Adrian,
>>
>> Thinking of it: could you please a deprecated warning at top of
>> https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide, mentionning
>> date or better revision? Also explaining releases previous to R12.04
>> are not affected
>>
>> Thanks
>>
>> Jacques
>>
>> From: "Jacques Le Roux" <[hidden email]>
>>> Great, thanks for the effort Adrian!
>>>
>>> Jacques
>>>
>>> From: "Adrian Crum" <[hidden email]>
>>>> Ofbiz's home-grown scripting language - Mini-language - is designed
>>>> to make application development fast and easy.
>>>>
>>>> Recently, Mini-language was completely overhauled: the grammar was
>>>> updated based on suggestions from the developer community, source
>>>> code validation was added, and the scripting engine was optimized
>>>> and made more robust. Those changes result in a scripting language
>>>> that is easier to use and performs well.
>>>>
>>>> New Mini-language features:
>>>>
>>>> 1. Improved grammar
>>>> (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>>>> 2. New looping elements <break> and <continue>.
>>>> 3. New <trace> element - provides detailed logging of script engine
>>>> behavior.
>>>> 4. Script engine source code has been optimized to use less memory
>>>> and run faster (40% faster on trunk version).
>>>>
>>>> The overhaul has been back-ported to the Release 12 branch.
>>>>
>>>> The Mini-language overhaul represents three man-months of work and
>>>> it was sponsored by 1Tech Ltd (http://1tech.eu).
>>>>
>>>> -Adrian
>>>>

[Jacques Le Roux]

Will be even better indeed. In the meantime the warning will help

Jacques

From: "Adrian Crum" <[hidden email]>

>I was planning on updating that document.
>
> -Adrian
>
> On 7/15/2012 11:30 AM, Jacques Le Roux wrote:
>> OK done
>>
>> Jacques
>>
>> From: "Jacques Le Roux" <[hidden email]>
>>> Adrian,
>>>
>>> Thinking of it: could you please a deprecated warning at top of
>>> https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide, mentionning
>>> date or better revision? Also explaining releases previous to R12.04
>>> are not affected
>>>
>>> Thanks
>>>
>>> Jacques
>>>
>>> From: "Jacques Le Roux" <[hidden email]>
>>>> Great, thanks for the effort Adrian!
>>>>
>>>> Jacques
>>>>
>>>> From: "Adrian Crum" <[hidden email]>
>>>>> Ofbiz's home-grown scripting language - Mini-language - is designed
>>>>> to make application development fast and easy.
>>>>>
>>>>> Recently, Mini-language was completely overhauled: the grammar was
>>>>> updated based on suggestions from the developer community, source
>>>>> code validation was added, and the scripting engine was optimized
>>>>> and made more robust. Those changes result in a scripting language
>>>>> that is easier to use and performs well.
>>>>>
>>>>> New Mini-language features:
>>>>>
>>>>> 1. Improved grammar
>>>>> (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>>>>> 2. New looping elements <break> and <continue>.
>>>>> 3. New <trace> element - provides detailed logging of script engine
>>>>> behavior.
>>>>> 4. Script engine source code has been optimized to use less memory
>>>>> and run faster (40% faster on trunk version).
>>>>>
>>>>> The overhaul has been back-ported to the Release 12 branch.
>>>>>
>>>>> The Mini-language overhaul represents three man-months of work and
>>>>> it was sponsored by 1Tech Ltd (http://1tech.eu).
>>>>>
>>>>> -Adrian
>>>>>
>
>

[Jacques Le Roux]

Hi Adrian,

Have you tried to use https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.xsl against
simple-methods-v2.xsd
Example of result for the old grammar https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.html
More at https://cwiki.apache.org/confluence/pages/viewpageattachments.action?pageId=6553867

Else will you try and adapt it if needed?

Also I think we should make this tool more visible. For instance by putting it in the repo and adding an howto README file.

Jacques

From: "Jacques Le Roux" <[hidden email]>

> Will be even better indeed. In the meantime the warning will help
>
> Jacques
>
> From: "Adrian Crum" <[hidden email]>
>>I was planning on updating that document.
>>
>> -Adrian
>>
>> On 7/15/2012 11:30 AM, Jacques Le Roux wrote:
>>> OK done
>>>
>>> Jacques
>>>
>>> From: "Jacques Le Roux" <[hidden email]>
>>>> Adrian,
>>>>
>>>> Thinking of it: could you please a deprecated warning at top of
>>>> https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide, mentionning date or better revision? Also explaining
>>>> releases previous to R12.04 are not affected
>>>>
>>>> Thanks
>>>>
>>>> Jacques
>>>>
>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>> Great, thanks for the effort Adrian!
>>>>>
>>>>> Jacques
>>>>>
>>>>> From: "Adrian Crum" <[hidden email]>
>>>>>> Ofbiz's home-grown scripting language - Mini-language - is designed to make application development fast and easy.
>>>>>>
>>>>>> Recently, Mini-language was completely overhauled: the grammar was updated based on suggestions from the developer community,
>>>>>> source code validation was added, and the scripting engine was optimized and made more robust. Those changes result in a
>>>>>> scripting language that is easier to use and performs well.
>>>>>>
>>>>>> New Mini-language features:
>>>>>>
>>>>>> 1. Improved grammar (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>>>>>> 2. New looping elements <break> and <continue>.
>>>>>> 3. New <trace> element - provides detailed logging of script engine behavior.
>>>>>> 4. Script engine source code has been optimized to use less memory and run faster (40% faster on trunk version).
>>>>>>
>>>>>> The overhaul has been back-ported to the Release 12 branch.
>>>>>>
>>>>>> The Mini-language overhaul represents three man-months of work and it was sponsored by 1Tech Ltd (http://1tech.eu).
>>>>>>
>>>>>> -Adrian
>>>>>>
>>

[Adrian Crum-3]

I didn't know about that style sheet.

I know there was an effort to put all Mini-language documentation in the
schema, but I'm not sure that is a good idea because it isn't
i18n-friendly. If someone wanted a translation of the Mini-language
reference then they could create another Wiki page for it.

-Adrian

On 7/19/2012 8:47 AM, Jacques Le Roux wrote:

> Hi Adrian,
>
> Have you tried to use
> https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.xsl 
> against simple-methods-v2.xsd
> Example of result for the old grammar
> https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.html
> More at
> https://cwiki.apache.org/confluence/pages/viewpageattachments.action?pageId=6553867
>
> Else will you try and adapt it if needed?
>
> Also I think we should make this tool more visible. For instance by
> putting it in the repo and adding an howto README file.
>
> Jacques
>
> From: "Jacques Le Roux" <[hidden email]>
>> Will be even better indeed. In the meantime the warning will help
>>
>> Jacques
>>
>> From: "Adrian Crum" <[hidden email]>
>>> I was planning on updating that document.
>>>
>>> -Adrian
>>>
>>> On 7/15/2012 11:30 AM, Jacques Le Roux wrote:
>>>> OK done
>>>>
>>>> Jacques
>>>>
>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>> Adrian,
>>>>>
>>>>> Thinking of it: could you please a deprecated warning at top of
>>>>> https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide,
>>>>> mentionning date or better revision? Also explaining releases
>>>>> previous to R12.04 are not affected
>>>>>
>>>>> Thanks
>>>>>
>>>>> Jacques
>>>>>
>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>> Great, thanks for the effort Adrian!
>>>>>>
>>>>>> Jacques
>>>>>>
>>>>>> From: "Adrian Crum" <[hidden email]>
>>>>>>> Ofbiz's home-grown scripting language - Mini-language - is
>>>>>>> designed to make application development fast and easy.
>>>>>>>
>>>>>>> Recently, Mini-language was completely overhauled: the grammar
>>>>>>> was updated based on suggestions from the developer community,
>>>>>>> source code validation was added, and the scripting engine was
>>>>>>> optimized and made more robust. Those changes result in a
>>>>>>> scripting language that is easier to use and performs well.
>>>>>>>
>>>>>>> New Mini-language features:
>>>>>>>
>>>>>>> 1. Improved grammar
>>>>>>> (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>>>>>>> 2. New looping elements <break> and <continue>.
>>>>>>> 3. New <trace> element - provides detailed logging of script
>>>>>>> engine behavior.
>>>>>>> 4. Script engine source code has been optimized to use less
>>>>>>> memory and run faster (40% faster on trunk version).
>>>>>>>
>>>>>>> The overhaul has been back-ported to the Release 12 branch.
>>>>>>>
>>>>>>> The Mini-language overhaul represents three man-months of work
>>>>>>> and it was sponsored by 1Tech Ltd (http://1tech.eu).
>>>>>>>
>>>>>>> -Adrian
>>>>>>>
>>>

[Jacques Le Roux]

You did not complelty answer my question :o)

I think it's pretty useful and pragmatic (did you see any API translated? ;o) to have the doc in schemas. Because of auto-completion
and inline doc with modern XML editors.

Also for the transform, will you try to use it on the new one? It could be still useful when you get no connections.

BTW I guess you put already most of the doc in the schema (not complete, I understand)?

Jacques

From: "Adrian Crum" <[hidden email]>

>I didn't know about that style sheet.
>
> I know there was an effort to put all Mini-language documentation in the schema, but I'm not sure that is a good idea because it
> isn't i18n-friendly. If someone wanted a translation of the Mini-language reference then they could create another Wiki page for
> it.
>
> -Adrian
>
> On 7/19/2012 8:47 AM, Jacques Le Roux wrote:
>> Hi Adrian,
>>
>> Have you tried to use https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.xsl against
>> simple-methods-v2.xsd
>> Example of result for the old grammar https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.html
>> More at https://cwiki.apache.org/confluence/pages/viewpageattachments.action?pageId=6553867
>>
>> Else will you try and adapt it if needed?
>>
>> Also I think we should make this tool more visible. For instance by putting it in the repo and adding an howto README file.
>>
>> Jacques
>>
>> From: "Jacques Le Roux" <[hidden email]>
>>> Will be even better indeed. In the meantime the warning will help
>>>
>>> Jacques
>>>
>>> From: "Adrian Crum" <[hidden email]>
>>>> I was planning on updating that document.
>>>>
>>>> -Adrian
>>>>
>>>> On 7/15/2012 11:30 AM, Jacques Le Roux wrote:
>>>>> OK done
>>>>>
>>>>> Jacques
>>>>>
>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>> Adrian,
>>>>>>
>>>>>> Thinking of it: could you please a deprecated warning at top of
>>>>>> https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide, mentionning date or better revision? Also explaining
>>>>>> releases previous to R12.04 are not affected
>>>>>>
>>>>>> Thanks
>>>>>>
>>>>>> Jacques
>>>>>>
>>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>>> Great, thanks for the effort Adrian!
>>>>>>>
>>>>>>> Jacques
>>>>>>>
>>>>>>> From: "Adrian Crum" <[hidden email]>
>>>>>>>> Ofbiz's home-grown scripting language - Mini-language - is designed to make application development fast and easy.
>>>>>>>>
>>>>>>>> Recently, Mini-language was completely overhauled: the grammar was updated based on suggestions from the developer
>>>>>>>> community, source code validation was added, and the scripting engine was optimized and made more robust. Those changes
>>>>>>>> result in a scripting language that is easier to use and performs well.
>>>>>>>>
>>>>>>>> New Mini-language features:
>>>>>>>>
>>>>>>>> 1. Improved grammar (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>>>>>>>> 2. New looping elements <break> and <continue>.
>>>>>>>> 3. New <trace> element - provides detailed logging of script engine behavior.
>>>>>>>> 4. Script engine source code has been optimized to use less memory and run faster (40% faster on trunk version).
>>>>>>>>
>>>>>>>> The overhaul has been back-ported to the Release 12 branch.
>>>>>>>>
>>>>>>>> The Mini-language overhaul represents three man-months of work and it was sponsored by 1Tech Ltd (http://1tech.eu).
>>>>>>>>
>>>>>>>> -Adrian
>>>>>>>>
>>>>
>

[Adrian Crum-3]

On 7/19/2012 3:45 PM, Jacques Le Roux wrote:
> You did not complelty answer my question :o)
>
> I think it's pretty useful and pragmatic (did you see any API
> translated? ;o) to have the doc in schemas. Because of auto-completion
> and inline doc with modern XML editors.

In my mind there is a difference between a language reference and a user
guide (or developer's guide). A language reference simply describes the
language's grammar. A user/developer guide tells you how to use the
language to write programs. I put the Mini-language reference in the
schema. The user/developer guide should be in the Wiki. The
user/developer guide should point to the language reference. And yes, I
have seen user/developer guides written in multiple languages.

>
> Also for the transform, will you try to use it on the new one? It
> could be still useful when you get no connections.

I don't have the time to work on it. Sorry.

>
> BTW I guess you put already most of the doc in the schema (not
> complete, I understand)?
>
> Jacques
>
> From: "Adrian Crum" <[hidden email]>
>> I didn't know about that style sheet.
>>
>> I know there was an effort to put all Mini-language documentation in
>> the schema, but I'm not sure that is a good idea because it isn't
>> i18n-friendly. If someone wanted a translation of the Mini-language
>> reference then they could create another Wiki page for it.
>>
>> -Adrian
>>
>> On 7/19/2012 8:47 AM, Jacques Le Roux wrote:
>>> Hi Adrian,
>>>
>>> Have you tried to use
>>> https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.xsl 
>>> against simple-methods-v2.xsd
>>> Example of result for the old grammar
>>> https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.html
>>> More at
>>> https://cwiki.apache.org/confluence/pages/viewpageattachments.action?pageId=6553867
>>>
>>> Else will you try and adapt it if needed?
>>>
>>> Also I think we should make this tool more visible. For instance by
>>> putting it in the repo and adding an howto README file.
>>>
>>> Jacques
>>>
>>> From: "Jacques Le Roux" <[hidden email]>
>>>> Will be even better indeed. In the meantime the warning will help
>>>>
>>>> Jacques
>>>>
>>>> From: "Adrian Crum" <[hidden email]>
>>>>> I was planning on updating that document.
>>>>>
>>>>> -Adrian
>>>>>
>>>>> On 7/15/2012 11:30 AM, Jacques Le Roux wrote:
>>>>>> OK done
>>>>>>
>>>>>> Jacques
>>>>>>
>>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>>> Adrian,
>>>>>>>
>>>>>>> Thinking of it: could you please a deprecated warning at top of
>>>>>>> https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide,
>>>>>>> mentionning date or better revision? Also explaining releases
>>>>>>> previous to R12.04 are not affected
>>>>>>>
>>>>>>> Thanks
>>>>>>>
>>>>>>> Jacques
>>>>>>>
>>>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>>>> Great, thanks for the effort Adrian!
>>>>>>>>
>>>>>>>> Jacques
>>>>>>>>
>>>>>>>> From: "Adrian Crum" <[hidden email]>
>>>>>>>>> Ofbiz's home-grown scripting language - Mini-language - is
>>>>>>>>> designed to make application development fast and easy.
>>>>>>>>>
>>>>>>>>> Recently, Mini-language was completely overhauled: the grammar
>>>>>>>>> was updated based on suggestions from the developer community,
>>>>>>>>> source code validation was added, and the scripting engine was
>>>>>>>>> optimized and made more robust. Those changes result in a
>>>>>>>>> scripting language that is easier to use and performs well.
>>>>>>>>>
>>>>>>>>> New Mini-language features:
>>>>>>>>>
>>>>>>>>> 1. Improved grammar
>>>>>>>>> (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>>>>>>>>> 2. New looping elements <break> and <continue>.
>>>>>>>>> 3. New <trace> element - provides detailed logging of script
>>>>>>>>> engine behavior.
>>>>>>>>> 4. Script engine source code has been optimized to use less
>>>>>>>>> memory and run faster (40% faster on trunk version).
>>>>>>>>>
>>>>>>>>> The overhaul has been back-ported to the Release 12 branch.
>>>>>>>>>
>>>>>>>>> The Mini-language overhaul represents three man-months of work
>>>>>>>>> and it was sponsored by 1Tech Ltd (http://1tech.eu).
>>>>>>>>>
>>>>>>>>> -Adrian
>>>>>>>>>
>>>>>
>>

[Jacques Le Roux]

From: "Adrian Crum" <[hidden email]>

> On 7/19/2012 3:45 PM, Jacques Le Roux wrote:
>> You did not complelty answer my question :o)
>>
>> I think it's pretty useful and pragmatic (did you see any API translated? ;o) to have the doc in schemas. Because of
>> auto-completion and inline doc with modern XML editors.
>
> In my mind there is a difference between a language reference and a user guide (or developer's guide). A language reference simply
> describes the language's grammar. A user/developer guide tells you how to use the language to write programs. I put the
> Mini-language reference in the schema. The user/developer guide should be in the Wiki. The user/developer guide should point to
> the language reference. And yes, I have seen user/developer guides written in multiple languages.

I understand your point wich makes totally sense. Also I remember you said you will update the Mini-Language Guide, completing your
awesome effort.
What I'm afraid of is the maintenance of the (beautiful) language reference page in wiki. I prefer no documentation, than an
obsolete/wrong one. I don't say that specifically for this page. We have much to much examples in our wiki :/

That's why I thought that rather than expecting translation of this page, it would be better to rely on an automated process based
on the schema content. It's only a pragmatic concern.
On the other hand we should not expect much changes in the mini language now (the past shows this happens). So maybe we can forget
it, and simply keep the idea to generate doc (automated process based on the  - schema - content)

Jacques

>>
>> Also for the transform, will you try to use it on the new one? It could be still useful when you get no connections.
>
> I don't have the time to work on it. Sorry.
>
>>
>> BTW I guess you put already most of the doc in the schema (not complete, I understand)?
>>
>> Jacques
>>
>> From: "Adrian Crum" <[hidden email]>
>>> I didn't know about that style sheet.
>>>
>>> I know there was an effort to put all Mini-language documentation in the schema, but I'm not sure that is a good idea because it
>>> isn't i18n-friendly. If someone wanted a translation of the Mini-language reference then they could create another Wiki page for
>>> it.
>>>
>>> -Adrian
>>>
>>> On 7/19/2012 8:47 AM, Jacques Le Roux wrote:
>>>> Hi Adrian,
>>>>
>>>> Have you tried to use https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.xsl against
>>>> simple-methods-v2.xsd
>>>> Example of result for the old grammar https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.html
>>>> More at https://cwiki.apache.org/confluence/pages/viewpageattachments.action?pageId=6553867
>>>>
>>>> Else will you try and adapt it if needed?
>>>>
>>>> Also I think we should make this tool more visible. For instance by putting it in the repo and adding an howto README file.
>>>>
>>>> Jacques
>>>>
>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>> Will be even better indeed. In the meantime the warning will help
>>>>>
>>>>> Jacques
>>>>>
>>>>> From: "Adrian Crum" <[hidden email]>
>>>>>> I was planning on updating that document.
>>>>>>
>>>>>> -Adrian
>>>>>>
>>>>>> On 7/15/2012 11:30 AM, Jacques Le Roux wrote:
>>>>>>> OK done
>>>>>>>
>>>>>>> Jacques
>>>>>>>
>>>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>>>> Adrian,
>>>>>>>>
>>>>>>>> Thinking of it: could you please a deprecated warning at top of
>>>>>>>> https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide, mentionning date or better revision? Also explaining
>>>>>>>> releases previous to R12.04 are not affected
>>>>>>>>
>>>>>>>> Thanks
>>>>>>>>
>>>>>>>> Jacques
>>>>>>>>
>>>>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>>>>> Great, thanks for the effort Adrian!
>>>>>>>>>
>>>>>>>>> Jacques
>>>>>>>>>
>>>>>>>>> From: "Adrian Crum" <[hidden email]>
>>>>>>>>>> Ofbiz's home-grown scripting language - Mini-language - is designed to make application development fast and easy.
>>>>>>>>>>
>>>>>>>>>> Recently, Mini-language was completely overhauled: the grammar was updated based on suggestions from the developer
>>>>>>>>>> community, source code validation was added, and the scripting engine was optimized and made more robust. Those changes
>>>>>>>>>> result in a scripting language that is easier to use and performs well.
>>>>>>>>>>
>>>>>>>>>> New Mini-language features:
>>>>>>>>>>
>>>>>>>>>> 1. Improved grammar (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>>>>>>>>>> 2. New looping elements <break> and <continue>.
>>>>>>>>>> 3. New <trace> element - provides detailed logging of script engine behavior.
>>>>>>>>>> 4. Script engine source code has been optimized to use less memory and run faster (40% faster on trunk version).
>>>>>>>>>>
>>>>>>>>>> The overhaul has been back-ported to the Release 12 branch.
>>>>>>>>>>
>>>>>>>>>> The Mini-language overhaul represents three man-months of work and it was sponsored by 1Tech Ltd (http://1tech.eu).
>>>>>>>>>>
>>>>>>>>>> -Adrian
>>>>>>>>>>
>>>>>>
>>>
>

[Adrian Crum-3]

On 7/20/2012 10:29 AM, Jacques Le Roux wrote:

> From: "Adrian Crum" <[hidden email]>
>> On 7/19/2012 3:45 PM, Jacques Le Roux wrote:
>>> You did not complelty answer my question :o)
>>>
>>> I think it's pretty useful and pragmatic (did you see any API
>>> translated? ;o) to have the doc in schemas. Because of
>>> auto-completion and inline doc with modern XML editors.
>>
>> In my mind there is a difference between a language reference and a
>> user guide (or developer's guide). A language reference simply
>> describes the language's grammar. A user/developer guide tells you
>> how to use the language to write programs. I put the
>> Mini-language reference in the schema. The user/developer guide
>> should be in the Wiki. The user/developer guide should point to
>> the language reference. And yes, I have seen user/developer guides
>> written in multiple languages.
>
> I understand your point wich makes totally sense. Also I remember you
> said you will update the Mini-Language Guide, completing your
> awesome effort.

I still plan to do that in a few weeks.

> What I'm afraid of is the maintenance of the (beautiful) language
> reference page in wiki. I prefer no documentation, than an
> obsolete/wrong one. I don't say that specifically for this page. We
> have much to much examples in our wiki :/
>
> That's why I thought that rather than expecting translation of this
> page, it would be better to rely on an automated process based
> on the schema content. It's only a pragmatic concern.
> On the other hand we should not expect much changes in the mini
> language now (the past shows this happens). So maybe we can forget
> it, and simply keep the idea to generate doc (automated process based
> on the  - schema - content)
>
> Jacques
>
>>>
>>> Also for the transform, will you try to use it on the new one? It
>>> could be still useful when you get no connections.
>>
>> I don't have the time to work on it. Sorry.
>>
>>>
>>> BTW I guess you put already most of the doc in the schema (not
>>> complete, I understand)?
>>>
>>> Jacques
>>>
>>> From: "Adrian Crum" <[hidden email]>
>>>> I didn't know about that style sheet.
>>>>
>>>> I know there was an effort to put all Mini-language documentation
>>>> in the schema, but I'm not sure that is a good idea because it
>>>> isn't i18n-friendly. If someone wanted a translation of the
>>>> Mini-language reference then they could create another Wiki page for
>>>> it.
>>>>
>>>> -Adrian
>>>>
>>>> On 7/19/2012 8:47 AM, Jacques Le Roux wrote:
>>>>> Hi Adrian,
>>>>>
>>>>> Have you tried to use
>>>>> https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.xsl 
>>>>> against
>>>>> simple-methods-v2.xsd
>>>>> Example of result for the old grammar
>>>>> https://cwiki.apache.org/confluence/download/attachments/6553867/simple-methods.html
>>>>> More at
>>>>> https://cwiki.apache.org/confluence/pages/viewpageattachments.action?pageId=6553867
>>>>>
>>>>> Else will you try and adapt it if needed?
>>>>>
>>>>> Also I think we should make this tool more visible. For instance
>>>>> by putting it in the repo and adding an howto README file.
>>>>>
>>>>> Jacques
>>>>>
>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>> Will be even better indeed. In the meantime the warning will help
>>>>>>
>>>>>> Jacques
>>>>>>
>>>>>> From: "Adrian Crum" <[hidden email]>
>>>>>>> I was planning on updating that document.
>>>>>>>
>>>>>>> -Adrian
>>>>>>>
>>>>>>> On 7/15/2012 11:30 AM, Jacques Le Roux wrote:
>>>>>>>> OK done
>>>>>>>>
>>>>>>>> Jacques
>>>>>>>>
>>>>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>>>>> Adrian,
>>>>>>>>>
>>>>>>>>> Thinking of it: could you please a deprecated warning at top of
>>>>>>>>> https://cwiki.apache.org/confluence/display/OFBIZ/Mini-Language+Guide,
>>>>>>>>> mentionning date or better revision? Also explaining
>>>>>>>>> releases previous to R12.04 are not affected
>>>>>>>>>
>>>>>>>>> Thanks
>>>>>>>>>
>>>>>>>>> Jacques
>>>>>>>>>
>>>>>>>>> From: "Jacques Le Roux" <[hidden email]>
>>>>>>>>>> Great, thanks for the effort Adrian!
>>>>>>>>>>
>>>>>>>>>> Jacques
>>>>>>>>>>
>>>>>>>>>> From: "Adrian Crum" <[hidden email]>
>>>>>>>>>>> Ofbiz's home-grown scripting language - Mini-language - is
>>>>>>>>>>> designed to make application development fast and easy.
>>>>>>>>>>>
>>>>>>>>>>> Recently, Mini-language was completely overhauled: the
>>>>>>>>>>> grammar was updated based on suggestions from the developer
>>>>>>>>>>> community, source code validation was added, and the
>>>>>>>>>>> scripting engine was optimized and made more robust. Those
>>>>>>>>>>> changes
>>>>>>>>>>> result in a scripting language that is easier to use and
>>>>>>>>>>> performs well.
>>>>>>>>>>>
>>>>>>>>>>> New Mini-language features:
>>>>>>>>>>>
>>>>>>>>>>> 1. Improved grammar
>>>>>>>>>>> (https://cwiki.apache.org/confluence/display/OFBADMIN/Mini-language+Reference).
>>>>>>>>>>> 2. New looping elements <break> and <continue>.
>>>>>>>>>>> 3. New <trace> element - provides detailed logging of script
>>>>>>>>>>> engine behavior.
>>>>>>>>>>> 4. Script engine source code has been optimized to use less
>>>>>>>>>>> memory and run faster (40% faster on trunk version).
>>>>>>>>>>>
>>>>>>>>>>> The overhaul has been back-ported to the Release 12 branch.
>>>>>>>>>>>
>>>>>>>>>>> The Mini-language overhaul represents three man-months of
>>>>>>>>>>> work and it was sponsored by 1Tech Ltd (http://1tech.eu).
>>>>>>>>>>>
>>>>>>>>>>> -Adrian
>>>>>>>>>>>
>>>>>>>
>>>>
>>