Skip to content
Snippets Groups Projects
Commit 94643712 authored by Andre Maroneze's avatar Andre Maroneze
Browse files

[Doc/Devman] Update ptests section in developer manual

parent ea221a25
No related branches found
No related tags found
No related merge requests found
......@@ -709,19 +709,6 @@ There is exactly one directive by line. The different directives (\emph{i.e.}
possibilities for \texttt{CONFIG\_OPTION}) are detailed in
Section~\ref{ptests:directives}.
\begin{important}
Note that some specific configurations require dynamic linking, which
is not available on all platforms for native code. {\tt ptests} takes
care of reverting to bytecode when it detects that the {\tt OPT},
{\tt EXECNOW}, or \texttt{EXEC} options of a test require dynamic linking. This
occurs currently in the following cases:
\begin{itemize}
\item {\tt OPT} contains the option {\tt -load-script}
\item {\tt OPT} contains the option {\tt -load-module}
\item {\tt EXECNOW} and \texttt{EXEC} use {\tt make} to create a {\tt .cmxs}
\end{itemize}
\end{important}
\begin{important}
\textbf{Concurrency issues:}
tests using compiled modules ({\tt -load-script} or {\tt -load-module}) may
......@@ -740,6 +727,7 @@ occurs currently in the following cases:
In addition, if the same script {\tt tests/suite/script.ml}
is shared by several test files, the {\tt EXECNOW} directive should be put
into {\tt tests/suite/test\_config}.
Check the {\tt MODULE} directive for a common solution to this issue.
\end{important}
......@@ -832,9 +820,11 @@ Figure~\ref{fig:ptests-options} details the options of \ptests.
& \texttt{-byte} & Use bytecode toplevel & no \\
& \texttt{-opt} & Use native toplevel & yes \\
& \texttt{-gui} & Use GUI instead of console-based toplevel & no \\
\hline \multirow{4}{16mm}{\centering{Behavior}}
\hline \multirow{5}{16mm}{\centering{Behavior}}
& \texttt{-run} & Delete current results; run tests and examine results & yes
\\
& \texttt{-dry-run} & Print commands, but do not execute them & no
\\
& \texttt{-examine} & Only examine current results; do not run tests & no \\
& \texttt{-show} & Run tests and show results, but do not examine
them; implies \texttt{-byte} &
......
......@@ -203,13 +203,6 @@ only possible one to define mutually dependent plug-ins while the third one
(through module \texttt{Db}) is now fully deprecated even if most of the older
\framac plug-ins are still defined this way.
Plug-ins are usually dynamically linked when \framac is booting, even if some
older \framac plug-ins are still statically linked. However it is still possible
to statically link a dynamic plug-in if wanted or required. In particular,
\ocaml does not support dynamic linking on some hardware
architecture~\cite{caml}: in this case, you have to statically link all
plug-ins.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Libraries}\label{archi:libraries}
......
......@@ -338,7 +338,7 @@ let rec argspec =
"-xunit", Arg.Set xunit,
" Create a xUnit file named xunit.xml collecting results";
"-error-code", Arg.Set do_error_code,
" Exit with error code 1 if tests failed (useful for scripts";
" Exit with error code 1 if tests failed (useful for scripts)";
]
and help_msg () = Arg.usage (Arg.align argspec) umsg;;
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment