Home » Modeling » TMF (Xtext) » building xtext documentation
|
| Re: building xtext documentation [message #653551 is a reply to message #653406] |
Thu, 10 February 2011 08:31   |
 Jan Koehnlein
Messages: 760
Registered: July 2009
Location: Hamburg |
Senior Member |
|
|
As far as I remember you have to use a real Java 5 SDK to run the
generator. Note that the documentation generation is a bad hack, i.e. it
downloads some framework jars on execution and puts them somewhere in
your file system. We don't actively support this anymore.
For Xtext 2.0, we have switched to Xdoc, our own Xtext-based
documentation generator. This is far easier to use, offers better tool
support and tighter integration into eclipse. And, last but not least,
it is actively maintained ;-) Have a look at
https://github.com/RvonMassow/xDoc
Am 09.02.11 17:17, schrieb Lorenzo Bettini:
> Hi
>
> since I'd like to write my documentation in textile as well, I'm taking
> a look at the org.xtext.doc source, and I'm trying to run customBuild.xml
>
> that ant file tries to download some stuff... first of all, it looks
> like the url
> http://mirrorspace.org/apache/xmlgraphics/fop/binaries/fop-0 .95-bin.zip
> does not work (and I replaced that with
> http://archive.apache.org/dist/xmlgraphics/fop/binaries/fop- 0.95-bin.zip
>
> after the script finished downloading stuff, the build fails with this
> error:
>
> org.eclipse.xtext/plugins/org.eclipse.xtext.doc/customBuild. xml:127: The
> following error occurred while executing this line:
> org.eclipse.xtext/plugins/org.eclipse.xtext.doc/customBuild. xml:210:
> java.lang.ClassNotFoundException:
> org.apache.xalan.processor.TransformerFactoryImpl
>
> any clue please?
>
> thanks in advance
> Lorenzo
>
--
Need professional support for Eclipse Modeling?
Go visit: http://xtext.itemis.com
---
Get professional support from the Xtext committers at www.typefox.io
|
|
|
| Re: building xtext documentation [message #653789 is a reply to message #653551] |
Fri, 11 February 2011 08:46 |
|
On 02/10/2011 09:31 AM, Jan Koehnlein wrote:
> As far as I remember you have to use a real Java 5 SDK to run the
> generator. Note that the documentation generation is a bad hack, i.e. it
> downloads some framework jars on execution and puts them somewhere in
> your file system. We don't actively support this anymore.
>
> For Xtext 2.0, we have switched to Xdoc, our own Xtext-based
> documentation generator. This is far easier to use, offers better tool
> support and tighter integration into eclipse. And, last but not least,
> it is actively maintained ;-) Have a look at
> https://github.com/RvonMassow/xDoc
>
uh looks cool! :)
and I don't have to switch to xtext 2.0 to use that, right?
but, from what I understand, it's another wiki-like language, different
from textile, right?
thanks
Lorenzo
>
> Am 09.02.11 17:17, schrieb Lorenzo Bettini:
>> Hi
>>
>> since I'd like to write my documentation in textile as well, I'm taking
>> a look at the org.xtext.doc source, and I'm trying to run customBuild.xml
>>
>> that ant file tries to download some stuff... first of all, it looks
>> like the url
>> http://mirrorspace.org/apache/xmlgraphics/fop/binaries/fop-0 .95-bin.zip
>> does not work (and I replaced that with
>> http://archive.apache.org/dist/xmlgraphics/fop/binaries/fop- 0.95-bin.zip
>>
>> after the script finished downloading stuff, the build fails with this
>> error:
>>
>> org.eclipse.xtext/plugins/org.eclipse.xtext.doc/customBuild. xml:127: The
>> following error occurred while executing this line:
>> org.eclipse.xtext/plugins/org.eclipse.xtext.doc/customBuild. xml:210:
>> java.lang.ClassNotFoundException:
>> org.apache.xalan.processor.TransformerFactoryImpl
>>
>> any clue please?
>>
>> thanks in advance
>> Lorenzo
>>
>
>
--
Lorenzo Bettini, PhD in Computer Science, DI, Univ. Torino
ICQ# lbetto, 16080134 (GNU/Linux User # 158233)
HOME: http://www.lorenzobettini.it MUSIC: http://www.purplesucker.com
http://www.myspace.com/supertrouperabba
BLOGS: http://tronprog.blogspot.com http://longlivemusic.blogspot.com
http://www.gnu.org/software/src-highlite
http://www.gnu.org/software/gengetopt
http://www.gnu.org/software/gengen http://doublecpp.sourceforge.net
HOME: http://www.lorenzobettini.it
TDD Book: https://leanpub.com/tdd-buildautomation-ci
Xtext Book: https://www.packtpub.com/application-development/implementing-domain-specific-languages-xtext-and-xtend-second-edition
|
|
|
| Re: building xtext documentation [message #654120 is a reply to message #653789] |
Mon, 14 February 2011 09:19 |
Jan Koehnlein
Messages: 760
Registered: July 2009
Location: Hamburg |
Senior Member |
|
|
Yes, it's another language with specific syntax for documenting Java
code. But we are developing it on Xtext 2.0. It should always be
compatible with the HEAD.
Am 11.02.11 09:46, schrieb Lorenzo Bettini:
> On 02/10/2011 09:31 AM, Jan Koehnlein wrote:
>> As far as I remember you have to use a real Java 5 SDK to run the
>> generator. Note that the documentation generation is a bad hack, i.e. it
>> downloads some framework jars on execution and puts them somewhere in
>> your file system. We don't actively support this anymore.
>>
>> For Xtext 2.0, we have switched to Xdoc, our own Xtext-based
>> documentation generator. This is far easier to use, offers better tool
>> support and tighter integration into eclipse. And, last but not least,
>> it is actively maintained ;-) Have a look at
>> https://github.com/RvonMassow/xDoc
>>
>
> uh looks cool! :)
>
> and I don't have to switch to xtext 2.0 to use that, right?
>
> but, from what I understand, it's another wiki-like language, different
> from textile, right?
>
> thanks
> Lorenzo
>
>>
>> Am 09.02.11 17:17, schrieb Lorenzo Bettini:
>>> Hi
>>>
>>> since I'd like to write my documentation in textile as well, I'm taking
>>> a look at the org.xtext.doc source, and I'm trying to run
>>> customBuild.xml
>>>
>>> that ant file tries to download some stuff... first of all, it looks
>>> like the url
>>> http://mirrorspace.org/apache/xmlgraphics/fop/binaries/fop-0 .95-bin.zip
>>> does not work (and I replaced that with
>>> http://archive.apache.org/dist/xmlgraphics/fop/binaries/fop- 0.95-bin.zip
>>>
>>> after the script finished downloading stuff, the build fails with this
>>> error:
>>>
>>> org.eclipse.xtext/plugins/org.eclipse.xtext.doc/customBuild. xml:127: The
>>> following error occurred while executing this line:
>>> org.eclipse.xtext/plugins/org.eclipse.xtext.doc/customBuild. xml:210:
>>> java.lang.ClassNotFoundException:
>>> org.apache.xalan.processor.TransformerFactoryImpl
>>>
>>> any clue please?
>>>
>>> thanks in advance
>>> Lorenzo
>>>
>>
>>
>
>
--
Need professional support for Eclipse Modeling?
Go visit: http://xtext.itemis.com
---
Get professional support from the Xtext committers at www.typefox.io
|
|
|
Goto Forum:
Current Time: Fri Apr 26 10:32:43 GMT 2024
Powered by FUDForum. Page generated in 0.02758 seconds |
] 
Search
Help
Register
Login
Home
