home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / assemblr / asm / wasm / samples.doc < prev    next >
Text File  |  1988-03-07  |  6KB  |  164 lines
  1.  
  2.  
  3.                 Description of Wolfware Assembler Sample Programs
  4.  
  5.        Wolfware Assembler comes with numerous sample programs.  These
  6.        programs can be looked at, modified, assembled, and executed on
  7.        your computer.  Routines listed separately and individual sections
  8.        of code within the sample programs may be used in your own
  9.        programs.
  10.  
  11.        If you are new to assembly language, it might be wise to look at
  12.        the simple programs first.  Generally speaking, the smaller a
  13.        program is, the simpler it is, for example PRES is a very simple
  14.        program, while SHOW87 is fairly complex.
  15.  
  16.        Two separate "libraries" are implemented.  By library, I mean a
  17.        single set of routines that may be used by different programs.
  18.        The first is the "IO runtime library."  This library uses some
  19.        fancy coding to implement separately assembled modules which are
  20.        loaded transparently during execution.  The library also includes
  21.        a macro interface.  The second library consists of several include
  22.        files that were written to be used with specific programs, but are
  23.        general enough to be used by any program.  These include files
  24.        consist of CONVERT1.INC, CONVERT2.INC, VIDEO1.INC, VIDEO2.INC, and
  25.        FILE1.INC.
  26.  
  27.        The following is a summary of the sample programs.  See also the
  28.        files IO.DOC, FILT.DOC, and SHOW87.DOC for a more thorough
  29.        description of some of the programs.
  30.  
  31.        Files marked with \IO deal with the IO runtime library and may be
  32.        in a subdirectory named IO.  Files marked with \8087 deal with the
  33.        8087 coprocessor and may be in a subdirectory named 8087.  Files
  34.        marked with \FILT deal with the text filter program and may be in
  35.        a subdirectory named FILT.
  36.  
  37.  
  38.        BIN2DAT.ASM, binary file to data statements (\IO)
  39.  
  40.          This is a stand-alone program to convert any binary file to
  41.          BASIC data statements.  Useful for imbedding machine language
  42.          subroutines directly in BASIC programs.
  43.  
  44.        BOOT.ASM, software initiated reboot
  45.  
  46.          This is a stand-alone program that initiates a warm or cold
  47.          boot.
  48.  
  49.        BTYPE.ASM, binary type
  50.  
  51.          This is a stand-alone program to display the contents of ANY
  52.          file to the screen.  No interpretation of control characters is
  53.          carried out, including carriage returns, linefeeds, bells, etc.
  54.          All characters are displayed just as the screen controller sees
  55.          them.
  56.  
  57.  
  58.        CASE.ASM, set case of string
  59.  
  60.          This is a Turbo Pascal (3.0) subroutine to set the case of a
  61.          string to all upper, all lower, or capitalized (first character
  62.          upper and remaining lower).
  63.  
  64.        CLP.ASM, clear partial screen
  65.  
  66.          This is a BASIC subroutine to clear or scroll any or all of the
  67.          screen.
  68.  
  69.        CONVERT1.INC, integer conversion routines (\8087)
  70.        CONVERT2.INC, real number conversion routines (\8087)
  71.  
  72.          These are some string conversion routines.  Used by SHOW87.ASM
  73.          and FACTOR.ASM.
  74.  
  75.        DISPATCH.ASM, dispatch code (\IO)
  76.  
  77.          This is a program fragment to help implement separately
  78.          assembled libraries. See IO.DOC.
  79.  
  80.        DOS.MAC, common DOS functions (\IO)
  81.  
  82.          These are some macros to implement a few common DOS functions.
  83.  
  84.        FACTOR.ASM, factorial calculator (\8087)
  85.  
  86.          This is a stand-alone program that calculates the factorial of
  87.          numbers using the 8087 coprocessor.
  88.  
  89.        FILE1.INC, file routines (\FILT)
  90.  
  91.          This is some sequential buffered file i/o routines.  Used by
  92.          FILT.ASM.
  93.  
  94.        FILT.ASM, text filter (\FILT)
  95.        FILT1.ASM, additional FILT source code (\FILT)
  96.  
  97.          This is a stand-alone program to perform some simple text
  98.          filtering functions.  See FILT.DOC.
  99.  
  100.        IO.ASM, basic input and output routines (\IO)
  101.        IO.MAC, macro front end for IO.ASM (\IO)
  102.        IO.RED, redirection table for IO.ASM (\IO)
  103.        IO.BIN, runtime library assembly of IO.ASM (\IO)
  104.  
  105.          These are a set routines to assist in performing standard input
  106.          and output functions.  See IO.DOC.
  107.  
  108.        KEY.ASM, key reassignment
  109.  
  110.          This is a stand-alone program to reassign the meaning of any key
  111.          via ANSI escape sequences.  Requires ANSI.SYS or a compatible
  112.          device driver be installed.
  113.  
  114.  
  115.        LIBRARY.ASM, library code (\IO)
  116.  
  117.          This is a program fragment to help implement separately
  118.          assembled libraries. See IO.DOC.
  119.  
  120.        PRES.ASM, printer reset
  121.  
  122.          This is a stand-alone program that uses the BIOS printer
  123.          interface to do a low level printer reset.  This program resets
  124.          the printer to its default state.
  125.  
  126.        PRIMES.ASM, generate prime numbers (\IO)
  127.  
  128.          This is a stand-alone program that generates all the prime
  129.          numbers between 1 and 65535 and sends them to the standard
  130.          output device.
  131.  
  132.        PTEST.ASM, printer test
  133.  
  134.          This is a Turbo Pascal (3.0) subroutine to determine if a
  135.          printer is connected and ready.
  136.  
  137.        RTIME.ASM, resident time display
  138.  
  139.          This is memory resident program that shows the active time in
  140.          the upper right corner of the screen.  The display can be
  141.          enabled or disabled from the keyboard.
  142.  
  143.        SHOW87.ASM, shows 8087 state (\8087)
  144.  
  145.          This is a memory resident program that shows the present state
  146.          of an installed 8087 coprocessor chip.  The information is
  147.          displayed in the upper half of the screen.  See SHOW87.DOC.
  148.  
  149.        SOUND.ASM, make sounds on the speaker (\IO)
  150.  
  151.          This is a stand-alone program the allows you to make various
  152.          sounds on the speaker.  Requires the IO.BIN runtime library for
  153.          execution and ANSI.SYS or a compatible device driver be
  154.          installed.
  155.  
  156.        VIDEO1.INC, low (BIOS) level display (\8087)
  157.        VIDEO2.INC, high-level/formatted display (\8087)
  158.  
  159.          These are some screen display routines.  VIDEO1 contains low
  160.          level, BIOS compatible routines.  VIDEO2 contains higher level,
  161.          formatted display routines.  Used by SHOW87.ASM.
  162.  
  163.  
  164.