Provided by: atfs-dev_1.4pl6-16.1build1_amd64 bug

NAME

       stLog,  stQuietFlag, stShutupFlag, stProgramName, stMessage, stGetFromStdin, stAskConfirm,
       stGetTermWidth - user interaction

SYNOPSIS

       #include <config.h>
       #include <sttk.h.h>

       voidstLog (char *logMsg, int logType);

       int stQuietFlag;

       int stShutupFlag;

       char*stProgramName;

       charstMessage[];

       char*stGetFromStdin (int termChar);

       int stAskConfirm (char *message, char *defaultAnswer);

       int stGetTermWidth (int fdes);

DESCRIPTION

       These functions do the dialogue with the user. stLog  outputs  a  message  to  the  user's
       terminal. The message text is given in the logMsg buffer. logType is one of

       ST_LOG_MSG    Message to be sent to standard output.

       ST_LOG_MSGERR
                     Message to be sent to standard error.

       ST_LOG_WARNING
                     Warning  message,  preceded by the string `programName - warning:', going to
                     standard error.

       ST_LOG_ERROR  Error message, preceded by the  string  `programName  -  error:',  going  to
                     standard error.

       Additionally, when the flag

       ST_LOG_NONL   is  ored  to the message type (e.g. `ST_LOG_MSG | ST_LOG_NONL'), the message
                     is printed without adding a  newline  character.  Otherwise,  a  newline  is
                     always added.

       Whether  a message really makes it's way to the user, depends on the variables stQuietFlag
       and stShutupFlag. When stQuietFlag is set to a non null value, all messages  except  error
       messages (ST_LOG_ERROR) will be suppressed. With the stShutupFlag set to a null value, all
       messages will be suppressed. Initially, both flags are set to NULL.

       The stProgramName pointer should be set pointing to a buffer containing the name  how  the
       program  was  called.  It  is  used  for composing proper error messages and warnings (see
       above).

       stMessage is a buffer for constructing messages using sprintf(3). It  is  designed  to  be
       large  enough  to  hold  a  file's  pathname and an additional short message. It's size is
       MAXPATHLEN+128.

       stGetFromStdin reads from stdin a text  terminated  by  ^D  or  by  the  specified  single
       character termChar at the beginning of a new line. If termChar is -1 text is terminated by
       ^D.

       stAskConfirm returns true if the answer is equivalent to defaultAnswer (assumption).

       stGetTermWidth returns the actual with of the user's termainal in columns.

BUGS

       stGetTermWidth will not work on all machines properly. In it's current implementation,  it
       is quite SUN specific.