Seppo Mustonen : Programming Survo in C

Functions in library SURVO.LIB

tut_init, tut_end

Summary

int tut_init()

int tut_end()

Description

The tut_init function opens the tutorial file, if the current module is run under tutorial mode (system parameter etu>0). tut_init is called once immediately after s_init in those modules which operate at least partially in conversational mode (by using the prompt and nextch functions). Thus tut_init is not needed in modules which simply carry out their task without any prompts for the user. Error messages ending with WAIT do not require tut_init either. If tut_init has been called, the functions tut_end and s_end must be called (in this order) before the exit from the module.

Return Value

There is no return value.

See Also

s_init, s_end, prompt, nextch

Example

A typical construction in a SURVO 84C module is:

#include "survo.h"
#include "survoext.h"

main(argc,argv)
int argc; char *argv[1];
        {
        if (argc==1) return;
        s_init(argv[1]);
        tut_init();
/*  ..........  */
        tut_end();
        s_end(argv[1]);
        }