NAME
        Translate -- Convert an English string into narrator device phonemes.

    SYNOPSIS
        rtnCode = Translate(inString, inLength, outBuffer, outLength)
        D0                  A0        D0        A1         D1

        long translate( strptr instring, long inlength, strptr outbuffer,
            long outlen );

    FUNCTION
        The translate function converts an English string into
        a string of phonetic codes suitable as input to the
        narrator device.

    INPUTS
        inString - pointer to English string
        inLength - length of English string
        outBuffer - a char array which will hold the phonetic codes
        outLength - the length of the output array

    RESULTS
        rtnCode - zero if no error has occured.
            The only error that can occur is overflowing the outBuffer.
            If Translate() determines that an overflow will occur, it
            will stop the translation at a word boundary before the
            overflow happens.  If this occurs, rtnCode will be a
            negative number whose absolute value indicates where in
            inString Translate() stopped.  The user can then use the
            offset -rtnCode from the beginning of inString in a
            subsequent Translate() call to continue the translation.

    SEE ALSO
        narrator.device/cmd_write