home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol069 / install.doc < prev    next >
Encoding:
Text File  |  1984-04-29  |  3.5 KB  |  79 lines
  1.  
  2.             INSTALL DOC
  3.  
  4.  
  5.  
  6.     Install  was  written  because    there  are  so    many good
  7. programs out there going  begging  because  the program has to be
  8. rewritten for some specific terminal it can be used.
  9.  
  10.     INSTALL is very easy to use.  You just chose the terminal
  11. type  from  a  menu  and INSTALL will write the correct data to a
  12. file 'TERMIO.FIL'.  If your  terminal  is  not one of those types
  13. listed or you desire to make changes to any of    the  values  then
  14. select    the  response 'None of the above'.  You will be presented
  15. with the name  of  the    string    sequence  to  be  changed and the
  16. current values, you enter one or more bytes of data [use  decimal
  17. numbers  not  hex] for the string. e.g. the sequence for erase to
  18. end of line might be 'escape' followed by 't'.    These codes would
  19. be entered as -  27  116  carriage  return.    The values will be
  20. displayed again for editing, if  required.    If  the  codes  are
  21. correct  as displayed then enter a carriage return and move on to
  22. the next sequence.
  23.  
  24.     In INSTALL, terminal specific characteristics are defined
  25. as short string sequences.  These sequences are placed in a  data
  26. file,  "TERMIO.FIL", allowing a user program to be configured for
  27. any terminal  simply  by  reading  the    data  file  and using the
  28. sequences.  Sounds easy and with INSTALL it can be.
  29.  
  30.     INSTALL has the definitions  of  12  different    terminals
  31. built  in,  however,  not  all    of  the  many  functions for each
  32. terminal are implimented in the  program.   Using the source code
  33. one can add any additional string sequencs [If you do enhance the
  34. source code of INSTALL.PAS please send a  copy    to  the  Pascal/Z
  35. Users' Group. ED].
  36.  
  37.     The file "TERMIO.PAS" is the complete source code for the
  38. procedures,    constants,  variables and functions that are to be
  39. included in  your  Pascal  prgm.    These  may    be  edited out of
  40. TERMIO.PAS into seperate files:  TERMIO.VAR  and  TERMIO.CST  and
  41. this  edited  file  should  be named TERMIO.LIB.  It contains the
  42. procedure 'writes()'  that  writes  the  string  sequences to the
  43. console; the procedure 'gotoxy()'  that  directly  positions  the
  44. cursor    and  the  function 'InitTerm' that reads in the data file
  45. "TERMIO.FIL" returning true if the  data  file is found and false
  46. if the file is not found.
  47.  
  48.     Write  your  program  in  the  usual  way  then  add  the
  49. variables and the procedures required simply by using the include
  50. facility of Pascal/Z.  e.g. {$iTERMIO.VAR } for the variables and
  51. {$iTERMIO.LIB } for the procedures and the  function  "InitTerm".
  52. TERMIO.LIB  contains  the  procedure  'gotoxy()'  that    has  been
  53. written  specifically  to  be  used  with  INSTALL.  The function
  54. "InitTerm" reads the  terminal    data  file  to    set up the string
  55. sequences and so should be the first  or  second  procedure  call
  56. from the main program.    e.g.
  57.     BEGIN { MAIN PROGRAM }
  58.       GCML(CmdLine); { Read the comand line }
  59.       If not InitTerm then
  60.         HALT('TERMIO.FIL NOT FOUND. RUN INSTALL');
  61.       ...
  62.  
  63.     The  procedure    writes() must be used to write the string
  64. sequences.  Suppose you  want  the  string '+++ COMMAND PROCESSOR
  65. +++' highlighted by inverse video at row  12,  column  22.    The
  66. sequences INVON and INVOFF should be used as follows:
  67.  
  68.     gotoxy(22,12);
  69.     writes( INVON );
  70.     write( '+++ COMMAND PROCESSOR +++' );
  71.     writes( INVOFF );
  72.     writeln;
  73.  
  74.     Since writes() does not do a carriage return/line feed it
  75. may  be used to continue other sequences on the same line but one
  76. must issue a writeln to get to the next line.
  77.  
  78.  
  79.