Bug 484856 - [AQL] Add syntax documentation
Summary: [AQL] Add syntax documentation
Status: RESOLVED FIXED
Alias: None
Product: Acceleo
Classification: Modeling
Component: Query Language (show other bugs)
Version: 3.1.0   Edit
Hardware: PC Windows NT
: P3 enhancement
Target Milestone: ---   Edit
Assignee: Yvan Lussaud CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-12-23 09:02 EST by Etienne Juliot CLA
Modified: 2016-02-18 12:20 EST (History)
3 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Etienne Juliot CLA 2015-12-23 09:02:40 EST 
There isn't a description of the AQL syntax and its keywords.

In the embedded help, in the section "Writing Queries and Interpreted Expressions" / "Using AQL", help says:
- "AQL is similar to Acceleo 3/MTL, but simpler " which is not enough to understand keywords (or you just add an hyperlink to the good section of MTL syntax documentation).
- "See the AQL documentation for more details about the language itself, ... " which go this page : https://www.eclipse.org/acceleo/documentation/aql.html . This page describes only services, not the syntax itself.

A dedicated section should be added to describe each keywords.
(on my own experience, I had some difficulties to find the good syntax for the "if / then / else / endif" statement as I tried with brackets or without else)
Comment 1 Yvan Lussaud CLA 2015-12-24 05:29:22 EST 
commit 8af3cf8d2375590c257d0704ca1a9f6c32ad094a
Author: Yvan Lussaud <yvan.lussaud@obeo.fr>
Date:   Thu Dec 24 11:27:12 2015 +0100

    Added AQL expression syntax
Comment 2 Yvan Lussaud CLA 2015-12-24 08:48:26 EST 
This commit is in this repository:
git.eclipse.org/gitroot/www.eclipse.org/acceleo.git