Bug 478830 - Xtext documentation for Maven-integration is missing important details.
Summary: Xtext documentation for Maven-integration is missing important details.
Status: NEW
Alias: None
Product: TMF
Classification: Modeling
Component: Website (show other bugs)
Version: unspecified   Edit
Hardware: All All
: P3 major (vote)
Target Milestone: ---   Edit
Assignee: Project Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-10-01 12:22 EDT by Alexander Nyßen CLA
Modified: 2015-12-09 05:43 EST (History)
5 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 Alexander Nyßen CLA 2015-10-01 12:22:51 EDT 
The Xtext documentation section about 'Building an Xtext language with Maven and Tycho' is missing important information. In detail, the section about 'The core language project (my.mavenized.herolanguage)' should depict that the mwe2 workflow needs an additional adjustment:

// generates Java API for the generated EPackages
fragment = ecore.EMFGeneratorFragment auto-inject {
  javaModelDirectory = "/${projectName}/src-gen"
}

Without the javaModelDirectory entry, the mwe workflow fails with IOException of kind 'The path 'xxx/xxx.java' is unmapped'. Pleased adjust the documentation accordingly.
Comment 1 Stefan Oehme CLA 2015-10-01 12:28:49 EDT 
Since Xtext 2.9 will come with a Wizard that automatically generates Maven and Gradle builds, maybe we should remove that documentation?
Comment 2 Alexander Nyßen CLA 2015-10-01 13:17:07 EDT 
Well, while its not released, the documentation is definitely needed. And it would be good to have it concise.
Comment 3 Dennis Huebner CLA 2015-10-02 01:48:25 EDT 
I think it's good to have online documentation anyway.
Comment 4 Sebastian Zarnekow CLA 2015-10-02 14:55:32 EDT 
(In reply to Dennis Huebner from comment #3)
> I think it's good to have online documentation anyway.

I totally second that.