-
Notifications
You must be signed in to change notification settings - Fork 95
SnlEditor
Purpose: Editor for the State Notation Language (SNL)
The State Notation Language is a superset of the C language, used for programming EPICS-based IOCs. The SNL perspective aids in editing through syntax highlighting, display of problems, code completion and outline-based navigation in the source code.(XXX macro: "BR")
A brief introduction for using the SNL Development perspective follows, inline)]
Open the SNL Development perspective. Press the button in the toolbar for selecting perspectives
/00_SNL_Open_Perspective.png(XXX macro: "BR")
click Other ... and chose the SNL perspective
/01_SNL_Select_Perspective.png(XXX macro: "BR")
If you already have worked with it, it may have a different layout. Reset it then, so your display has a layout similar to this one:(XXX macro: "BR")
Developer Perspective.png)](XXX macro: "BR")
Install the samples via CSS menu:(XXX macro: "BR")
Menu Install Sample Projects.png)](XXX macro: "BR")
Then you will find the SNL Demo Project in the Navigator View.
You may as well import your own source files. If you want to do so, first create an SNL Project with the help of its wizard(XXX macro: "BR")
Create Project.png)](XXX macro: "BR")
and import your files using the Import menu of the navigator(XXX macro: "BR")
Navigator Import.png)](XXX macro: "BR")
followed by the selection of the Import Wizard(XXX macro: "BR")
Navigator Import from File System.png)](XXX macro: "BR")
and eventually chosing your files and the newly created project as the destination.
Now double click a file containing source code from the navigator. The editor will open. Positoning of the cursor is now reflected in the outline. You may navigate using the outline as well.(XXX macro: "BR")
Editor And Outline With Selection.png)](XXX macro: "BR")
Code Completion (triggered by Ctrl-Space as usual) helps in editing:(XXX macro: "BR")
Editor Code Completion.png)](XXX macro: "BR")
Now let us have a look at the problem view. You may want to filter its output to stay focused:(XXX macro: "BR")
Problem View Filter.png)](XXX macro: "BR")
The problem view shows warnings or errors which can be determined through syntactical analysis. Update occurs after saving the source file. Double-clicking an entry in the problem view navigates to the location in the source file.(XXX macro: "BR")
Problem View Error.png)](XXX macro: "BR")
Even though you are not connected to a source code repository, a limited amount of version management is available. Each time you save a file it is stored in the local history maintained by CSS. This is by no means a replacement for backup nor for a repository, just a hint for working in CSS.(XXX macro: "BR")
Editor Show History.png)](XXX macro: "BR")
The History View will open, giving you access to previous versions. For example, select the versions you want to compare and start a comparison:(XXX macro: "BR")
Editor Select For Comparison.png)](XXX macro: "BR")
Now you can review your changes:(XXX macro: "BR")
Editor Differ.png)](XXX macro: "BR") The actual amount of source code which is stored in the local history is a matter of preferences.
Finally your source code will be ready to be compiled. However, this is currently not supported (for non-DESY versions).
Documentation for the State Notation Language is available from the Argonne National Laboratory at the EPICS Home http://www.aps.anl.gov/epics/