X-Git-Url: https://scm.cri.ensmp.fr/git/Faustine.git/blobdiff_plain/c7f552fd8888da2f0d8cfb228fe0f28d3df3a12c..b4b6f2ea75b9f0f3ca918f5b84016610bf7a4d4f:/interpretor/preprocessor/faust-0.9.47mr3/documentation/faust-quick-reference-src/chapters/installation.tex

diff --git a/interpretor/preprocessor/faust-0.9.47mr3/documentation/faust-quick-reference-src/chapters/installation.tex b/interpretor/preprocessor/faust-0.9.47mr3/documentation/faust-quick-reference-src/chapters/installation.tex
new file mode 100644
index 0000000..dd5f290
--- /dev/null
+++ b/interpretor/preprocessor/faust-0.9.47mr3/documentation/faust-quick-reference-src/chapters/installation.tex
@@ -0,0 +1,70 @@
+\chapter{Compiling and installing \faust}
+
+The \faust source distribution \lstinline'faust-0.9.46.tar.gz' can be downloaded from sourceforge (\myurl{http://sourceforge.net/projects/faudiostream/}).
+
+\section{Organization of the distribution}
+The first thing is to decompress the downloaded archive. 
+\begin{lstlisting}
+	tar xzf faust-0.9.46.tar.gz
+\end{lstlisting}
+
+The resulting  \lstinline'faust-0.9.46/' folder should contain the following elements:
+
+\begin{tabular}{ll}
+	\lstinline'architecture/' 		&\faust libraries and architecture files\\
+	\lstinline'benchmark'			&tools to measure the efficiency of the generated code\\
+	\lstinline'compiler/'			&sources of the \faust compiler\\
+	\lstinline'examples/'			&examples of \faust programs\\
+	\lstinline'syntax-highlighting/'&	support for syntax highlighting for several editors\\
+	\lstinline'documentation/' 		&\faust's documentation, including this manual\\
+	\lstinline'tools/'				&tools to produce audio applications and plugins\\
+	\lstinline'COPYING'				&license information\\
+	\lstinline'Makefile'			&Makefile used to build and install \faust\\
+	\lstinline'README'				&instructions on how to build and install \faust
+\end{tabular}
+
+\section{Compilation}
+\faust has no dependencies outside standard libraries. Therefore the compilation should be straightforward. There is no configuration phase, to compile the \faust compiler simply do :
+\begin{lstlisting}
+	cd faust-0.9.46/
+	make
+\end{lstlisting}
+
+If the compilation was successful you can test the compiler before installing it:
+\begin{lstlisting}
+	[cd faust-0.9.46/]
+	./compiler/faust -v
+\end{lstlisting}
+It should output:
+\begin{lstlisting}
+	FAUST, DSP to C++ compiler, Version 0.9.46
+	Copyright (C) 2002-2012, GRAME - Centre... 
+\end{lstlisting}
+
+Then you can also try to compile one of the examples :
+\begin{lstlisting}
+	[cd faust-0.9.46/]
+	./compiler/faust examples/noise.dsp
+\end{lstlisting}
+It should produce some C++ code on the standard output
+
+\section{Installation}
+You can install \faust with:
+\begin{lstlisting}
+	[cd faust-0.9.46/]
+	sudo make install
+\end{lstlisting}
+or
+\begin{lstlisting}
+	[cd faust-0.9.46/]
+	su
+	make install
+\end{lstlisting}
+depending on your system.
+
+
+\section{Compilation of the examples}
+Once \faust correctly installed, you can have a look at the provided examples in the \lstinline'examples/' folder. This folder contains a  \lstinline'Makefile' with all the required instructions to build these examples for various \textit{architectures}\marginpar{An architecture file provides the code needed to connect a signal processor to the outside world. It typically defines the audio communications and user interface.}, either standalone audio applications or plugins.
+
+The command \lstinline'make help' will list the available targets. Before using a specific target, make sure you have the appropriate development tools, libraries and headers installed. For example to compile the examples as ALSA applications with a GTK user interface do a \lstinline'make alsagtk'. This will create a \lstinline'alsagtkdir/' subfolder with all the binaries. 
+