<?xml version="1.0" encoding="UTF-8"?>
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="pause">
    <refnamediv>
        <refname>pause</refname>
        <refpurpose>mode de pause, attente clavier  </refpurpose>
    </refnamediv>
    <refsection>
        <title>Description</title>
        <para>
            Passage en mode de <literal>pause</literal>;
            inséré dans le code d'une fonction, <literal>pause</literal> fait une pause dans l'exécution
            de la fonction : un symbole d'invite de commande est affiché à l'utilisateur indiquant le "niveau" de la <literal>pause</literal> (e.g. <literal>-1-&gt;</literal>). L'utilisateur se trouve dans un environnement dans lequel toutes les variables du niveau correspondant sont accessibles (en particulier les variables locales de la fonction).
            Pour reprendre l'exécution taper <literal>"return"</literal>.
        </para>
        <para>
            Dans ce mode, <literal>[...]=return(...) </literal>
            renvoie les variables de l'argument <literal>(...)</literal> dans l'environnement appelant
            sous les noms précisés dans <literal> [...]</literal>. Sinon, les variables de l'environnement interrompu sont protégées et non modifiables.
        </para>
        <para>
            L'instruction <literal>pause</literal> est très utile en phase de mise au point ou de débogage.
        </para>
        <para>
            Il est possible de sortir du mode de pause en mettant fin à l'exécution en tapant <literal>"abort"</literal>.
        </para>
    </refsection>
    <refsection role="see also">
        <title>Voir aussi</title>
        <simplelist type="inline">
            <member>
                <link linkend="halt">halt</link>
            </member>
            <member>
                <link linkend="return">return</link>
            </member>
            <member>
                <link linkend="abort">abort</link>
            </member>
            <member>
                <link linkend="quit">quit</link>
            </member>
            <member>
                <link linkend="whereami">whereami</link>
            </member>
            <member>
                <link linkend="where">where</link>
            </member>
            <member>
                <link linkend="sleep">sleep</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
