Commanding the editor
When you are coding in MPS you will notice there are some differences between how you normally type code in text editors and how code is edited in MPS. In MPS you manipulate the AST directly as you type your code through the projectional editor. The editor gives you an illusion of editing text, which, however, has its limits. So you are slightly limited in where you can place your cursor and what you can type on that position. As we believe, projectional editor brings huge benefits in many areas. It requires some getting used to, but once you learn a few tricks you'll leave your plain-text-editor colleagues far behind in productivity and code quality. In general, only the items suggested by a completion menu can be entered. MPS can always decide, which elements are allowed and which are disallowed at a certain position. Once the code you type is in the red color you know you're off the track.
Code completion Ctrl+Space will be your good friend allowing you to quickly complete the statements you typed. This is the default way to enter new things.
It is positioned with the current text cell and can be filtered further by typing ahead. Remember that CamelHumps are supported, so you only need to type the capital characters of long names and MPS will guess the rest for you.
The completion menu contains from 1 up to hundreds of items, sorted by groups. Defining hierarchical menus for it will be flattened so the leaves of them will be listed as well as menu titles.
Open it with Ctrl+Space. Type to filter. Select an item with arrow keys, or clicking it. Finish with Tab, Enter, or double-click. Abort with Escape, clicking outside the menu, or changing to another application (for example Alt). To reduce the filtering, press left arrow; to jump to the beginning to remove all filtering press Ctrl+Space for a second time.
Frequently you can enhance or alter your code by means of predefined semi-automated procedures called Intentions. By pressing Alt+Enter MPS will show you a popup dialog with options applicable to your code at the current position. Some intentions are only applicable to a selected code region, for example, to wrap code inside a try-catch block. These are called Surround With intentions and once you select the desired block of code, press Ctrl+Alt+T to show the list of applicable intentions.
Whenever you need to see the definition of an element you are looking at, press Ctrl+B or Ctrl + mouse click to open up the element definition in the editor. To quickly navigate around editable positions on the screen use Shift+Tab. Enter will typically insert a new element right after your current position and let you immediately edit it. The Insert key will do the same for a position right before your current position.
When a piece of code is underlined in either red or yellow, indicating an error or a warning respectively, you can display a popup with the error message by hovering your mouse over the error or by pressing Ctrl+F1.
Control/Cmd + Up/Down key combination allows you to increase/decrease block selection. It ensures you always select valid subtrees of the AST. The usual Shift + Arrow keys way of text-like selection is also possible.
To quickly find out the type of an element, press Alt/Control + X will open the selected element in the Node Explorer allowing you to investigate the appropriate part of the AST. Alt+F7 will enable you to search for usages of a selected element. To quickly visualize the inheritance hierarchy of an element, use Ctrl+H.
The Inspector window opens after you press Alt+2. Some code and properties (for example editor styles, macros and so on) are shown and edited inside the Inspector window so it is advisable to keep the window ready.
BaseLanguage postfix transformations
Postfix code transformations let you conveniently modify code with predefined keywords typed right behind the code that you have just typed. For example, the "if" postfix applied to an expression wraps it with an if statement. BaseLanguage provides several postfix code transformations:
if - wraps a boolean expression with an IfStatement, the expression becomes its condition.
while - wraps a boolean expression with a WhileStatement, the expression becomes its condition.
cast - wraps an expression with a CastExpression.
paren - wraps an expression with parentheses.
var - turns an expression into a variable declaration initialized with that expression.
return - wraps an expression with a ReturnStatement.
not - wraps a boolean expression with a NotExpresssion.
for - wraps a collection-typed expression with a ForeachStatement that iterates over the values provided by the expression.
Most useful key shortcuts
Go To Definition
Move to the next cell
Move to the previous cell
Expand/Shrink the code selection
Shift + Arrow keys
Run the current configuration
Show the type of the expression under caret
Open the expression under caret at the Node Explorer to inspect the appropriate node and its AST surroundings
Show the structure (inheritance hierarchy)
A generic contextual New command - will typically popup a menu with elements that can be created at the given location
Comment/uncomment the current node
Comment/uncomment with block comment (available in BaseLanguage only)
Cut current line or selected block to buffer
Copy current line or selected block to buffer
Paste from buffer
Paste from history (displays a popup dialog that lists all previously copied code blocks)
Duplicate current line or selected block
Refer to the Default Keymap Reference page for a complete listing of MPS keyboard shortcuts (Also available from the MPS Help menu).