]> Creatis software - bbtk.git/blobdiff - kernel/doc/bbtkUsersGuide/bbtkReferenceManual.tex
doc updates
[bbtk.git] / kernel / doc / bbtkUsersGuide / bbtkReferenceManual.tex
index 196cd6a6fc25b5345a33d1905ca4a682d5e7f32b..56a71c500226f5dcb1a280ae2f164b6895d0f8ab 100644 (file)
@@ -14,7 +14,7 @@
 {\Huge Reference Manual}
 \vspace{1cm}
 
-\bbtk version 1.0
+\bbtk version \bbtkVersion
 \vspace{0.5cm}
 
 
@@ -46,6 +46,9 @@ Fantomas, Belphegor
 \begin{verbatim}
 ---> Should be moved in a 'Reference Manual' ?\\
 ---> Any suggestion welcome!
+
+--> The following is just the concatenation of various parts, removed from different 'manuals', and wainting for
+their new affectation.
 \end{verbatim}
 
 \section{aaa}
@@ -139,6 +142,148 @@ Package         & What it's used for \\ \hline
 
 
 
+% ==========================================
+\subsubsection{complex black box definition related commands}
+\label{bbi-reference-black-box-definition}
+% ==========================================
+
+See table \ref{bbi-reference-complex-box} 
+% ==========================================
+\begin{table}[!ht]
+\caption{\label{bbi-reference-complex-box} \bbi complex black box definition related commands.}
+\small
+\begin{tabular}{|lcm{6cm}|}
+\hline
+Command & Parameters & Effect \\ \hline
+
+
+\texttt{define} & \texttt{<box-type>} & 
+Starts the definition of a complex black box of type  
+\texttt{box-type}\\ \hline 
+
+\texttt{endefine} & - & 
+Ends the definition of a complex black box type\\ \hline 
+
+\texttt{author} & \texttt{<string>} & 
+Sets the author(s) of the complex black box currently being defined \\ \hline 
+
+\texttt{description} & \texttt{<string>} & 
+Sets the description of the complex black box currently being defined \\ \hline 
+
+\texttt{input} & \texttt{<name>} \texttt{<box.input>} \texttt{<help>} & 
+Defines a new input for the current complex black box, 
+named \texttt{name}. 
+It is defined as corresponding to 
+the input \texttt{input} of the box \texttt{box}.
+\texttt{<help>} is the help string for the new input.
+The box \texttt{box} must already have been created in the complex box 
+and of course have an input named \texttt{input}.\\ \hline 
+
+\texttt{output} & \texttt{<name>} \texttt{<box.output>} \texttt{<help>} & 
+Defines a new output for the current complex black box, 
+named \texttt{name}. 
+It is defined as corresponding to 
+the output \texttt{output} of the box \texttt{box}. 
+\texttt{<help>} is the help string for the new output.
+The box \texttt{box} must already have been created in the complex box and of course have an output named \texttt{output}. \\ \hline 
+
+
+\end{tabular}
+\end{table}
+
+% ==========================================
+\subsubsection{Interpreter related commands}
+\label{bbi-reference-interpreter}
+% ==========================================
+See table \ref{tabbbi-reference-interpreter_1} and \ref{tabbbi-reference-interpreter_2}
+% ==========================================
+\begin{table}[!ht]
+\caption{\label{tabbbi-reference-interpreter_1}\bbi intepreter related commands (part 1).}
+\small
+\begin{tabular}{|lcm{6cm}|}
+\hline
+Command & Parameters & Effect \\ \hline
+
+\texttt{author} &  \texttt{<author-name>} & 
+Adds the string \texttt{<author-name>} to the author information of the black box being defined \\ \hline 
+
+\texttt{category} & \texttt{<category-name>} & 
+  Adds the string \texttt{<category-name>} to the category information of the black box being defined \\ \hline 
+
+\texttt{help} & - & 
+Prints help on available commands \\ \hline 
+
+& \texttt{<command-name>} & 
+Prints help on the command \texttt{command-name} \\ \hline 
+
+& \texttt{packages} & 
+Prints help on available packages and their box types 
+(without description)\\ \hline 
+
+& \texttt{<package-name>} & 
+Prints help on the package \texttt{package-name} and its boxes 
+(with brief description). 
+The package must have been previously loaded \\ \hline 
+
+& \texttt{<box-type>} & 
+Prints help (with full description) on the type of box 
+\texttt{box-type}. 
+The box type must belong to a package which has been previously loaded \\ \hline 
+
+& \texttt{<debug-directive>} & 
+[expr|-C|-D] 
+  Prints debug info on living bbtk objects containing the string \texttt{expr} (default expr=''). 
+         \texttt{-C} checks the factory integrity.
+        \texttt{-D} turns on objects debug info after main ends\\ \hline 
+
+\texttt{include} & \texttt{<file-name>} & 
+Includes and executes the content of the file named \texttt{file-name} 
+exactly like if you were typing its content at the place were the 
+\texttt{include} command is. \\ \hline 
+
+\texttt{load} & \texttt{<package-name>} & 
+Loads the package \texttt{package-name} (use it only if you know that you won't work with complex black boxes) \\ \hline 
+
+\texttt{include} & \texttt{<package-name>} & 
+Loads the package \texttt{package-name} and includes all the complex black boxes that comes with it \\ \hline 
+
+\texttt{kind} & \texttt{<box kind>} & 
+Specifies the \texttt{kind} of the complex black boxes you are describing \\ \hline 
+\end{tabular}
+\end{table}
+
+
+
+%
+% This arbitrary part1/part2 is to avoid to have all the tables at the end of the docoment ...
+%
+
+\begin{table}[!ht]
+\caption{\label{tabbbi-reference-interpreter_2}\bbi intepreter related commands (part 2).}
+\small
+\begin{tabular}{|lcm{6cm}|}
+\hline
+Command & Parameters & Effect \\ \hline
+\texttt{unload} & \texttt{<package-name>}& 
+Unloads the package \texttt{package-name}. 
+The package must have been previously loaded. 
+No box of a type defined in this package must still exist.\\ \hline 
+
+\texttt{message} & \texttt{<category>} \texttt{<level>} & 
+Sets the level of verbosity of \bbi for the category of messages 
+\texttt{category} to \texttt{level}.\\ \hline 
+%See \ref{verbosity}.
+
+\texttt{config} & - & Displays the Configuration parameters\\ \hline 
+
+\texttt{reset} & - & Deletes all boxes and unloads all packages so 
+that \bbi gets back to its initial state \\ \hline 
+
+\texttt{quit} & - & Exits the interpreter (Don't use it under \bbStudions)\\ \hline 
+
+\end{tabular}
+\end{table}
 
 
 \subsection{ccc}