Event-B XText Front-end User Guide - Revision history

imported>Son at 23:27, 21 July 2017

2017-07-21T23:27:29Z

← Older revision		Revision as of 23:27, 21 July 2017
Line 1:		Line 1:
			'''IMPORTANT''': Event-B XText Front-end is now developed into [[XEvent-B\| ''extended Event-B (XEvent-B)'']].

	The complete Event-B XText Front-end User Guide is available as pdf [https://sourceforge.net/projects/rodin-b-sharp/files/Plugin_EventBXText/0.0.5/EventBXTextUserManual_v0.0.1.pdf/download here]. Some important information is listed below.		The complete Event-B XText Front-end User Guide is available as pdf [https://sourceforge.net/projects/rodin-b-sharp/files/Plugin_EventBXText/0.0.5/EventBXTextUserManual_v0.0.1.pdf/download here]. Some important information is listed below.

imported>Son at 19:16, 28 January 2017

2017-01-28T19:16:40Z

Show changes

imported>Son: /* XContext */

2016-11-23T07:10:28Z

XContext

← Older revision		Revision as of 07:10, 23 November 2016
Line 32:		Line 32:
	=== XContext ===		=== XContext ===
	* Any file with extension ''*.bucx'' will be recognised as XContext file. As a result, XContext file can be created by the standard ''New File'' wizard of Eclipse.		* Any file with extension ''*.bucx'' will be recognised as XContext file. As a result, XContext file can be created by the standard ''New File'' wizard of Eclipse.
	* The XText syntax of XContext file is as follows.		* The XText syntax of XContext file (v0.0.3) is as follows.
	XContext returns econtext::Context:		XContext returns econtext::Context:
	{econtext::Context}		{econtext::Context}

imported>Son: /* IMPORTANT */

2016-11-23T07:08:36Z

IMPORTANT

← Older revision		Revision as of 07:08, 23 November 2016
Line 18:		Line 18:
	* Since the XContexts and XMachines are compiled to the Rodin files, the corresponding Rodin contexts and machines will be '''OVER-WRITTEN'''. Any changes in the Rodin files will not be lost.		* Since the XContexts and XMachines are compiled to the Rodin files, the corresponding Rodin contexts and machines will be '''OVER-WRITTEN'''. Any changes in the Rodin files will not be lost.
	* '''DO NOT USE''' the Event-B XText Front-end if you use modelling plug-ins such as iUML-B state-machines and class-diagrams, as the additional modelling elements will be over-written.		* '''DO NOT USE''' the Event-B XText Front-end if you use modelling plug-ins such as iUML-B state-machines and class-diagrams, as the additional modelling elements will be over-written.

			=== KNOWN ISSUES ===
			- Converting to XText: Currently, the "extended" attribute of events are not serialised.

	== Configuration ==		== Configuration ==

imported>Son: /* XMachine */

2016-11-04T18:01:51Z

XMachine

← Older revision		Revision as of 18:01, 4 November 2016
Line 160:		Line 160:
	name=XLABEL action=STRING		name=XLABEL action=STRING
	;		;

			=== Type Setting Event-B Symbols ===
			The Event-B Symbols are supported via Content assist, e.g., when type setting invariant or action. Sometime, a preceding blank space is required to enable the correct content assist.

	== Converting Rodin files to Event-B XText ==		== Converting Rodin files to Event-B XText ==
	Rodin contexts and machines can be converted to XContext and XMachine files using context menu. From the ''Event-B Explorer'', right click on a Rodin project, a Rodin context, or a Rodin machine will offer option ''Convert to XText''. When a Rodin project is selected, all Rodin contexts and machines within that project will be converted.		Rodin contexts and machines can be converted to XContext and XMachine files using context menu. From the ''Event-B Explorer'', right click on a Rodin project, a Rodin context, or a Rodin machine will offer option ''Convert to XText''. When a Rodin project is selected, all Rodin contexts and machines within that project will be converted.

imported>Son: /* Converting Rodin files to Event-B XText */

2016-11-04T17:55:55Z

Converting Rodin files to Event-B XText

← Older revision		Revision as of 17:55, 4 November 2016
Line 162:		Line 162:

	== Converting Rodin files to Event-B XText ==		== Converting Rodin files to Event-B XText ==
			Rodin contexts and machines can be converted to XContext and XMachine files using context menu. From the ''Event-B Explorer'', right click on a Rodin project, a Rodin context, or a Rodin machine will offer option ''Convert to XText''. When a Rodin project is selected, all Rodin contexts and machines within that project will be converted.

imported>Son: /* XMachine */

2016-11-04T17:54:20Z

XMachine

← Older revision		Revision as of 17:54, 4 November 2016
Line 64:		Line 64:

	=== XMachine ===		=== XMachine ===
			* Any file with extension ''*.bumx'' will be recognised as XMachine file. As a result, XMachine file can be created by the standard ''New File'' wizard of Eclipse.
			* The XText syntax of XMachine file is as follows.
			XMachine returns emachine::Machine:
			{emachine::Machine}
			(comment=(ML_COMMENT\|SL_COMMENT))?
			'machine' name=ID
			('refines' refines+=[emachine::Machine])?
			('sees' sees+=[econtext::Context]+)?
			('variables' variables+=XVariable+)?
			('invariants' invariants+=XInvariant+)?
			('variant' variant=XVariant)?
			('events' events+=XEvent (';' events+=XEvent)*)?
			('end')
			;

			XVariable returns emachine::Variable:
			{emachine::Variable}
			(comment=(ML_COMMENT\|SL_COMMENT))?
			name=ID
			;

			XInvariant returns emachine::Invariant:
			{emachine::Invariant}
			(comment=(ML_COMMENT\|SL_COMMENT))?
			name=XLABEL predicate=STRING (theorem?='theorem')?
			;

			terminal XLABEL returns ecore::EString:
			'@' !(':')+ ':'
			;

			XVariant returns emachine::Variant:
			{emachine::Variant}
			(comment=(ML_COMMENT\|SL_COMMENT))?
			expression=STRING
			;

			XEvent returns emachine::Event:
			{emachine::Event}
			(comment=(ML_COMMENT\|SL_COMMENT))?
			name=ID
			(
			(extended?='extended')? &
			(convergence=XConvergence)?
			)
			('refines' refines+=[emachine::Event]+)?
			(
			('with' witnesses+=XWitness+)?
			'begin'
			actions+=XAction+
			'end'
			\|
			'when'
			guards+=XGuard+
			('with' witnesses+=XWitness+)?
			('then'
			actions+=XAction+)?
			'end'
			\|
			'any'
			parameters+=XParameter+
			'where'
			guards+=XGuard+
			('with' witnesses+=XWitness+)?
			('then'
			actions+=XAction+)?
			'end'
			)?
			;

			enum XConvergence returns emachine::Convergence:
			ordinary = 'ordinary' \| convergent = 'convergent' \| anticipated = 'anticipated';

			XParameter returns emachine::Parameter:
			{emachine::Parameter}
			(comment=(ML_COMMENT\|SL_COMMENT))?
			name=ID
			;

			XGuard returns emachine::Guard:
			{emachine::Guard}
			(comment=(ML_COMMENT\|SL_COMMENT))?
			name=XLABEL predicate=STRING (theorem?='theorem')?
			;

			XWitness returns emachine::Witness:
			{emachine::Witness}
			(comment=(ML_COMMENT\|SL_COMMENT))?
			name=XLABEL predicate=STRING
			;

			XAction returns emachine::Action:
			{emachine::Action}
			(comment=(ML_COMMENT\|SL_COMMENT))?
			name=XLABEL action=STRING
			;

	== Converting Rodin files to Event-B XText ==		== Converting Rodin files to Event-B XText ==

imported>Son: /* XContext */

2016-11-04T17:49:33Z

XContext

← Older revision		Revision as of 17:49, 4 November 2016
Line 28:		Line 28:

	=== XContext ===		=== XContext ===
	* Any file with extension ''bucx'' will be recognised as XContext file. As a result, XContext file can be created by the standard ''New File'' wizard of Eclipse.		* Any file with extension ''*.bucx'' will be recognised as XContext file. As a result, XContext file can be created by the standard ''New File'' wizard of Eclipse.
	* The XText syntax of XContext file is as follows.		* The XText syntax of XContext file is as follows.
	XContext returns econtext::Context:		XContext returns econtext::Context:

imported>Son: /* XContext */

2016-11-04T17:46:44Z

XContext

← Older revision		Revision as of 17:46, 4 November 2016
Line 52:		Line 52:
	name=ID		name=ID
	;		;

	XAxiom returns econtext::Axiom:		XAxiom returns econtext::Axiom:
	{econtext::Axiom}		{econtext::Axiom}
Line 58:		Line 58:
	name=XLABEL predicate=STRING (theorem?='theorem')?		name=XLABEL predicate=STRING (theorem?='theorem')?
	;		;

	terminal XLABEL returns ecore::EString:		terminal XLABEL returns ecore::EString:
	'@' !(':')+ ':'		'@' !(':')+ ':'

imported>Son: /* Editing */

2016-11-04T17:46:30Z

Editing

@@ Line 18: / Line 18: @@
 * Since the XContexts and XMachines are compiled to the Rodin files, the corresponding Rodin contexts and machines will be '''OVER-WRITTEN'''. Any changes in the Rodin files will not be lost.
 * '''DO NOT USE''' the Event-B XText Front-end if you use modelling plug-ins such as iUML-B state-machines and class-diagrams, as the additional modelling elements will be over-written.
 == Editing ==
 === XContext ===
 === XMachine ===
 == Converting Rodin files to Event-B XText ==