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" <adrian.c...@sandglass-software.com>
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" <jacques.le.r...@les7arts.com>
Will be even better indeed. In the meantime the warning will help
Jacques
From: "Adrian Crum" <adrian.c...@sandglass-software.com>
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" <jacques.le.r...@les7arts.com>
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" <jacques.le.r...@les7arts.com>
Great, thanks for the effort Adrian!
Jacques
From: "Adrian Crum" <adrian.c...@sandglass-software.com>
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
