home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / compress / ql40.arc / QL40-CFG.DOC < prev    next >
Text File  |  1991-08-11  |  6KB  |  184 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 QL40", you should  take  the
  11.    extra  minute to configure the program for your terminal.   Simply  edit
  12.    the file QL40.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 QL40.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.    QL40.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 QL40.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 QL40
  52.  
  53.     ...and  wait for your new customized QL40.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 QL40.AZM from FALSE to TRUE.  Then:
  77.     ......
  78.  
  79.    For M80:       ren QL40.MAC=QL40.AZM   (do not rename any other files)
  80.  
  81.                   M80 =QL40/N/Z
  82.  
  83.    then,w/ L80:   L80 /P:100,QL40,QL40/N,/E
  84.    or, w/ LINK:   LINK QL
  85.     ......
  86.  
  87.    For Z80ASM:    ren QL40.Z80=QL40.AZM   (do not rename any other files)
  88.  
  89.                   Z80ASM QL40             (that's it)
  90.  
  91.                         ......................
  92.  
  93.    For  ZCPR3, you must set ZCPR3 to TRUE in QL40.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 QL40.MAC=QL40.AZM   (do not rename any other files)
  98.  
  99.                   M80 =QL40/N/Z
  100.  
  101.    then, w/LINK   LINK QL,VLIB[s],Z3LIB[s],SYSLIB[s]
  102.  
  103.     ......
  104.  
  105.    For Z80ASM     ren QL40.Z80=QL40.AZM   (do not rename any other files)
  106.  
  107.                   Z80ASM QL40/6
  108.    then,
  109.    w/SLRNK+    SLRNK+  QL40/n/a:100/j  QL40  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.  
  119.  
  120.  
  121.  
  122.                               2
  123.  
  124.  
  125.  
  126.  
  127.    Resulting  file sizes will vary depending on the assemblers and  linkers
  128.    used  (SLR always give the smallest and fastest results).  The  programs
  129.    have been set up so the resulting COM files will not include large  data
  130.    blocks.   The  regular CP/M version should always be less  than  8k,  as
  131.    should the ZCPR3 version.  A pre-assembled, pre-linked, ZCPR3 version of
  132.    QL40 is included as QLZ40.COM, and should run right "out of the box" for
  133.    many Z3 systems, especially if your TCAP is set up for dim video.  It is
  134.    63  records long, and was created by SLRNK+ and linked to the new  'z80-
  135.    ified' versions of the three libraries (the pre-linked file included was
  136.    supplied courtesy Bruce Morgen).  The new libraries are not only slight-
  137.    ly shorter, but they utilize DSEG's to save additional code space.
  138.  
  139.    The  standard libraries, linked with SLRNK+, should still give you a  64
  140.    record COM file.  If you use a linker which leaves DSEG's  unnecessarily
  141.    attached,  the  result may be slightly larger.  QL initializes  all  its
  142.    data  when run, so if you know what you are doing, and "breaking the  8k
  143.    barrier" really bothers you, you can chop off the DSEG with a  debugger.
  144.    The  self-initialization also means that there is no problem  re-running
  145.    QL40 with a 'GO' command or equivalent.
  146.  
  147.    Finally,  if  you  want to just patch terminal control  codes  into  the
  148.    QLZ40.COM file supplied, these are the relevant addresses.  There should
  149.    be  a  series of 6 zeroes at each address, of which up to 5 may  be  re-
  150.    placed  with  a control sequence.  These addresses are specific  to  the
  151.    exact  QLZ40.COM file supplied in the distribution library.  Patched  in
  152.    sequences will override any TCAP defined sequences.
  153.  
  154.    Dim video on:       173BH
  155.    Dim video off:      1759H
  156.    Reverse video on:   177CH
  157.    Reverse video off:  17A1H
  158.    Clear screen        17DCH
  159.  
  160.                                                    - Steven Greenberg
  161.                                                      14  August  1988
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.                               3
  184.