home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / program / arp68bok / programs.doc < prev    next >
Encoding:
Text File  |  1993-10-23  |  17.6 KB  |  397 lines
  1.                Atari ST Machine Specific Programming In Assembly
  2.                
  3.  
  4. Program Index
  5.  
  6.      Source files are listed in alphabetical and numerical order, the order in 
  7.   
  8. which they appear in the book.  The following information is given for each 
  9.   
  10. entry: the folder in which the source file and assembled programs are stored on 
  11.   
  12. disk; the chapter in which the program is introduced and the page number within 
  13.   
  14. the chapter; a brief description of program function.
  15.  
  16.   
  17. Alphabetical Listing
  18.   
  19.  
  20.  Source    Folder   Chapter  Program  Function
  21.   Name      Name     /Page    Number
  22.  
  23. AUT_DATA  INSTTEST    7/62      38    A version of program 37 in which data 
  24.   
  25.                                       areas are declared within the AUTs.
  26.                                       
  27. CLR_MEM   ALGRTEST    6/29      29    Compares 6 ways of clearing 32,000 bytes 
  28.   
  29.                                       of ram.
  30.                                       
  31. CLR_MEM2  ALGRTEST    6/36      30    Measures specific values reported by 
  32.   
  33.                                       program 29 with greater accuracy.
  34.                                       
  35. CONFIG    UTILITY     6/16      27    Configures certain system variables during 
  36.   
  37.                                       boot.
  38.                                       
  39. CMD_TEST  UTILITY     5/36      20    Compares the command line processing 
  40.   
  41.                                       algorithms used in programs 16, 18 and 19.
  42.                                       
  43. CUSTOM    CUSTTRAP    7/53      --    This is a version of program 13 to which 
  44.   
  45.                                       program 34 has been added.
  46.                                       
  47. HEX_TEST  ALGRTEST    4/67      14    Verifies the accuracy of the binary to 
  48.   
  49.                                       ASCII decimal algorithm used in PRG_4AP 
  50.                                       
  51.                                       and TRAPS.
  52.                                       
  53. LEA_ADDA  ALGRTEST    6/49      33    Confirms that the LEA instruction is the 
  54.   
  55.                                       better choice for stack adjustments 
  56.                                       
  57.                                       greater than 8 bytes.
  58.                                       
  59. LEA_MOVE  INSTTEST    7/50      37    Compares the execution speed and requisite 
  60.   
  61.                                       memory of two algorithms that write data 
  62.                                       
  63.                                       to a location.
  64.                                       
  65. LEAMOVEA  INSTTEST    7/73      40    Compares the execution speed and requisite 
  66.   
  67.                                       memory of two instructions that load an 
  68.   
  69.                                       address into an address register.
  70.                                       
  71. MULTIPLY  ALGRTEST    6/45      32    Compares the speed of three multiplication 
  72.   
  73.                                       algorithms.
  74.                                       
  75. PEA_MOVE  INSTTEST    7/79      41    Compares two ways of pushing the contents 
  76.   
  77.                                       of an address register onto the stack.
  78.                                       
  79. PRG_1AP   PRG_1       2/19       1    A minimum ST program.
  80.   
  81. PRG_1BP   PRG_1       2/46       2    Waits for a keypress.
  82.  
  83. PRG_1CP   PRG_1       2/56       3    Exposes an AssemPro bug.
  84.  
  85. PRG_1DP   PRG_1       2/60       4    A bug killer.
  86.  
  87. PRG_1EP   PRG_1       2/74       5    Embedding data between program text 
  88.   
  89.                                       segments.
  90.  
  91. PRG_2AR   PRG_2       3/3        6    Exposes an error in the AssemPro manual.
  92.  
  93. PRG_2AC   PRG_2       3/16       7    Introduces the Combo assembly mode.
  94.  
  95. PRG_2BR   PRG_2       3/19       8    Illustrates the type of instructions that 
  96.   
  97.                                       are not compatible with PC-relative 
  98.                                       
  99.                                       assembly.
  100.                                       
  101. PRG_2CC   PRG_2       6/3       23    Programs 23 and 24 are used to generate 
  102.   
  103.                                       executable files assembled in three modes 
  104.                                       
  105.                                       so that their load and execute times can 
  106.                                       
  107.                                       be compared.
  108.                                       
  109. PRG_2CP   PRG_2       6/5       24    Used to generate the PC-relative and 
  110.   
  111.                                       Relocatable files for the comparison 
  112.                                       
  113.                                       discussed above.
  114.                                       
  115. PRG_2DP   PRG_2       6/9       25    Compares the effects of three floppy disk 
  116.   
  117.                                       formatting techniques.
  118.                                       
  119. PRG_3AP   PRG_3       4/12       9    Compares two methods of calculating the 
  120.   
  121.                                       length of a program.
  122.                                       
  123. PRG_3BP   PRG_3       4/36      10    Illustrates the use of GEMDOS $4A.
  124.   
  125. PRG_3CP   PRG_3       4/41      11    Compares two binary to ASCII decimal 
  126.   
  127.                                       conversion algorithms.
  128.                                       
  129. PRG_4AP   PRG_4       4/54      12    Illustrates the use of GEMDOS $31.
  130.   
  131. PRG_5AP   PRG_5       5/22      17    Exercises SPEED_1 and custom traps 3, 6 
  132.   
  133.                                       and 8.
  134.                                       
  135. PUSHZERO  ALGRTEST    6/22      28    Compares three ways of pushing zero onto 
  136.   
  137.                                       the stack.
  138.                                       
  139. SPAWN     UTILITY     5/70      22    Spawns a process and saves its redirected 
  140.   
  141.                                       output in a disk file.
  142.                                       
  143. SPEED_1   UTILITY     5/15      16    Computes a program's load and execution 
  144.   
  145.                                       times.
  146.                                       
  147. SPEED_2   UTILITY     5/26      18    Improved SPEED_1.
  148.   
  149. SPEED_3   UTILITY     5/31      19    Improved SPEED_2.
  150.   
  151. SPEEDTST  UTILITY     5/65      21    Improved SPEED_3 = final algorithm in 
  152.   
  153.                                       series.
  154.                                       
  155. TIMES_4   ALGRTEST    6/40      31    Refutes the claim that multiplying by 4 
  156.   
  157.                                       using add dn, dn twice is faster than 
  158.                                       
  159.                                       using asl #2, dn.
  160.                                       
  161. TRAP_9    CUSTTRAP    5/12      15    Installs a custom trap for programs 16-19.
  162.   
  163. TRAP_9P   CUSTTRAP    7/17      34    Installs an adaptive algorithm that 
  164.   
  165.                                       reconstructs itself to form an executable 
  166.                                       
  167.                                       loop about an algorithm under test (AUT) 
  168.                                       
  169.                                       and reports the AUT's execution time and 
  170.                                       
  171.                                       requisite memory.
  172.                                       
  173. TRAP_9R   CUSTTRAP    7/39      36    Installs an adaptive algorithm that 
  174.   
  175.                                       reconstructs itself to form an executable 
  176.                                       
  177.                                       loop about an algorithm under test (AUT) 
  178.                                       
  179.                                       and reports the AUT's execution time and 
  180.                                       
  181.                                       requisite memory.  This is program 34 
  182.                                       
  183.                                       designed for Relocatable assembly.
  184.                                       
  185. TRAP_10   CUSTTRAP    6/14      26    Converts a timed interval passed as a 
  186.   
  187.                                       parameter in D0 to milliseconds, then 
  188.                                       
  189.                                       prints the ASCII decimal value of that 
  190.                                       
  191.                                       interval.
  192.                                       
  193. TRAP9DAT  CUSTTRAP    7/65      39    A version of program 34 designed to work 
  194.   
  195.                                       with AUTs which have declared data areas, 
  196.                                       
  197.                                       such as those in program 38.
  198.                                       
  199. TRAP9TST  CUSTTRAP    7/35      35    Verifies that program 34 functions 
  200.   
  201.                                       correctly.  Measures the speed of 
  202.                                       
  203.                                       multiplication algorithms.
  204.                                       
  205. TRAPS     CUSTTRAP    4/59      13    Installs 8 custom traps.
  206.  
  207.   
  208. Numerical Listing
  209.  
  210. Program  Chapter   Source    Folder   Function
  211.  Number   /Page     Name      Name    
  212.  
  213.     -      7/53   CUSTOM    CUSTTRAP  This is a version of program 13 to which 
  214.   
  215.                                       program 34 has been added.
  216.                                       
  217.     1      2/19   PRG_1AP   PRG_1     A minimum ST program.
  218.  
  219.     2      2/46   PRG_1BP   PRG_1     Waits for a keypress.
  220.  
  221.     3      2/56   PRG_1CP   PRG_1     Exposes an AssemPro bug.
  222.  
  223.     4      2/60   PRG_1DP   PRG_1     A bug killer.
  224.  
  225.     5      2/74   PRG_1EP   PRG_1     Embedding data between program text 
  226.   
  227.                                       segments.
  228.  
  229.     6      3/3    PRG_2AR   PRG_2     Exposes an error in the AssemPro manual.
  230.  
  231.     7      3/16   PRG_2AC   PRG_2     Introduces the Combo assembly mode.
  232.  
  233.     8      3/19   PRG_2BR   PRG_2     Illustrates the type of instructions that 
  234.   
  235.                                       are not compatible with PC-relative 
  236.                                       
  237.                                       assembly.
  238.                                       
  239.     9      4/12   PRG_3AP   PRG_3     Compares two methods of calculating the 
  240.   
  241.                                       length of a program.
  242.                                       
  243.    10      4/36   PRG_3BP   PRG_3     Illustrates the use of GEMDOS $4A.
  244.   
  245.    11      4/41   PRG_3CP   PRG_3     Compares two binary to ASCII decimal 
  246.   
  247.                                       conversion algorithms.
  248.                                       
  249.    12      4/54   PRG_4AP   PRG_4     Illustrates the use of GEMDOS $31.
  250.   
  251.    13      4/59   TRAPS     CUSTTRAP  Installs 8 custom traps.
  252.   
  253.    14      4/67   HEX_TEST  ALGRTEST  Verifies the accuracy of the binary to 
  254.   
  255.                                       ASCII decimal algorithm used in PRG_4AP 
  256.                                       
  257.                                       and TRAPS.
  258.                                       
  259.    15      5/12   TRAP_9    CUSTTRAP  Installs a custom trap for programs 16-19.
  260.   
  261.    16      5/15   SPEED_1   UTILITY   Computes a program's load and execution 
  262.   
  263.                                       times.
  264.                                       
  265.    17      5/22   PRG_5AP   PRG_5     Exercises SPEED_1 and custom traps 3, 6 
  266.   
  267.                                       and 8.
  268.                                       
  269.    18      5/26   SPEED_2   UTILITY   Improved SPEED_1.
  270.   
  271.    19      5/31   SPEED_3   UTILITY   Improved SPEED_2.
  272.   
  273.    20      5/36   CMD_TEST  UTILITY   Compares the command line processing 
  274.   
  275.                                       algorithms used in programs 16, 18 and 19.
  276.                                       
  277.    21      5/65   SPEEDTST  UTILITY   Improved SPEED_3 = final algorithm in 
  278.   
  279.                                       series.
  280.                                       
  281.    22      5/70   SPAWN     UTILITY   Spawns a process and saves its redirected 
  282.   
  283.                                       output in a disk file.
  284.                                       
  285.    23      6/3    PRG_2CC   PRG_2     Programs 23 and 24 are used to generate 
  286.   
  287.                                       executable files assembled in three modes 
  288.                                       
  289.                                       so that their load and execute times can 
  290.                                       
  291.                                       be compared.
  292.                                       
  293.    24      6/5    PRG_2CP   PRG_2     Used to generate the PC-relative and 
  294.   
  295.                                       Relocatable files for the comparison 
  296.                                       
  297.                                       discussed above.
  298.                                       
  299.    25      6/9    PRG_2DP   PRG_2     Compares the effects of three floppy disk 
  300.   
  301.                                       formatting techniques.
  302.                                       
  303.    26      6/14   TRAP_10   CUSTTRAP  Converts a timed interval passed as a 
  304.   
  305.                                       parameter in D0 to milliseconds, then 
  306.                                       
  307.                                       prints the ASCII decimal value of that 
  308.                                       
  309.                                       interval.
  310.                                       
  311.    27      6/16   CONFIG    UTILITY   Configures certain system variables during 
  312.   
  313.                                       boot.
  314.                                       
  315.    28      6/22   PUSHZERO  ALGRTEST  Compares three ways of pushing zero onto 
  316.   
  317.                                       the stack.
  318.                                       
  319.    29      6/29   CLR_MEM   ALGRTEST  Compares 6 ways of clearing 32,000 bytes 
  320.   
  321.                                       of ram.
  322.                                       
  323.    30      6/36   CLR_MEM2  ALGRTEST  Measures specific values reported by 
  324.   
  325.                                       program 29 with greater accuracy.
  326.                                       
  327.    31      6/40   TIMES_4   ALGRTEST  Refutes the claim that multiplying by 4 
  328.   
  329.                                       using add dn, dn twice is faster than 
  330.                                       
  331.                                       using asl #2, dn.
  332.                                       
  333.    32      6/45   MULTIPLY  ALGRTEST  Compares the speed of three multiplication 
  334.   
  335.                                       algorithms.   
  336.                                       
  337.    33      6/49   LEA_ADDA  ALGRTEST  Confirms that the LEA instruction is the 
  338.   
  339.                                       better choice for stack adjustments 
  340.                                       
  341.                                       greater than 8 bytes.
  342.                                       
  343.    34      7/17   TRAP_9P   CUSTTRAP  Installs an adaptive algorithm that 
  344.   
  345.                                       reconstructs itself to form an executable 
  346.                                       
  347.                                       loop about an algorithm under test (AUT) 
  348.                                       
  349.                                       and reports the AUT's execution time and 
  350.                                       
  351.                                       requisite memory.
  352.                                       
  353.    35      7/35   TRAP9TST  CUSTTRAP  Verifies that program 34 functions 
  354.   
  355.                                       correctly.  Measures the speed of 
  356.                                       
  357.                                       multiplication algorithms.
  358.                                       
  359.    36      7/39   TRAP_9R   CUSTTRAP  Installs an adaptive algorithm that 
  360.   
  361.                                       reconstructs itself to form an executable 
  362.                                       
  363.                                       loop about an algorithm under test (AUT) 
  364.                                       
  365.                                       and reports the AUT's execution time and 
  366.                                       
  367.                                       requisite memory.  This is program 34 
  368.                                       
  369.                                       designed for Relocatable assembly.
  370.                                       
  371.    37      7/50   LEA_MOVE  INSTTEST  Compares the execution speed and requisite 
  372.   
  373.                                       memory of two algorithms that write data 
  374.                                       
  375.                                       to a location.
  376.                                       
  377.    38      7/62   AUT_DATA  INSTTEST  A version of program 37 in which data 
  378.   
  379.                                       areas are declared within the AUTs.
  380.                                       
  381.    39      7/65   TRAP9DAT  CUSTTRAP  A version of program 34 designed to work 
  382.   
  383.                                       with AUTs which have declared data areas, 
  384.                                       
  385.                                       such as those in program 38.
  386.                                       
  387.    40      7/73   LEAMOVEA  INSTTEST  Compares the execution speed and requisite 
  388.   
  389.                                       memory of two instructions that load an 
  390.                                       
  391.                                       address into an address register.
  392.                                       
  393.    41      7/79   PEA_MOVE  INSTTEST  Compares two ways of pushing the contents 
  394.   
  395.                                       of an address register onto the stack.
  396.  
  397.