Eclipse Community Forums: M2T (model-to-text transformation)

Help

Home

Home » Modeling » M2T (model-to-text transformation) » Acceleo Documentation(Complete AQL documentation)

Show: Today's Messages :: Show Polls :: Message Navigator

Acceleo Documentation [message #1761470]

Thu, 11 May 2017 12:11

Geoffry Roberts

Messages: 52
Registered: July 2016

Member

All,

Can anyone point me to a comprehensive documentation for Acceleo? I need documentation on AQL in particular. I am getting the broad ideas but keep running afoul of some of the nitty gritty. I find myself faced with much trial and error.

I've Googled and keep coming up with things that are good as far as they go but are in the end a bit terse.

I need to generate bash, java, c++, xml, javascript from papyrus' uml.

I really need to generate entire eclipse projects code, scaffolding, and all but that is probably a bridge too far for Acceleo.

Thanks so much

Report message to a moderator

Re: Acceleo Documentation [message #1761473 is a reply to message #1761470]

Thu, 11 May 2017 12:25

Ed Willink

Messages: 7655
Registered: July 2009

Senior Member

Hi

The Acceleo documentation can be found via Help->Contents. Acceleo extends the Classic Eclipse OCL. It has not been upgraded to exploit the additional capabilities of the Pivot-based Eclipse OCL.

AQL is something of a misnomer. It appears to be a redevelopment independent of Eclipse OCL. Consequently Acceleo and/or OCL documentation could be misleading. You need to read only something that explicitly claims to be AQL or explains how AQL refines whatever it is based on.

Regards

Ed Willink

Report message to a moderator

Re: Acceleo Documentation [message #1761474 is a reply to message #1761473]

Thu, 11 May 2017 12:37

Geoffry Roberts

Messages: 52
Registered: July 2016

Member

Thanks Ed.

I've read the Help. That's some of what I am labeling as terse.

Let me ask this of the community: How are you learning Acceleo? Do you find the aforementioned help sufficient? Are you getting significant things done or just piddling around?

Report message to a moderator

Re: Acceleo Documentation [message #1761586 is a reply to message #1761474]

Thu, 11 May 2017 13:29

Ed Willink

Messages: 7655
Registered: July 2009

Senior Member

Hi

You can also read the MOFM2T specification.

Acceleo is an M2T technology so its fairly easy to push debug print out into the generated output to see what is happening.

This is part of the typical Open Source contract, documentation is inadequate unless a community member provides it. But you get the sources so you can investigate properly and accurately. Sometimes you get helpful forum answers.

But ultimately I'm a Java tool developer so I dive in with the debugger when baffled. I reported a number of bugs. Some were fixed, some weren't. Since I was using Acceleo based on OCL to transform OCL, my use case confused the tooling, so I moved to Xtend (whose String Templates make it an M2T tool as just one of its many Java++ capabilities).

Regards

Ed Willink

Report message to a moderator

Re: Acceleo Documentation [message #1766147 is a reply to message #1761586]

Fri, 16 June 2017 13:08

Laurent Goubet

Messages: 1902
Registered: July 2009

Senior Member

Hi Geoffry,

AQL is the language used by Sirius, but not Acceleo, so the documentation on it will not apply to Acceleo. The help contents (that Ed pointed you to) and the wiki are the main entry points for Acceleo documentation. We tried to make the documentation extensive enough when we initially wrote it, but there might be issues now as we didn't always keep it up to date with latest developments. Do not hesitate to point out the erroneous/misleading information if any.

As for learning how to use the language, I'd say it'd be best to look at existing generators to see how they are written. The Eclipse UML Generators project had some good examples.

Laurent Goubet
Obeo

Report message to a moderator

Previous Topic:	Cross table
Next Topic:	acceleo expression

Goto Forum:

-=] Back to Top [=-

[ Syndicate this forum (XML) ] [

]

Current Time: Tue Apr 23 07:07:54 GMT 2024

.:: Contact :: Home ::.

Breadcrumbs

Sign up to our Newsletter