



              The SALT Programming HyperText Manual v1.0 (SPHM10)

                     Copyright 1991, 1992 Craig S. Miller


                             Web-Man Applications
                                P.O. Box 60562
                          Sacramento, CA  95860-0562

                       Phone (916) 486-0756 - Voice only


                         Designed by: Craig S. Miller


                 Text of SALT Manual Copyright 1991 Exis Inc.
                              Used by permission.




     Description
     -----------

     The   SALT   Programming   HyperText   Manual   v1.0   SPHM10,   is  a
     context-sensitive help system, pop-up manual,  and  tutorial  for  the
     Script  Application  Language  for  Telix (SALT). It is designed to be
     used as either a learning tool for SALT programming and/or  to  assist
     in the programming of Telix SALT scripts.

     SPHM10  presents  the Telix v3.15 SALT Programming Manual in HyperText
     format. HyperText is  text  with  embedded  cross  references,  called
     HyperText  links.  These links allow the programmer to jump to related
     reference material.  Thus, the SALT Programming  Manual  is  presented
     'multi-dimensionally.'

     Features of SPHM10 include context-sensitive searching, stand alone or
     TSR  (Terminate  &  Stay  Resident)  operation,  automatic screen mode
     sensing, copy and paste, mouse support, place  marking,  backtracking,
     topic searching, printing, and exporting.

     In   stand-alone  mode,  SPHM10  can  be  operated  as  an  intuitive,
     interactive tutorial system for the beginner. The user (or reader) may
     explore the SALT  Programming  Manual  in  any  direction  he  or  she
     desires.

     When  used  in  TSR  mode, SPHM10 can be accessed from within any text
     editor (such as QEDIT, TED, etc.) while programming a SALT script. The
     context-sensitive nature of SPHM10 can bring  the  needed  information
     directly onto the screen without searching.

     The  user  can  look  up information about commands, related commands,
     SALT program structure, etc., and return directly to the script  being
     edited.




     The SALT Programming HyperText Manual v1.0 (SPHM10)        Page 2 of 7

     Registration & Distribution
     ---------------------------

     SPHM10  is  distributed by Web-Man Applications as FREEWARE. It may be
     distributed freely; no compensation of any kind is required or will be
     accepted by Web-Man Applications. However, registration  of  Telix  is
     encouraged by Web-Man Applications.


     Disclaimer
     ----------

     SPHM10,  the  SALT Programming HyperText Manual v1.0 is distributed as
     is. There are no warranties, expressed or implied. In no  event  shall
     Web-Man Applications or Exis, Inc. be held responsible for any direct,
     indirect,  special,  incidental,  or  consequential damages or loss of
     profits to users of this program regardless of the legal theory,  even
     if advised of the possibility of such damage. The use of this software
     states that the user has and will accept and acknowledge these terms.


     File Included
     -------------

     SPHM10.EXE   - The SALT Programming HyperText Manual, executable
     README       - This file


     System Requirements
     -------------------

               - IBM PC or compatible
               - DOS 2.1 or greater
               - Monochrome or color monitor


     Memory Requirements
     -------------------

     SPHM10  uses  45-58K of conventional memory.  If installed in expanded
     memory, it requires as little as 1K  (See the Command-Line  Options in
     SPHM10 for further details).


     Display Modes
     -------------

     SPHM10  will operate in monochrome or color, and supports most display
     sizes (80x25, 80x50, 40x25, etc.). Display size will be  automatically
     detected,  and  can  be  resized  if desired.  Monochrome monitors are
     automatically detected.




     The SALT Programming HyperText Manual v1.0 (SPHM10)        Page 3 of 7

     Browser Features
     ----------------

     ALL MODES

     SPHM10 has many different types of 'links' to other  cards.  Some  are
     evident   by  their  color  (such  as  menu  selections),  others  are
     invisible.  Position the cursor on any word and press enter; if  there
     are cards associated with that word, they will be displayed.


     CONTEXT-SENSITIVE BROWSING (TSR MODE)

     SPHM10  will  read  the  screen  at  the  current  cursor location and
     determine which card to bring up.  For example, while looking  through
     a sample SALT script, suppose an unfamiliar command is encountered, or
     related  information  is  desired. With the SALT Programming HyperText
     Manual in TSR mode, simply move the cursor to the command in  question
     and press "CTRL - ." (press the CONTROL or CTRL key, then the period).
     A  short  list of possible 'topic links' will appear; the user selects
     the one desired. SPHM10 will pop up and display 'card' associated with
     that topic, showing the exact text from the SALT Manual.  Alternately,
     if  a  topic  has been selected for which there is only one associated
     card, that card will be immediately displayed.


     STAND-ALONE MODE

     SPHM10  can  be called up and the manual 'paged' through in any manner
     desired  to  familiarize  the  reader  with  the  concepts   of   SALT
     programming.  Place marking and backtracking features allow the reader
     to come back to information already presented.




     The SALT Programming HyperText Manual v1.0 (SPHM10)        Page 4 of 7

     Command Line Options
     --------------------

     SPHM10  should  reside  in  the  same  directory  where the Telix SALT
     scripts are edited and compiled.

     To use SPHM10, enter one of the following lines from DOS:

     sphm10 -tsr   -  Run SPHM10 Terminate & Stay Resident (TSR) mode
     sphm10 -u     -  Unload SPHM10 TSR from memory
     sphm10        -  Run SPHM10 stand-alone mode
     sphm10 -h     -  Displays help screen with list of command line
                      options available in the current browsing mode.
                      This option varies depending on whether the
                      browser is in memory.

     Note: Commands (such as -tsr, -u, -h) are CASE SENSITIVE. Be  sure  to
           enter commands in lower-case.

     The user must enter the full DOS path name if SPHM10 is not located in
     the same directory  where  the  SALT  scripts  are  being  edited  and
     compiled.

             Example: c:\telix\sphm\sphm10 -tsr


     For more command line options, see the SPHM10 Command-Line Options
     in SPHM10.


     Example Batch File
     ------------------

     To  use  SPHM10  while editing a SALT script, the programmer may first
     use the TSR mode command (see above) or use a batch file such as;

     EDIT.BAT

     sphm10 -tsr      <-- Use SPHM in the TSR mode
     q myscript.slt   <-- Edit the script (using QEDIT in this example)
     sphm10 -u        <-- Remove SPHM from memory (when editing has
                          been completed)




     The SALT Programming HyperText Manual v1.0 (SPHM10)        Page 5 of 7

     Basic SPHM10 Navigation
     -----------------------

     The HELP section within SPHM10 will provide the user with an extensive
     overview of the concepts of HyperText. Use the "ALT - H" command  from
     within SPHM10.


     Known Problems
     --------------

     MOUSE DRIVERS

     If  you have a Logitech mouse with an old driver (pre-V5.0), the mouse
     action will not work properly in SPHM10. Update to V5.0 or  higher  of
     the driver to correct the problem.

     Also,  SPHM10  will  lock  up  if  you  are  using a TrueMouse driver,
     (purportedly supplied  by  NorthGate.)  Even  though  this  driver  is
     supposed  to  be  100%  Microsoft compatible, it apparently isn't! The
     same symptoms occur with some Mouse System mouse drivers.

     Try to use the latest mouse driver you can, and if  at  all  possible,
     use a true Microsoft mouse driver.


     IMMEDIATE LOCKUP

     If SPHM10 locks up on you, here are two possible reasons:

     1) Your computer is non-standard in some way in the upper memory  area
        (between  640K-1MB),  and  causes  SPHM10's  automatic scan of this
        area to lock up.

         Solution: Try using the -xh option, which will prevent SPHM10
         from  scanning the upper memory area. If you use this option,
         then you may NOT load SPHM10 into the upper memory area using
         the DOS loadhigh command.

     2) Your mouse driver is old, or is not  a  true  Microsoft  compatible
        driver.

         Solution: Try using the -mo- option which turns of the use of
         the mouse in SPHM10. (Notice the dash before AND after "mo".)
         If this clears up the problem, then either  use  this  option
         all  the  time,  or  try to update to the latest mouse driver
         you can.




     The SALT Programming HyperText Manual v1.0 (SPHM10)        Page 6 of 7

     About Telix
     -----------

     Telix  v3.15 is a full-featured communications program for PCs running
     the PC/MS-DOS operating system, that is able  to  meet  the  needs  of
     almost any user.

     Telix's extensive Script Application Language for Telix (SALT) is used
     to automatically perform needed tasks  or  functions.  The  tasks  can
     range  from  the  very  simple to the very complicated. For example, a
     SALT script can be linked to a dialing directory entry, so that when a
     connection to that service  has  been  established,  it  automatically
     sends the user's i.d. and password to the remote service.  A much more
     complicated  SALT  script  is  used  as  the  basis  for the Host Mode
     included with Telix.

     Telix
     is Copyright (c) 1986,1987,1988,1989,1990,1991 by Exis Inc.

     SALT Programming Manual
     is Copyright (C) 1986,1987,1988,1989,1990,1991 by Exis Inc.

     EXIS Inc., Post Office Box 130, West Hill, ON, Canada  M1E 4R4
     Phone (416)-289-4641 voice, (416)-289-4645 FAX, (416)-439-9399 BBS


     About HyperHelper
     -----------------

     SPHM10, the SALT Programming HyperText Manual v1.0 was developed using
     HyperHelper v3.03 by  Azarona  Software.   The  Trial  Kit  (Shareware
     version)  of HyperHelper is available free on CompuServe in the IBMAPP
     Forum, Word-Processing library as HHV30.EXE.

     Call or write to;

     Azarona Software, P.O. Box 13433, Denver, CO, 80301
     Phone (303) 697-1088, CompuServe address 73057, 3172




     The SALT Programming HyperText Manual v1.0 (SPHM10)        Page 7 of 7

     Feedback
     --------

     No compensation will be accepted by Web-Man Applications  for  SPHM10,
     the SALT Programming HyperText Manual v1.0; however, feedback would be
     appreciated.

     Please mail comments, suggestion, etc, to:

                             Web-Man Applications
                              c/o Craig S. Miller
                                P.O. Box 60562
                           Sacramento, CA 95860-0562

                       Phone (916) 486-0756 - Voice only

     I can be reached also through the FidoNet Telix Support echo.

