+\item \texttt{help <package name>} does not display the adaptors of the package. To see them use: \texttt{help <package name> all}
+including adaptors.
+\end{itemize}
+\hrule
+% ==========================================
+
+% ==========================================
+\subsection{Writing scripts files}
+\label{bbi-writing-scripts}
+% ==========================================
+
+Now that you know how to connect the existing black boxes, you will soon realize that you want to save and reuse some sequences of commands that you are particularly glad of. In the following subsections you will learn how to write ``simple'' pipeline applications and new complex black boxes built of existing black boxes.
+
+% ==========================================
+\subsubsection{Stand-alone pipeline applications}
+\label{sec:pipeline-appli}
+% ==========================================
+
+Let us take an example similar to that from section \ref{bbi-connecting-black-boxes}:
+
+\begin{verbatim}
+> include vtk
+> include wx
+> include itk
+> include wxvtk
+> include itkvtk
+
+> new DirectorySelector dirSelect
+> new DICOMDirReader reader
+> new Slider slider
+> new Viewer2D viewer
+
+> connect dirSelect.Out reader.In
+> connect reader.Out viewer.In
+> connect slider.Out viewer.Slice
+> connect slider.BoxChange viewer.BoxExecute
+> set slider.ReactiveOnTrack 1
+
+> exec viewer
+\end{verbatim}
+
+This is an elementary DICOM-image slicer (fig.~\ref{fig:simpleslicer}) designed to view 3D medical images slice-by-slice. The image is to be composed of a series of DICOM files contained in a separate directory. The index of the slice to be displayed is selected by means of a slider. The command \texttt{connect slider.BoxChange viewer.BoxExecute} permits the Viewer to update the display every time the output of the Slider changes. The command \texttt{set slider.ReactiveOnTrack 1} on its turn makes that the output of the Slider changes every time its cursor is moved, while the default behavior is to change only when the mouse-button is released after moving the cursor.\\
+
+\begin{figure}[!ht]
+\caption{ Graph of a (very) simple 3D slicer}
+\begin{center}
+\includegraphics[width=0.8\textwidth]{bbi-simplegraph.png}
+\end{center}
+\label{fig:simpleslicer}
+\end{figure}
+
+Despite its simplicity, this application may already be useful. If you want to reuse it, you have to save the \bbs commands in a text file. The conventional (and mandatory) extension for such script files is \texttt{bbs}
+(black box script). For example, our elementary 3D DICOM-image slicer
+can be defined in the following file:
+
+\begin{file}{my\_slicer.bbs}
+\begin{verbatim}
+# my_slicer.bbs: elementary 3D image slicer"
+/*
+ the 3D image has to be stored in a separate directory
+ as a series of DICOM files representing the 2D slices
+*/
+
+include vtk
+include wx
+include itk
+include wxvtk
+include itkvtk
+
+new DirectorySelector dirSelect
+new DICOMDirReader reader
+new Slider slider
+new Viewer2D viewer
+
+connect dirSelect.Out reader.In
+connect reader.Out viewer.In
+connect slider.Out viewer.Slice
+connect slider.BoxChange viewer.BoxExecute
+set slider.ReactiveOnTrack 1
+
+exec viewer
+\end{verbatim}
+\end{file}
+
+Lines starting with a \texttt{\#} character or with double slash (\texttt{\//\//}) are ignored, they
+are considered as comments by the interpreter. A longer comment can be placed between the marks \texttt{\//*} and \texttt{*\//}. Each of this mark is to be placed alone in a separate line, like in the example.\par
+
+To use this file in \bbStudions, click on the \texttt{include} button, and browse your filestore to find the file. You can also type the command:
+
+\begin{verbatim}
+> include my_slicer.bbs
+\end{verbatim}
+
+provided that \bbStudio knows the path to the desired \texttt{bbs} file.
+See the section \ref{The_configuration_file} to learn about the configuration file and the way to add a new path to it. Note that, if you modify the configuration file, you will have to close \bbStudio and run it again, so that the new configuration be taken into account.
+
+Actually, since the file has the \texttt{bbs} extension, you can omit it and just type:
+\begin{verbatim}
+> include my_slicer
+\end{verbatim}
+
+% ==========================================
+\hrule
+
+\paragraph{Summary}
+%\hrule
+\begin{itemize}
+\item The \texttt{include} command tells the interpreter to include a script file.
+\item Lines starting with \texttt{\#} or \texttt{\//\//} are considered as comments by the interpreter.
+\item A longer comment can be written between two empty lines only containing \texttt{\//*} and \texttt{*\//} respectively.