home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / assemblr / disasm / uasm / listkey < prev    next >
Encoding:
Text File  |  1988-06-03  |  15.0 KB  |  541 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                             Computerenergy's CROSSREF
  8.  
  9.                              Cross Reference Utility
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                    Version 1.0
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                Proprietary Notice
  44.  
  45. CROSSREF is  a  proprietary   product  developed  by  Richard  C.    Bemis  and
  46. distributed by Computerenergy Corporation, Denver, Colorado.
  47.  
  48. Copyright 1982 by Richard C.  Bemis and Computerenergy Corporation.  All rights
  49. reserved except those expressly granted to the user within this document.
  50.  
  51. Computerenergy Corporation,  PO  Box  6267,  Denver,  CO  80206  (303) 233-9118
  52. Source: ST6070
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                       - i -
  61.  
  62.  
  63.                                 TABLE OF CONTENTS
  64.  
  65. Section                                                                    Page
  66.  
  67.  
  68.  
  69. CHAPTER 1  CROSSREF DISTRIBUTION NOTICE ...................................   1
  70.  
  71. CHAPTER 2  INTRODUCTION ...................................................   2
  72.  
  73. CHAPTER 3  SYSTEM SETUP ...................................................   3
  74.    3.1  Copying CROSSREF ..................................................   3
  75.    3.2  Program Setup - Final Installation ................................   3
  76.  
  77. CHAPTER 4  OPERATION ......................................................   4
  78.    4.1  Execution .........................................................   4
  79.    4.2  Entering Responses ................................................   4
  80.    4.3  Maillist/Donation Assistance ......................................   4
  81.    4.4  Program Entry .....................................................   4
  82.  
  83. CHAPTER 5  OTHER INFORMATION ..............................................   6
  84.    5.1  Distribution Disk Contents ........................................   6
  85.    5.2  System Requirements ...............................................   6
  86.    5.3  Disclaimer ........................................................   6
  87.  
  88. CHAPTER 6  SUGGESTIONS, FEEDBACK, AND BUG REPORTS .........................   7
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122. CROSSREF                             - ii -          Computerenergy Corporation
  123.  
  124.  
  125.                                     CHAPTER 1
  126.  
  127.                           CROSSREF DISTRIBUTION NOTICE
  128.  
  129. CROSSREF is being  distributed using the "Freeware"* approach.  To those of you
  130. unfamiliar with  this  approach, it  works like  this.   You may send either  a
  131. preformatted  single-sided  disk (or  a prepaid  contribution  for our disk and
  132. mailer) to  us with a prepaid return mailer and we will send a complete copy of
  133. the product.   If the product does not meet your needs, please pay nothing.  If
  134. the product  does meet your needs, and you can use it, then we would appreciate
  135. a  contribution of  whatever  you  feel  is  appropriate.  Naturally,  we  have
  136. probably given  you  a clue  in several  places  as to what is  our "completely
  137. unprejudiced opinion" of an appropriate contribution amount.  Contributions are
  138. completely voluntary and much encouraged.
  139.  
  140. Even if you  do not  contribute, you are encouraged to  copy and distribute the
  141. product freely subject to the following restrictions:
  142.  
  143.      1. Do not  distribute altered copies.  Note: You may distribute a separate
  144.         set of modifications  to merge in if you  wish but they must be clearly
  145.         identified  as  not originating  from Computerenergy.   If  you do make
  146.         modifications, we  would like to see what you've done, if possible, for
  147.         future versions.
  148.  
  149.      2. The  product  is to  be distributed  as  a complete "distribution copy"
  150.         produced  by the  copy  utility  provided  with  the product  for  this
  151.         purpose.
  152.  
  153.      3. No fee is to be charged for copying or distributing the program without
  154.         an express written agreement with Computerenergy Corporation.
  155.  
  156.      4. Commercial  sale of  this product  in any manner is prohibited  without
  157.         Computerenergy's  written  permission.  Some  products will be released
  158.         with this permission automatically given and expressly stated.
  159.  
  160. User Groups/Clubs:  Computerenergy's  freeware  products may  be distributed by
  161. Clubs and User Groups subject to the same restrictions.  We would ask only that
  162. contributions to  our continuing efforts be encouraged by those performing such
  163. distribution.
  164.  
  165. Computer Bulletin Boards: Computerenergy's freeware products may be distributed
  166. by  BBS's  subject  to the  same restrictions  and  contribution encouragement.
  167. However, as the products tend to be large and consist of several files, we have
  168. some concern as to the reliability of transmissions and length of connect time.
  169. Perhaps disks could be mailed or just the documentation placed on the board for
  170. browsers.
  171.  
  172.  
  173. * The  Freeware concept  was initially  developed by Andrew Fluegelman and  the
  174. term  "FREEWARE"  is a  trademark of  The Headlands Press, Inc.  The  Headlands
  175. Press provides  a catalog of information about Freeware products available from
  176. multiple sources.   They may  be contacted at PO Box  862, Tiburon, CA 94920 or
  177. Source: TCP204 or Compuserve: 71435,1235.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184. CROSSREF                             - 1 -           Computerenergy Corporation
  185.  
  186.  
  187.                                     CHAPTER 2
  188.  
  189.                                   INTRODUCTION
  190.  
  191.  
  192. Computerenergy's Cross   Reference   was   created  to   make  programming  and
  193. maintenance jobs  easier.   We  feel  that  a computer  should  help as much as
  194. possible in  its own  development efforts.  CROSSREF is a  tool that produces a
  195. cross-reference  for  each reference  to a  variable or a line number  within a
  196. program.
  197.  
  198.  
  199.  
  200. After you have  setup the  system and read the Operation  chapter, we recommend
  201. that you  try  CROSSREF  on some  of your  own  programs.  If you are  going to
  202. "wing-it"  without   reading  further,  then  SAVE  the  Basic  program  to  be
  203. cross-referenced in  ASCII (true  wingers understand this), type CROSSREF,  and
  204. good luck!
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246. CROSSREF                             - 2 -           Computerenergy Corporation
  247.  
  248.  
  249.                                     CHAPTER 3
  250.  
  251.                                   SYSTEM SETUP
  252.  
  253.  
  254. The Cross  Reference  distribution disk  contains a  version  of the program in
  255. compiled  formats  along  with its  Syntax file.   Compiled  versions are being
  256. distributed as they execute much faster.
  257.  
  258. 3.1  Copying CROSSREF
  259.  
  260.      There is a batch file which copies the entire distribution disk for backup
  261.      or distribution purposes.  We highly recommend making a backup copy before
  262.      proceeding as it is safer and the mails can be slow.
  263.  
  264.      Place the Cross  Reference distribution  disk in Drive A: and  a formatted
  265.      disk without  DOS on it in Drive B:.  While in DOS, type CRCOPY and follow
  266.      any instructions.
  267.  
  268. 3.2  Program Setup - Final Installation
  269.  
  270.      We recommend that a  copy of CROSSREF and its  control file, CROSSWDS.DAT,
  271.      be placed  on a Basic Program Development DOS System disk if possible.  If
  272.      this is  your first  run-through, do not perform this  step yet - use your
  273.      copy of the distribution disk and proceed to the Operation Chapter.
  274.  
  275.      1. Copy CROSSREF.EXE to the System disk.
  276.  
  277.              A Sample COPY command might be:
  278.  
  279.                             COPY B:CROSSREF.EXE A:
  280.  
  281.      2. Copy  the CROSSWDS.DAT  file  to  the  same  disk.  This  file  must be
  282.         available any time CROSSREF program is used.
  283.  
  284.              A sample COPY command might be:
  285.  
  286.                             COPY B:CROSSWDS.DAT A:
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308. CROSSREF                             - 3 -           Computerenergy Corporation
  309.  
  310.  
  311.                                     CHAPTER 4
  312.  
  313.                                     OPERATION
  314.  
  315. 4.1  Execution
  316.  
  317.      Starting Cross  Reference is  simply a  matter of entering DOS and  typing
  318.      CROSSREF followed by the Enter key.
  319.  
  320. 4.2  Entering Responses
  321.  
  322.      You will quickly  notice that all input requested by Cross Reference is at
  323.      the  bottom  of  the screen,  following a  prompt,  and contained within a
  324.      "target".  We have found that a relatively constant area for data entry is
  325.      superior  to  the  more  typical  design  of  "fill-in-the-blanks"  as  it
  326.      minimizes  eye travel  and  usually  makes  for  a more  consistant  entry
  327.      process.   All  responses  are completed  by pressing  the  Enter key.  In
  328.      several prompts,  and on  the keyboard, the Enter key  is represented by a
  329.      symbol roughly similar to this: (<-').
  330.  
  331.      In addition  to  the  normal  editing  functions provided  for inner-field
  332.      editing there are a couple of special functions available:
  333.  
  334.                Field Erase:  Press the ESC key to erase an entry and start over
  335.                              or to change a field that has a pre-loaded value.
  336.  
  337.                Field Backup: Press the Up-Arrow to "backup" to the previous
  338.                              entry.  The current entry will be erased as you
  339.                              "backup".
  340.                              Note: You can "backup" as far as you like until
  341.                              the very beginning of the program.
  342.  
  343. 4.3  Maillist/Donation Assistance
  344.  
  345.      The first  screen you  see is  a title, information, and copyright  screen
  346.      with a "Press Enter to continue or space for Maillist/Donation assistance"
  347.      prompt.  Normally, you will press the Enter key to start CROSSREF.  If you
  348.      press the space bar, a program will run which will help you print a letter
  349.      that you  can  send  to us  to be  sure  you are placed on  our maillist -
  350.      particularly important  if you did not receive your copy directly from us.
  351.      Amazingly enough, the letter will even assist you in making a contribution
  352.      but that is not required (nice though).
  353.  
  354.      Note: The assistance program  - CRMAIL - is contained  on the distribution
  355.      disk and  its copies but should not be copied to your DOS development disk
  356.      as it  is  large,  not required,  and a  waste  of disk space.  CRMAIL  is
  357.      chained  from CROSSREF  as it  resides on the distribution disk  or may be
  358.      executed directly from the distribution disk by typing CRMAIL.
  359.  
  360. 4.4  Program Entry
  361.  
  362.      Up to 25 programs  may be specified to be  listed in sequence at one time.
  363.      NOTE: Each program must be previously saved in ASCII format using the ",A"
  364.      option of the Save command in Basic.  Example:
  365.  
  366.                     SAVE "B:progname.S",A
  367.  
  368.      We use the  .S  extension  for  "Source"  to differentiate  between  Basic
  369.  
  370. CROSSREF                             - 4 -           Computerenergy Corporation
  371.  
  372.  
  373.                                                            CHAPTER 4: OPERATION
  374.  
  375.  
  376.      encoded programs  and those saved in ASCII.  This approach also provides 2
  377.      copies of  each program  as it is developed -  a sort of automatic backup.
  378.      Any program extension may be used.
  379.  
  380.      If a program is  read by CROSSREF that has  accidentally not been saved in
  381.      ASCII, CROSSREF will display an ERR=62 message and return to DOS.
  382.  
  383.      For each program to be listed, CROSSREF asks for 3 pieces of information -
  384.      program name, beginning  line number to start listing,  ending line number
  385.      to end listing.  Each program name may be entered without an extension and
  386.      CROSSREF will  append the a default Program Name Extension = ".S".  If the
  387.      program is entered  with an extension, then the  entered extension will be
  388.      used.
  389.  
  390.      Each line  number field  is pre-loaded  with a default value which  may be
  391.      changed  most easily  by pressing  the ESC key and keying  a new number or
  392.      backspacing and  re-keying the  number.  The default value is  selected by
  393.      pressing the Enter key.
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432. CROSSREF                             - 5 -           Computerenergy Corporation
  433.  
  434.  
  435.                                     CHAPTER 5
  436.  
  437.                                 OTHER INFORMATION
  438.  
  439. 5.1  Distribution Disk Contents
  440.  
  441.  
  442.           File Name       Description
  443.           ------------    --------------------------------------
  444.  
  445.           CROSSREF.EXE    Compiled CROSSREF
  446.           CROSSREF.DOC    Documentation
  447.           CROSSWDS.DAT    Basic Syntax File
  448.           CRMAIL.EXE      Maillist/Donation Assistance
  449.           CRCOPY.BAT      Copies Distribution Disk - both CROSSREF and MONITOR
  450.  
  451.  
  452. 5.2  System Requirements
  453.  
  454.      CROSSREF requires an IBM  PC with 64K, DOS 1.1,  and at least 1 disk drive
  455.      (2 disks highly recommended for development machines).
  456.  
  457.  
  458. 5.3  Disclaimer
  459.  
  460.      All Computerenergy computer programs  are distributed on an "as  is" basis
  461.      without warranty.
  462.  
  463.      Computerenergy Corporation and/or any of its program authors shall have no
  464.      liability or responsibility to customer or any other person or entity with
  465.      respect to  any liability,  loss or damage caused or  alleged to be caused
  466.      directly  or  indirectly   by  programs  distributed  in  any   manner  by
  467.      Computerenergy Corporation,  including but not limited to any interruption
  468.      of  service,  loss of  business or  anticipatory  profits or consequential
  469.      damages resulting from the use or operation of such computer programs.
  470.  
  471.      Note: Good  data  processing  procedure dictates  that the  user  test the
  472.      program, run  and test sample sets of data, and run the system in parallel
  473.      with the  system previously in use for a period of time adequate to insure
  474.      that results of operation of the computer program are satisfactory.
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494. CROSSREF                             - 6 -           Computerenergy Corporation
  495.  
  496.  
  497.                                     CHAPTER 6
  498.  
  499.                      SUGGESTIONS, FEEDBACK, AND BUG REPORTS
  500.  
  501.      If you  can  spare  the  time,  we  would  appreciate  your  feedback  and
  502.      suggestions to  help us  to improve CROSSREF.  As an  added inducement, we
  503.      will also send  a free CROSSREF (corrected) to  the first person reporting
  504.      each bug.   Immediate family  members of Computerenergy employees are  NOT
  505.      eligible.    If   possible,   each   bug   reported   should   include   a
  506.      short-as-possible  printout  of  the reference  situation with explanatory
  507.      notes.   Our unprejudiced  judging panel  will make "Bug Awards" when  the
  508.      spirit moves them and, of course, their decisions are final.
  509.  
  510.      We are also  aware of  some esthetic errors when operating  with the color
  511.      video interface.  Those still remaining should be corrected soon, but we'd
  512.      still like to hear about any you find.
  513.  
  514.      Please address  correspondence  to  the address  on the  title  page.  (If
  515.      you've lost  your title page, just send us a note and we'll send you a new
  516.      one.)
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556. CROSSREF                             - 7 -           Computerenergy Corporation
  557.  
  558.