Unclear capabilities of MelangeResource

[dvojtise]

Neither the documentation nor the API makes clear about which adaptations are legal or possible (or not implemented yet)

We need a clear table of what is supposed to work or not in its "conversion" versus "adaptation" capabilities. (not sure conversion/ adaptation is the best wording)

for example: I don't know if this is possible (using resource URI and/or directly in the API):

package fsmadaptation
language FSM {
	syntax "platform:/resource/org.eclipse.gemoc.sample.fsmmodeladaptation.fsm.model/model/fsm.ecore"
}
language XSFSM inherits FSM {
	with fsmadaptation.fsm.k3dsa.*
}

using the URI syntax:
Is this possible ?

• melange:/file/model/myfsm.fsm?lang=fsmadaptation.FSM&mt=fsmadaptation.XSFSMMT
  (which is actually the same as: melange:/file/model/myfsm.fsm?mt=fsmadaptation.XSFSMMT, since the model is already an instance of FSM

all options to document:

• melange:/file/model/myfsm.fsm?lang=fsmadaptation.FSM (should work since it does nothing)

• melange:/file/model/myfsm.fsm?lang=fsmadaptation.FSM&mt=fsmadaptation.FSMMT

• melange:/file/model/myfsm.fsm?lang=fsmadaptation.FSM&mt=fsmadaptation.XSFSMMT

• melange:/file/model/myfsm.fsm?lang=fsmadaptation.XSFSM (this one works for sure, I use it in Gemoc)

• melange:/file/model/myfsm.fsm?lang=fsmadaptation.XSFSM&mt=fsmadaptation.FSMMT

• melange:/file/model/myfsm.fsm?lang=fsmadaptation.XSFSM&mt=fsmadaptation.XSFSMMT

• melange:/file/model/myxsfsm.xsfsm?lang=fsmadaptation.FSM

• melange:/file/model/myxsfsm.xsfsm?lang=fsmadaptation.FSM&mt=fsmadaptation.FSMMT

• melange:/file/model/myxsfsm.xsfsm?lang=fsmadaptation.FSM&mt=fsmadaptation.XSFSMMT

• melange:/file/model/myxsfsm.xsfsm?lang=fsmadaptation.XSFSM (should work since it does nothing)

• melange:/file/model/myxsfsm.xsfsm?lang=fsmadaptation.XSFSM&mt=fsmadaptation.FSMMT

• melange:/file/model/myxsfsm.xsfsm?lang=fsmadaptation.XSFSM&mt=fsmadaptation.XSFSMMT

This is related to #111 since the API (and its java doc) should also helps to know what is possible or not.