~presto-developers/presto/trunk

    \begin{abstract}

        Hello, dear programmer! In this document you will (hopefully) find all information regarding how to write

        your programs using using the Presto programming language. The Presto language is very different from

        conventional programming languages, and so will be this manual.

 

        In Presto you write music and this music represents an algorithm. Therefore this will be a document about

        how to write music\ldots nice, huh? We'll give you the basic guidelines of how the language \emph{works},

        i.e, it's fundamental constructs, and also give some tips of style of how to write some very common

        programming idioms.

    \end{abstract}

 

    \section*{Introduction, or ``What we wanted Presto to be''}

        So, what did we have in mind when designing a ``musical language''? A very short answer is: we wanted

        that the user be able to create \emph{beautiful} programs. Presto programs are not meant to be

        efficient, although some simple optimizations are performed; it's an esoteric language, to demonstrate

        the regular and algorithmic nature of music (and the musical nature of algorithms). This simple

        thought has guided our design in several ways:

        \begin{itemize}

            \item There are multiple ways of achieving the same computational task. We wanted to give the

                programmer (or rather, the \emph{composer}) as much freedom as possible. For instance, to

                build an arithmetic series the composer can use several tempos, several rhythmic patterns and

                various melodic patterns also.

            \item Whenever possible, algorithmic concepts are to be represented by their direct musical

                counterpart. For example, an ascending numerical sequence can be built using ascending

                melodies, and a quicker rhythm makes the sequence grow faster.

            \item Our \emph{machine model} should be as simple as possible: a small number of primitive

                operations would enable our goal to give more freedom to the composer, even though it might be

                \emph{more difficult} to write Presto programs. We've settled on a stack machine model, with

                one single stack and a very limited number of operations.

        \end{itemize}