search

eclipse-ocl / org.eclipse.ocl

Eclipse Public License 2.0
0 stars 0 forks source link

[oomph] Set up documentation build pre-requisites #1531

Open eclipse-ocl-bot opened 1 week ago

eclipse-ocl-bot commented 1 week ago

| --- | --- | | Bugzilla Link | 468622 | | Status | NEW | | Importance | P3 normal | | Reported | May 28, 2015 09:10 EDT | | Modified | Aug 06, 2015 13:43 EDT | | Reporter | Ed Willink |

Description

The documentation support requires

Mylyn Wikitext from SimRel\ Xalan-Java from Orbit - org.apache.xalan\ Xerces-J from Orbit - org.apache.xml.serializer

eclipse-ocl-bot commented 1 week ago

By Adolfo Sanchez-Barbudo Herrera on Aug 06, 2015 11:49

Hi Ed,

I'm afraid I'm not familiar with doc activity.

By running

Indeed the build fails due to a missing xalan class.

However, could you please provide additional repros/use cases (if there is any) to realize why you say that you need for instance Mylyn Wikitext ? Actually,\ "org.eclipse.mylyn.wikitext_feature" is supposed to be installed in the IDE when oomphing OCL projects.

I'm assuming that the required additions will be part of the OCL/Development setup project, rather than the OCL/Releng one. Right ?

Regards,\ Adolfo.

eclipse-ocl-bot commented 1 week ago

By Ed Willink on Aug 06, 2015 13:43

At one time documentation used to be built by Hudson, but that was very fragile.

Now it is a manual activity (just the same as building *.ecore's).

The "OCL Documentation" external tools launch does the hard work, with perhaps 80% success rate. Failures occur if the external tool downloads get an Internet failure/inadequacy.

Mylyn Wikitext is needed to edit the *.textile files.

The OCL Documentation launch uses:

Xalan-Java from Orbit - org.apache.xalan\ Xerces-J from Orbit - org.apache.xml.serializer

Perhaps Wikitext should be an OCL/Development element and Xalan-Java/Xerces-J OCL/Releng elements.