home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / f / ql41.ark / QL41-CFG.DOC < prev    next >
Encoding:
Text File  |  1990-04-13  |  4.3 KB  |  123 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 SETTING IT UP
  6.  
  7.  
  8.    Vanilla or Chocolate CP/M:
  9.  
  10.    If  you  can edit 5 lines and then type "Z1 QL41", you should  take  the
  11.    extra  minute to configure the program for your terminal.   Simply  edit
  12.    the file QL41.AZM  and insert the byte sequences for clearscreen, dim  /
  13.    bright,  and  reverse / normal video where  indicated.   After  editing,
  14.    follow the simple assembly instructions below.
  15.  
  16.    If you do not know or have all the video features mentioned, you  should
  17.    at least try to put in the clearscreen code.  The reverse video is  only
  18.    used to highlight strings found when using the "Find" command.  The  dim
  19.    /  bright  sequence is used in the filename  selection  screens  (binary
  20.    files  displayed  dim) and to display status  information  (to  visually
  21.    separate the status/command line from the file being viewed).
  22.  
  23.                                     ......
  24.  
  25.    ZCPR3x
  26.  
  27.    No  configuration  is necessary;  the program will use  your  'standout'
  28.    video  for  both  of  the  sequences  described  above.   If  yours   is
  29.    dim/bright, you are in pretty good shape already.  Reverse video is much
  30.    less  appropriate and not likely to look that great.  For absolute  best
  31.    results  in either case, however, fill in the 'other' sequence  so  both
  32.    modes  are used.  See the notes in QL41.AZM for more detail on  how  the
  33.    'hardcoded' sequence will always take precedence.  Then follow the ZCPR3
  34.    assembly and linking instructions below.
  35.  
  36.                                     ......
  37.    All Systems:
  38.    A  number of other things can be configured to your preference, but  all
  39.    are  non-essential.   Each and briefly described in comments  near  each
  40.    option.   All  user configurable options are all located  in  the  short
  41.    QL41.AZM file.
  42.  
  43.  
  44.                       HOW TO ASSEMBLE AFTER CONFIGURING
  45.  
  46.    For  standard CP/M 2.2 or CP/M+, you can use the Z1 assembler  included,
  47.    even if you've never assembled a program before.  Just make sure  you've
  48.    got the QL41.AZM file you just edited, along with the rest of the  files
  49.    in this release, all on the same drive / user.  Then just type:
  50.  
  51.    Z1 QL41
  52.  
  53.     ...and  wait for your new customized QL41.COM to be created.  You  will
  54.    probably want to rename it just plain "QL.COM" for convenience.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                               1
  62.  
  63.  
  64.  
  65.    ------------------------------------------------------------------------
  66.  
  67.    Advanced or alternative assembly and linking instructions:
  68.  
  69.    If you prefer to use a different assembler or are creating a ZCPR3  ver-
  70.    sion, here are some helpful tips:
  71.  
  72.                         ......................
  73.  
  74.    For  regular  (non-ZCPR) assembly, if you prefer to use  either  M80  or
  75.    SLR's  Z80ASM,  you must first make sure that you have changed  the  M80
  76.    equate at the beginning of QL41.AZM from FALSE to TRUE.  Then:
  77.     ......
  78.  
  79.    For M80:       ren QL41.MAC=QL41.AZM   (do not rename any other files)
  80.  
  81.                   M80 =QL41/N/Z
  82.  
  83.    then,w/ L80:   L80 /P:100,QL41,QL41/N,/E
  84.    or, w/ LINK:   LINK QL
  85.     ......
  86.  
  87.    For Z80ASM:    ren QL41.Z80=QL41.AZM   (do not rename any other files)
  88.  
  89.                   Z80ASM QL41             (that's it)
  90.  
  91.                         ......................
  92.  
  93.    For  ZCPR3, you must set ZCPR3 to TRUE in QL41.AZM.  You must  also  set
  94.    M80 to TRUE, since the Z1 assembler cannot be used.  You must have  cop-
  95.    ies of SYSLIB, Z3LIB, and VLIB to link to (not supplied).
  96.  
  97.    For M80:       ren QL41.MAC=QL41.AZM   (do not rename any other files)
  98.  
  99.                   M80 =QL41/N/Z
  100.  
  101.    then, w/LINK   LINK QL,VLIB[s],Z3LIB[s],SYSLIB[s]
  102.  
  103.     ......
  104.  
  105.    For Z80ASM     ren QL41.Z80=QL41.AZM   (do not rename any other files)
  106.  
  107.                   Z80ASM QL41/6
  108.    then,
  109.    w/SLRNK+    SLRNK+  QL41/n/a:100/j  QL41  VLIB/s Z3LIB/s SYSLIB/s  /e
  110.  
  111.  
  112.    (or use LINK as above)
  113.  
  114.     ......
  115.  
  116.    Other combinations of assemblers and linkers are left as an exercise..
  117.  
  118.                                                     S. Greenberg
  119.                                                     rev.  26 Jan 1989
  120.  
  121.  
  122.                               2
  123.