1 Introduction

1.1 Welcome

Welcome to the Logix Tutorial! You’ve arrived a little early – the current alpha version of Logix is still a little rough around the edges. You should interpret what you discover here as a flavor of what is to come, rather than the definitive guide to Logix.

One implication of this is that Logix is going to be changing in incompatible ways. If you start writing Logix code, you can expect to be making changes before it will work with future Logix releases. For an idea of aspects of Logix that are likely to be changing, have a look at http://logix.livelogix.com/future-work.html.

Have fun!

1.2 Status and Warnings

Logix is currently in use on a daily basis. It is nevertheless definitely alpha quality.

1.2.1 Error Messages

By far the biggest issue for users will be error reporting. While some error reporting is already quite helpful, some is lacking.

You are likely at some point to find an error in your code reported not with a nice tidy message, but with a stack-trace into the parser. You then have two options.

The second option is clearly going to require some understanding of the internals of the parser. Plus there’s always the possibility that your code is correct and you’ve discovered a bug in the parser :-)

1.3 Examples in this Tutorial

The examples in this tutorial are intended to be tried at the Logix prompt. You are strongly encouraged to go through the tutorial at the computer, and try the examples as they come up.

One thing to bear in mind – the layout in this tutorial doesn’t allow for very long lines in the examples. It will generally be best to enter the examples on a single line, even if they span multiple lines in the tutorial. If, at the Logix prompt, you enter a line that ends in a colon, the prompt will allow you to enter continuation lines until you enter a blank line.